# 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="/files/vtW6VSz2hECMfr9ur9y4" 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="/files/GzIFlQ9k7HKP80fkR9yk" 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"*

**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 to your message |

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