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

# Agent value capture

> Document the business value and operational criticality of your agents so admins can prioritize and report on impact

Agent value capture helps workspace and team administrators understand what each agent delivers. Agent owners describe value in structured categories with quantified descriptions, and optionally rate how critical an agent is to day-to-day operations.

<Frame>
  <img src="https://mintcdn.com/abundly/1Vcuy8bdCdtsIDhY/images/agent-value-capture-settings.png?fit=max&auto=format&n=1Vcuy8bdCdtsIDhY&q=85&s=be0e4e6f7d604ab04f6c4828b1618e45" alt="Agent settings Value capture section showing a Speed increase value entry and Major impact criticality selected" style={{ width: '520px', height: 'auto' }} width="1024" height="416" data-path="images/agent-value-capture-settings.png" />
</Frame>

## Who configures what

| Role                     | What they can do                                                                                                                                                           |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Workspace admin**      | Turn value capture on or off, define value categories, enable each capture method, set workspace-wide required/optional rules, and control the owner-facing warning banner |
| **Team admin**           | Tighten requirements for their team (never loosen below workspace rules) and view compliance on the team settings tab                                                      |
| **Agent owner / editor** | Fill in value entries and criticality under **Settings → Main Settings → Value capture**                                                                                   |

## Capture methods

When enabled, a workspace can use one or both methods:

### Quantifiable value

Each entry combines a **category** (for example Cost reduction, Revenue increase, Speed increase) with a **free-text description**. Use monthly figures where possible (e.g. "\~\$8,400 / month") so values stay comparable across agents.

Workspace admins manage the category list — rename, reorder, recolor, add, or delete unused categories. Categories in use by an agent cannot be deleted until those agents are updated.

### Criticality for operations

A single choice: *If this agent was removed…*

* Impossible to operate
* Major impact
* Minor impact
* No impact

These four levels are fixed in the current release.

## Required fields and compliance

Workspace admins can require at least one quantifiable value entry and/or a criticality level for all agents. Team admins may **tighten** these rules for their team but cannot make a field optional if the workspace requires it.

When fields are required but empty:

* Agent owners see a warning banner in the **Value capture** section on Main Settings (when enabled by the workspace admin)
* Main Settings shows a warning indicator when required fields are missing
* The agent management table shows a warning icon and summarizes captured value in the **Value & criticality** column
* Team admins can view compliance counts on the team's **Settings** tab

## Where to find it

* **Workspace → Settings → Value capture** — master toggle, categories, workspace requirements, and owner warning banner
* **Team → Settings → Agent value capture** — team requirement overrides and compliance summary (when teams are enabled)
* **Agent → Settings → Main Settings → Value capture** — owner entry form (when the feature is enabled for the workspace)
* **Agent management** — column summary and missing-field indicators for admins

<Tip>
  Workspace Explorer and Team Explorer agents can list agents with `valueEntries` and `criticality`, and call `summarize_workspace_value_capture` or `summarize_team_value_capture` for aggregate reports.
</Tip>

## Learn more

<CardGroup cols={2}>
  <Card title="Agent management" icon="sliders" href="/features/agent-management">
    Centralized view of agents including value summaries
  </Card>

  <Card title="Teams" icon="users" href="/features/teams">
    Team settings and per-team governance
  </Card>
</CardGroup>
