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

# Chat

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FxT2NHgIWcWkAyizri9Us%2FVioletChat-MassChart.png?alt=media&amp;token=45f8169a-19fc-4f92-9659-b26172f3e310" alt=""><figcaption></figcaption></figure>

## Overview

Violet Chat allows you to query your data, summarize changes, and generate reports and charts in natural language.

Ask Violet to:

* List parts with a certain release status, mass or owner
* Calculate the total unpaid amount across your open invoices
* Summarize recent changes to a BOM, requirement or test

### Setup

First, head to **Integrations** to connect to an LLM provider. We support:

* Amazon Bedrock
* Azure AI Foundry
* Claude
* Gemini via Vertex AI
* Google Gemini
* Groq
* OpenAI (ChatGPT)

To connect, you'll need an API key generated from your selected provider.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2F7B4RGBCmDDk7d26qpqP0%2FLLMs.png?alt=media&amp;token=00184338-29f5-40e2-a521-42920b1c3629" alt="" width="563"><figcaption></figcaption></figure>

Next, navigate to **Chat** and select your provider and desired model.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2Ff8nBKL0RzzJvLlGugKbf%2FScreenshot%202026-04-21%20at%207.47.25%E2%80%AFAM.png?alt=media&amp;token=8f10a249-aa11-4f55-ad75-eafadca96174" alt="" width="375"><figcaption></figcaption></figure>

### Queries

Use natural language queries to summarize data, count relevant results, identify outliers and perform calculations.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FEnYESVvbV7CmCmiBChCu%2FChat%20-%20summary.png?alt=media&amp;token=9089b6f1-ffcf-4f3b-b4cc-09484cf395ee" alt=""><figcaption><p>Summarize changes</p></figcaption></figure>

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FKeCThpt9vI04NbaN9Ti0%2FChat%20-%20invoices.png?alt=media&amp;token=165af964-f4e1-47d6-b874-579a84b640ae" alt=""><figcaption><p>Perform calculations</p></figcaption></figure>

### Explorations

To dive deeper into your data, open the query results in **Data Explorer** or save the results as an **Exploration**.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FfIDtSTQnhxtSmKAx4Gs9%2FChat%20-%20Explorations.png?alt=media&amp;token=172ee9df-5db0-42b9-bf0e-b993b36a11ad" alt=""><figcaption><p>Save results as Violet Explorations</p></figcaption></figure>

### Charts

To visualize your data in a chart, click **Show Chart**.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2Fh9iHjm3OtXqnjV3IOFl2%2FChat%20-%20Charts.png?alt=media&amp;token=7d37d2ba-8785-4ca9-b9d9-898aff54bb30" alt="" width="563"><figcaption></figcaption></figure>

Click **Expanded View** to see a preview, or click download to export the chart as a .png file.

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FkxUEfumGFrCVIrdamjiO%2FChat%20-%20Expanded%20View.png?alt=media&amp;token=00dc5f37-57cd-4b7a-a10a-efb916c8da13" alt=""><figcaption></figcaption></figure>

Configure your chart by selecting the properties to measure, the type of chart, and the orientation.

<div><figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2F0q3fZvEIh6qmNcWFBWRK%2FScreenshot%202026-04-26%20at%206.44.54%E2%80%AFPM.png?alt=media&amp;token=23079c13-ea82-4877-a116-95d65ed8a850" alt=""><figcaption></figcaption></figure> <figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FRqVClpclDel3GqznAEBs%2FScreenshot%202026-04-26%20at%206.44.59%E2%80%AFPM.png?alt=media&amp;token=e05f7354-d1f9-4912-9ef5-6fb1080a53ad" alt=""><figcaption></figcaption></figure></div>


---

# 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.violetlabs.com/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.
