> 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/agent-builder/pipeline.md).

# Pipeline

The Pipeline tab shows your agent's work as a horizontal Kanban board. Each column represents a state in your agent's workflow. Each card is a task the agent is managing.

## Layout

**Top bar:** title "Pipeline" · subtitle "The agent's working board." · **Dev / Prod toggle** (right side)

**Columns:** one per workflow state, scrollable horizontally. Each column shows a header with the state label and task count, and a scrollable list of task cards below.

## Dev / Prod toggle

Switches the board between your development environment and production environment. Use Dev while testing; use Prod to see what real users and real triggers are producing.

## Task cards

Each card shows:

* **Agent type badge** — small uppercase label (e.g. "ANALYST")
* **Live indicator** — a pulsing blue dot appears when the agent is actively working on this task right now
* **Task title**
* **Metadata** — Priority · Assignee · Due Date (when set)
* **Description preview** — first two lines
* **Status dropdown** — at the bottom of the card; click to move the task to a different state

Click anywhere on a card (except the status dropdown) to open the task detail page.

## When to use Pipeline

Pipeline is most useful when your agent manages multi-step processes or case-style workflows — where tasks move through defined stages (e.g. Received → In Review → Resolved). The live indicator shows you exactly which task the agent is working on at any given moment.

If your agent runs simple one-shot jobs (triggered, runs, done), you may find the [Activity](/reference/agent-builder/activity.md) tab more useful for observability.


---

# 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/agent-builder/pipeline.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.