> 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/chat.md).

# AI Chat

The AI Chat panel is your main way to interact with the AI assistant. Describe changes to your diagram in plain language, and the AI generates those changes for you to review before they are applied.

## Opening the AI Chat Panel

1. Look for the **AI Chat** button in the top-right corner of the editor.
2. Click the button to open the chat panel on the right side of the screen.
3. The panel displays a welcome message and a set of quick-start suggestion cards.

<figure><img src="https://2110136944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOS5XKTz5WlrX4s5rESlH%2Fuploads%2FjbyqwxJZxvK6PeeeOCDG%2FScreenshot%202026-04-27%20at%2013.50.56.png?alt=media&amp;token=6849ee95-08bb-4dbe-b6cf-6a8d72871b81" alt=""><figcaption></figcaption></figure>

## Quick-Start Suggestions

When you open a new chat, suggestion cards with example prompts help you get started:

* *"Add high-criticality business applications"*
* *"Show all top-level business capabilities"*
* *"What business apps are recommended for decommission?"*
* *"Build a network topology diagram for a small office"*
* *"Create a basic API Architecture diagram"*
* *"Build a banking industry diagram"*

Click any card to send that prompt to the AI immediately.

<figure><img src="https://2110136944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOS5XKTz5WlrX4s5rESlH%2Fuploads%2F55aGHc2VNyT5y3MJi05W%2FScreenshot%202026-04-27%20at%2013.53.46.png?alt=media&amp;token=458027a6-d687-46eb-9b68-f5b267e04f71" alt=""><figcaption></figcaption></figure>

## Sending a Message

1. Type your request in the text box at the bottom of the chat panel. The placeholder reads *"Describe the changes you want..."*
2. Press **Enter** to send your message.
3. The AI processes your request and responds with a message and, where applicable, a preview of the diagram changes.

> **Tip:** Press **Shift+Enter** to add a new line without sending.

## What You Can Ask

**Create new elements**

* *"Add three server nodes connected to a load balancer"*
* *"Create a flowchart showing a user login process"*
* *"Build a network diagram with a firewall, two switches, and four workstations"*

**Modify existing elements**

* *"Change the color of the database node to blue"*
* *"Make all the server nodes larger"*
* *"Rename 'Server 1' to 'Production Server'"*
* *"Move the firewall node to the top of the diagram"*

**Work with links (connections)**

* *"Connect the web server to the database"*
* *"Change the link style to curved"*
* *"Add a connection from the router to the switch"*

**Create groups and boundaries**

* *"Group the three servers into a boundary called 'Server Farm'"*
* *"Create a cloud boundary around the external services"*

**Build notation diagrams and decks**

* *"Create a BPMN process for onboarding with lanes for HR, IT and the manager"* — see [Architecture & Process Diagrams](/models/work-in-the-app/ai/architecture-diagrams.md)
* *"Make a five-slide deck on our top business capabilities"* — see [Slide Decks](/models/work-in-the-app/ai/slide-decks.md)

**Ask questions about your data**

* *"What business apps are recommended for decommission?"*
* *"Show all top-level business capabilities"*

## Slash Commands

Type `/` in the chat input to see available commands:

| Command   | What It Does                                      |
| --------- | ------------------------------------------------- |
| `/new`    | Start a new chat session                          |
| `/clear`  | Clear the current chat history                    |
| `/attach` | Attach an image, PDF or text file to your message |

## Composer Controls

Under the message box you find the **attachment button** (**+**), the **model selector** and the **Assistant settings**. The line *"You are interacting with an AI system. Double-check its output."* is the AI transparency notice; content the Assistant adds to a board is marked as AI-generated. See [Choosing a Model](/models/work-in-the-app/ai/models.md) and [Data Privacy & Transparency](/models/work-in-the-app/ai/privacy.md).

<figure><img src="https://2110136944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOS5XKTz5WlrX4s5rESlH%2Fuploads%2Fgit-blob-09ff118a7787c320590de892672d2fc816a71313%2Fv26.1-ai-composer.png?alt=media" alt=""><figcaption><p>Attachment button, model selector, settings and the transparency notice</p></figcaption></figure>

## Re-running or Editing a Message

Hover over one of your messages in the conversation and click the **edit icon** to revise it. Editing a previous message rolls the conversation back to that point, so you can rephrase without starting over.

## Related

* [@Mentions & Context](/models/work-in-the-app/ai/mentions.md) – Pin the AI to specific elements
* [Reviewing & Staging Changes](/models/work-in-the-app/ai/staging.md) – What happens after the AI responds
* [Managing Chat Sessions](/models/work-in-the-app/ai/sessions.md) – Keep multiple conversations


---

# 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/chat.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.