5.2 KiB
Basic Blocks Documentation
Store Value
What it is
A data storage and forwarding component that can hold and pass along values.
What it does
Stores a provided value and makes it available for reuse without modification.
How it works
Takes an input value and either stores it directly or uses a pre-stored value, then forwards it as output.
Inputs
- Input: The value to be stored (if no data is provided)
- Data: A pre-stored value to use instead of the input (optional)
Outputs
- Output: The stored value
Possible use case
Storing a user's name that needs to be used multiple times throughout a workflow.
Print to Console
What it is
A debugging tool that displays information during operation.
What it does
Prints text messages to the console for monitoring and debugging purposes.
How it works
Takes a text message and displays it in the console with a "Print: " prefix.
Inputs
- Text: The message to be displayed
Outputs
- Status: Confirmation that the message was printed
Possible use case
Monitoring the progress of a workflow by printing status updates.
Find in Dictionary
What it is
A search tool for looking up values in data structures.
What it does
Searches for and retrieves values from dictionaries, lists, or objects using a specified key.
How it works
Takes a data structure and a key, then attempts to find and return the corresponding value.
Inputs
- Input: The data structure to search in
- Key: The key to look up
Outputs
- Output: The found value
- Missing: The original input when the key isn't found
Possible use case
Looking up a user's details from a database response using their ID.
Agent Input
What it is
An interface for collecting input values from users.
What it does
Provides a structured way to gather and validate user input with optional constraints.
How it works
Creates an input field with customizable properties and validates the entered value.
Inputs
- Name: Identifier for the input
- Value: The actual input value
- Title: Display name (optional)
- Description: Help text (optional)
- Placeholder Values: Suggested values
- Limit to Placeholder Values: Restrict input to suggestions only
Outputs
- Result: The collected input value
Possible use case
Creating a form field for users to enter their age with suggested ranges.
Agent Output
What it is
A display component for showing results to users.
What it does
Formats and presents output values in a user-friendly way.
How it works
Takes a value and optional formatting instructions to display the result.
Inputs
- Value: The data to display
- Name: Identifier for the output
- Title: Display name
- Description: Additional information
- Format: Custom formatting instructions
Outputs
- Output: The formatted result
Possible use case
Displaying the results of a calculation with proper formatting and explanation.
Add to Dictionary
What it is
A tool for adding new entries to dictionaries.
What it does
Adds one or more key-value pairs to an existing or new dictionary.
How it works
Takes a dictionary and new entries, then creates an updated dictionary with the additions.
Inputs
- Dictionary: Existing dictionary (optional)
- Key: New entry key
- Value: New entry value
- Entries: Multiple entries to add
Outputs
- Updated Dictionary: The modified dictionary
- Error: Any error messages
Possible use case
Adding a new user preference to an existing settings dictionary.
Add to List
What it is
A tool for adding items to lists.
What it does
Adds one or more items to an existing or new list at specified positions.
How it works
Takes a list and new items, then creates an updated list with the additions.
Inputs
- List: Existing list (optional)
- Entry: Single item to add
- Entries: Multiple items to add
- Position: Where to insert items
Outputs
- Updated List: The modified list
- Error: Any error messages
Possible use case
Adding new tasks to a todo list at specific priorities.
Note
What it is
A documentation tool for adding explanatory notes.
What it does
Displays text as a sticky note in the workflow.
How it works
Takes text input and displays it as a note for documentation purposes.
Inputs
- Text: The note content
Outputs
- Output: The displayed note text
Possible use case
Adding explanatory comments to describe complex workflow steps.
Create Dictionary
What it is
A dictionary creation tool.
What it does
Creates a new dictionary with specified key-value pairs.
How it works
Takes a set of key-value pairs and combines them into a new dictionary.
Inputs
- Values: Key-value pairs for the dictionary
Outputs
- Dictionary: The created dictionary
- Error: Any error messages
Possible use case
Creating a new user profile with multiple fields.
Create List
What it is
A list creation tool.
What it does
Creates a new list with specified values.
How it works
Takes a set of values and combines them into a new list.
Inputs
- Values: Items for the list
Outputs
- List: The created list
- Error: Any error messages
Possible use case
Creating a new shopping list with multiple items.