# Sharing your Agent

Once you've tested your AI Agent and are confident in its responses, you can make it available for others to use. To begin, you first need to activate the agent within the [Map settings for viewers](/carto-user-manual/maps/sharing-and-collaboration/map-settings-for-viewers.md) by enabling the AI Agent toggle.

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

You can use Preview Mode to interact with the agent exactly as an end-user would, providing a final opportunity to validate that the entire experience works as expected.

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

After confirming everything looks good, you can share your map using CARTO's sharing options. This will make both the map and the integrated AI Agent available to your chosen audience, whether it's specific colleagues, your entire organization, or the public.

{% hint style="warning" %}
**Important: Public sharing limitations**

Agents with the [Query sources](/carto-user-manual/ai-agents/configuring-capabilities.md#query-sources-for-insights) capability are restricted to private and organization sharing modes and cannot be made public. This security restriction prevents unauthorized data access.

For public-facing applications:

* Build required logic into Workflows and expose them as MCP Tools.
* Use only pre-configured widgets and layers.
* Consider creating a separate, limited connection for public access.
  {% endhint %}


---

# 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/sharing-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.