Scenarios for AI agents
This page reflects a previous version of Make AI Agents. For the latest information, see Make AI Agent (New).
When you use a as a tool for an AI agent, you need to create a (or choose an existing one), and specify its name and description. Unlike module tools, require you to define the scenario inputs and outputs so that the agent knows how to handle the data it receives and returns.
To use a as a tool for an AI agent, make sure it's active and scheduled On demand. You can also use triggered by a Custom webhook.
Create a
You can create a for an AI agent in the AI Agents configuration tab or in the Make AI Agents > Run an agent module.
To create a for an AI agent in the AI Agents configuration tab:
Go to the AI Agents configuration tab on the left sidebar.
Select an agent where you want to add a .
In the Tools section, click Add, and select Scenario.
Click Create scenario.
Configure the :
- Enter scenario's Name and Description.
- Define scenario inputs and outputs:
- Name: The name of the input (e.g., "city")
- Description: The description of the input (e.g., "City we want to get the weather report from")
- Type: The data type (e.g., Text for a city name)
Click Create scenario.
To create a for an AI agent in the Make AI Agents > Run an agent module:
Open the Make AI Agents > Run an agent module in a .
In the Agent field, select your agent.
In the Tools section, click Add, and select Scenario.
Follow the same steps as when creating a tool in the AI Agents configuration tab.
Once the is created, add modules to it:
Click the or the Edit button, and then click the giant plus.
Choose the module you want to add.
Map the corresponding inputs you've added in step 5, and click Save.
In the Toolbar, click Save to save the , check if it's scheduled to run On demand and activate it. This is required to use a as a tool for AI agents.
Go back to the AI Agent configuration tab, click Add > Scenarios, select the you've created, and click Save in the top-right corner to save the changes in your AI Agent.
You can see below that a with a single module looks the same as the created for a module tool. The difference is:
- With a module tool, automatically creates the with inputs and outputs. You can't edit it in the Builder unless you convert it to a .
- With a tool, you have to add manually the module you want to use, do the mappings for the inputs/outputs, and edit afterward.
Thus, if you don't plan to add additional modules or build a more complex workflow, we recommend using a module tool instead.
Now you can use your as a tool for an AI agent. You can test it by typing a request in the Testing & Training chat.
You can find the created for AI agents in the All scenarios folder.
Edit a
To edit a for an AI agent:
Go to the Tools section of the AI agent configuration tab, and click the expand icon next to the .
Alternatively, within the Make AI Agents > Run an agent module, select your agent, and click the expand icon next to the .
Or just go to the All scenarios folder and select the required from the list.
In all cases, you will be redirected to the scenario diagram. Click Edit in the top-right corner, make the required changes, and save your .
Once you're done editing the scenario, ensure the is active and scheduled to On demand.
Delete a
To delete a for an AI agent:
Go to the Tools section of the AI agent configuration tab, click the delete icon next to the .
Alternatively, within the Make AI Agents > Run an agent module, select your agent and click the delete icon next to the .
Your will be deleted from all instances of the agent across all scenarios. However, it will still be available in your All scenarios folder.