Nigel
/
AutoGPT
1
0
Fork 0
Code Issues Pull Requests 3 Packages Projects Releases Wiki Activity

rm files

This commit is contained in:
Bentlybro 2025-01-10 13:30:37 +00:00
parent 03691329be
commit d56931f4cb
31 changed files with 0 additions and 1509 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docs/content/platform/blocks/update/__init__.md
View File

@ -1,34 +0,0 @@
## Agent Executor
### What it is
A specialized block that enables the execution of an existing agent within another agent, allowing for nested agent operations.
### What it does
This block manages the execution of a pre-configured agent (graph) and processes its outputs. It handles the entire lifecycle of the agent execution, including monitoring its status and collecting results.
### How it works
1. Receives execution parameters including user identification and graph details
2. Initiates the execution of the specified agent
3. Monitors the execution progress through an event system
4. Collects and processes outputs from the agent
5. Reports execution status and results
6. Continues monitoring until the execution is completed, terminated, or fails
### Inputs
- User ID: The identifier for the user initiating the execution
- Graph ID: The unique identifier of the agent (graph) to be executed
- Graph Version: The specific version number of the agent to run
- Data: The input data that will be provided to the agent for processing
- Input Schema: The structure definition that describes the expected input format
- Output Schema: The structure definition that describes the expected output format
### Outputs
- Dynamic Outputs: The block yields outputs based on the executed agent's results
- Each output consists of:
- Output Name: A label identifying the type of output
- Output Data: The actual data produced by the executed agent
### Possible use case
A customer service automation system where a main agent needs to delegate specific tasks to specialized sub-agents. For example, a primary customer service agent might use this block to execute a specialized product recommendation agent when a customer asks for product suggestions. The main agent can continue its conversation while the recommendation agent processes the request and returns detailed product recommendations.

43
docs/content/platform/blocks/update/agent.md
View File

@ -1,43 +0,0 @@
## AI Image Generator
### What it is
A versatile tool that creates images using various AI models based on text descriptions and specified parameters.
### What it does
Transforms text descriptions into high-quality images while allowing users to control the image's size, style, and overall appearance using different AI models.
### How it works
The block takes your text description (prompt) and styling preferences, sends them to selected AI image generation models through the Replicate platform, and returns a URL containing your generated image. It supports multiple image formats and artistic styles, automatically adjusting your request to work best with each AI model.
### Inputs
- Credentials: Your Replicate API key for accessing the image generation service
- Prompt: Text description of the image you want to create (e.g., "A red panda using a laptop in a snowy forest")
- Model: Choice of AI model for image generation:
- Flux 1.1 Pro
- Flux 1.1 Pro Ultra
- Recraft v3
- Stable Diffusion 3.5 Medium
- Image Format: The shape and dimensions of your generated image:
- Square: For profile pictures and icons (1:1 ratio)
- Landscape: For traditional photos (4:3 ratio)
- Portrait: For vertical photos (3:4 ratio)
- Wide: For desktop wallpapers (16:9 ratio)
- Tall: For mobile wallpapers (9:16 ratio)
- Image Style: Visual style preference, including:
- Realistic options (standard, black & white, HDR, natural light, studio portrait)
- Digital art options (pixel art, hand-drawn, sketch, poster styles)
- Special effects (grain, motion blur, engraving)
### Outputs
- Image URL: Web address where the generated image can be accessed
- Error: Description of any problems that occurred during image generation
### Possible use cases
1. Marketing team needs custom images for social media posts
2. Designer creating mockups for website designs
3. Content creator generating unique thumbnails for blog posts
4. E-commerce platform creating product visualization concepts
5. App developer generating placeholder images for prototypes
6. Social media manager creating consistent-style posts across platforms

47
docs/content/platform/blocks/update/ai_image_generator_block.md
View File

@ -1,47 +0,0 @@
## AI Music Generator
### What it is
A specialized block that generates music using Meta's MusicGen model through the Replicate platform.
### What it does
Creates original music based on text descriptions, allowing users to generate custom audio tracks by simply describing the kind of music they want.
### How it works
The block takes a text description and various musical parameters, sends them to Meta's MusicGen model, and returns a URL containing the generated audio file. It includes automatic retries if generation fails and supports different output formats and normalization strategies.
### Inputs
- Credentials: Replicate API key required for accessing the service
- Prompt: Text description of the music you want to generate (e.g., "An upbeat electronic dance track with heavy bass")
- Model Version: Choice of three models:
- Stereo Large (default)
- Melody Large
- Large
- Duration: Length of the generated audio in seconds (default: 8)
- Temperature: Controls creativity level in generation (default: 1.0)
- Top K: Controls diversity of sound selection (default: 250)
- Top P: Alternative sampling method for sound selection (default: 0.0)
- Classifier Free Guidance: Controls how closely the output follows the input description (default: 3)
- Output Format: Choice between WAV or MP3
- Normalization Strategy: Audio normalization method (Loudness, Clip, Peak, or RMS)
### Outputs
- Result: URL link to the generated audio file
- Error: Error message if the generation process fails
### Possible use cases
- Creating background music for videos or presentations
- Generating custom music for games or apps
- Producing demo tracks for musicians
- Creating mood-specific music for meditation or relaxation apps
- Generating soundtrack options for content creators
- Prototyping musical ideas for composers
- Creating custom jingles for advertisements
- Generating ambient music for installations or exhibits
### Additional Notes
- The block includes automatic retry functionality (up to 3 attempts) if generation fails
- Generation time may vary depending on the requested duration and model complexity
- Output quality and adherence to the prompt may vary based on the selected parameters
- The system uses advanced normalization techniques to ensure consistent audio quality

48
docs/content/platform/blocks/update/ai_music_generator.md
View File

@ -1,48 +0,0 @@
## AI Shortform Video Creator
### What it is
A powerful tool that creates short-form videos using AI technology, perfect for social media content creation.
### What it does
Creates engaging videos by combining AI-generated visuals, voice narration, and background music based on a provided script. The tool can generate different styles of videos including stock footage, AI-generated images, or AI videos.
### How it works
The block takes your script and preferences, sends them to revid.ai's service, and creates a video by:
1. Converting text to AI voice narration
2. Matching visuals to your script descriptions
3. Adding background music
4. Combining everything into a final video
### Inputs
- Credentials: Your revid.ai API key for accessing the service
- Script: Your video script with spoken text and visual descriptions in brackets (e.g., "[close-up of a cat] Meow!")
- Ratio: The aspect ratio of your video (default: 9/16 for vertical videos)
- Resolution: Video quality setting (default: 720p)
- Frame Rate: Video smoothness setting (default: 60 fps)
- Generation Preset: Visual style for AI-generated content (options include Default, Anime, Realism, Illustration, etc.)
- Background Music: Choice of music track (21 options including Observer, Futuristic Beat, Science Documentary, etc.)
- Voice: AI voice selection for narration (options: Lily, Daniel, Brian, Jessica, Charlotte, Callum)
- Video Style: Type of visuals to use (Stock Videos, Moving AI Images, or AI Video)
### Outputs
- Video URL: Link to download the finished video
- Error: Description of any issues that occurred during video creation
### Possible use cases
- Creating TikTok or Instagram Reels content
- Making educational short-form videos
- Producing product demonstrations
- Generating social media marketing content
- Creating automated news summaries
- Developing quick tutorial videos
- Producing storytelling content for social platforms
### Tips for best results
1. Write clear, concise scripts with short sentences
2. Use brackets to specify exact visuals you want
3. Choose background music that matches your content's mood
4. Select the appropriate generation preset for your desired visual style
5. Pick a voice that suits your content's tone
This block is particularly useful for content creators, marketers, and businesses looking to create professional-quality short-form videos efficiently using AI technology.

47
docs/content/platform/blocks/update/ai_shortform_video_block.md
View File

@ -1,47 +0,0 @@
## Block Installation Manager
### What it is
A specialized tool designed to verify and install new blocks into the system, primarily intended for development purposes.
### What it does
This block acts as an installation manager that can:
- Accept new block code
- Verify the code's structure and validity
- Install the block into the system
- Test the block's functionality
- Provide feedback on the installation process
### How it works
The block follows a systematic process to manage new block installations:
1. Receives the block code as input
2. Checks if the code contains a valid block class definition
3. Verifies the presence of a unique identifier (UUID)
4. Creates a new file to store the block code
5. Attempts to load and test the new block
6. Either confirms successful installation or removes the file if there's an error
### Inputs
- Block Code: The complete Python code for the new block that needs to be installed. This should include all necessary class definitions and configurations.
### Outputs
- Success Message: A confirmation message indicating that the block was installed successfully
- Error Message: Detailed information about what went wrong if the installation fails, including both the problematic code and the specific error
### Possible use case
A developer creating a new custom block for the system could use this block to:
1. Write their new block code
2. Submit it through this installation manager
3. Receive immediate feedback on whether the block is properly structured
4. Get confirmation that the block is successfully installed and ready to use
5. Quickly identify and fix any issues if the installation fails
### Important Notes
- This block has heightened security implications as it can execute code on the server
- It is specifically designed for development purposes
- The block is disabled by default as a security measure
- It should only be enabled in controlled development environments
### Security Warning
This block should be used with caution as it has the ability to execute code on the server. It's recommended to keep this block disabled in production environments and only enable it in secure development settings.

34
docs/content/platform/blocks/update/basic.md
View File

@ -1,34 +0,0 @@
## Condition Block
### What it is
A logical comparison tool that evaluates two values based on a specified operator and produces different outputs depending on whether the condition is true or false.
### What it does
This block compares two values using standard comparison operators (like equals, greater than, less than) and outputs both the result of the comparison and corresponding values based on whether the condition was met or not.
### How it works
The block takes two values and compares them using the selected operator. It then determines if the comparison is true or false. Based on this result, it outputs either a "yes value" (if true) or a "no value" (if false). If no specific yes/no values are provided, it uses the input values as defaults.
### Inputs
- Value 1: The first value to compare (can be a number, text, or boolean)
- Operator: The comparison operator to use (equals, not equals, greater than, less than, greater than or equal to, less than or equal to)
- Value 2: The second value to compare (can be a number, text, or boolean)
- Yes Value (Optional): The value to output if the comparison is true (if not specified, Value 1 will be used)
- No Value (Optional): The value to output if the comparison is false (if not specified, Value 2 will be used)
### Outputs
- Result: A boolean value (true/false) indicating whether the condition was met
- Yes Output: The value produced when the condition is true (either the specified Yes Value or Value 1)
- No Output: The value produced when the condition is false (either the specified No Value or Value 2)
### Possible use case
In an e-commerce application, this block could be used to implement a discount system:
- Value 1: Customer's purchase amount
- Operator: Greater than
- Value 2: $100
- Yes Value: "10% discount applied"
- No Value: "No discount available"
This would output different messages based on whether the purchase amount exceeds $100, helping to implement a conditional discount policy.

42
docs/content/platform/blocks/update/block.md
View File

@ -1,42 +0,0 @@
## Code Execution Block
### What it is
A secure sandbox environment that allows users to execute code in various programming languages with internet access.
### What it does
This block provides a safe and isolated environment where users can run code in different programming languages (Python, JavaScript, Bash, R, and Java), execute setup commands, and receive the results of their code execution.
### How it works
The block creates an isolated sandbox environment using E2B's infrastructure. It first runs any specified setup commands to prepare the environment, then executes the provided code in the chosen programming language. The system captures all outputs, including standard output, error messages, and execution results, and returns them to the user.
### Inputs
- Credentials: Your E2B API key required to access the sandbox environment
- Setup Commands: Optional shell commands to prepare the environment (e.g., installing packages or dependencies)
- Code: The actual code you want to execute
- Programming Language: Choice of language to run your code (Python, JavaScript, Bash, R, or Java)
- Timeout: Maximum time in seconds allowed for code execution (default: 300 seconds)
- Template ID: Optional custom sandbox template ID for specialized environments
### Outputs
- Response: The main output or return value from your code execution
- Standard Output Logs: Any text that your code printed to standard output
- Standard Error Logs: Any error messages or warnings generated during execution
- Error: Detailed error message if the execution failed
### Possible use cases
- Testing code snippets in different programming languages
- Running data analysis scripts in a secure environment
- Executing system commands safely
- Teaching programming concepts with immediate feedback
- Prototyping solutions before implementing them in production
- Running code that requires specific dependencies without affecting local environment
### Notes
- The sandbox provides internet access, allowing for package installations and external API calls
- Pre-installed tools include pip and npm package managers
- The environment is Debian-based, allowing for additional package installations
- Each execution runs in isolation, ensuring clean and consistent results
- The sandbox is automatically cleaned up after execution
- Resource usage is controlled through templates for CPU and memory allocation

43
docs/content/platform/blocks/update/branching.md
View File

@ -1,43 +0,0 @@
## Code Extraction Block
### What it is
A tool that identifies and separates different types of programming code from within a text document.
### What it does
This block analyzes text content and automatically detects, extracts, and categorizes code snippets based on their programming language. It can handle multiple programming languages simultaneously and preserves any non-code text.
### How it works
The block searches through the input text for content enclosed in special markers (code blocks), identifies the programming language of each block, extracts the code, and organizes it by language. It also preserves any regular text that isn't code.
### Inputs
- Text: The source text containing code blocks to be extracted. This could be any text that includes programming code examples, such as AI responses, technical documentation, or tutorial content.
### Outputs
- HTML: Extracted HTML markup code
- CSS: Extracted styling code
- JavaScript: Extracted JavaScript code
- Python: Extracted Python code
- SQL: Extracted database query code
- Java: Extracted Java code
- C++: Extracted C++ code
- C#: Extracted C# code
- JSON: Extracted JSON data structures
- Bash: Extracted command-line scripts
- PHP: Extracted PHP code
- Ruby: Extracted Ruby code
- YAML: Extracted YAML configuration code
- Markdown: Extracted Markdown formatting
- TypeScript: Extracted TypeScript code
- XML: Extracted XML markup
- Remaining Text: Any non-code text that was in the original input
### Possible use cases
1. Processing AI-generated responses that contain multiple code examples to separate the code from explanations
2. Analyzing technical documentation to extract code samples for testing or implementation
3. Processing programming tutorials to separate explanations from actual code examples
4. Organizing mixed content documents into separate code files by language
5. Creating automated documentation systems that need to handle both text and code
6. Extracting code samples from educational materials for creating exercises or tests
The block is particularly useful in scenarios where you need to automatically process documents containing multiple programming languages and want to organize the code by type while preserving the contextual information.

35
docs/content/platform/blocks/update/code_executor.md
View File

@ -1,35 +0,0 @@
## Word Character Count
### What it is
A text analysis tool that helps you count both words and characters in any given text.
### What it does
This block takes a piece of text and calculates two important metrics:
- The total number of words in the text
- The total number of characters in the text
### How it works
The block processes your input text by:
1. Breaking down the text into individual words to count them
2. Counting all characters (including spaces and punctuation)
3. Providing both counts as separate outputs
4. If any errors occur during processing, it will provide an error message
### Inputs
- Text: The text you want to analyze. This can be anything from a single word to multiple paragraphs. You'll enter this in a text field where it asks for "Enter your text here"
### Outputs
- Word Count: The total number of words found in your text
- Character Count: The total number of characters (including spaces and punctuation) in your text
- Error: If something goes wrong during processing, this will contain an explanation of what happened
### Possible use case
A content writer could use this block to:
- Check if their article meets specific word count requirements
- Ensure their social media post stays within character limits
- Quickly analyze the length of multiple text segments
- Verify the length of titles, headlines, or meta descriptions for SEO purposes
For example, a social media manager could paste their tweet draft into this block to ensure it doesn't exceed Twitter's character limit, while simultaneously knowing how many words they've used.

37
docs/content/platform/blocks/update/code_extraction_block.md
View File

@ -1,37 +0,0 @@
## Read CSV
### What it is
A data processing block that reads and parses CSV (Comma-Separated Values) files, converting them into a more usable format.
### What it does
This block takes CSV-formatted text and transforms it into structured data, processing it row by row. It can handle various CSV formats and configurations, making it versatile for different types of CSV files.
### How it works
The block reads a CSV file's contents, splits it into rows and columns based on specified delimiters, and converts each row into a dictionary where column headers (or numbers if no headers exist) become keys and cell contents become values. It can process the file in two ways: outputting data row by row and providing all data at once.
### Inputs
- Contents: The actual text content of the CSV file to be processed
- Delimiter: The character that separates values in your CSV file (default is comma ",")
- Quote Character: The character used to enclose fields that contain special characters (default is double quote """)
- Escape Character: The character used to escape special characters in the CSV (default is backslash "\")
- Has Header: Indicates whether the first row contains column names (default is Yes)
- Skip Rows: Number of rows to skip from the beginning of the file (default is 0)
- Strip: Whether to remove extra whitespace from values (default is Yes)
- Skip Columns: List of column names to exclude from the output (default is none)
### Outputs
- Row: Provides each row of the CSV as a dictionary, where keys are either column headers or column indices
- All Data: Delivers the complete CSV data as a list of dictionaries, where each dictionary represents one row
### Possible use case
A data analyst needs to process a monthly sales report that comes in CSV format. The CSV file contains columns for date, product, quantity, and price. Using this block, they can:
1. Load the CSV file
2. Automatically recognize column headers
3. Process the data row by row for immediate analysis
4. Get a complete dataset for overall reporting
5. Skip unnecessary columns like internal reference numbers
6. Clean up any extra whitespace in the data
The block would be particularly useful when dealing with large CSV files, as it can process data row by row without loading everything into memory at once, and it provides flexibility in handling different CSV formats and structures.

21
docs/content/platform/blocks/update/count_words_and_char_block.md
View File

@ -1,21 +0,0 @@
## Text Decoder
### What it is
A specialized tool that converts text containing special escape characters into regular, readable text.
### What it does
This block takes text that contains special character sequences (like '\n' for new lines or '\"' for quotation marks) and converts them into their actual intended characters. It makes text that was previously formatted for computer processing readable for humans.
### How it works
The block takes the input text and processes it through a decoder that recognizes special character sequences. When it finds these sequences, it replaces them with their actual characters. For example, '\n' becomes an actual line break, and '\"' becomes a regular quotation mark.
### Inputs
- text: The text string that needs to be decoded. This can contain various escaped characters like '\n' for new lines or '\"' for quotation marks. For example, you might input something like "Hello\nWorld!" or "This is a \"quoted\" phrase"
### Outputs
- decoded_text: The final, human-readable text where all special character sequences have been converted to their actual characters. The output will show actual line breaks and proper quotation marks instead of their escaped versions.
### Possible use case
Imagine you're working with text exported from a programming environment or a database, and it contains escaped characters. For example, you might have received a document that looks like this: "Dear Mr. Smith,\nThank you for your \"excellent\" presentation.\nBest regards" The Text Decoder would convert this into properly formatted text with actual line breaks and quotation marks, making it ready for use in documents or display to users.

46
docs/content/platform/blocks/update/csv.md
View File

@ -1,46 +0,0 @@
## Read Discord Messages
### What it is
A block that monitors and captures messages from a Discord channel using a bot token.
### What it does
This block connects to Discord and reads incoming messages from specified channels, including the ability to process text file attachments.
### How it works
The block establishes a connection to Discord using a bot token, listens for new messages in the channels where the bot is present, and captures the message content, channel name, and username of the sender. If a message contains a text file attachment, it will also read and include the file's contents.
### Inputs
- Discord Credentials: A bot token that allows the block to connect to Discord servers
### Outputs
- Message Content: The actual text content of the received message, including any processed text file attachments
- Channel Name: The name of the Discord channel where the message was sent
- Username: The name of the user who sent the message
### Possible use case
A community manager wanting to monitor discussions in a Discord server and automatically collect messages for analysis or archiving. This could be particularly useful for gathering feedback, maintaining records of discussions, or tracking user engagement.
## Send Discord Message
### What it is
A block that sends messages to specific Discord channels using a bot token.
### What it does
This block enables automated message sending to Discord channels, with the ability to handle long messages by automatically splitting them into appropriate sizes.
### How it works
The block connects to Discord using a bot token, locates the specified channel by name, and sends the provided message. If the message is longer than Discord's character limit (2000 characters), it automatically splits the message into smaller chunks and sends them sequentially.
### Inputs
- Discord Credentials: A bot token that allows the block to connect to Discord servers
- Message Content: The text message that should be sent to Discord
- Channel Name: The name of the Discord channel where the message should be sent
### Outputs
- Status: A message indicating whether the operation was successful ("Message sent") or if there was an error
### Possible use case
An automated notification system that needs to send updates or alerts to a Discord community. For example, a project management system could use this block to automatically post status updates, announcements, or notifications about project milestones to a team's Discord channel.

36
docs/content/platform/blocks/update/decoder_block.md
View File

@ -1,36 +0,0 @@
## Send Email
### What it is
A communication block that enables sending emails through an SMTP server, designed to work with various email providers including Gmail.
### What it does
This block allows users to send emails by providing recipient details, email content, and SMTP server credentials. It handles the entire email sending process, from establishing a secure connection to delivering the message.
### How it works
The block establishes a secure connection with the specified SMTP server using provided credentials, constructs the email message with the given subject and body, and sends it to the designated recipient. After sending, it confirms the delivery status or reports any errors that occurred during the process.
### Inputs
- To Email: The recipient's email address where the message will be sent (e.g., recipient@example.com)
- Subject: The title or heading of the email that appears in the recipient's inbox
- Body: The main content of the email message
- Email Credentials:
- SMTP Server: The address of the email server (default: smtp.gmail.com)
- SMTP Port: The connection port number for the email server (default: 25)
- SMTP Username: Your email address or account username (stored securely)
- SMTP Password: Your email account password or app-specific password (stored securely)
### Outputs
- Status: A message indicating whether the email was sent successfully
- Error: Information about what went wrong if the email sending failed
### Possible use case
A company's automated notification system could use this block to:
- Send order confirmations to customers
- Deliver automated reports to team members
- Send password reset links to users
- Distribute newsletter updates to subscribers
- Send alert notifications when specific system events occur
The block is particularly useful in automated workflows where email communication needs to be triggered based on certain events or conditions.

35
docs/content/platform/blocks/update/discord.md
View File

@ -1,35 +0,0 @@
## Google Maps Search
### What it is
A specialized search tool that connects with Google Maps to find and retrieve information about local businesses and places.
### What it does
This block searches for local businesses and places using the Google Maps API, providing detailed information about each location including its name, address, phone number, rating, number of reviews, and website.
### How it works
The block takes a search query and parameters from the user, connects to Google Maps, performs the search within the specified radius, and returns detailed information about each matching place. It can process multiple results and continues searching until it reaches the requested number of results or exhausts all available options.
### Inputs
- Google Maps API Key: Required credentials to access the Google Maps service
- Search Query: The text to search for (e.g., "restaurants in New York")
- Search Radius: The distance (in meters) to search from a central point, with a maximum of 50,000 meters (50 kilometers)
- Maximum Results: The maximum number of places to return, up to 60 results
### Outputs
- Place Information: For each found location, returns:
- Name: The business or place name
- Address: The complete formatted address
- Phone: Contact phone number
- Rating: Average rating (out of 5)
- Reviews: Total number of user reviews
- Website: URL of the business website
- Error: Message explaining what went wrong if the search fails
### Possible use cases
- A restaurant discovery app that helps users find dining options within walking distance
- A real estate application showing nearby amenities around a property
- A tourist guide application helping visitors discover attractions in a new city
- A business analysis tool comparing ratings and reviews of similar businesses in an area
- A local service finder helping users locate specific businesses like mechanics or dentists within their neighborhood

44
docs/content/platform/blocks/update/email_block.md
View File

@ -1,44 +0,0 @@
## Send Web Request
### What it is
A utility block that allows you to send HTTP requests to external web services or APIs.
### What it does
This block enables communication with external web services by sending HTTP requests and handling their responses. It supports various request methods (GET, POST, PUT, etc.) and can handle both JSON and plain text data formats.
### How it works
The block takes your specified parameters (URL, method, headers, etc.), sends a request to the target web service, and processes the response. It automatically handles different types of responses based on the status code received and can work with both JSON and plain text formats.
### Inputs
- URL: The web address where you want to send the request (e.g., "https://api.example.com")
- Method: The type of HTTP request to make (GET, POST, PUT, DELETE, PATCH, OPTIONS, or HEAD)
- Headers: Additional information to send with the request, such as authentication tokens or content type specifications
- JSON Format: A toggle to specify whether the request and response should be treated as JSON data (turned on by default)
- Body: The main content to send with your request (optional)
### Outputs
- Response: The successful response from the server (for status codes 200-299)
- Client Error: Error information when the request fails due to client-side issues (status codes 400-499)
- Server Error: Error information when the request fails due to server-side issues (status codes 500-599)
### Possible use cases
1. Integrating with external APIs:
- Sending data to a payment processing service
- Retrieving weather information from a weather API
- Posting messages to social media platforms
- Updating inventory in an e-commerce system
- Fetching customer data from a CRM system
2. Data exchange:
- Syncing information between different systems
- Submitting form data to a remote server
- Downloading content from web services
- Updating remote databases
- Sending notifications to external services
### Notes
- The block automatically detects and handles JSON formatting, converting between JSON and plain text as needed
- It provides separate outputs for different types of responses, making it easier to handle both successful and error scenarios
- The block is part of the OUTPUT category, indicating its role in external communications

42
docs/content/platform/blocks/update/google_maps.md
View File

@ -1,42 +0,0 @@
## Ideogram Model Block
### What it is
A specialized block that generates and optionally upscales images using the Ideogram AI image generation service.
### What it does
This block creates images from text descriptions using various Ideogram AI models, with options to customize the generation process and enhance the output quality through upscaling.
### How it works
The block takes a text prompt and various customization options, sends this information to the Ideogram AI service, and returns a URL linking to the generated image. If upscaling is requested, it processes the image through an additional enhancement step.
### Inputs
- Credentials: Ideogram API key required for accessing the service
- Prompt: Text description of the image you want to generate
- Image Generation Model: Choice of Ideogram model version (V2, V1, V1 Turbo, V2 Turbo)
- Aspect Ratio: Desired dimensions of the output image (various options from square to wide/tall formats)
- Upscale Image: Option to enhance image quality (AI Upscale or No Upscale)
- Magic Prompt Option: Setting to automatically enhance your text prompt (Auto, On, or Off)
- Seed: Optional number for reproducible image generation
- Style Type: Visual style preference (Auto, General, Realistic, Design, 3D Render, Anime)
- Negative Prompt: Optional text describing elements to exclude from the image
- Color Palette Preset: Predefined color schemes (None, Ember, Fresh, Jungle, Magic, etc.)
### Outputs
- Result: URL of the generated image
- Error: Message explaining any issues that occurred during image generation
### Possible use cases
1. Digital Marketing: Creating unique promotional images for social media campaigns
2. Content Creation: Generating custom illustrations for blog posts or articles
3. Design Prototyping: Quickly visualizing design concepts for client presentations
4. Educational Materials: Creating visual aids for learning materials
5. Product Visualization: Generating product concept images for early-stage development
### Additional Notes
- The block supports various aspect ratios suitable for different platforms and use cases
- Advanced settings allow fine-tuned control over the image generation process
- The upscaling feature can enhance image quality for professional use
- Built-in color palette presets help maintain consistent visual themes
- Seed values enable regenerating the exact same image when needed

39
docs/content/platform/blocks/update/http.md
View File

@ -1,39 +0,0 @@
## Step Through Items
### What it is
A logical processing block that helps you work through lists or collections of items one at a time, like flipping through pages in a book.
### What it does
This block takes a collection of items (which could be a list, dictionary, or text representation of either) and processes them one by one, outputting each item along with its position (key or index) in the sequence.
### How it works
The block accepts your collection of items and then:
1. Checks which input format you've provided (list, dictionary, or text)
2. If you've provided text, it converts it into a proper list or dictionary
3. Goes through each item one by one
4. For each item, it produces two pieces of information: the item itself and its position
5. If working with a dictionary, it focuses on the values rather than the keys
### Inputs
- Items (List): A collection of items in list format, like a shopping list or sequence of numbers
- Items Object (Dictionary): A collection of paired items, like a contact list with names and phone numbers
- Items String (Text): A text version of either a list or dictionary, useful when your data comes from text sources
### Outputs
- Item: The current piece of data being processed from your collection
- Key: The position or identifier of the current item (will be a number for lists, starting from 0)
### Possible use case
Imagine you have a list of customer orders that need to be processed one at a time. This block could help you:
1. Take the list of orders
2. Process each order individually
3. Keep track of which order number you're working on
4. Ensure no orders are missed or processed multiple times
For example, if you had a list of customer names `["Alice", "Bob", "Charlie"]`, the block would output:
- First round: Item="Alice", Key=0
- Second round: Item="Bob", Key=1
- Third round: Item="Charlie", Key=2
This makes it perfect for situations where you need to perform the same action on multiple items in sequence while keeping track of your progress.

150
docs/content/platform/blocks/update/ideogram.md
View File

@ -1,150 +0,0 @@
# Block Documentation
## AI Structured Response Generator
### What it is
A specialized block that generates structured responses from various AI language models in a specific format.
### What it does
Takes a prompt and generates a response that follows a predefined structure or format, ensuring consistency in the output.
### How it works
1. Receives a prompt and formatting requirements
2. Sends the request to the specified AI model
3. Validates the response matches the expected format
4. Retries if the response format is incorrect
5. Returns the properly formatted response
### Inputs
- Prompt: The text instruction to send to the AI model
- Expected Format: Dictionary defining the required structure of the response
- Model: Choice of AI model to use (e.g., GPT-4, Claude, etc.)
- Credentials: API key for accessing the AI service
- System Prompt: Optional context to guide the AI's behavior
- Conversation History: Previous messages for context
- Retry Count: Number of attempts to get a valid response
- Prompt Values: Variables to insert into the prompt
- Max Tokens: Limit on response length
### Outputs
- Response: The structured response from the AI model
- Error: Any error messages if the process fails
### Possible use case
Creating a customer service bot that needs to extract specific information (like order number, issue type, and priority) from customer messages in a consistent format.
## AI Text Generator
### What it is
A block that generates free-form text responses from AI language models.
### What it does
Takes a prompt and returns a natural language response without enforcing any specific structure.
### How it works
1. Receives a prompt and optional context
2. Sends the request to the chosen AI model
3. Returns the generated text response
### Inputs
- Prompt: The text instruction to send to the AI model
- Model: Choice of AI model to use
- Credentials: API key for accessing the AI service
- System Prompt: Optional context to guide the AI's behavior
- Retry Count: Number of retry attempts
- Prompt Values: Variables to insert into the prompt
### Outputs
- Response: The generated text from the AI model
- Error: Any error messages if the process fails
### Possible use case
Creating blog post content or generating creative writing based on given topics or themes.
## AI Text Summarizer
### What it is
A block that creates concise summaries of longer texts using AI.
### What it does
Processes long texts and generates summaries in various styles (concise, detailed, bullet points, or numbered list).
### How it works
1. Breaks long text into manageable chunks
2. Summarizes each chunk
3. Combines the summaries into a final coherent summary
### Inputs
- Text: The long text to be summarized
- Model: Choice of AI model to use
- Focus: Specific topic to emphasize in the summary
- Style: Format of the summary (concise, detailed, etc.)
- Credentials: API key for accessing the AI service
- Max Tokens: Maximum length of the summary
- Chunk Overlap: How much context to maintain between chunks
### Outputs
- Summary: The final summarized text
- Error: Any error messages if the process fails
### Possible use case
Summarizing long research papers or creating executive summaries of lengthy reports.
## AI Conversation
### What it is
A block that manages multi-turn conversations with AI language models.
### What it does
Maintains context through a series of messages between user and AI, generating appropriate responses.
### How it works
1. Maintains a list of previous messages
2. Sends the entire conversation context to the AI
3. Returns the AI's response as the next message
### Inputs
- Messages: List of previous conversation messages
- Model: Choice of AI model to use
- Credentials: API key for accessing the AI service
- Max Tokens: Maximum length of responses
### Outputs
- Response: The AI's reply to the conversation
- Error: Any error messages if the process fails
### Possible use case
Creating an interactive chatbot that can maintain context through a conversation.
## AI List Generator
### What it is
A block that generates lists based on provided criteria or source data.
### What it does
Creates structured lists from either provided source data or generates new lists based on given focus areas.
### How it works
1. Processes the focus or source data
2. Generates a list using AI
3. Validates the list format
4. Returns both the complete list and individual items
### Inputs
- Focus: The topic or theme for the list
- Source Data: Optional data to base the list on
- Model: Choice of AI model to use
- Credentials: API key for accessing the AI service
- Max Retries: Number of attempts to generate a valid list
- Max Tokens: Maximum length of the response
### Outputs
- Generated List: The complete list of items
- List Item: Individual items from the list
- Error: Any error messages if the process fails
### Possible use case
Extracting key points from articles or generating categorized lists of items from unstructured data.

45
docs/content/platform/blocks/update/iteration.md
View File

@ -1,45 +0,0 @@
## Calculator Block
### What it is
A mathematical calculation tool that performs basic arithmetic operations between two numbers.
### What it does
Performs one of five mathematical operations (addition, subtraction, multiplication, division, or power) on two numbers and provides the result. It can also optionally round the result to the nearest whole number.
### How it works
The block takes two numbers and a selected operation, processes them according to the chosen mathematical operation, and returns the result. It includes safety features to handle special cases like division by zero.
### Inputs
- Operation: Choose from Add, Subtract, Multiply, Divide, or Power operations
- First Number (A): The first number in the calculation
- Second Number (B): The second number in the calculation
- Round Result: Option to round the final answer to the nearest whole number
### Outputs
- Result: The numerical outcome of the mathematical operation
### Possible use case
A budgeting application where users need to perform various calculations, such as adding expenses, calculating percentage increases, or dividing costs among multiple people.
## Count Items Block
### What it is
A counting tool that determines the number of items in various types of collections.
### What it does
Counts the total number of elements in a given collection, whether it's a list of items, characters in a text, or key-value pairs in a dictionary.
### How it works
The block analyzes the provided collection and counts its elements. It can handle various types of collections including lists, strings, dictionaries, and other iterable objects. If it encounters an invalid input, it returns -1 to indicate an error.
### Inputs
- Collection: The group of items you want to count (can be a list, dictionary, string, or any other collection of items)
### Outputs
- Count: The total number of items found in the collection
### Possible use case
An inventory management system where users need to quickly count items in different categories, or a text analysis tool that needs to count elements like words in a sentence or items in a shopping cart.

35
docs/content/platform/blocks/update/llm.md
View File

@ -1,35 +0,0 @@
## Publish to Medium
### What it is
A block that enables automated publishing of content to the Medium platform, allowing users to create and manage posts programmatically.
### What it does
This block takes your content and various publishing preferences and automatically posts it to Medium under your account. It can create posts in different states (public, draft, or unlisted) and supports various formatting and customization options.
### How it works
The block connects to your Medium account using your API credentials, takes your content and publishing preferences, and creates a new post on Medium according to your specifications. It handles all the necessary communication with Medium's servers and returns information about the published post.
### Inputs
- Author ID: Your unique Medium author identifier, required to specify where the post should be published
- Title: The headline of your Medium post
- Content: The main body of your post (can be in HTML or Markdown format)
- Content Format: Specifies whether your content is in HTML or Markdown format
- Tags: Up to 5 topic tags to help categorize your post
- Canonical URL: Optional link to the original source if this content was published elsewhere first
- Publish Status: Choose between public (visible to all), draft (private), or unlisted (visible only with direct link)
- License: The type of content license for your post (e.g., all rights reserved, Creative Commons)
- Notify Followers: Option to notify your followers when you publish the post
- Credentials: Your Medium API authentication details
### Outputs
- Post ID: The unique identifier assigned to your published post
- Post URL: The direct web link to your published post
- Published At: The timestamp indicating when the post was published
- Error: Any error message if the post creation fails
### Possible use case
A content marketing team could use this block to automatically publish their blog posts to Medium as part of their content distribution workflow. For example, when a new blog post is approved on their main website, this block could automatically create a copy on Medium with proper attribution (using the canonical URL), helping to reach a wider audience while maintaining SEO benefits.
Additional features like setting posts as drafts first for review, adding relevant tags for better discoverability, and controlling follower notifications make it a versatile tool for content management and distribution strategies.

81
docs/content/platform/blocks/update/maths.md
View File

@ -1,81 +0,0 @@
## Pinecone Initialization Block
### What it is
A block that sets up and initializes a new Pinecone vector database index, or connects to an existing one.
### What it does
Creates a new searchable database index in Pinecone if it doesn't exist, or connects to an existing index with the specified name.
### How it works
The block connects to Pinecone using your API credentials, checks if the requested index exists, and either creates a new one with your specified settings or connects to the existing one.
### Inputs
- Credentials: Your Pinecone API key for authentication
- Index Name: The name you want to give to your database index
- Dimension: The size of the vectors to be stored (default: 768)
- Metric: The method used to measure similarity between vectors (default: cosine)
- Cloud: The cloud provider for the serverless deployment (default: aws)
- Region: The geographical region for data storage (default: us-east-1)
### Outputs
- Index: The name of the initialized Pinecone index
- Message: A status message indicating whether a new index was created or an existing one was connected
### Possible use case
Setting up a new semantic search system where you need to initialize a database to store and search through document embeddings.
## Pinecone Query Block
### What it is
A block that searches through a Pinecone vector database to find similar vectors.
### What it does
Searches the specified Pinecone index using a query vector to find the most similar items in the database.
### How it works
Takes a query vector, searches the Pinecone database for the most similar vectors, and returns both the raw results and a combined text of the matches.
### Inputs
- Credentials: Your Pinecone API key for authentication
- Query Vector: The vector to search for in the database
- Namespace: Optional subdivision of your index (default: empty)
- Top K: Number of results to return (default: 3)
- Include Values: Whether to include vector values in results (default: false)
- Include Metadata: Whether to include metadata in results (default: true)
- Host: Pinecone host address (default: empty)
- Index Name: Name of the Pinecone index to query
### Outputs
- Results: Raw query results including matches and combined text
- Combined Results: A concatenated string of all matched text
### Possible use case
Implementing a semantic search feature where users can find similar documents or text passages based on meaning rather than exact keyword matches.
## Pinecone Insert Block
### What it is
A block that adds new data to a Pinecone vector database.
### What it does
Uploads text chunks and their corresponding vector embeddings to a specified Pinecone index.
### How it works
Takes text chunks and their vector representations, adds unique identifiers and metadata, then uploads them to the specified Pinecone index.
### Inputs
- Credentials: Your Pinecone API key for authentication
- Index: Name of the Pinecone index to upload to
- Chunks: List of text pieces to store
- Embeddings: Vector representations of the text chunks
- Namespace: Optional subdivision of your index (default: empty)
- Metadata: Additional information to store with each vector (default: empty dictionary)
### Outputs
- Upsert Response: Confirmation message of successful upload
### Possible use case
Building a document storage system where you need to continuously add new documents and their vector representations for later similarity search.

53
docs/content/platform/blocks/update/medium.md
View File

@ -1,53 +0,0 @@
## Get Reddit Posts
### What it is
A specialized block designed to fetch posts from a specified subreddit on Reddit.
### What it does
This block retrieves a collection of posts from a designated subreddit, allowing users to filter posts based on time and limit the number of posts retrieved.
### How it works
The block connects to Reddit using provided credentials, navigates to the specified subreddit, and collects posts based on the given parameters. It can filter posts by time and stop when it reaches a specific post ID.
### Inputs
- Subreddit: The name of the subreddit you want to fetch posts from
- Reddit Credentials: Authentication details needed to access Reddit (client ID, client secret, username, password, and user agent)
- Last Minutes: Optional filter to only get posts from the last X minutes
- Last Post: Optional post ID where the fetching should stop
- Post Limit: Optional limit on the number of posts to fetch (defaults to 10)
### Outputs
- Post: A Reddit post object containing:
- ID: Unique identifier of the post
- Subreddit: Name of the subreddit
- Title: Post title
- Body: Post content
### Possible use case
A social media monitoring tool that needs to track recent discussions in specific Reddit communities, such as gathering customer feedback from a company's subreddit.
## Post Reddit Comment
### What it is
A block that enables posting comments on Reddit posts.
### What it does
This block posts a comment on a specified Reddit post using provided credentials and comment content.
### How it works
The block authenticates with Reddit using the provided credentials, locates the specified post using its ID, and posts the given comment content as a reply to that post.
### Inputs
- Reddit Credentials: Authentication details needed to access Reddit (client ID, client secret, username, password, and user agent)
- Comment Data: Contains:
- Post ID: The ID of the post to comment on
- Comment: The text content of the comment
### Outputs
- Comment ID: The unique identifier of the posted comment
### Possible use case
An automated customer service system that responds to user inquiries or feedback posted on Reddit, such as providing automated responses to frequently asked questions in a product's subreddit.

33
docs/content/platform/blocks/update/pinecone.md
View File

@ -1,33 +0,0 @@
## Replicate Flux Advanced Model
### What it is
A sophisticated image generation block that creates custom images based on text descriptions using various Flux AI models (Flux Schnell, Flux Pro, or Flux Pro 1.1) through the Replicate platform.
### What it does
Transforms text descriptions into high-quality images with customizable parameters for fine-tuning the generation process. Users can control various aspects of the image generation, from image quality to aspect ratio and safety settings.
### How it works
The block takes a text prompt and various configuration settings, sends them to the selected Flux AI model on Replicate's platform, and returns a URL containing the generated image. It handles all the technical aspects of image generation while providing users with intuitive controls for customization.
### Inputs
- Credentials: Replicate API key required for accessing the service
- Prompt: Text description of the image you want to generate
- Image Generation Model: Choice between Flux Schnell, Flux Pro, or Flux Pro 1.1 models
- Seed: Optional number for reproducible results
- Steps: Number of refinement steps in the generation process (default: 25)
- Guidance: Balance between prompt adherence and image quality (default: 3)
- Interval: Controls output variance and prompt following (default: 2)
- Aspect Ratio: Image dimensions (options: 1:1, 16:9, 2:3, 3:2, 4:5, 5:4, 9:16)
- Output Format: Image file format (WEBP, JPG, or PNG)
- Output Quality: Image quality setting from 0-100 (default: 80)
- Safety Tolerance: Content safety level from 1 (strict) to 5 (permissive)
### Outputs
- Result: URL link to the generated image
- Error: Error message if something goes wrong during generation
### Possible use case
A marketing team needs custom images for their social media campaign. They can use this block to generate unique, branded visuals by providing detailed text descriptions and adjusting parameters like aspect ratio for different social media platforms. The team can ensure consistency by using the seed parameter and adjust safety settings to maintain brand-appropriate content.

30
docs/content/platform/blocks/update/reddit.md
View File

@ -1,30 +0,0 @@
## RSS Feed Reader
### What it is
A tool that monitors and retrieves content from RSS feeds, which are web feeds that allow users to get updates from websites in a standardized format.
### What it does
This block automatically checks an RSS feed at regular intervals and retrieves new entries that have been published within a specified time period. It can either run once or continuously monitor the feed for new content.
### How it works
The block connects to a specified RSS feed URL and checks for new entries based on their publication date. When it finds entries published within the specified time period, it extracts relevant information such as the title, link, description, publication date, author, and categories. It can be set to either check once or continuously monitor the feed at regular intervals.
### Inputs
- RSS URL: The web address of the RSS feed you want to monitor (e.g., "https://example.com/rss")
- Time Period: The number of minutes in the past to check for new entries (default is 1440 minutes, or 24 hours)
- Polling Rate: How often the block should check for new entries, specified in seconds
- Run Continuously: Whether the block should keep checking for new entries (true) or just check once (false)
### Outputs
- Entry: A structured package of information containing:
- Title: The headline or name of the entry
- Link: The web address where the full content can be found
- Description: A summary or brief description of the content
- Publication Date: When the entry was published
- Author: Who created the content
- Categories: List of topics or tags associated with the entry
### Possible use case
A news aggregation system that needs to monitor multiple news websites for breaking stories. The block could be configured to check each news site's RSS feed every 5 minutes and collect new articles published in the last hour. This could be used to automatically update a news dashboard or send notifications about new content to subscribers.

60
docs/content/platform/blocks/update/replicate_flux_advanced.md
View File

@ -1,60 +0,0 @@
## Data Sampling Block
### What it is
A specialized tool designed to extract representative samples from datasets using various sampling methods.
### What it does
Takes a dataset and creates a smaller subset using one of eight different sampling techniques, ensuring the selected data meets specific criteria or patterns based on the chosen method.
### How it works
The block receives input data and a set of parameters, then applies the specified sampling method to select a subset of the data. It can either process data immediately or accumulate it over time before sampling. The block supports various sampling strategies, from simple random selection to more complex methods like stratified or weighted sampling.
### Inputs
- Data: The source dataset that you want to sample from. Can be structured as a single record or a list of records
- Sample Size: The number of items you want in your final sample
- Sampling Method: Choose from eight different approaches:
- Random: Selects items completely at random
- Systematic: Picks items at regular intervals
- Top: Takes items from the beginning
- Bottom: Takes items from the end
- Stratified: Samples from different groups proportionally
- Weighted: Selects items based on their importance (weight)
- Reservoir: Maintains a running sample as data streams in
- Cluster: Samples entire groups of related items
- Accumulate: Option to collect data over multiple runs before sampling
- Random Seed: Optional number to ensure consistent sampling results
- Stratify Key: Field name used to group data for stratified sampling
- Weight Key: Field name containing importance values for weighted sampling
- Cluster Key: Field name identifying groups for cluster sampling
### Outputs
- Sampled Data: The selected subset of records from your input data
- Sample Indices: The positions of the selected items in the original dataset
### Possible use cases
1. Quality Control: Randomly selecting products from a production line for inspection
2. Market Research: Ensuring survey responses come from different demographic groups using stratified sampling
3. Data Analysis: Creating smaller, representative datasets for testing or analysis
4. Customer Feedback: Selecting customer reviews based on rating weights
5. Geographic Studies: Sampling data by location clusters
6. Stream Processing: Maintaining a representative sample of continuous data feeds
### Tips for Usage
- Choose Random sampling for simple, unbiased selection
- Use Stratified sampling when you need representation from different groups
- Apply Weighted sampling when some items are more important than others
- Select Cluster sampling when items naturally group together
- Enable Accumulate when working with streaming data
- Set a Random Seed when you need reproducible results
### Common Applications
- Social Science Research
- Manufacturing Quality Control
- Customer Survey Analysis
- Scientific Studies
- Big Data Processing
- Machine Learning Dataset Preparation
- Population Studies
- Performance Testing

46
docs/content/platform/blocks/update/rss.md
View File

@ -1,46 +0,0 @@
## Get Wikipedia Summary
### What it is
A tool that retrieves concise summaries of topics from Wikipedia.
### What it does
This block fetches and provides a summary of any given topic using Wikipedia's API, making it easy to get quick information about various subjects.
### How it works
When given a topic, the block connects to Wikipedia's service, searches for the topic, and returns a condensed summary of the information. If the topic cannot be found or there's an error, it will provide an error message instead.
### Inputs
- Topic: The subject you want to learn about. This can be any topic that exists on Wikipedia.
### Outputs
- Summary: A concise explanation of the requested topic from Wikipedia
- Error: A message explaining what went wrong if the summary couldn't be retrieved
### Possible use case
A student working on a research project could use this block to quickly get overview information about different subjects they're studying, helping them understand basic concepts before diving deeper into their research.
## Get Weather Information
### What it is
A weather information retrieval tool that uses the OpenWeatherMap service to provide current weather conditions for any location.
### What it does
This block fetches real-time weather data for a specified location, including temperature, humidity, and current weather conditions.
### How it works
When provided with a location and API credentials, the block connects to OpenWeatherMap's service and retrieves current weather information. It can display temperatures in either Celsius or Fahrenheit based on user preference.
### Inputs
- Location: The name of the place you want weather information for (e.g., "New York", "London", "Tokyo")
- Use Celsius: A yes/no option to choose between Celsius (true) or Fahrenheit (false) for temperature display
- Credentials: OpenWeatherMap API authentication details (handled automatically by the system)
### Outputs
- Temperature: The current temperature in the specified location (in either Celsius or Fahrenheit)
- Humidity: The current humidity percentage in the specified location
- Condition: A description of the current weather conditions (e.g., "sunny", "overcast clouds", "light rain")
- Error: A message explaining what went wrong if the weather information couldn't be retrieved
### Possible use case
A travel planning application could use this block to show users the current weather conditions at their destination, helping them pack appropriate clothing and plan suitable activities.

42
docs/content/platform/blocks/update/sampling.md
View File

@ -1,42 +0,0 @@
## Create Talking Avatar Video
### What it is
A specialized block that creates personalized video content featuring an AI-powered talking avatar using the D-ID platform.
### What it does
This block transforms text input into a video featuring a digital presenter who speaks the provided script. It can create videos with different voices, presenters, and formatting options, with the ability to include subtitles if desired.
### How it works
The block takes your input text and configuration options, sends them to the D-ID service, and monitors the video creation process. Once the video is ready, it provides you with a URL where you can access the finished video.
### Inputs
- Credentials: D-ID API key required for accessing the service
- Script Input: The text that the avatar will speak in the video
- Voice Provider: Choice of voice service (Microsoft, ElevenLabs, or Amazon)
- Voice ID: Specific voice identifier for the chosen provider
- Presenter ID: The digital avatar that will appear in the video
- Driver ID: Controls how the avatar animates
- Result Format: Output format of the video (MP4, GIF, or WAV)
- Crop Type: Video frame format (wide, square, or vertical)
- Subtitles: Option to include subtitles in the video
- SSML: Option to use Speech Synthesis Markup Language for more control over speech
- Max Polling Attempts: Number of times to check if the video is ready
- Polling Interval: Time to wait between checking video status
### Outputs
- Video URL: Web address where the completed video can be accessed
- Error: Message explaining what went wrong if the video creation fails
### Possible use case
A marketing team wants to create personalized welcome videos for new customers. They could use this block to generate videos where a digital presenter greets each customer by name and explains the company's key features. The team could select a professional-looking avatar, choose an appropriate voice, and even include subtitles for accessibility.
For example:
1. Input a script: "Welcome, [Customer Name]! We're excited to have you join us..."
2. Select a professional presenter avatar
3. Choose a natural-sounding voice
4. Enable subtitles for accessibility
5. Get back a video URL that can be sent to the customer
This creates a scalable way to deliver personalized video content without needing to record individual videos for each customer.

95
docs/content/platform/blocks/update/search.md
View File

@ -1,95 +0,0 @@
## Match Text Pattern
### What it is
A tool that checks if a specific pattern exists within a text and routes data accordingly.
### What it does
Searches through text to find matches for a specific pattern and directs the output to different paths depending on whether a match is found or not.
### How it works
The block takes input text and a pattern to search for, then examines the text to see if the pattern exists. If it finds a match, it sends the data through the "positive" path; if not, it sends it through the "negative" path.
### Inputs
- Text: The text content to be searched
- Match: The pattern (in regular expression format) to search for
- Data: Information that will be passed to the output
- Case Sensitive: Whether the search should consider upper/lowercase differences (default: yes)
- Dot All: Whether the dot character should match all characters including newlines (default: yes)
### Outputs
- Positive: Data that is output when a pattern match is found
- Negative: Data that is output when no pattern match is found
### Possible use case
Filtering customer feedback messages to route complaints (containing words like "unhappy" or "disappointed") to the customer service team, and positive feedback to the marketing team.
## Extract Text Information
### What it is
A tool that pulls out specific pieces of information from text based on patterns.
### What it does
Searches through text to find and extract specific portions that match a given pattern.
### How it works
The block searches for text matching a specified pattern and extracts either the entire match or a specific part of it. It can find either the first match or all matches, depending on the settings.
### Inputs
- Text: The text to extract information from
- Pattern: The pattern (in regular expression format) to use for extraction
- Group: Which portion of the match to extract (default: 0 for entire match)
- Case Sensitive: Whether to consider upper/lowercase differences (default: yes)
- Dot All: Whether the dot character should match all characters including newlines (default: yes)
- Find All: Whether to find all matches or just the first one (default: no)
### Outputs
- Positive: The extracted text when matches are found
- Negative: The original text when no matches are found
### Possible use case
Extracting email addresses or phone numbers from a document or extracting product codes from customer messages.
## Fill Text Template
### What it is
A tool that creates customized text by filling in a template with specific values.
### What it does
Takes a template and a set of values, then creates a final text by replacing placeholders in the template with the actual values.
### How it works
The block uses a template with special markers ({{placeholder}}) and replaces these markers with corresponding values from a provided dictionary.
### Inputs
- Values: A dictionary of names and values to be used in the template
- Format: The template text with placeholders for the values
### Outputs
- Output: The final text with all placeholders replaced with their corresponding values
### Possible use case
Creating personalized email messages by filling in customer names, order numbers, and other specific details in a standard template.
## Combine Texts
### What it is
A tool that joins multiple pieces of text into a single text.
### What it does
Takes a list of separate text pieces and combines them into one unified text, optionally placing a delimiter between each piece.
### How it works
The block takes multiple text inputs and joins them together, with an optional separator between each piece of text.
### Inputs
- Input: A list of text pieces to be combined
- Delimiter: The text to insert between each piece (default: nothing)
### Outputs
- Output: The final combined text
### Possible use case
Combining separate paragraphs into a single document, or joining pieces of an address with appropriate spacing or punctuation.

36
docs/content/platform/blocks/update/talking_head.md
View File

@ -1,36 +0,0 @@
## Unreal Text to Speech
### What it is
A specialized block that converts written text into natural-sounding speech using the Unreal Speech API technology.
### What it does
This block takes written text and transforms it into spoken audio, creating an MP3 file that can be accessed via a URL. It uses advanced AI voice technology to generate human-like speech with customizable voice options.
### How it works
The block processes your input text and selected voice preference, sends this information to the Unreal Speech API service, and returns a link to an MP3 audio file containing the generated speech. The process happens in real-time, and the resulting audio file can be easily accessed through the provided URL.
### Inputs
- Text: The written content you want to convert into speech. This can be any text content, from single sentences to longer paragraphs.
- Voice ID: The specific voice you want to use for the speech generation. By default, it uses a voice called "Scarlett," but other voices can be selected.
- Credentials: Your Unreal Speech API authentication details. This is required to access the service and is managed through an API key system.
### Outputs
- MP3 URL: A web link to the generated audio file in MP3 format. This file contains your text converted to speech and can be played or downloaded.
- Error: If something goes wrong during the process, this will contain a message explaining what happened. This helps users understand and troubleshoot any issues that might occur.
### Possible use cases
- Creating audio versions of written content for accessibility purposes
- Developing automated voice responses for customer service systems
- Generating voiceovers for educational content or presentations
- Creating audio versions of articles or blog posts for podcast-style consumption
- Building interactive voice applications or voice-enabled features in applications
- Creating audio books from digital text
- Developing learning materials for language education
### Notes
- The block is categorized under both AI and Text processing capabilities
- The speech generation includes options for voice customization
- The service requires valid API credentials to function
- The generated audio is delivered in high-quality MP3 format (192k bitrate)

89
docs/content/platform/blocks/update/text.md
View File

@ -1,89 +0,0 @@
## Get Current Time
### What it is
A block that provides the current time in a customizable format.
### What it does
Outputs the current time when triggered, allowing users to specify their preferred time format.
### How it works
When triggered, the block captures the current system time and formats it according to the user's specifications. If no format is specified, it uses the default format of hours:minutes:seconds.
### Inputs
- Trigger: Any input that activates the block to output the current time
- Format: Optional formatting pattern for the time output (default: HH:MM:SS)
### Outputs
- Time: The current time formatted according to the specified pattern
### Possible use case
Creating a digital clock display for a dashboard or logging timestamps in a specific format for event tracking.
## Get Current Date
### What it is
A block that provides the current date with optional day offsetting capabilities.
### What it does
Outputs the current date and allows users to offset it by a specified number of days (forward or backward) with customizable formatting.
### How it works
The block takes the current date, applies any specified day offset, and formats the result according to the user's preferences. If no format is specified, it uses the standard YYYY-MM-DD format.
### Inputs
- Trigger: Any input that activates the block to output the date
- Days Offset: Number of days to adjust the date forward or backward (default: 0)
- Format: Optional formatting pattern for the date output (default: YYYY-MM-DD)
### Outputs
- Date: The calculated date in the specified format
### Possible use case
Scheduling applications, deadline calculations, or generating dates for report generation with consistent formatting.
## Get Current Date and Time
### What it is
A block that combines both date and time information into a single output.
### What it does
Provides a complete timestamp containing both the current date and time in a customizable format.
### How it works
Captures the current system date and time and combines them into a single formatted string according to the user's specifications.
### Inputs
- Trigger: Any input that activates the block to output the timestamp
- Format: Optional formatting pattern for the combined date and time (default: YYYY-MM-DD HH:MM:SS)
### Outputs
- Date Time: The current timestamp in the specified format
### Possible use case
Creating log entries, generating timestamps for database records, or displaying a complete datetime stamp on user interfaces.
## Countdown Timer
### What it is
A block that creates a customizable countdown timer with multiple time unit inputs.
### What it does
Waits for a specified duration and then outputs a message when the time has elapsed.
### How it works
Combines the input time units (days, hours, minutes, and seconds) into a total duration, waits for that duration to pass, and then outputs the specified message.
### Inputs
- Input Message: The message to display when the timer completes (default: "timer finished")
- Seconds: Number of seconds to wait (default: 0)
- Minutes: Number of minutes to wait (default: 0)
- Hours: Number of hours to wait (default: 0)
- Days: Number of days to wait (default: 0)
### Outputs
- Output Message: The specified message that is output when the timer completes
### Possible use case
Creating delayed notifications, scheduling automated tasks, or implementing cooldown periods in applications.

41
docs/content/platform/blocks/update/text_to_speech_block.md
View File

@ -1,41 +0,0 @@
## YouTube Video Transcriber
### What it is
A specialized tool that converts the spoken content of YouTube videos into written text.
### What it does
This block takes a YouTube video URL and creates a text transcript of all spoken content in the video. It automatically detects the video's available subtitles or closed captions and converts them into readable text format.
### How it works
The block operates in three main steps:
1. It takes the YouTube URL and extracts the unique video ID
2. It searches for available transcripts/subtitles for the video
3. It converts the found transcript into a clean, readable text format
### Inputs
- YouTube URL: The web address of the YouTube video you want to transcribe. This can be in various formats, including:
- Standard watch URLs (https://www.youtube.com/watch?v=...)
- Short URLs (https://youtu.be/...)
- Embed URLs (https://www.youtube.com/embed/...)
### Outputs
- Video ID: The unique identifier of the YouTube video that was processed
- Transcript: The complete text transcription of the video's spoken content, formatted as readable text
- Error: A message explaining what went wrong if the transcription process fails
### Possible use cases
- Creating written content from video lectures or educational content
- Making YouTube content accessible to deaf or hard-of-hearing viewers
- Extracting quotes or information from video interviews
- Creating searchable archives of video content
- Generating subtitles for content localization
- Research and analysis of video content
- Content repurposing (turning video content into blog posts or articles)
### Notes
- The block will automatically detect the available language for transcription
- If no transcript is available for the video, it will return an error message
- The output transcript is formatted as plain text with appropriate line breaks
- The block can handle various YouTube URL formats, making it flexible for different input styles