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

# Ask Riff

Ask Riff is a team-level chat with the Riff agent. It lives in the left sidebar of the Team Workspace and gives you a single place to ask questions, explore data across your integrations, and get help — without opening a specific app or agent.

{% hint style="info" %}
Ask Riff is an Enterprise feature.
{% endhint %}

## Layout

Two panels side by side:

**Left — Conversations** A scrollable list of past conversations, each showing a title (or "Untitled Conversation") and a date stamp. A **+** button at the top starts a new conversation. A collapse icon hides the panel when you want more space.

**Right — Main chat** When you start a fresh conversation, a centred heading appears: *"What would you like to explore?"* Below it, four suggestion cards offer questions relevant to your team's connected integrations — these are generated based on which integrations your team has enabled, so they reflect your actual data. Type in the input at the bottom or click a card to send it immediately.

Once a conversation has messages, the suggestion cards are replaced by the scrollable thread history.

## What the Riff agent can do here

The Riff agent in Ask Riff has access to your team's connected integrations and your [Context](/reference/team-workspace/context.md) library. You can ask it to:

* Pull data across systems — "How many open POs do we have with Acme this month?"
* Surface exceptions — "Which supplier confirmations are more than 48 hours overdue?"
* Answer questions from your knowledge library — "What's our escalation policy for invoice mismatches?"
* Help you think through a build — "What's the best way to structure an agent that handles delivery exceptions?"

## Chat input

* **Agent dropdown** — adjust model (Best / Standard / Fast), context window, tone of voice, response style, and technical level
* **Image icon** — attach images to your message
* Type your message and press Enter or the arrow button to send

## Ask Riff vs. the Riff agent in a builder

|               | Ask Riff                                     | App builder / Agent builder chat                |
| ------------- | -------------------------------------------- | ----------------------------------------------- |
| Scope         | Your whole Team Workspace                    | A single app or agent project                   |
| What it knows | All connected integrations + Context library | That project's integrations, code, instructions |
| Best for      | Answering cross-workspace questions          | Building and configuring                        |

Ask Riff is not a builder. To create or change an app or agent, open the App builder or Agent builder.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.riff.ai/reference/team-workspace/ask-riff.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.