> For the complete documentation index, see [llms.txt](https://docs.revenium.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.revenium.io/get-started/ask-revvy.md).

# Ask Revvy

Revvy is the assistant inside the Revenium app. Ask it about your team's AI spend and usage, how to set something up, or where to find a page.

Revvy is an assistant built into the Revenium app. Ask it a question in plain words and it answers from your team's own Revenium data and from the Revenium documentation. When the answer lives on a page in the app, Revvy gives you a button that opens it.

{% hint style="info" %}
Revvy chat is different from the [Revvy CLI](https://docs.revenium.io/integrations/revvy-cli.md), a command-line tool that instruments your codebase. This page covers the chat inside the app.
{% endhint %}

***

### Open Revvy

Open Revvy from any page in the app in either of these ways:

* **Keyboard shortcut**: press <kbd>⌘</kbd> + <kbd>/</kbd> on a Mac, or <kbd>Ctrl</kbd> + <kbd>/</kbd> on Windows. Press the same shortcut again to close it.
* **Revvy button**: click the round Revvy button in the bottom right corner of the screen. Hover over it to see **Ask Revvy** and the shortcut for your computer.

Revvy opens in a panel on the right side of the page, so the page you were looking at stays in place behind it. Type your question in the **Ask Revvy anything** box and press <kbd>Enter</kbd> to send it. Press <kbd>Shift</kbd> + <kbd>Enter</kbd> to start a new line.

When you open a new conversation, Revvy offers a few starting questions you can click, such as:

* Show me the top movers this week
* Am I on track for my monthly budget?
* Where can I see cost by agent?

***

### What Revvy can answer

* **Your team's AI spend and usage**: for example, which providers, models or agents cost the most over a period, how spend changed, or whether you are on track for a budget.
* **Why data is missing**: if a question returns no data, Revvy says so and explains what it found, for example when each data source last sent data.
* **How to do something in Revenium**: setup, integration and how-to questions are answered from the Revenium documentation, with a link to the page it used.
* **Where to find something**: ask where to see a view, such as cost by agent, and Revvy shows a button that opens that page.

Revvy sees the same data you can see in the app for the team you are working in. Each answer shows a short line for the lookups Revvy made, such as **Used 2 sources** or the name of a single lookup. Click the line to see the details.

***

### What Revvy will not do

* **Make changes for you.** Revvy only reads. If you ask it to create, change, delete, invite, connect or configure something, it opens the page where you can do it yourself and tells you what to do there. For example, asking it to create a budget alert opens **Create an alert**.
* **Show secrets.** Revvy does not return credential values such as API keys or client secrets.
* **Look outside your team.** Revvy answers only from the team you are currently working in.

***

### Manage your conversations

The buttons at the top of the Revvy panel let you:

* **Conversation history**: see your earlier conversations and open one again.
* **New conversation**: start again with an empty conversation.
* **Widen chat** (larger screens only): make the panel wider for long answers or tables, and narrow it again.
* **Help**: open the Revenium documentation and, when there is an announcement, see what's new.
* **Close**: close the panel.

When you start a new conversation, Revvy may offer **Pick up where you left off** with the topic of your latest conversation. Click it to reopen that conversation.

If an answer does not arrive, click **Retry**, or **Ask again**, to send the question again.

***

### Give feedback

Under each answer you will find three buttons:

* **Copy answer**: copy the answer so you can paste it elsewhere.
* **Helpful** (thumbs up) or **Not helpful** (thumbs down): rate the answer. Your rating is sent to Revenium and helps us improve Revvy.

For anything else, contact us through [Get Support](https://docs.revenium.io/plans-and-contact/get-support.md).


---

# 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.revenium.io/get-started/ask-revvy.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.
