Skip to main content
The Agent Overview page is your control center for all saved agents. Here you can view agent performance, manage versions, and configure deployments.
Agent Overview

Dashboard Overview

At the top, you’ll see quick stats:
  • Total Agents: Number of agents you’ve created
  • Active: Agents currently deployed
  • Runs: Total execution count
  • Total Tokens: Cumulative token usage

Agent List

Each agent card shows:
  • Agent name and description
  • Current version number
  • Creation date
  • Quick action buttons (Config, Settings, Delete)

Quick Actions

Config: Opens the agent’s current version in the Playground where you can edit the YAML configuration Settings: Access version management, access control, statistics, and general settings Delete: Remove the agent and all its versions permanently

Managing Agent Versions

Understanding Versions

Every time you save changes to an agent, a new version is created. This gives you:
  • Version history: See all previous configurations
  • Easy rollback: Revert to an older version if needed
  • Safe experimentation: Test changes without losing the working version

Version States

Version Management
Current Badge: The version that’s actively deployed and handles all API requests Historical Versions: Previous configurations you can view or deploy

Deploying a Version

1

Go to Agent Settings

Click the settings icon on your agent
2

Navigate to Versions Tab

View all available versions
3

Click Deploy

Click the Deploy button next to the version you want to activate
4

Confirm

This version becomes the “Current” version and handles all requests
Deploying a version immediately affects:
  • API endpoints
  • Embedded chatbots
  • WebSocket connections
Test thoroughly in the Playground before deploying!

Agent Settings

Click the Settings button on any agent to access detailed configuration. The Settings modal has four tabs:

General

Agent Settings General
  • Public Access: Enable WebSocket access for external clients
  • Agent Key: Unique identifier for API/WebSocket connections
  • Origin URL: Allowed domain for public access (CORS)
  • Agent Details: View architecture, entry point, and last update time
When Public Access is enabled, you must specify an allowed origin URL for security.

Access Control

Access Control Settings
Control who can see and use your agent: Share with Company
  • When enabled, other users in your organization can view and use this agent in AMAS
  • Only you (the owner) can modify settings
Show in Atthene
  • When enabled, agent appears in the Atthene frontend interface
  • Works alongside company sharing
Access Summary:
  • AMAS: Shows your agents + shared company agents
  • Atthene: Shows agents with “Show in Atthene” enabled
  • Public Chatbot: Configured via Public Access in General tab

Versions

Version Management
  • View all versions: See complete version history
  • Deploy button: Activate a specific version (makes it “Current”)
  • View Config: Open version’s YAML in Playground
  • Current badge: Shows which version is actively deployed

Statistics

Agent Statistics
View usage metrics for your agent: Overview
  • Total Sessions
  • Total Answer Generations
Token Usage
  • Input Tokens
  • Output Tokens
  • Total Tokens
Averages
  • Answers per Session
  • Tokens per Session
  • Tokens per Answer
Playground preview sessions are not included in these statistics.

Creating New Versions

When you edit a saved agent in the Playground:
1

Click Config on Agent Card

Opens the agent in Playground with current version loaded
Loading Agent
2

Make Your Changes

Edit the YAML configuration as needed
3

Save as New Version

Click Save as New Version button (only appears when editing)
4

Version Created

A new version is automatically created and appears in the Versions tab
The Playground shows a version dropdown when editing an agent. This lets you switch between versions to view their configurations.

Best Practices

Test before deploying: Always test new versions in the Playground before deploying to production
Keep a stable version: Maintain one tested version as “production” while experimenting with new ones
Monitor statistics: Use the Statistics tab to track usage patterns and optimize performance
Check access control: Review who can access your agent before enabling company sharing

Sharing Agents

To share an agent with your organization:
  1. Click Settings on the agent card
  2. Go to Access Control tab
  3. Enable Share with Company
  4. Optionally enable Show in Atthene to make it visible in the Atthene interface
Shared agents are read-only for other users. Only the owner can modify settings or deploy versions.

Common Questions

Q: What happens to my API connections when I deploy a new version? A: They immediately start using the new version. No downtime, but behavior may change based on your config updates. Q: Can I restore a deleted agent? A: No. Deletion is permanent. Make sure you export the YAML configuration if you might need it later. Q: How many versions can I have? A: Unlimited. All versions are stored and accessible.

What’s Next?