> For the complete documentation index, see [llms.txt](https://docs.kaisar.io/kaisar-network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kaisar.io/kaisar-network/kaisar-ai-ops/organization/agents.md).

# Agents

Manage AI agents, their configurations, and monitoring.

![Agents List View](/files/sWU4MKHSzfGLxhzAYtYO)

## Overview

Agents are autonomous AI entities configured to perform specific tasks. This section allows you to manage their lifecycle, monitor their performance, and configure their behaviors.

**Dashboard Summary**:

* **Total Agents**: Total number of agents configured
* **Active**: Number of agents currently active
* **Error**: Number of agents in error state

## Agents List

The agents table displays:

* **Agent**: Name and description (e.g., "Claude Assistant", "Code Reviewer")
* **Type**: AI Provider (e.g., CLAUDE, OPENAI, CUSTOM)
* **Status**: Current state (Active, Error, Maintenance, Busy, Inactive)
* **Environment**: Runtime environment (e.g., x64 @ 8 GB)
* **Last Heartbeat**: Time since last signal
* **Created**: Creation date
* **Actions**: Edit, Delete, etc.

## Creating an Agent

Navigate to **Organization** → **Agents** → Click **+ Create**

![Create Agent Form](/files/maAsOffip6Fxv6C5dIk0)

### Basic Information

**Agent Name**\* (Required)

* A unique name to identify this agent
* Example: `Claude Assistant`

**Agent Type**\* (Required)

* Select the AI provider for this agent
* Options: `Claude (Anthropic)`, `OpenAI`, `Custom`

**Description**\* (Required)

* Brief description of what this agent does

**Workspace Path**\* (Required)

* File system path where agent files are stored
* Example: `/workspace/agents/claude-assistant`

### System Prompt

**System Prompt**\* (Required)

* Instructions that define the agent's behavior and personality
* Example: "You are a helpful AI assistant. Always be professional and accurate."

### Configuration

**Model**

* Model identifier (e.g., `claude-3-sonnet`, `gpt-4-turbo`)

**Temperature**

* Controls randomness (0 = deterministic, 1 = creative)

**Max Tokens**

* Maximum response length in tokens

**Anthropic API Version** / **OpenAI Organization**

* Provider-specific settings

**Custom API Endpoint**

* Full URL to your custom AI endpoint (if applicable)

### Environment

* Configure runtime environment variables and resources

### Actions

* **Cancel**: Discard changes
* **Create Agent**: Submit and create the agent

## Viewing Agent Details

To view detailed information about an agent:

1. Navigate to **Organization** → **Agents**
2. Click on an agent from the list
3. View details in the modal dialog

![View Agent](/files/OwcZDuzCh0cgvgxmXs3c)

**Details Panel**:

* **Basic Information**: Name, Type, Description, Workspace Path
* **System Prompt**: View the current system prompt
* **Configuration**: View model settings
* **Environment**: View environment settings

## Editing an Agent

To update an agent's configuration:

1. Open agent details
2. Click **Edit** button (or select Edit from list actions)
3. Modify editable fields in the Edit Agent modal

![Edit Agent](/files/JpMS5snwXv7k5f9I0jBL)

4. Click **Update Agent** to save changes

**Editable Fields**:

* ✅ Basic Information (Name, Description, Workspace Path)
* ✅ System Prompt
* ✅ Configuration (Model, Temperature, etc.)
* ✅ Environment

## Best Practices

* **Specific Prompts**: Write clear, specific system prompts to guide agent behavior
* **Resource Allocation**: Monitor environment usage and adjust resources as needed
* **Error Monitoring**: Check "Error" status agents immediately to resolve issues
* **Version Control**: Keep track of changes to system prompts and configurations

## Next Steps

* Configure [Platform Connections](/kaisar-network/kaisar-ai-ops/agent-configuration/platform-connections.md) for your agents
* Set up [Tools](/kaisar-network/kaisar-ai-ops/agent-configuration/tools.md) for your agents to use
* Monitor agent activity in [Analytics](/kaisar-network/kaisar-ai-ops/deep-learning-platform/analytics.md)