# Creating your Agent

To create an AI Agent, start with a map that represents your use case. Create a new map or adapt an existing one as needed.

Navigate to the AI tab to create your AI Agents (ensure [CARTO AI](/carto-user-manual/settings/carto-ai.md) is enabled in your organization). Click "Create AI Agent" to open the configuration dialog. Once you've provided at least the Use Case, you can begin testing your AI Agent.

<figure><img src="/files/C11yhnmFz2fpVcIFwb7W" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Use the [**Agent Config Assistant**](/carto-user-manual/ai-agents/agent-config-assistant.md) to configure your Agent through conversation. Describe your goals, iterate on the configuration, and let the Assistant generate and refine the use case, instructions, model selection, tools, and more.
{% endhint %}

Creating an AI Agent is an iterative process - you'll refine the map, adjust the Agent configuration, publish, and maintain your Agent to ensure all components work as expected.

#### Important considerations

**Timeout limits**:

* Synchronous Workflows MCP and query sources tools: 1 minute.
* Geocoding tool: 3 minutes.
* CARTO AI Service API: 5 minutes.
* Use asynchronous tools to overcome synchronous limitations.

**Access considerations**:

* Maps with QuerySources-enabled AI Agents cannot be made public.
* Enable QuerySources to access `execute_query` and `add_source` tools.
* When adding Workflows MCP Tools, you can inspect results from workflows.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.carto.com/carto-user-manual/ai-agents/creating-your-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.