Skip to main content

Tool Inputs in SimplAI: Structuring Data for AI Processing

User inputs are essential for passing data, parameters, and instructions to a tool. Inputs can:

  1. Provide settings & instructions (e.g., max results, formatting options).
  2. Supply actual data for analysis (e.g., uploading a CSV file).
  3. Allow users to ask questions for AI-driven responses.

Basic Tool: Adding User Inputs​

Navigate to the Tool Creation Page​

  1. Go to the Tools.
  2. Click on + Create Tool at the top-right cornerand create a Basic Tool..
  3. You will see an tool editor page, where you can: Add Inputs

Screen Recording

Understanding Variables in SimplAI​

Variables are used to reference user inputs within tools.
Use double curly braces {{}} to reference variables.
Example: If the input field is named my_text_input, reference it as {{my_text_input}}.

Advanced Tool: Configuring User Inputs​

Navigate to the Tool Creation Page​

  1. Go to the Tools.
  2. Click on + Create Tool at the top-right corner and create an Advanced Tool.
  3. You will see an tool editor page, where you can: Add Inputs

Setting Up Inputs​

  1. Go to Start Point in the tool editor.
  2. Select the input type required for the tool.
  3. Define variable names to be used in execution. Screen Recording

Mapping User Inputs to Multiple Nodes​

  1. Assign user inputs to multiple processing steps.
  2. Ensure proper variable mapping between inputs and AI steps.

Example:​

{{topic}} → Used in Web Research Step.
{{question}} → Used in Knowledge Base Retrieval.

Supported User Input Types​

SimplAI provides a variety of user input types that can be used to pass data, configure settings, and define user interactions in both basic and advanced tools.

1. Text​

  • Allows users to enter a short text input.
  • Example Use Case: Entering a search query for a web research tool.
  • Variable Reference: {{user_query}}.

2. Long Text​

  • Supports longer text inputs for detailed responses or content generation.
  • Example Use Case: Writing a product description for AI enhancement.
  • Variable Reference: {{detailed_input}}.

3. Number​

  • Accepts numerical values as input.
  • Example Use Case: Setting a numerical limit for search results or calculations.
  • Variable Reference: {{max_results}}.

4. File URL​

  • Accepts a URL to a file that the tool will process.
  • Example Use Case: Fetching a remote document for AI analysis.
  • Variable Reference: {{file_url}}.

5. Option (Dropdown)​

  • Provides a predefined list of selectable options.
  • Example Use Case: Letting users choose a language for translation.
  • Variable Reference: {{selected_option}}.

6. JSON​

  • Allows structured data input in JSON format.
  • Example Use Case: Passing a structured configuration for a complex tool.
  • Variable Reference: {{json_input}}.

Testing & Debugging User Inputs​

  1. Enter test values in the User Input Test Field.
  2. Click Run Tool to execute the workflow.
  3. Ensure the input is correctly passed and processed.
  4. Preview and refine if needed.

Next Steps​

  1. Start building tools with custom input configurations.
  2. Experiment with conditional logic and parallel processing.
  3. Need assistance? Contact [email protected].