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

# Roboflow Agent

Roboflow Agent has access to your [Workspace](/workspaces/key-concepts.md) and can create, edit, run, and debug [Workflows](/workflows/what-is-workflows.md). You can also use it to set up [Rapid](/rapid/what-is-roboflow-rapid.md) models. Access the Agent by clicking "Agent" in the left sidebar of your workspace.

<figure><img src="/files/Cv54AymVmgIex0z1nmb4" alt=""><figcaption></figcaption></figure>

## Capabilities

The Agent can:

* Build [Workflows](/workflows/what-is-workflows.md) from a natural language description, run them, and auto-fix failures (up to three retries per turn). All input modes are supported: image URLs, RTSP streams, local video, and webcam.
* Understand attached images and videos. You can attach, drag-and-drop, or paste an image or short video into the chat. The Agent analyzes your media to understand what it contains, builds a Workflow informed by it, then re-runs the Workflow on that same media to verify the result.
* Set up and manage [Rapid](/rapid/what-is-roboflow-rapid.md) models.
* Organize open Workflows, Rapid models, usage views, and plans into tabs. Use the "+" tab to reopen closed items or create new ones. Follow-up conversations inherit artifacts from previous chats.
* Open a zone editor to draw detection zones on a Workflow's input image.
* React to UI events: diagnose Rapid training failures, investigate Workflow run errors (via an "Investigate" prompt above the chat input), and continue automatically when a Rapid source Workflow is ready.
* Open a "Historical Usage" tab showing your Workspace's [Credit Usage Dashboard](/billing/credits/view-credit-usage.md) with the filters matching your question (timeframe, feature, attribution, cumulative/daily, credits/dollars). The Agent keeps the tab in sync as the conversation continues. Requires the "View Billing" permission.
* Set up [Vision Events](/deploy/vision-events.md) in your Workflows. When building a Workflow that runs a model, the Agent adds a Vision Events block and configures it with the right [Use Case](/deploy/vision-events/use-cases.md), creating one if needed.


---

# 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.roboflow.com/agents/roboflow-agent.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.