--- title: Scenarios for AI agents slug: scenarios-for-ai-agents docTags: createdAt: 2025-09-09T08:42:34.906Z --- :::hint{type="success"} This page reflects a **previous version of Make AI Agents**. For the latest information, see [Make AI Agent (New)](docId\:rXryASA6852hvhkZ6NhXU). ::: When you use a scenario as a tool for an AI agent, you need to create a scenario (or choose an existing one), and specify its name and description. Unlike module tools, scenarios require you to define the [scenario inputs and outputs](https://help.make.com/scenario-inputs-and-outputs) so that the agent knows how to handle the data it receives and returns. :::hint{type="info"} To use a scenario as a tool for an AI agent, make sure it's active and scheduled **On demand**. You can also use scenarios triggered by a Custom webhook. ::: ### Create a scenario You can create a scenario for an AI agent in the **AI Agents **configuration tab or in the **Make AI Agents > Run an agent** module. To create a scenario for an AI agent in the **AI Agents **configuration tab: ::::WorkflowBlock :::WorkflowBlockItem Go to the **AI Agents** configuration tab on the left sidebar. ::: :::WorkflowBlockItem Select an agent where you want to add a scenario. ::: :::WorkflowBlockItem In the **Tools** section, click **Add**, and select **Scenario**. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/vjb4_BwKmX0Az4vFCKeSm-20250923-075628.png" size="60" width="1310" height="1236" position="center" darkWidth="1310" darkHeight="1236" showCaption="false"} ::: :::WorkflowBlockItem Click** Create scenario**. ::Image[]{src="https://api.archbee.com/api/optimize/PL8X94efBsjvhfQV3wyyj-hkSSlrM95FomhsH5ZyeUT-20250821-161259.png" size="60" width="1086" height="940" position="center" darkWidth="1086" darkHeight="940" showCaption="false"} ::: :::WorkflowBlockItem Configure the scenario: - 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) ::: :::WorkflowBlockItem Click **Create scenario**. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/untoS8Sp2W8IzF2MBKyz--20250924-084908.png" size="40" width="698" height="1382" position="center" showCaption="false"} ::: :::: To create a scenario for an AI agent in the **Make AI Agents > Run an agent** module: ::::WorkflowBlock :::WorkflowBlockItem Open the **Make AI Agents > Run an agent** module in a scenario. ::: :::WorkflowBlockItem In the **Agent** field, select your agent. ::: :::WorkflowBlockItem In the **Tools** section, click **Add**, and select **Scenario**. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/N3bSys30BU0Sspj3H5RTy-20250924-085302.png" size="60" width="1182" height="1182" position="center" showCaption="false"} ::: :::WorkflowBlockItem Follow the same steps as when creating a scenario tool in the **AI Agents **configuration tab. ::: :::: Once the scenario is created, add modules to it: ::::WorkflowBlock :::WorkflowBlockItem Click the scenario or the **Edit** button, and then click the giant plus. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/_nvQN8CXH_Mb2BCUoSX5R-20250926-163403.png" size="80" width="2610" height="1408" position="center" showCaption="false"} ::: :::WorkflowBlockItem Choose the module you want to add. ::Image[]{src="https://api.archbee.com/api/optimize/PL8X94efBsjvhfQV3wyyj-ZoPo0aX0Vkcw-yz0H1r7P-20250822-060928.png" size="80" width="1724" height="878" position="center" showCaption="false"} ::: :::WorkflowBlockItem Map the corresponding scenario inputs you've added in step 5, and click **Save**. ::Image[]{src="https://api.archbee.com/api/optimize/PL8X94efBsjvhfQV3wyyj-c0LiG_ShfmO563C8C8jo5-20250826-095026.png" size="60" width="1298" height="592" position="center" showCaption="false"} ::: :::WorkflowBlockItem In the Toolbar, click **Save** to save the scenario, check if it's scheduled to run **On demand **and activate it. This is required to use a scenarioas a tool for AI agents. ::Image[]{src="https://api.archbee.com/api/optimize/PL8X94efBsjvhfQV3wyyj-18VZhZjc0Cd3Dkf1Wo17N-20250822-062700.png" size="60" width="904" height="70" position="center" showCaption="false"} ::: :::WorkflowBlockItem Go back to the AI Agent configuration tab, click **Add > Scenarios**, select the scenario you've created, and click **Save** in the top-right corner to save the changes in your AI Agent. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/xyX0oyJHkshgdDW9s4BTl-20250929-080150.png" size="70" width="2530" height="1314" position="center" showCaption="false"} ::: :::: You can see below that a scenario with a single module looks the same as the scenario created for a module tool. The difference is: - With a module tool, Make automatically creates the scenario with inputs and outputs. You can't edit it in the Scenario Builder unless you convert it to a scenario. - With a scenario tool, you have to add manually the module you want to use, do the mappings for the scenario inputs/outputs, and edit scenarios afterward. Thus, if you don't plan to add additional modules or build a more complex workflow, we recommend using a module tool instead. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/QkMigpPFEDJB2RlmgPijH-20250926-163635.png" size="70" width="2632" height="1376" position="center" showCaption="false"} 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. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/SSMBnS7cb2Jmt-tzLmnS9-20250929-075540.png" size="70" width="2654" height="1320" position="center" showCaption="false"} You can find the scenarios created for AI agents in the **All scenarios** folder. ### Edit a scenario To edit a scenario for an AI agent: ::::WorkflowBlock :::WorkflowBlockItem Go to the **Tools** section of the AI agent configuration tab, and click the expand icon next to the scenario. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/MDtAYZPHP2U5ciRawhNRr-20250924-092527.png" size="58" width="1268" height="1336" position="center" showCaption="false"} ::: :::WorkflowBlockItem Alternatively, within the **Make AI Agents > Run an agent** module, select your agent, and click the expand icon next to the scenario. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/aBFMaYUCe5X-bMYZAa-vs-20250924-091429.png" size="60" width="1296" height="1334" position="center" showCaption="false"} ::: :::WorkflowBlockItem Or just go to the **All scenarios** folder and select the required scenario from the list. ::Image[]{src="https://app.archbee.com/api/optimize/PL8X94efBsjvhfQV3wyyj-9cogRNhV_sy_IaqXl16Wk-20250824-084142.png" size="70" width="2606" height="428" position="center" showCaption="false"} ::: :::WorkflowBlockItem 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 scenario. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/c7-nAHaH7b3E7z-E53db8-20250926-164417.png" size="70" width="2632" height="1376" position="center" showCaption="false"} ::: :::: Once you're done editing the scenario, ensure the scenario is active and scheduled to **On demand**. ### Delete a scenario To delete a scenario for an AI agent: ::::WorkflowBlock :::WorkflowBlockItem Go to the **Tools** section of the AI agent configuration tab, click the delete icon next to the scenario. ::Image[]{src="https://api.archbee.com/api/optimize/PL8X94efBsjvhfQV3wyyj-0Uj8UoPJdVuSZnv0gq3s9-20250824-120902.png" size="60" width="1316" height="1248" position="center" showCaption="false"} ::: :::WorkflowBlockItem Alternatively, within the **Make AI Agents > Run an agent** module, select your agent and click the delete icon next to the scenario. ::Image[]{src="https://app.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/UZ6ztsgEXCSPBa_Yu0zG--20250924-092036.png" size="60" width="1296" height="1334" position="center" showCaption="false"} ::: :::: Your scenario will be deleted **from all instances of the agent **across all scenarios. However, it will still be available in your **All scenarios **folder.