Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(blocks) Update all the block docs #9249

Draft
wants to merge 197 commits into
base: dev
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
197 commits
Select commit Hold shift + click to select a range
c16d2f9
Update block docs for: __init__.md
Bentlybro Jan 10, 2025
7b004f0
Update block docs for: agent.md
Bentlybro Jan 10, 2025
5f4a411
Update block docs for: ai_image_generator_block.md
Bentlybro Jan 10, 2025
610b613
Update block docs for: ai_music_generator.md
Bentlybro Jan 10, 2025
706bf05
Update block docs for: block.md
Bentlybro Jan 10, 2025
e9a198f
Update block docs for: code_executor.md
Bentlybro Jan 10, 2025
3c3c1ce
Update block docs for: code_extraction_block.md
Bentlybro Jan 10, 2025
c73da1f
Update block docs for: count_words_and_char_block.md
Bentlybro Jan 10, 2025
8bf9779
Update block docs for: pinecone.md
Bentlybro Jan 10, 2025
8baabb0
remove files
Bentlybro Jan 10, 2025
b10a275
Update block docs for: __init__.md
Bentlybro Jan 10, 2025
c4d38e4
Update block docs for: agent.md
Bentlybro Jan 10, 2025
41c8504
Update block docs for: ai_image_generator_block.md
Bentlybro Jan 10, 2025
c0409ba
Update block docs for: ai_music_generator.md
Bentlybro Jan 10, 2025
0d47b0c
Update block docs for: ai_shortform_video_block.md
Bentlybro Jan 10, 2025
b92223c
Update block docs for: basic.md
Bentlybro Jan 10, 2025
c77f32b
Update block docs for: block.md
Bentlybro Jan 10, 2025
b2d5b9e
Update block docs for: branching.md
Bentlybro Jan 10, 2025
beeadd1
Update block docs for: code_executor.md
Bentlybro Jan 10, 2025
a43b329
Update block docs for: code_extraction_block.md
Bentlybro Jan 10, 2025
0cc625c
Update block docs for: count_words_and_char_block.md
Bentlybro Jan 10, 2025
a0ad796
Update block docs for: csv.md
Bentlybro Jan 10, 2025
100ab90
Update block docs for: decoder_block.md
Bentlybro Jan 10, 2025
ace5d34
Update block docs for: discord.md
Bentlybro Jan 10, 2025
79f3888
Update block docs for: email_block.md
Bentlybro Jan 10, 2025
3c8cf8b
Update block docs for: google_maps.md
Bentlybro Jan 10, 2025
e6254f0
Update block docs for: http.md
Bentlybro Jan 10, 2025
ba9c91d
Update block docs for: ideogram.md
Bentlybro Jan 10, 2025
f125bb6
Update block docs for: iteration.md
Bentlybro Jan 10, 2025
58c1e05
Update block docs for: llm.md
Bentlybro Jan 10, 2025
e9982ba
Update block docs for: maths.md
Bentlybro Jan 10, 2025
d6b1cf6
Update block docs for: medium.md
Bentlybro Jan 10, 2025
a24c869
Update block docs for: pinecone.md
Bentlybro Jan 10, 2025
ab33d07
Update block docs for: reddit.md
Bentlybro Jan 10, 2025
ed2e5e8
Update block docs for: replicate_flux_advanced.md
Bentlybro Jan 10, 2025
f45b4cc
Update block docs for: rss.md
Bentlybro Jan 10, 2025
cc41b2f
Update block docs for: sampling.md
Bentlybro Jan 10, 2025
b1f5413
Update block docs for: search.md
Bentlybro Jan 10, 2025
8f74e58
Update block docs for: talking_head.md
Bentlybro Jan 10, 2025
9813012
Update block docs for: text.md
Bentlybro Jan 10, 2025
0369132
Update block docs for: text_to_speech_block.md
Bentlybro Jan 10, 2025
d56931f
rm files
Bentlybro Jan 10, 2025
a393f8b
Update block docs for: code_executor.md
Bentlybro Jan 12, 2025
a40bb6f
rm file
Bentlybro Jan 12, 2025
d4e5a48
Update block docs for: code_execution_block.md
Bentlybro Jan 12, 2025
99779f5
Update block docs for:
Bentlybro Jan 12, 2025
d6f5dcd
Update block docs for: agent.md
Bentlybro Jan 12, 2025
b6c946a
Update block docs for: ai_image_generator_block.md
Bentlybro Jan 12, 2025
d19866b
Update block docs for: ai_music_generator.md
Bentlybro Jan 12, 2025
49490e8
Update block docs for: ai_shortform_video_block.md
Bentlybro Jan 12, 2025
9518ff4
Update block docs for: basic.md
Bentlybro Jan 12, 2025
61bfbee
Update block docs for: block_installation.md
Bentlybro Jan 12, 2025
6b82b9e
Update block docs for: condition_block.md
Bentlybro Jan 12, 2025
cc9ff9e
Update block docs for: code_executor.md
Bentlybro Jan 12, 2025
7791281
Update block docs for: code_extraction_block.md
Bentlybro Jan 12, 2025
e93c7dc
Update block docs for: word_character_count_block.md
Bentlybro Jan 12, 2025
8889d02
Update block docs for: read_csv.md
Bentlybro Jan 12, 2025
852af17
Update block docs for: text_decoder.md
Bentlybro Jan 12, 2025
d54c9d4
Update block docs for: discord.md
Bentlybro Jan 12, 2025
755a7b6
Update block docs for: email_block.md
Bentlybro Jan 12, 2025
04f0f64
Update block docs for: google_maps.md
Bentlybro Jan 12, 2025
e33263c
Update block docs for: http.md
Bentlybro Jan 12, 2025
ce3c86c
Update block docs for: ideogram.md
Bentlybro Jan 12, 2025
9e36144
Update block docs for: step_through_items.md
Bentlybro Jan 12, 2025
0599083
Update block docs for: llm.md
Bentlybro Jan 12, 2025
b7cc838
Update block docs for: maths.md
Bentlybro Jan 12, 2025
4017c5b
Update block docs for: medium.md
Bentlybro Jan 12, 2025
0d5ab20
Update block docs for: pinecone.md
Bentlybro Jan 12, 2025
f1f6f87
Update block docs for: reddit.md
Bentlybro Jan 12, 2025
db3d86b
Update block docs for: replicate_flux_advanced.md
Bentlybro Jan 12, 2025
ebbb7b0
Update block docs for: rss.md
Bentlybro Jan 12, 2025
4cb0bbe
Update block docs for: sampling.md
Bentlybro Jan 12, 2025
d1b51ad
Update block docs for: search.md
Bentlybro Jan 12, 2025
940fef0
Update block docs for: talking_avatar_video.md
Bentlybro Jan 12, 2025
bf91cc5
Update block docs for: text.md
Bentlybro Jan 12, 2025
154f0a2
Update block docs for: unreal_text_to_speech.md
Bentlybro Jan 12, 2025
757381c
Update block docs for: time_blocks.md
Bentlybro Jan 12, 2025
13be1a0
Update block docs for: youtube.md
Bentlybro Jan 12, 2025
40961cb
rm
Bentlybro Jan 12, 2025
cc75eea
Update block docs for: agent.md
Bentlybro Jan 12, 2025
d3cb3c7
Update block docs for: ai_image_generator_block.md
Bentlybro Jan 12, 2025
e3e4bc8
Update block docs for: ai_music_generator.md
Bentlybro Jan 12, 2025
2f7ad76
Update block docs for: ai_shortform_video_block.md
Bentlybro Jan 12, 2025
f57f6fc
Update block docs for: basic.md
Bentlybro Jan 12, 2025
88b0356
Update block docs for: block_installation.md
Bentlybro Jan 12, 2025
a395538
Update block docs for: condition_block.md
Bentlybro Jan 12, 2025
dc777ce
Update block docs for: code_executor.md
Bentlybro Jan 12, 2025
bb646e8
Update block docs for: code_extraction_block.md
Bentlybro Jan 12, 2025
25bab0e
Update block docs for: word_character_count_block.md
Bentlybro Jan 12, 2025
a08a7bd
Update block docs for: read_csv.md
Bentlybro Jan 12, 2025
01c0284
Update block docs for: text_decoder.md
Bentlybro Jan 12, 2025
ba64e05
Update block docs for: discord.md
Bentlybro Jan 12, 2025
bc64349
Update block docs for: email_block.md
Bentlybro Jan 12, 2025
a4bd7c9
Update block docs for: google_maps.md
Bentlybro Jan 12, 2025
f6b00f0
rm
Bentlybro Jan 12, 2025
91b88b8
Update block docs for: ai_image_generator_block.md
Bentlybro Jan 13, 2025
fba186e
Update block docs for: ai_music_generator.md
Bentlybro Jan 13, 2025
f6a1282
Update block docs for: ai_shortform_video_block.md
Bentlybro Jan 13, 2025
fb10bac
Update block docs for: basic.md
Bentlybro Jan 13, 2025
fbd1e26
Update block docs for: 45e78db5-03e9-447f-9395-308d712f5f08.md
Bentlybro Jan 13, 2025
1764cf9
Update block docs for: branching.md
Bentlybro Jan 13, 2025
dac7e4a
Update block docs for: code_executor.md
Bentlybro Jan 13, 2025
015e7d2
Update block docs for: code_extraction_block.md
Bentlybro Jan 13, 2025
146bf8e
Update block docs for: count_words_and_char_block.md
Bentlybro Jan 13, 2025
d83984b
Update block docs for: csv.md
Bentlybro Jan 13, 2025
d2d6346
Update block docs for: decoder_block.md
Bentlybro Jan 13, 2025
be4b2b1
Update block docs for: discord.md
Bentlybro Jan 13, 2025
6d09a46
Update block docs for: email_block.md
Bentlybro Jan 13, 2025
6aeec36
Update block docs for: google_maps.md
Bentlybro Jan 13, 2025
8804417
Update block docs for: http.md
Bentlybro Jan 13, 2025
a1607a3
Update block docs for: ideogram.md
Bentlybro Jan 13, 2025
36360b3
Update block docs for: iteration.md
Bentlybro Jan 13, 2025
e54a999
Update block docs for: llm.md
Bentlybro Jan 13, 2025
cca71f9
Update block docs for: maths.md
Bentlybro Jan 13, 2025
6f8f7ac
Update block docs for: medium.md
Bentlybro Jan 13, 2025
bd237c5
Update block docs for: pinecone.md
Bentlybro Jan 13, 2025
80de45c
Update block docs for: reddit.md
Bentlybro Jan 13, 2025
0e17f57
Update block docs for: replicate_flux_advanced.md
Bentlybro Jan 13, 2025
1081b15
Update block docs for: rss.md
Bentlybro Jan 13, 2025
388003f
Update block docs for: sampling.md
Bentlybro Jan 13, 2025
192ff65
Update block docs for: search.md
Bentlybro Jan 13, 2025
0da1461
Update block docs for: talking_head.md
Bentlybro Jan 13, 2025
64e59c5
Update block docs for: text.md
Bentlybro Jan 13, 2025
a8cde7c
Update block docs for: text_to_speech_block.md
Bentlybro Jan 13, 2025
7e2e884
Update block docs for: time_blocks.md
Bentlybro Jan 13, 2025
056c539
Update block docs for: youtube.md
Bentlybro Jan 13, 2025
4ebc34d
Update block docs for: compass/triggers.md
Bentlybro Jan 13, 2025
d8e38b5
Update block docs for: exa/contents.md
Bentlybro Jan 13, 2025
abfbdd0
Update block docs for: exa/helpers.md
Bentlybro Jan 13, 2025
223e3de
Update block docs for: exa/search.md
Bentlybro Jan 13, 2025
b73cb9f
Update block docs for: exa/similar.md
Bentlybro Jan 13, 2025
a113fdb
Update block docs for: fal/ai_video_generator.md
Bentlybro Jan 13, 2025
780c893
Update block docs for: github/issues.md
Bentlybro Jan 13, 2025
34954d8
Update block docs for: github/pull_requests.md
Bentlybro Jan 13, 2025
d4679bb
Update block docs for: github/repo.md
Bentlybro Jan 13, 2025
b892c2b
Update block docs for: github/triggers.md
Bentlybro Jan 13, 2025
cfb92dd
Update block docs for: google/gmail.md
Bentlybro Jan 13, 2025
ed9d0b8
Update block docs for: google/sheets.md
Bentlybro Jan 13, 2025
c577758
Update block docs for: helpers/http.md
Bentlybro Jan 13, 2025
5cf97dd
Update block docs for: hubspot/company.md
Bentlybro Jan 13, 2025
43ca817
Update block docs for: hubspot/contact.md
Bentlybro Jan 13, 2025
2c9baa6
Update block docs for: hubspot/engagement.md
Bentlybro Jan 13, 2025
14ef675
Update block docs for: jina/chunking.md
Bentlybro Jan 13, 2025
d133b47
Update block docs for: jina/embeddings.md
Bentlybro Jan 13, 2025
7d4775e
Update block docs for: jina/fact_checker.md
Bentlybro Jan 13, 2025
a2b3473
Update block docs for: jina/search.md
Bentlybro Jan 13, 2025
d36ac14
Update block docs for: nvidia/deepfake.md
Bentlybro Jan 13, 2025
6c62a6a
Update block docs for: slant3d/base.md
Bentlybro Jan 13, 2025
240ad75
rm files
Bentlybro Jan 13, 2025
6a4a8f5
Update block docs for: ai_music_generator.md
Bentlybro Jan 13, 2025
58a8b0d
Update block docs for: basic.md
Bentlybro Jan 13, 2025
abf05d6
Update block docs for: branching.md
Bentlybro Jan 13, 2025
94f4702
Update block docs for: code_executor.md
Bentlybro Jan 13, 2025
2012213
Update block docs for: csv.md
Bentlybro Jan 13, 2025
f02e2fd
Update block docs for: discord.md
Bentlybro Jan 13, 2025
ff494be
Update block docs for: google_maps.md
Bentlybro Jan 13, 2025
134163a
Update block docs for: http.md
Bentlybro Jan 13, 2025
5ea176e
Update block docs for: ideogram.md
Bentlybro Jan 13, 2025
88dc0bb
Update block docs for: iteration.md
Bentlybro Jan 13, 2025
c463d10
Update block docs for: llm.md
Bentlybro Jan 13, 2025
66f2e2a
Update block docs for: maths.md
Bentlybro Jan 13, 2025
69ae276
Update block docs for: medium.md
Bentlybro Jan 13, 2025
504a0a1
Update block docs for: pinecone.md
Bentlybro Jan 13, 2025
c2aad7d
Update block docs for: reddit.md
Bentlybro Jan 13, 2025
67991f7
Update block docs for: replicate_flux_advanced.md
Bentlybro Jan 13, 2025
ad1bf2f
Update block docs for: rss.md
Bentlybro Jan 13, 2025
9572415
Update block docs for: sampling.md
Bentlybro Jan 13, 2025
2b192a0
Update block docs for: search.md
Bentlybro Jan 13, 2025
df071ca
Update block docs for: talking_head.md
Bentlybro Jan 13, 2025
aef7b5d
Update block docs for: text.md
Bentlybro Jan 13, 2025
d3f5718
Update block docs for: time_blocks.md
Bentlybro Jan 13, 2025
6dc88e3
Update block docs for: youtube.md
Bentlybro Jan 13, 2025
791ab5d
Update block docs for: compass/triggers.md
Bentlybro Jan 13, 2025
dfc024a
Update block docs for: exa/contents.md
Bentlybro Jan 13, 2025
185d103
Update block docs for: exa/search.md
Bentlybro Jan 13, 2025
8fc00df
Update block docs for: exa/similar.md
Bentlybro Jan 13, 2025
20e93f3
Update block docs for: fal/ai_video_generator.md
Bentlybro Jan 13, 2025
1c1dda5
Update block docs for: github/issues.md
Bentlybro Jan 13, 2025
0b0c810
Update block docs for: github/pull_requests.md
Bentlybro Jan 13, 2025
7c719d6
Update block docs for: github/repo.md
Bentlybro Jan 13, 2025
3c23fd5
Update block docs for: github/triggers.md
Bentlybro Jan 13, 2025
00b163b
Update block docs for: google/gmail.md
Bentlybro Jan 13, 2025
00add57
Update block docs for: google/sheets.md
Bentlybro Jan 13, 2025
2352c50
Update block docs for: helpers/http.md
Bentlybro Jan 13, 2025
f156338
Update block docs for: hubspot/company.md
Bentlybro Jan 13, 2025
3831aa9
Update block docs for: hubspot/contact.md
Bentlybro Jan 13, 2025
09e1a40
Update block docs for: hubspot/engagement.md
Bentlybro Jan 13, 2025
2011322
Update block docs for: jina/chunking.md
Bentlybro Jan 13, 2025
73d032a
Update block docs for: jina/embeddings.md
Bentlybro Jan 13, 2025
4207dc2
Update block docs for: jina/fact_checker.md
Bentlybro Jan 13, 2025
fa56b68
Update block docs for: jina/search.md
Bentlybro Jan 13, 2025
6166e31
Update block docs for: nvidia/deepfake.md
Bentlybro Jan 13, 2025
805a988
Update block docs for: slant3d/base.md
Bentlybro Jan 13, 2025
2f97724
Update block docs for: slant3d/filament.md
Bentlybro Jan 13, 2025
097348e
Update block docs for: slant3d/order.md
Bentlybro Jan 13, 2025
c869fd0
Update block docs for: slant3d/slicing.md
Bentlybro Jan 13, 2025
7cfc0a0
update blocks.md
Bentlybro Jan 13, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 34 additions & 12 deletions docs/content/platform/blocks/blocks.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,16 @@ Below is a comprehensive list of all available blocks, categorized by their prim
## Basic Operations
| Block Name | Description |
|------------|-------------|
| [Store Value](basic.md#store-value) | Stores and forwards a value |
| [Print to Console](basic.md#print-to-console) | Outputs text to the console for debugging |
| [Find in Dictionary](basic.md#find-in-dictionary) | Looks up a value in a dictionary or list |
| [Agent Input](basic.md#agent-input) | Accepts user input in a workflow |
| [Agent Output](basic.md#agent-output) | Records and formats workflow results |
| [Add to Dictionary](basic.md#add-to-dictionary) | Adds a new key-value pair to a dictionary |
| [Add to List](basic.md#add-to-list) | Adds a new entry to a list |
| [Note](basic.md#note) | Displays a sticky note in the workflow |
| [Store Value](update/basic.md#store-value) | Stores and forwards a value |
| [Print to Console](update/basic.md#print-to-console) | Outputs text to the console for debugging |
| [Find in Dictionary](update/basic.md#find-in-dictionary) | Looks up a value in a dictionary or list |
| [Agent Input](update/basic.md#agent-input) | Accepts user input in a workflow |
| [Agent Output](update/basic.md#agent-output) | Records and formats workflow results |
| [Add to Dictionary](update/basic.md#add-to-dictionary) | Adds a new key-value pair to a dictionary |
| [Add to List](update/basic.md#add-to-list) | Adds a new entry to a list |
| [Note](update/basic.md#note) | Displays a sticky note in the workflow |
| [Create Dictionary](update/basic.md#create-dictionary) | Creates a new dictionary with specified key-value pairs |
| [Create List](update/basic.md#create-list) | Creates a new list with specified values |

## Data Processing
| Block Name | Description |
Expand All @@ -39,11 +41,13 @@ Below is a comprehensive list of all available blocks, categorized by their prim
| [AI Text Summarizer](llm.md#ai-text-summarizer) | Summarizes long texts using LLMs |
| [AI Conversation](llm.md#ai-conversation) | Facilitates multi-turn conversations with LLMs |
| [AI List Generator](llm.md#ai-list-generator) | Creates lists based on prompts using LLMs |
| [AI Music Generator](update/ai_music_generator.md#ai-music-generator) | Creates unique music using AI based on text descriptions |

## Web and API Interactions
| Block Name | Description |
|------------|-------------|
| [Send Web Request](http.md#send-web-request) | Makes HTTP requests to specified web addresses |
| [Send Web Request](update/http.md#web-request-sender) | Makes HTTP requests to specified web addresses |
| [HTTP Request Handler](update/helpers/http.md#http-request-handler) | Simplifies making HTTP GET requests to web services |
| [Read RSS Feed](rss.md#read-rss-feed) | Retrieves and processes entries from RSS feeds |
| [Get Weather Information](search.md#get-weather-information) | Fetches current weather data for a location |
| [Google Maps Search](google_maps.md#google-maps-search) | Searches for local businesses using Google Maps API |
Expand Down Expand Up @@ -81,19 +85,37 @@ Below is a comprehensive list of all available blocks, categorized by their prim
## Media Generation
| Block Name | Description |
|------------|-------------|
| [Ideogram Model](ideogram.md#ideogram-model) | Generates images based on text prompts |
| [Ideogram Model](update/ideogram.md#ideogram-model) | Generates images based on text prompts |
| [Create Talking Avatar Video](talking_head.md#create-talking-avatar-video) | Creates videos with talking avatars |
| [Unreal Text to Speech](text_to_speech_block.md#unreal-text-to-speech) | Converts text to speech using Unreal Speech API |
| [AI Shortform Video Creator](ai_shortform_video_block.md#ai-shortform-video-creator) | Generates short-form videos using AI |
| [Replicate Flux Advanced Model](replicate_flux_advanced.md#replicate-flux-advanced-model) | Creates images using Replicate's Flux models |
| [AI Music Generator](update/ai_music_generator.md#ai-music-generator) | Creates unique music using AI based on text descriptions |

## Miscellaneous
| Block Name | Description |
|------------|-------------|
| [Transcribe YouTube Video](youtube.md#transcribe-youtube-video) | Transcribes audio from YouTube videos |
| [Send Email](email_block.md#send-email) | Sends emails using SMTP |
| [Condition Block](branching.md#condition-block) | Evaluates conditions for workflow branching |
| [Step Through Items](iteration.md#step-through-items) | Iterates through lists or dictionaries |
| [Condition Block](update/branching.md#condition-block) | Evaluates conditions for workflow branching |
| [Step Through Items](update/iteration.md#step-through-items) | Iterates through lists or dictionaries |

## HubSpot Integration
| Block Name | Description |
|------------|-------------|
| [HubSpot Company Manager](update/hubspot/company.md#hubspot-company-manager) | Manages company records in HubSpot CRM |
| [HubSpot Contact Manager](update/hubspot/contact.md#hubspot-contact-manager) | Manages contact information in HubSpot CRM |
| [HubSpot Engagement Manager](update/hubspot/engagement.md#hubspot-engagement-manager) | Tracks and manages customer interactions in HubSpot |

## Code Management
| Block Name | Description |
|------------|-------------|
| [Code Executor](update/code_executor.md#code-executor) | Executes code snippets in a secure sandbox environment |

## Compass Integration
| Block Name | Description |
|------------|-------------|
| [Compass AI Trigger](update/compass/triggers.md#compass-ai-trigger) | Processes transcription content from Compass hardware |

## Google Services
| Block Name | Description |
Expand Down
34 changes: 34 additions & 0 deletions docs/content/platform/blocks/update/ai_music_generator.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@

## AI Music Generator

### What it is
A powerful tool that transforms text descriptions into original music pieces using artificial intelligence technology.

### What it does
Creates unique audio compositions based on your written descriptions, allowing you to specify various aspects of the music generation process, including duration, style, and output format.

### How it works
The system takes your text description and other parameters, sends them to an advanced AI music model (Meta's MusicGen), and returns a link to the generated audio file. It automatically retries if there are any issues during generation and ensures the audio meets your specified requirements.

### Inputs
- Text Description: Your written description of the music you want to create (e.g., "An upbeat electronic dance track with heavy bass")
- Model Version: Choice of AI model version (Stereo Large, Melody Large, or Large) for different generation capabilities
- Duration: Length of the generated music in seconds
- Temperature: Controls how creative or conventional the generation should be (higher values mean more creativity)
- Output Format: Choose between WAV or MP3 file formats
- Normalization Strategy: How the audio volume should be balanced (Loudness, Clip, Peak, or RMS)
- Advanced Settings:
- Top K: Helps control variety in the generation
- Top P: Influences probability-based generation
- Classifier Free Guidance: Controls how closely the output follows your description

### Outputs
- Audio File URL: Link to download the generated music file
- Error Message: Information about what went wrong (if the generation fails)

### Possible use cases
- Creating custom background music for videos
- Generating mood-specific music for presentations
- Producing unique sound effects for multimedia projects
- Experimenting with AI-generated music compositions
- Quick prototyping of musical ideas
224 changes: 224 additions & 0 deletions docs/content/platform/blocks/update/basic.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,224 @@

# 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.
33 changes: 33 additions & 0 deletions docs/content/platform/blocks/update/branching.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@

## Condition Block

### What it is
A logical comparison tool that helps make decisions based on comparing two values.

### What it does
Compares two values using standard comparison operators (equals, not equals, greater than, less than, etc.) and produces different outputs based on whether the comparison is true or false.

### How it works
1. Takes two values and compares them using the selected operator
2. Determines if the comparison is true or false
3. Outputs the result and the appropriate value based on the comparison outcome
4. If custom output values aren't specified, uses the input values as defaults

### Inputs
- First Value: Any value you want to compare (numbers, text, or true/false values)
- Comparison Operator: The type of comparison to perform (equals, not equals, greater than, less than, etc.)
- Second Value: The value to compare against the first value
- True Result Value (Optional): Custom value to output if the comparison is true
- False Result Value (Optional): Custom value to output if the comparison is false

### Outputs
- Comparison Result: Whether the comparison was true or false
- True Output: The value produced when the comparison is true
- False Output: The value produced when the comparison is false

### Possible use cases
- Creating an age-restricted content filter: Compare user's age against a minimum required age
- Price comparison system: Check if a product's price is below a certain threshold
- Temperature control: Determine if current temperature is within acceptable range
- Grade assessment: Evaluate if a student's score meets passing criteria
- Inventory management: Check if stock levels are below reorder point
Loading
Loading