---
title: Create your first Make AI Agent
slug: beta-make-ai-agents/create-your-first-make-ai-agent
docTags: 
createdAt: 2026-01-20T17:48:28.062Z
---

In this tutorial, you'll create and configure a Make AI Agent in the Scenario Builder. You'll set up the agent's instructions, add tools, and optionally upload files for the agent to reference.

::::WorkflowBlock
:::WorkflowBlockItem
Create a new scenario.

1. In Make, click **Create scenario**.
2. Enter a name for your scenario.
:::

:::WorkflowBlockItem
Add a **Make AI Agent **module**.**

![](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/EEAspkSgbk6irE6MUc7Sw-20260121-130405.png)

- Search for **Make AI Agent** and select it.
- Click the module to add it to the canvas.
:::

:::WorkflowBlockItem
Configure basic settings.

- **Connection:** Select **Make's AI Provider** to use Make's default AI provider, or select a custom AI provider.
- **Model:** Select a language model. **Large/GPT-5-Mini** is a good choice to start with.
- **Instructions:** Describe what the agent should do, which tools it can use, and what input and output to expect.

![](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/OlXf3nR5eXaBwkMPiAA4T-20260121-135454.png)
:::

:::WorkflowBlockItem
Set up input and conversation ID.

Use these fields to pass data to your agent:

- **Input:** Map data from previous modules in your scenario. This is the information your agent will process. 
- To process a file, map it in the **File **field instead.
- **Conversation ID:** Enter a unique identifier like a thread ID or timestamp. The agent uses this to maintain context across multiple runs in the same conversation.
:::

:::WorkflowBlockItem
Add tools to the agent. 

Tools are actions your agent can take, such as looking up information, updating records, or sending messages. To add a tool:

- Click **Add tool**.
- Select a Make module to use as a tool.
- Give the tool a clear name and description so the agent understands what it does.
- (Optional) Select Let AI Agent decide to have the agent automatically determine what value to fill in this field. If you don't select this, you need to enter the value manually. 

![](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/AJr_7lWg9dy2aafRD8qSl-20260121-135526.png)
:::

:::WorkflowBlockItem
Add knowledge to the agent. 

A knowledge base provides files that your agent can reference during execution:

- Click **Add** **knowledge**.
- Click **Upload file and **select a file from your computer.
- Note: The agent searches these files when it needs specific information. It does not load the complete content of each file into memory. If you need your agent to process the full content of a file, map the file in the **File** field instead.
:::

:::WorkflowBlockItem
Test the agent.

Your agent is now configured. Test it in one of two ways:

**Run the scenario:** Click **Run once** to test the full scenario from start to finish.

**Chat with the agent:** Right-click the **Make AI Agents** module and select **Chat with agent**. Enter a test prompt and interact with your agent to refine its behavior before running the full scenario.
:::

:::WorkflowBlockItem
Review agent reasoning.

After the agent runs, select the **Reasoning** tab to see a step-by-step log of the agent's actions, which tools it used, and the decisions it made.
:::
::::

You have now created and configured a Make AI Agent in your scenario. You can run it immediately or adjust the configuration and test again.