> For the complete documentation index, see [llms.txt](https://docs.smaq.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smaq.io/documentation/features/chat.md).

# Chat & AI agents

SMAQ AI isn't a generic chatbot stitched to your data. It's a team of specialized agents — fetch-data, visualization, search-datablock, business analysis, report writing — coordinated by a supervisor that routes your question to the right one.

> **\[Screenshot needed]** Chat panel with a multi-turn conversation showing a question, the AI's thinking task list, a generated chart, and follow-up turns.

### Where to chat

* **Project chat** — click **Chat** in the side menu. The AI has access to every datablock, dashboard, automation, and KB entry in the project.
* **Dashboard chat** — the chat icon in any dashboard header. Context is scoped to the current dashboard.
* **Public dashboard chat** — anonymous viewers on a [public dashboard](/documentation/features/dashboard/public-share-and-chat.md) can chat about the data they see.

### Two pages in this section

* [What SMAQ AI can do](/documentation/features/chat/capabilities.md) — full agent reference, capability list, examples.
* [Playbooks](/documentation/features/chat/playbooks.md) — codify reusable analyses the AI can run on demand.

### Tutorials

* [Chat with SMAQ AI (tutorial)](/documentation/get-started/tutorials/chat-with-smaq-ai.md)
* [Build your first playbook (tutorial)](/documentation/get-started/tutorials/build-your-first-playbook.md)

### How to get good answers

1. **Be specific.** "ROAS by campaign last week" beats "campaign performance."
2. **Name the source.** "Google Ads spend" beats "spend" if you have multiple ad platforms.
3. **Use a date window.** "Last 30 days" beats "lately."
4. **Iterate.** Treat it like a conversation. "Now break that down by device." "Filter to just search campaigns."
5. **Add to dashboard** — when the AI returns a chart you like, push it onto a dashboard so it's persistent.

### Privacy

* Chat conversations are private to your project by default.
* Organization Owners can view all historical messages — see [Review historical user messages](/documentation/organization/review-historical-user-messages.md).
* SMAQ's AI runs on Anthropic's Claude. See SMAQ's privacy policy for processing details.

### Credits

Every chat message consumes credits. Complex multi-step queries (multiple data fetches, AI analyses) cost more than single-fact questions. See [Credits & top-ups](/documentation/plans-and-billing/credits-and-top-ups.md).


---

# 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 dynamically by asking a question.

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

```
GET https://docs.smaq.io/documentation/features/chat.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.