> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/models/work-in-the-app/ai.md).

# AI Assistant

YouDesign Models includes an AI assistant that helps you create, modify, and organize diagrams using plain language — no technical expertise required. Describe what you want in your own words, and the AI generates the changes for you to review before they are applied.

## What You Can Do with the AI Assistant

* **Build diagrams from a description** — "Create a basic API architecture diagram"
* **Modify what's already on the canvas** — "Change the color of the database node to blue"
* **Ask questions about your ServiceNow data** — "What business apps are recommended for decommission?"
* **Recreate a sketch** — attach a photo of a hand-drawn diagram and let the AI rebuild it
* **Polish your diagram text** — fix grammar, shorten, change tone, or translate
* **Cluster related nodes automatically** by theme or keyword

## Before You Start

Your administrator must enable AI access in YouDesign Models for the features to appear. Once enabled, you will see an **AI Chat** button in the top-right area of the editor.

If you don't see the AI button, contact your administrator. Admins can find setup instructions in [AI Configuration](/models/admin/ai-configuration.md).

## How the AI Keeps You in Control

The AI never changes your diagram directly. Every change goes through a **preview → stage → commit** flow so you can review and reposition what the AI proposes before it lands on your board. You can also see exactly what data was sent to the AI for any response.

> **🖼 Screenshot needed:** \[AI Chat panel open on the right with welcome message and quick-start suggestion cards visible] *Show: editor with a diagram open, AI Chat panel expanded on the right, 6 suggestion cards visible, input field at the bottom.*

## In This Section

* [AI Chat](/models/work-in-the-app/ai/chat.md) – The main AI panel and how to send requests
* [@Mentions & Context](/models/work-in-the-app/ai/mentions.md) – Pointing the AI at specific elements
* [Attaching Images](/models/work-in-the-app/ai/images.md) – Using photos or screenshots as input
* [Reviewing & Staging Changes](/models/work-in-the-app/ai/staging.md) – The preview, stage, and commit flow
* [AI Text Adjust (Toolbar)](/models/work-in-the-app/ai/text-adjust.md) – Quick grammar, tone, and translation fixes
* [Cluster by Keyword](/models/work-in-the-app/ai/cluster.md) – Auto-grouping related nodes
* [Managing Chat Sessions](/models/work-in-the-app/ai/sessions.md) – Multiple conversations and history
* [Data Privacy & Transparency](/models/work-in-the-app/ai/privacy.md) – What data is sent, and how to inspect it
* [Tips & Best Practices](/models/work-in-the-app/ai/tips.md) – Getting the most from the AI


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.ins-pi.com/models/work-in-the-app/ai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.