Agent Setup

Agents are the AI systems you govern through Koladr. This guide covers registration, API key management, and best practices for organizing your agents.

What is an Agent?

In Koladr, an Agent is any autonomous or semi-autonomous system that performs actions on behalf of your organization. This could be:

• A customer support chatbot that handles tickets and refunds
• A sales assistant that sends follow-up emails
• A data pipeline that updates CRM records
• A monitoring system that creates incident tickets
• Any LLM-powered workflow with real-world side effects

Each agent you register gets its own identity in Koladr. All runs, actions, and incidents from that agent are tracked under its identity, giving you clear visibility into what each agent is doing.

Registering an Agent

To register a new agent:

1. Navigate to Agents in the sidebar
2. Click Register Agent
3. Enter the agent's name and an optional description
4. Click Create

After registration, Koladr assigns a unique agent ID. You will use this ID when initializing the SDK in your agent's code.

Agent Environments

If your agent operates in multiple environments (development, staging, production), you have two approaches:

• Separate agents per environment— register "Support Bot (Dev)" and "Support Bot (Prod)" as distinct agents. This gives you separate run histories and lets you apply different policies per environment.
• Single agent with metadata — use one agent and include the environment in run metadata. This is simpler but gives you less granular policy control.

For production deployments, we recommend separate agents per environment. The overhead is minimal and the operational clarity is significant.

API Keys

API keys authenticate your agent with the Koladr API. Each key is scoped to your workspace and should be assigned to a specific agent or environment.

Creating Keys

1. Go to Settings → API Keys
2. Click Create API Key
3. Give the key a descriptive name (e.g. "support-bot-prod")
4. Copy the key immediately — it is only shown once

Store the key in your environment variables or secrets manager:

KOLADR_API_KEY=kdr_live_abc123...

Rotating Keys

To rotate a key, create a new key first, update your agent's configuration to use the new key, verify the agent is working, then delete the old key. This ensures zero downtime during rotation.

Naming Conventions

Good agent names make your dashboard easier to navigate and your audit trail easier to read. Recommendations:

• Use descriptive names: Refund Processor not Agent 1
• Include the environment if you separate them: Support Bot (Prod)
• Use consistent formatting across your team
• Keep names short but unambiguous

Managing Agents

From the Agents page you can:

• View all registered agents and their status
• See recent run counts and last activity time
• Click into an agent to see its full run history
• Deactivate agents that are no longer in use

Deactivating an agent preserves its history but prevents new runs from being created. You can reactivate it at any time.