> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/ai-agents.md).

# AI Agents

**Smartico AI Agents** is an intelligent assistant solution that helps users get instant answers to their questions, analyze data, and understand platform features without leaving their workflow.

Built on advanced Large Language Models (LLMs), the AI Agents system provides context-aware responses by accessing your platform's knowledge base and data warehouse.

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FY50XmrhKncRe4OrlbiMc%2FScreenshot_23.png?alt=media&amp;token=cc486404-7b41-47bb-ac4f-916a722c757d" alt=""><figcaption><p>Agent selection</p></figcaption></figure></div>

The AI Agents system includes specialized agents designed for different tasks:

1. [**Product Expert Agent**](/welcome/products/ai-agents/ai-agent-product-expert.md) - Answers questions about platform features, configurations, and how-to guides
2. [**Data Analyst Agent**](/welcome/products/ai-agents/ai-agent-data-analyst.md) - Analyzes your data, generates charts, makes insights from the data, and provides the possibility to export the raw data
3. [**Popup Builder Agent**](/welcome/products/ai-agents/ai-agent-popups-builder.md) — **retired**. Create popups with Vibe Studio: see [Create a popup with Vibe Studio](https://help.smartico.ai/welcome/products/crm-automation/communication-channels/pop-up#create-a-popup-with-vibe-studio).
4. [**Wheel Design Creator**](/welcome/products/ai-agents/ai-agent-wheel-design-creator.md) — **retired**. Design wheels and other mini-games with Vibe Studio: see [Custom Games](https://help.smartico.ai/welcome/products/vibe-studio/custom-games).
5. [**Doodle Game Creator**](/welcome/products/ai-agents/ai-agent-doodle-game-creator.md) — **retired**. Create doodles with Vibe Studio: see [Doodles](https://help.smartico.ai/welcome/products/crm-automation/communication-channels/doodles).
6. [**Create an image Agent**](/welcome/products/ai-agents/ai-agent-create-an-image.md) - allows you to generate images directly within the Smartico Backoffice.

{% hint style="warning" %}
**Retired agents.** The Popup Builder, Wheel Design Creator and Doodle Game Creator agents are retired: their work is now done in **Vibe Studio**, which designs popups, doodles, emails and custom games, saves your designs as templates for your team, and keeps everything editable in one place. You can still open these agents, but each shows a notice with a link to its replacement. Popups, doodles and wheel designs that you made with them keep working.

* Popups → [Create a popup with Vibe Studio](https://help.smartico.ai/welcome/products/crm-automation/communication-channels/pop-up#create-a-popup-with-vibe-studio)
* Doodles → [Doodles](https://help.smartico.ai/welcome/products/crm-automation/communication-channels/doodles)
* Wheel designs → [Custom Games](https://help.smartico.ai/welcome/products/vibe-studio/custom-games)
  {% endhint %}

![The notice on a retired agent](https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Ft3hXSFCGcjwyCc05MgJs%2Fai-agent-retired-notice-06eac7fb-c511bb.png?alt=media)

The agents are available to all Smartico clients for all roles except "CRM Support" (see the [Permissions system](/welcome/products/tools-and-guides/back-office-permissions-home-label-and-sso.md)).

By default, users in the "CRM Support" group get only the Product Expert Agent and do not see the **Analytics** report buttons. To give them all AI agents of your label and the report buttons, turn on the **Give the 'CRM Support' group all AI agents** setting in **Label settings** (CRM Admins can change it).

Agent usage is limited to **30,000,000** tokens per organization per month and applies to all users in your setup. Based on our estimates, this is sufficient for most organizations to cover daily operational needs. If you need more tokens, please contact your Success Manager

{% hint style="info" %}
What is a "token"?

**Tokens** are the basic units of text that Large Language Models (LLMs) process. Instead of understanding full sentences directly, an LLM breaks text into smaller units, such as words, word parts, numbers, or punctuation. Every interaction uses ***input tokens*** (the user’s question, instructions, or data descriptions) and ***output tokens*** (the generated answer or query). The agents that access the Data Warehouse to read your operational data also consume tokens for data processing
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.smartico.ai/welcome/products/ai-agents.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
