# 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: 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.ins-pi.com/models/work-in-the-app/ai.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.