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

# Agents Reference

> Reference for key agents surfaces, actions, and fields

## UI Surfaces

| Surface              | Purpose                             | Notable Actions                          |
| -------------------- | ----------------------------------- | ---------------------------------------- |
| Global Agents        | Discover and manage across projects | Search, filter, edit, delete             |
| Project Agents Table | Project-scoped lifecycle view       | Create New, Use this agent, sort         |
| Agent Details        | Deep-dive operational view          | Overview, Versions                       |
| Builder Drawer       | Step-by-step configuration          | Type selection, prompt config, run, save |

## Project Table Columns

* Prompt Name
* Version (default)
* Type
* Status
* Model Name
* Modality
* Created On

## Common Actions

### Create Agent

Starts a new workflow session and opens guided creation.

### Edit Agent

Loads an existing agent configuration into the drawer for updates.

### Delete Agent

Deletes the selected agent (permission-gated, with confirmation).

### Use this Agent

Shows integration snippets (cURL, Python, JavaScript).

### Add Version

Creates a new version from existing agent context.

### Set Default Version

Promotes a selected version as default.

## Core Configuration Areas

```mermaid theme={null}
graph TB
    A[Agent Config] --> B[Prompt Messages]
    A --> C[System Prompt]
    A --> D[Model Settings]
    A --> E[Input/Output Schemas]
    A --> F[Connected Tools]
```

## Permissions

Create/Edit/Delete actions are permission-gated by project-level manage controls.
