UUID Tools Integration with SmythOS

Need unique identifiers for your records or tracking? Use the UUID Tools integration to empower your agents to generate universally unique identifiers (UUIDs) instantly and without any configuration.

TL;DR

Use the "Generate UUID" or "Generate Multiple UUIDs" components to create unique IDs on-the-fly. No authentication or API key is required, making this one of the simplest integrations to use.

List of UUID Tools Components

Quickly compare UUID Tools components by what they do and their key I/O.

Component	Action	What it Does	Inputs	Key Outputs	Use Case
Generate UUID	Generate	Creates a single, unique version 4 UUID.	required trigger	uuid	Generating a unique ID for a new database record.
Generate Multiple UUIDs	Generate	Creates a batch of unique version 4 UUIDs.	required trigger optional count	uuids	Creating unique session IDs for a batch of new users.

INFO

Why Integrate UUID Tools with Your Agent?

Universally Unique Identifiers (UUIDs) are a standard for generating random IDs. Using this integration provides a simple, reliable way for your agents to create them.

• Ensure Data Uniqueness: When an agent creates new records in a database (like Firestore or Upstash), use this component to generate a unique primary key, preventing collisions and ensuring data integrity.
• Tracking and Correlation: Generate a unique ID at the start of a complex workflow. This "correlation ID" can be passed between different agents and services, making it easy to track a single process from start to finish in your logs.
• Simplify Development: Offload the task of UUID generation to a reliable, dedicated service. There's no need to implement custom code or manage libraries for creating unique IDs.
• Testing and Mocking: Quickly generate large batches of UUIDs for populating test databases or creating mock data for your development environments.

Prerequisites

Before you begin, you only need one thing:

• An active SmythOS account. (Sign up here).

That's it! This API requires no authentication.

Getting Started With UUID Tools

This integration is one of the easiest to use as it requires no API key or authentication setup.

Step 1: Add a UUID Tools Component

1. In your SmythOS agent graph, drag and drop either the Generate UUID or Generate Multiple UUIDs component.
2. That's it! The component is ready to use immediately.

No Configuration Needed

There are no settings to configure for this integration. You can start using the components right away to generate unique identifiers in your workflows.

Which UUID Tools Component Should I Use?

If you need to…	Target	Use this Component	Why this one?
Create just one unique ID	A single operation	Generate UUID	The simplest way to get a single, random UUID.
Create a batch of unique IDs at once	Multiple items	Generate Multiple UUIDs	More efficient for creating up to 100 UUIDs in a single API call.

Component Details

This section provides detailed information for each UUID Tools component.

Generate UUID

Generates a single, standard version 4 UUID.

INFO

This component is ready to use and does not require any authentication or settings configuration.

Inputs

Field	Type	Required	Notes
trigger	any	Yes	Any input value can be used to trigger the component's execution.

Outputs

Field	Type	Description
uuid	string	The generated unique identifier (e.g., xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx).
Response	string	The raw response from the UUID Tools API, which is the UUID itself.
Headers	object	The HTTP headers from the API response.

Use Case

An agent is designed to log events. For each new event, it calls this component to generate a unique uuid to serve as the event's primary key before writing it to a database.

{
  "component": "uuidTools.generateUuid",
  "trigger": "true"
}

Simplicity

This component is designed for one purpose: to return a single v4 UUID. For other versions or multiple IDs, use a different tool or component.

Generate Multiple UUIDs

Generates a batch of unique version 4 UUIDs in a single API call.

INFO

This component is ready to use and does not require any authentication or settings configuration.

Inputs

Field	Type	Required	Notes
trigger	any	Yes	Any input value to trigger the execution.
count	integer	Optional	The number of UUIDs to generate (from 1 to 100). Default: 10.

Outputs

Field	Type	Description
uuids	array	An array of strings, where each string is a unique identifier.
Response	object	The full, raw JSON response from the UUID Tools API, containing the uuids array.
Headers	object	The HTTP headers from the API response.

Use Case

An agent needs to create 10 new user accounts for a test environment. It calls this component with count set to 10 to get a list of unique IDs to assign to each test user.

{
  "component": "uuidTools.generateMultipleUuids",
  "trigger": "true",
  "count": 50
}

Batch Limit

You can generate a maximum of 100 UUIDs per call with this component. If you need more, you will need to call it multiple times.

Best Practices & Advanced Tips

• Use as Primary Keys: UUIDs are excellent candidates for primary keys in distributed systems because they are globally unique, meaning you can generate them anywhere without risk of collision.
• Idempotency Keys: Use a generated UUID as an idempotency key when making requests to other APIs. This can prevent duplicate operations if an agent accidentally runs the same request twice.
• No Secrets Needed: One of the main benefits of this integration is its simplicity. There are no API keys to manage or rotate, reducing your security overhead.

Troubleshooting Common Issues

• Error: 429 Too Many Requests

  • Cause: You have exceeded the API's rate limit of 60 requests per minute from your IP address.
  • Solution: Add a delay in your agent if you are calling the component in a rapid loop. Consolidate requests using the "Generate Multiple UUIDs" component where possible.

• Network Errors

  • Cause: A temporary connectivity issue between SmythOS and the UUID Tools API.
  • Solution: This is rare, but possible with any external API call. Build retry logic into your agent to handle transient network failures.

What's Next?

You are now ready to generate unique identifiers in any workflow with the SmythOS UUID Tools Integration!

Consider these ideas:

• Build an Agent That...

  • Creates new user records in a Firebase or Firestore database, using a freshly generated UUID as the document ID for each new user.
  • Generates a unique tracking ID for a customer support ticket and includes it in the subject line of all subsequent email correspondence related to that ticket.
  • Processes a batch of items from a Google Sheet, generates a unique ID for each one, and writes the data along with the new ID to a database.

• Explore Other Integrations:

  • The UUID Tools integration is a fundamental utility. Think of it as a building block that can be combined with almost any other integration that requires the creation of new, unique data records.