Skip to main content

​
Add the ‘Insert Knowledge’ Tool step to your Tool

You can add the ‘Insert Knowledge’ Tool step to your Tool by:
  1. Creating a new Tool, then clicking + Add Step
  2. Searching for and adding the ‘Insert Knowledge’ Tool step
  3. Clicking ‘Expand’ to see the full Tool step
  4. Selecting the Knowledge table you would like to access
  5. New data to insert: Accepts a JSON selection of objects, where each object corresponds to a row. Add more objects as outlined in the formatting examples below to insert multiple rows at once.
  6. Use the Sync on upload field to determine whether the data should be vectorized when added to the knowledge set. In most cases, you’ll want this enabled as it allows your agents to semantically search and retrieve relevant information from your knowledge table.
  7. Click Run step to test out the Tool

​
Common errors

This indicates that there is a formatting issue in the “New data to insert” input field. Make sure your object is formatted correctly. Expected property name or '}' in JSON at...
This means the data being inserted into the knowledge table is not a JSON. Invalid JSON
When creating a Tool that wraps the Insert Knowledge Tool step for use with AI agents, ensure the Tool input for new data is configured as a JSON input type rather than a Text input. The Insert Knowledge Tool step expects a JSON array of objects (as shown in the formatting examples above), so the Tool input should match this format to properly pass data from agents to the step.When setting up the Tool input:
  • Use the JSON input type (not Text)
  • Optionally provide a JSON Schema that matches the structure of your knowledge table to guide agents on the expected format
  • Reference the Tool input variable in the Insert Knowledge Tool step’s New data to insert field using variable mode ({{input_variable_name}})
This ensures that the data format passed from the Tool input to the Tool step remains consistent and properly structured.

​
Formatting Examples

​
Example 1: Insert single row

[
  {
    "breed": "poodle",
    "size": "small"
  }
]

​
Example 2: Insert multiple rows

[
  {
    "breed": "poodle",
    "size": "small"
  }, 
  {
    "breed": "great dane",
    "size": "large"
  }
]
Ensure to separate each object with a comma if inserting multiple rows.

​
Using Variables in JSON

You can use variables from Tool inputs and other Tool steps in the New data to insert field. For detailed information on how to use variables in JSON for Knowledge Tool steps, including variable syntax and typing, see Using Variables in JSON. For Knowledge Tool steps, all variables should be wrapped in quotes in the JSON format: "{{variable_name}}". The type of the inserted value is determined by the column type defined in your knowledge table.

​
Frequently asked questions (FAQs)

If “Sync on Upload” is disabled, the data will be stored but not vectorized. This means your agents won’t be able to semantically search or reference that data until you manually vectorize it.
Yes. After inserting data, you can manage your knowledge set using the available tools this includes updating or deleting rows as needed.
You can insert text, numbers, booleans, or any JSON-serializable value. Just make sure each object in the array follows the correct formatting.