AI Agents
Last updated
Was this helpful?
Last updated
Was this helpful?
With CARTO Builder, you can effortlessly create AI Agents that transform how users interact with maps, making data exploration intuitive, engaging, and conversational. AI Agents enable users to explore maps seamlessly and extract valuable insights through a natural language interface, enhancing the overall mapping experience.
AI Agents are disabled by default in your organization. To enable this functionality, navigate to: Settings > Customizations > AI Agents and use the toggle to activate AI Agents in your CARTO platform.
Once enabled, Editor users in your organization will have the ability to create AI Agents in any Builder map.
To enable AI Agents in your organization you must be an Admin user.
Once AI Agents are available in your organization, you can start the creation of Agents directly in Builder to make your maps more interactive and engaging. By linking an AI Agent to your map, end-users can ask questions, extract insights, and explore data through a conversational interface.
Before creating the AI Agent, you have the option to add custom instructions and context in the Map Context section. This helps the AI Agent deliver more accurate and relevant responses, tailored to the map’s purpose.
The Agent will automatically read your map’s configuration—such as layer styling, widget settings, and other components—to generate context-aware answers.
Adding custom instructions is optional, but highly recommended to ensure the Agent aligns with your specific use case and improves the overall experience.
To enhance the user experience, you can define Conversation Starters—common prompts that guide users in interacting with the AI Agent—and provide a User Guide that appears when the Agent greets users. These additions make the interaction more intuitive and informative.
Once you're ready—with or without configuring map context, instructions, or conversation starters—you can enable the AI Agent by toggling the AI Agent switch in the AI Agent tab. After activation, the Agent becomes available in the Editor version of the map and to end-users who access the map in Viewer mode, whether via organizational sharing, user-specific access, or SSO groups.
When you load a map with an AI Agent available, either as Editor in Preview Mode or as Viewer when accessing the published version of the map, the AI Agent will appear at the bottom center of your screen. Click on it to initiate a conversation. The Agent will greet users by displaying the user guide and conversational starter prompts, making it easy to start exploring the map.
In addition to providing text-based answers, the AI Agent has access to several capabilities for interacting with the map and helping users extract insights:
Search and zoom to specific locations.
Extract insights from widgets.
Filter data through widget interactions.
Switch layers on and off.
Retrieve the latitude and longitude of current map position.
For more information on the AI Agent's capabilities, please refer to .
