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

# Agent Controls

Stop individual agents or all agents during an emergency.

Agent Controls shows every agent's runtime state. Use it to stop current work in one project. You can stop one agent or every agent.

Use it when:

* An agent behaves unexpectedly.
* A scheduled load test needs intervention.
* You must stop active work before changing configuration.

Open **Governance → Controls & Policies → Agent Controls**.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-25bacca453e3d091320d8698aa2d7ae1419e7b43%2Fqore_control-center_control-centre-controls-audit-agent-controls_rounded_shadow.png?alt=media" alt="The Agent Controls screen, with a Stop all agents button and a per-agent status list"><figcaption><p>Agent Controls, with emergency stop controls and per-agent runtime status.</p></figcaption></figure>

## Key terms

| Term    | Meaning                                                                                | What you can do here          | Scope         |
| ------- | -------------------------------------------------------------------------------------- | ----------------------------- | ------------- |
| Agent   | A configured AI worker with an identity, skills, knowledge, triggers, and integrations | Stop its active runs          | One agent     |
| Project | The boundary for the current work                                                      | Stop active runs              | One project   |
| Run     | One execution after a trigger or request                                               | Ends when complete or stopped | One execution |

Agent Controls does not build, edit, disable, delete, or deactivate agents. Switch projects to review or stop work elsewhere. This view has no cross-project scope.

> Stopping work only interrupts current runs. The agent runs again after its next trigger.

## Stop work safely

| Need             | Action                         | Confirmation | Result                                        |
| ---------------- | ------------------------------ | ------------ | --------------------------------------------- |
| Stop one agent   | Select **Stop** for that agent | None         | Interrupts that agent's active runs           |
| Stop every agent | Select **Stop all agents**     | Required     | Interrupts active runs throughout the project |

The single-agent action takes effect immediately. The project-wide action asks you to confirm the affected project.

{% hint style="warning" %}
Narrow the agent list with **Search agents…** before stopping work. This reduces the chance of selecting the wrong agent.
{% endhint %}

## Stop a running agent

For an agent, open **More Actions** (`⋯`). Choose **View Agent** or **Stop**. These actions remain available when activity shows `Completed` or `Unknown`.

**View Agent** opens the agent in a new browser tab at `/platform/agent-builder/<agentId>?…`. Configure its graph, skills, triggers, knowledge, and integrations in [Agent Builder](/console/agent-builder.md). Your current activity view stays open.

**Stop** interrupts the agent's active runs. Work in progress is lost. If none exist, the request has no effect. The service still sends the request and displays `Stopping the agent's executions`.

{% hint style="info" %}
`Stopping the agent's executions` can remain visible and can appear twice. It does not indicate ongoing work. The request runs once.
{% endhint %}

## Stop every agent in the project

Select **Stop all agents** to interrupt active runs throughout the current project. The confirmation states `in this project` and warns that the action cannot be undone. Select **Cancel** to leave work running. New runs can start immediately after stopping.

The confirmation applies only to the current project. To stop work elsewhere, switch projects and repeat the action.

## Find agents

Use **Search agents…** to find agents by name. Matching ignores case and accepts part of a name. The filter is saved as `?search=<term>`, so you can bookmark or share it. Search covers the full project, including agents beyond the default first page.

{% hint style="info" %}
Unlike Search, changing the page does **not** update the URL—page state is client-only, so a specific page cannot be bookmarked or shared. Use Search to narrow the list when you need a shareable view.
{% endhint %}

## Choose the right destination

Use these destinations for work that does not stop active runs:

| Goal                   | Destination    | Available action           | Limitation                                  |
| ---------------------- | -------------- | -------------------------- | ------------------------------------------- |
| Build or edit an agent | Agent Builder  | Change configuration       | Does not stop work automatically            |
| Stop selected agents   | Agent Controls | Stop each agent separately | Selected-agent bulk stopping is unavailable |

## Related

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td><strong>Governed Graph</strong></td><td>Explore how agents, apps, tools, and data connect</td><td><a href="/control-center/govern/governed-graph.md">Governed Graph</a></td></tr><tr><td><strong>Agent Builder</strong></td><td>Configure agents and their connected resources</td><td><a href="/console/agent-builder.md">Agent Builder</a></td></tr><tr><td><strong>Glossary</strong></td><td>Look up agent, project, run, and related terms</td><td><a href="/start-here/glossary.md">Glossary</a></td></tr></tbody></table>


---

# 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.uptiq.ai/control-center/govern/agent-controls.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.