AutoGPT/docs/content/platform/blocks/update/basic.md

# 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.