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

# Context

Context is your team's shared knowledge library. The Riff agent refers to it when answering questions in Ask Riff, when building in the App builder, and when your agents run their tasks.

## What you see

The Context tab shows your knowledge library as a browsable, searchable list. Entries are organised by domain and category. Click any entry to expand it and read its full content.

Use the search bar to find entries by name or content — search is semantic, so you can describe what you're looking for rather than matching exact words.

## How knowledge gets in

Knowledge is added by the Riff agent — not manually. As the Riff agent works with your data and integrations, it identifies information worth saving (supplier details, business rules, terminology, process notes) and surfaces it as a suggestion.

**Pending suggestions** appear as a section in the Context tab. Each suggestion shows what the agent proposes to save and why. You decide what to keep:

* Click **Add** to confirm — the entry joins your knowledge library
* Click **Dismiss** to skip it

You cannot paste, upload, or write entries directly. The Riff agent is the route in.

## What knowledge entries contain

Each entry has a name and content (written in plain text or markdown). Entries may also have optional metadata — including tags, source, and update frequency — which the Riff agent sets when it creates them.

## How the Riff agent uses Context

The Riff agent does not automatically load your entire Context library into every response. Instead, it searches Context on demand — when it determines that background knowledge would help it answer a question or complete a task more accurately.

You can ask the Riff agent to search Context explicitly: *"Check what we know about Acme Logistics before drafting this email."*

## Keeping Context useful

Context is most valuable when it reflects your current business reality. Review your library periodically — especially when supplier relationships change, processes update, or new ERP reference data is introduced. Ask the Riff agent to update or retire entries that are no longer accurate.


---

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