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

# Agents

> Watch over your Digital Twin's agents from the Agents tab of the Digital Twin editor — live sessions, pending approvals, Shield events and extensions.

An **agent** is your Digital Twin given its own workspace: a private cloud computer that persists
between conversations, so it can carry out longer jobs, pick up where it left off and run work on a
schedule. People use their agents on the [agents page](/mdx/admin-guide/agent-workspace). This page
covers the **Agents** tab, where a Digital Twin's administrators keep an eye on them.

<Note>
  Agents are set up per Digital Twin by the Praxis AI team, because each one runs on its own cloud
  workspace. To have agents for your Digital Twin, contact the Praxis AI team at
  [humans@praxis-ai.com](mailto:humans@praxis-ai.com). Until then, the **Agents** tab does not appear.
</Note>

## Opening the Agents tab

<Steps>
  <Step title="Open your Digital Twin in Admin">
    Go to **Admin → Instances** and edit your Digital Twin.
  </Step>

  <Step title="Select Agents">
    Select the **Agents** tab (in the Studio UI: **Agents Control Center**). It is shown once agents
    are set up for the Digital Twin, to administrators who may edit it.
  </Step>
</Steps>

## The tab at a glance

Four tiles at the top summarise the current state:

| Tile | What it tells you |
| - | - |
| **Workspace** | Whether the agent's workspace is up (see below) |
| **Important Shield events** | High and critical security events in the last 24 hours |
| **Live sessions** | How many sessions are running now |
| **Pending approvals** | How many actions are waiting for your decision, or **No reviews needed** |

Below the tiles: **PraxisShield** with an **Agent readiness** checklist, **Live Threads &
Sessions**, **Active sessions**, **Pending approvals**, **Extensions & Features** and **Impact**.

### Workspace status

| Status | What it means |
| - | - |
| **Inactive** | The agent for your Digital Twin is not set up |
| **Queued** | Setup was requested; it starts shortly |
| **Setting up** | The workspace is being built — this takes a few minutes the first time |
| **Active** | The agent is live and accepting work |
| **Needs attention** | Setup did not finish. The reason is shown; contact the Praxis AI team |
| **Disabled** | The agent is paused |

## Active sessions

Work happening right now. Select **Cancel session** to stop one that is stuck, wrong or no longer
needed. Cancelling stops that session only; a scheduled workflow still starts its next run on time.

## Pending approvals

Some actions pause and wait for a person instead of going ahead. They collect here, and nothing
happens until someone decides. **Approve** lets the agent continue; **Reject** means the step is
not taken. Each decision is recorded with who made it.

<Tip>
  If the same approval keeps coming back, the work is probably asking for more than it should —
  narrow the workflow's instructions.
</Tip>

## PraxisShield

Security events raised by [Praxis Shield](/mdx/admin-guide/praxis-shield) for this Digital Twin's
agents, so you do not have to look for them. Only events worth an administrator's attention are
listed; with none in the last 24 hours the card reads "All clear".

## Extensions & Features

Optional capabilities for this Digital Twin's agents. Each one shows **Enabled** or **Disabled**;
select **Enable** or **Disable** to switch it.

## Impact

Tokens used in the last 24 hours and the last 7 days (prompt, reply and total), the estimated cost
and the success rate.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The workspace stays in Setting up">
    The first setup takes a few minutes. If it stays there much longer, or shows **Needs attention**,
    contact [humans@praxis-ai.com](mailto:humans@praxis-ai.com) rather than waiting.
  </Accordion>

  <Accordion title="A scheduled workflow never seems to run">
    Check that the workspace is **Active**, that the workflow is switched on, and that the Digital
    Twin still has credits. A run that cannot be paid for does not start.
  </Accordion>
</AccordionGroup>

## Related

* [The Agent Workspace](/mdx/admin-guide/agent-workspace) — the agents page, workflows, the remote desktop and connections
* [Praxis Shield](/mdx/admin-guide/praxis-shield) — the security events shown on this tab
* [Credit Management](/mdx/admin-guide/credit-management) — how agent work is paid for
* [Entitlements](/mdx/admin-guide/entitlements) — who may edit a Digital Twin


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.