> 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).