> 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"
* **Draw BPMN, C4 and ArchiMate diagrams** that follow the notation, with pools, lanes and boundaries placed correctly
* **Turn a document into a diagram** — attach a PDF, a text file or a screenshot and let the AI build the board from it
* **Create slide decks** with findings, charts and citations, laid out on the board
* **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 Files & Images](/models/work-in-the-app/ai/images.md) – Using PDFs, text files, photos or screenshots as input
* [Architecture & Process Diagrams](/models/work-in-the-app/ai/architecture-diagrams.md) – BPMN, C4 and ArchiMate from a prompt
* [Slide Decks](/models/work-in-the-app/ai/slide-decks.md) – Research decks laid out on the board
* [Choosing a Model](/models/work-in-the-app/ai/models.md) – Fast models for edits, strong models for big jobs
* [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 by asking a question.

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

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