> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whawit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# The agents screen

> On Call → Agents shows every on-call agent in the project as a card — status, objective, escalation wiring, provider and cadence at a glance, with start and pause one click away

## Every agent, on one screen

**On Call → Agents** (`/ops/oncall`) is the on-call area's landing page: a card grid
titled **On-Call Agents**, one card per agent in the current project. A project usually
runs several agents with different objectives — one watching payments, one watching the
batch jobs — and the grid shows them all side by side, each with its own status and
wiring. The header counts them (*"4 agents in this project"*) and carries the two
entry points: **Escalation Teams** and **New Oncall**.

## What a card tells you

Each card is a complete health check of one agent, without clicking into it:

| On the card          | What it means                                                                                                                                                                                                      |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Status dot and badge | A pulsing green **Running** for an active agent; **Paused** or **Inactive** otherwise.                                                                                                                             |
| **AI Agents** badge  | The autonomous agent team is enabled on this agent — clicking the card opens the live team view.                                                                                                                   |
| Objective            | The agent's **Focus Description** — what it watches. Falls back to *"Monitors all logs from the connected provider."*                                                                                              |
| **Escalation** panel | Who gets paged when this agent finds an incident: the default escalation policy (*"Sev1 chain · 3 levels"*), and each rotation with its resolution — **Policy**, **Team**, or **Members**.                         |
| Provider             | The connected log provider's logo and name — or **No provider connected**.                                                                                                                                         |
| Cadence              | How often the agent looks: **Adaptive · coordinator-driven** when the agent team runs (the coordinator decides the period), **Autonomous · balanced** in autonomous mode, or **Every 15 min** on a fixed interval. |

<Warning>
  A card showing **"No escalation configured — nobody gets paged when this agent finds an
  incident."** deserves attention before the incident happens. Wire a default policy or a
  rotation from the agent's settings — though note the organization's default policy, if
  one exists, still applies as a fallback.
</Warning>

Two controls live directly on the card, no menu needed:

* **Pause agent / Start agent** — the play-pause button in the corner stops and resumes
  the agent in place.
* The **⋮ Agent actions** menu — **View Details**, **Edit Settings**, and **Delete**
  (with a confirmation; deleting is irreversible).

Clicking anywhere else on the card opens the agent: the **live agent-team view** when the
AI Agents badge is present, the detail page (tabs **Overview**, **Incidents**,
**Executions**, **Team**) otherwise. The sidebar stays with you either way.

## Creating an agent

Press **New Oncall**. Two prerequisites apply:

* The project needs at least one **connected log provider** — without one you are taken
  to the Integrations page first.
* Creation requires an active subscription or trial.

The five-step wizard walks Foundation (provider and monitoring mode), Alert Rules,
Response Team, Notifications, and Review & Launch. The new agent appears as a card when
you finish. See [Set up on-call](/on-call/setup) for the full walkthrough.

## Editing an agent

**⋮ → Edit Settings** opens **Configure Oncall Agent**, the agent's full-width editor:

* **Basic Settings** — **Agent Name**, **Agent Status** (Active / Paused / Inactive),
  **Focus Description** (what the card shows as the objective — be specific about the
  systems, logs or metrics to watch), and the **Integration** the agent reads from. An
  agent with no integration assigned stays inactive, and the editor says so.
* **Monitoring Mode** — **Autonomous Mode** (AI-driven cadence, with a Conservative /
  Balanced / Aggressive **Autonomous Level**) or **Fixed Interval** (**Check Frequency**
  from every 5 minutes to hourly).
* **Alert Rules** — the severity thresholds that turn findings into alerts.
* **On-Call Rotations** — the rotations and the **Escalation Policy** select. Leaving the
  policy on *"Derive from the rotations below"* makes each rotation one escalation level,
  15 minutes apart.
* **Cooldown & Anti-Spam Control** — how long the agent holds fire after alerting.
* **AI Agent Team** — the **Enable AI Agent Team** switch: a team of specialized
  DevOps/SRE agents that investigates alerts, queries logs, analyzes infrastructure and
  populates the knowledge base. With the team on, the agent's cadence becomes
  coordinator-driven — checking more often during active incidents and backing off when
  the system is healthy.
* **Notification Channels** — Discord, Slack and Microsoft Teams, side by side. The
  [Slack app](/on-call/slack) and [Teams app](/on-call/microsoft-teams) connect here.

A sticky save bar appears the moment anything changes; **Save Changes** applies it all at
once.

<Note>
  Pausing from the card sets the agent **Inactive**. The distinct **Paused** state is set
  from the editor's **Agent Status** field — both stop the agent; they differ only in
  what the badge communicates to your team.
</Note>

## Who can do what

Everyone in the project sees the agent cards. Creating, editing and configuring agents
requires the on-call configure capability — the **Admin** and **Owner** roles. The
backend enforces the same rule on every action.

## Related

<CardGroup cols={2}>
  <Card title="Agentic on-call" icon="robot" href="/on-call/agent-teams">
    What the AI agent team actually does when it investigates.
  </Card>

  <Card title="Escalation policies" icon="arrow-up-right-dots" href="/on-call/escalation-policies">
    The chains behind the card's Escalation panel.
  </Card>

  <Card title="Set up on-call" icon="rocket" href="/on-call/setup">
    The guided setup, end to end.
  </Card>

  <Card title="Notifications" icon="bell" href="/on-call/notifications">
    Every channel a page can reach.
  </Card>
</CardGroup>
