---
title: "Autonomous Agents"
section: "Autonomous Agents"
description: "SmartestQA autonomous agents watch your project on a schedule or after each deploy: triage red runs, write QA reports, find coverage gaps. Changes come as proposals."
url: https://docs.smartestqa.ai/en/ai-agents.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "autonomous agents ai agents agent catalog daily triage qa report coverage gap report deploy verification proposals run now budget schedule"
---
# Autonomous Agents

Autonomous agents are AI workers that look after your project on a rhythm: after each deploy, every morning, every week or when you ask. They read your project, write a report and record any change they want as a proposal that a person applies.

## In short

**On this page you can**

- Install ready-made agents from a catalog of fourteen, grouped by when they run.
- Build a Custom agent with your own instructions and tools.
- Run an agent on demand with Run now and read its report.
- Review the changes an agent proposes and apply or dismiss each one.
- Cap every agent with step, per-run cost and daily budget limits.

**How to use it**

1. Open Agents in the main menu and pick your project in the header.
2. Click Install new agent , choose an agent and click Install .
3. Review the settings, save, then switch the agent on (it starts paused).
4. Let it run on its trigger, or click Run now .
5. Open the run from the card or the Runs tab and apply the proposals you agree with.

**At a glance**

- **Where:** Main menu › **Agents** (page title **Autonomous Agents**). Tabs: **Agents** and **Runs**.
- **Who:** Every role (Super Admin, Admin, User) in projects they can open. A User role’s agents can be refused tools its role has no [permission](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix) for.
- **You need:** A project selected in the header. Deploy agents also need a [code repository](https://docs.smartestqa.ai/en/deployments-repos.html#add-repo); **Deploy verification** needs a [Smoke pipeline](https://docs.smartestqa.ai/en/schedule-create.html#tags).
- **Runs on:** The SmartestQA server with the [project’s AI connection](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account), or a [scheduled task in Claude Desktop](https://docs.smartestqa.ai/en/ai-agents-settings.html#runs-on).
- **Produces:** A run with a summary, a report (also as PDF), every step it took, and **proposals** for changes.
- **Safety:** New agents start paused. A server run never writes: every change waits for a person to apply it.
- **Project types:** WEB, MOBILE and DESKTOP. Agents read runs, [reports](https://docs.smartestqa.ai/en/report.html), [defects](https://docs.smartestqa.ai/en/tasks.html) and the [app map](https://docs.smartestqa.ai/en/discover-app-map.html), which exist in every project type.

## Start from your question

I want to…

- [Install my first agent](https://docs.smartestqa.ai/en/ai-agents-catalog.html#install)
- [Choose the right agent](https://docs.smartestqa.ai/en/ai-agents-catalog.html#which-agent)
- [Write a custom agent in plain words](https://docs.smartestqa.ai/en/ai-agents-settings.html#instructions)
- [Send reports to Slack, Teams or e-mail](https://docs.smartestqa.ai/en/ai-agents-settings.html#reports)
- [Apply what an agent proposed](https://docs.smartestqa.ai/en/ai-agents-runs.html#proposals)

Something is wrong

- [The Install button is greyed out](https://docs.smartestqa.ai/en/ai-agents-troubleshooting.html#fix-install-disabled)
- [Run now does nothing](https://docs.smartestqa.ai/en/ai-agents-troubleshooting.html#fix-run-now-disabled)
- [A run says Budget blocked](https://docs.smartestqa.ai/en/ai-agents-troubleshooting.html#fix-budget-blocked)
- [“Expected run did not arrive”](https://docs.smartestqa.ai/en/ai-agents-troubleshooting.html#fix-overdue)
- [All agent problems](https://docs.smartestqa.ai/en/ai-agents-troubleshooting.html)

How does it work?

- [What happens during a run](https://docs.smartestqa.ai/en/ai-agents.html#how-a-run-works)
- [How cost and budget are counted](https://docs.smartestqa.ai/en/ai-agents-numbers.html#spend)
- [Server or Claude Desktop](https://docs.smartestqa.ai/en/ai-agents-settings.html#runs-on)
- [Why changes come as proposals](https://docs.smartestqa.ai/en/ai-agents-runs.html#proposals)
- [What the four numbers at the top mean](https://docs.smartestqa.ai/en/ai-agents-numbers.html#kpis)

## Where agents fit

Agents come after the order of work, not inside it. Once you have tests and pipelines, agents keep watching them so nobody has to check every morning by hand.

1. **Discover** — Pages, controls, rules
2. **Analyze** — Requirements
3. **Automate** — Test cases
4. **Schedule** — Pipelines
5. **Report** — Results
6. **Maintenance + Agents** — Watch, triage, report ← this page

The last stage of the [Setup Roadmap](https://docs.smartestqa.ai/en/discover.html#screen-tour) in Discover, **Install autonomous agents**, opens the [agent catalog](https://docs.smartestqa.ai/en/ai-agents-catalog.html#install) for you. [Test Health](https://docs.smartestqa.ai/en/insight-test-health.html#agents) shows “Autonomous agents this week” with a link, **Go to agents**.

## Why use agents

- **No red run stays unexplained.** **[Daily triage](https://docs.smartestqa.ai/en/ai-agents-catalog.html#daily)** groups yesterday’s failures by cause before the team starts work.
- **Everyone gets the same picture.** **Daily QA report** and **Weekly management report** go to e-mail (with a PDF), [Slack](https://docs.smartestqa.ai/en/integrations-notifications.html#slack), [Teams](https://docs.smartestqa.ai/en/integrations-notifications.html#teams), Discord or a webhook.
- **You see what is not tested.** **[Coverage gap report](https://docs.smartestqa.ai/en/ai-agents-catalog.html#weekly)** lists untested points on the [app map](https://docs.smartestqa.ai/en/discover-app-map.html) and [sub-requirements](https://docs.smartestqa.ai/en/analyze-requirements.html#sub-requirements) without test cases.
- **Deploys are checked right away.** [Deploy agents](https://docs.smartestqa.ai/en/ai-agents-catalog.html#on-deploy) wake up when your [CI reports a new deploy](https://docs.smartestqa.ai/en/deployments-ci.html).
- **You stay in control.** An agent proposes; a person applies. Every run, step, token and cent is logged.

## How a run works

1. **Something starts it**

   You click [**Run now**](https://docs.smartestqa.ai/en/ai-agents-runs.html#run-now), the [schedule](https://docs.smartestqa.ai/en/ai-agents-settings.html#cron) comes due, or a [new deploy](https://docs.smartestqa.ai/en/ai-agents-settings.html#deploy-trigger) arrives. A paused agent never starts. If the agent already has a run going, a second one is not opened.
2. **The budget is checked**

   If the agent has already spent its daily budget today, the run is recorded as **Budget blocked** and does not start. See [how spend is counted](https://docs.smartestqa.ai/en/ai-agents-numbers.html#spend).
3. **The model works step by step**

   Each step, the model decides what to do next and calls one tool. It may call only the tools ticked in the [agent’s settings](https://docs.smartestqa.ai/en/ai-agents-settings.html#tools); anything else is refused and logged as **DENIED**.
4. **Changes become proposals**

   When a tool would change something (a locator, a defect, a tag), the server does not run it. It records a **[PROPOSAL](https://docs.smartestqa.ai/en/ai-agents-runs.html#proposals)** step with the exact arguments.
5. **The run ends**

   The agent writes its summary and report. The run ends **Succeeded**, **Failed**, or **Stopped at limit** when it hits the [step or cost limit](https://docs.smartestqa.ai/en/ai-agents-settings.html#limits). The report goes to the targets in [Reports](https://docs.smartestqa.ai/en/ai-agents-settings.html#reports).

   You open the run, read the report and apply the proposals you agree with.

## The building blocks

- **Agent:** One job with its instructions, allowed tools, trigger and limits. It belongs to one project. Every save creates a [new version](https://docs.smartestqa.ai/en/ai-agents-settings.html#versions).
- **Autonomous agent:** An agent installed from the [catalog](https://docs.smartestqa.ai/en/ai-agents-catalog.html#which-agent), with instructions written by SmartestQA. You can change its settings.
- **Custom agent:** An agent you [build yourself](https://docs.smartestqa.ai/en/ai-agents-catalog.html#custom): you write the instructions and pick the tools. It starts paused and runs on demand.
- **Trigger:** When the agent runs: **Manual** (only with Run now), **Schedule** (a [cron expression](https://docs.smartestqa.ai/en/ai-agents-settings.html#cron)) or **After each deploy**.
- **Run:** One execution of an agent, with its [status](https://docs.smartestqa.ai/en/ai-agents-runs.html#statuses), steps, tokens, cost, summary, report and proposals.
- **Step:** One entry in a [run](https://docs.smartestqa.ai/en/ai-agents-runs.html#run-detail): **MODEL** (a decision), **TOOL** (a tool call), **PROPOSAL** (a change waiting for a person), **FINAL** or **ERROR**.
- **Proposal:** A change the agent wants, saved with its exact arguments. **Apply** runs it as you; **Dismiss** drops it.
- **Runs on:** Who executes the run: the SmartestQA server (uses the [project’s AI connection](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account) and costs tokens) or your Claude Desktop (a scheduled task there calls the agent).

## The screen

![Autonomous Agents with three installed agents.](https://docs.smartestqa.ai/media/shots/AGT-SHOT-01.png)

- **Refresh** and [**Install new agent**](https://docs.smartestqa.ai/en/ai-agents-catalog.html#install) in the header.
- **KPI cards** (when at least one agent exists): [**Active agents**](https://docs.smartestqa.ai/en/ai-agents-numbers.html#kpis), [**Runs today**](https://docs.smartestqa.ai/en/ai-agents-numbers.html#kpis), [**Proposals to review**](https://docs.smartestqa.ai/en/ai-agents-numbers.html#kpis), [**Spent today**](https://docs.smartestqa.ai/en/ai-agents-numbers.html#kpis). [How they are counted](https://docs.smartestqa.ai/en/ai-agents-numbers.html#kpis).
- **Agents (n)**: [one card per agent](https://docs.smartestqa.ai/en/ai-agents-runs.html#card) with its switch, last runs, today’s budget and [**Run now**](https://docs.smartestqa.ai/en/ai-agents-runs.html#run-now).
- **Runs (n)**: the [latest 100 runs](https://docs.smartestqa.ai/en/ai-agents-runs.html#runs-tab) of the project. Click a row to open it.

The tab is kept in the address (`?tab=runs`), so a refresh or a shared link opens the same tab. While any run is queued or running, the page refreshes itself every 5 seconds.

## Before you start

| You want | You need | Check it |
| --- | --- | --- |
| Report agents (triage, QA report, coverage gap) | Test runs and [pipelines](https://docs.smartestqa.ai/en/schedule-create.html) in the project; the [project’s AI connection](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account) working | [Report](https://docs.smartestqa.ai/en/report-list.html) shows recent runs |
| **Deploy verification** | A code repository in **[Deploys & Repos](https://docs.smartestqa.ai/en/deployments-repos.html#add-repo)** and a pipeline [tagged](https://docs.smartestqa.ai/en/schedule-create.html#tags) `smoke` | The [catalog card](https://docs.smartestqa.ai/en/ai-agents-catalog.html#blocked) shows no warning |
| **Deploy impact analysis** | A code repository with an [access token](https://docs.smartestqa.ai/en/deployments-repos.html#token-types) that SmartestQA can read | The catalog card shows no warning |
| Reports by Slack, Teams, Discord or WhatsApp | The channel set up and enabled in **[Integrations](https://docs.smartestqa.ai/en/integrations-notifications.html)** | The channel is tickable in [Reports](https://docs.smartestqa.ai/en/ai-agents-settings.html#reports) |
| Runs in Claude Desktop | Claude Desktop with the [SmartestQA MCP](https://docs.smartestqa.ai/en/mcp-connect.html) installed, open at the scheduled time | The card shows no “Expected run did not arrive” line |

## Best practices

#### Do

- Start with the [**Core** agents](https://docs.smartestqa.ai/en/ai-agents-catalog.html#which-agent): Daily triage, Daily QA report, Coverage gap report.
- Run a new agent once with [**Run now**](https://docs.smartestqa.ai/en/ai-agents-runs.html#run-now) before you switch on its schedule.
- Keep the [safe rules](https://docs.smartestqa.ai/en/ai-agents-settings.html#easy-mode) on in custom agents: no deleting, proposals only, never PRP.
- Read the [proposal’s **Input**](https://docs.smartestqa.ai/en/ai-agents-runs.html#proposals) before you click **Apply**.
- Send [reports to a team channel](https://docs.smartestqa.ai/en/ai-agents-settings.html#reports) so the result is seen, not only stored.

#### Don’t

- Click [**Apply all**](https://docs.smartestqa.ai/en/ai-agents-runs.html#proposals) without reading what each proposal changes.
- Raise the [daily budget](https://docs.smartestqa.ai/en/ai-agents-settings.html#limits) to make a failing agent “try harder”: fix its instructions instead.
- Tick every tool in a custom agent. Give it only what its job needs.
- Install two agents that do the same job on the same schedule.

## Agents, MCP or doing it yourself

| Way | Best when | Who decides |
| --- | --- | --- |
| Autonomous agent | The same check must happen every day or after every deploy | The agent proposes, you apply later |
| [AI assistant through MCP](https://docs.smartestqa.ai/en/mcp.html) | You want to build or fix tests in a conversation, now | You approve each diff in the chat |
| [Report](https://docs.smartestqa.ai/en/report.html) and [Maintenance](https://docs.smartestqa.ai/en/maintenance.html) screens | You want to look at one run or one heal yourself | You |

## In this section

- [Install an agent](https://docs.smartestqa.ai/en/ai-agents-catalog.html) — The fourteen ready-made agents, what each one needs, how to install one and how to start a custom agent.
- [Agent settings](https://docs.smartestqa.ai/en/ai-agents-settings.html) — Every tab of the agent settings dialog: instructions, tools, trigger and where it runs, report targets and limits.
- [Runs and proposals](https://docs.smartestqa.ai/en/ai-agents-runs.html) — Start a run, follow it, read its report and steps, and apply or dismiss what the agent proposed.
- [How the numbers work](https://docs.smartestqa.ai/en/ai-agents-numbers.html) — Formulas and worked examples for the four KPI cards, run cost, the limits, the budget meter, the run bars and the overdue warning.
- [Troubleshooting](https://docs.smartestqa.ai/en/ai-agents-troubleshooting.html) — Every Autonomous Agents message and symptom, with why it happens, what to check and how to fix it.
- [FAQ & limits](https://docs.smartestqa.ai/en/ai-agents-faq.html) — Questions and answers about autonomous agents, how agents relate to MCP, and the limits.
