Skip to content

Agent Management

Commands for creating, updating, enabling, disabling, and removing agents via the CLI.

List all agents with their status, tool count, and channel count.

Terminal window
evonic agent list

Output:

ID Name Status Tools Channels
-------------------------------------------------
siwa Siwa Miwa enabled 10 1
claimg ClaimGuard enabled 7 0

Show detailed information about a specific agent.

Terminal window
evonic agent get siwa

Output:

ID: siwa
Name: Siwa Miwa
Description: Super agent
Status: enabled
Super: yes
Model: moonshotai/kimi-k2-thinking
System Prompt: Kamu adalah super agent Siwa Miwa...
Tools (10):
- bash
- calculator
- patch
...
Channels (1):
- Mirai

Create a new agent. Optionally apply a skillset template for pre-configured tools and prompt.

Terminal window
evonic agent add <agent_id> --name <name> [--description <desc>] [--model <model>] [--skillset <skillset_id>]
FlagRequiredDescription
--nameYesDisplay name for the agent
--descriptionNoShort description
--modelNoModel override
--skillsetNoSkillset template ID (pre-configures tools & prompt)

Example:

Terminal window
# Basic agent
evonic agent add my_bot --name "My Bot"
# Agent from skillset template
evonic agent add dev_bot --name "Dev Bot" --skillset coder --description "Coding assistant"

Output:

Agent created: Dev Bot (dev_bot)
Applied skillset: coder

Enable a disabled agent.

Terminal window
evonic agent enable my_bot

Output:

Agent enabled: my_bot

Disable an agent so it stops processing messages. Super agent cannot be disabled.

Terminal window
evonic agent disable my_bot

Output:

Agent disabled: my_bot

Permanently remove an agent. Requires interactive confirmation.

Terminal window
evonic agent remove my_bot

Output:

Agent to remove:
ID: my_bot
Name: My Bot
Status: enabled
Are you sure? [y/N]: y
Agent removed: my_bot