Creating Agents
This page covers the full agent creation process in detail, including every field in the creation dialog and how to configure agents after creation.
Opening the Agent Creator
Section titled “Opening the Agent Creator”Create a new agent by opening Agents from the sidebar and clicking New Agent. If you have no agents yet, you can also click Create Your First Agent in the empty state.
The Create Dialog
Section titled “The Create Dialog”The creation dialog has four fields:
Give your agent a descriptive name (up to 50 characters). The name appears on the agent card, in chat headers, and in logs. You can change it later without affecting the agent’s data.
Duplicate names are not allowed — the dialog shows a warning if the name is already taken.
Choose the AI model from a single dropdown. Models are grouped by provider and each entry shows the model name, tier badge (Fast, Balanced, or Powerful), and cost per 1M tokens.
The default model is DeepSeek V3.2 (NVIDIA NIM, free). Free models from NVIDIA NIM and Z.AI are available without any API key. See Model Selection for detailed comparisons.
Avatar
Section titled “Avatar”Pick an avatar for your agent from the avatar picker. Four options are available (blue, gold, green, red). The default is blue. You can change it later from the agent profile dialog.
Personality (SOUL.md)
Section titled “Personality (SOUL.md)”An optional textarea where you can define your agent’s personality, tone, and behavioral rules. Written in plain text or Markdown. This becomes the agent’s system prompt (SOUL.md file).
You can leave this blank during creation and edit it later with the full Personality Editor, which includes a template picker and Markdown preview.
See Personality & System Prompts for writing guidelines and examples.
Creating the Agent
Section titled “Creating the Agent”Click Create Agent. The agent is created immediately — no waiting for containers, downloads, or initialization. You stay on the Agents page, where the new agent appears as a card. Click the Chat button on the card or open Chat from the sidebar to start a conversation.
Configuring After Creation
Section titled “Configuring After Creation”The creation dialog is intentionally lightweight — just name, model, avatar, and personality. Everything else is configured after the agent exists:
- Tools & Plugins — Click the agent card to open the profile dialog, then use the Plugins or Tools tab to enable/disable capabilities.
- Skills — Use the Skills tab in the profile dialog to attach skills from your installed catalog.
- Channels — Open the Channels page from the sidebar to connect the agent to Discord, Telegram, or Slack.
- Scheduling — Open the Automation page from the sidebar to set up cron-based recurring tasks.
- Wallet — Use the Wallet tab in the profile dialog to create a crypto wallet on Base blockchain.
The Agent Card
Section titled “The Agent Card”Each agent on the Agents page is displayed as a card showing:
- Avatar and name
- Model — Clickable link with a ✎ icon to quickly change the model without opening the full profile
- Status badge — “Active” (green) or “Off” (outline)
- Enable/Disable toggle — Switch the agent on or off
- Capabilities summary — Count of active skills and plugins
- Action buttons:
- Chat — Opens a new chat session with this agent (disabled if agent is off)
- Edit Personality (pencil icon) — Opens the Personality Editor dialog
- Tool Permissions (settings icon) — Opens the tool permissions dialog
- Delete (trash icon) — Deletes the agent after confirmation
The Agent Profile Dialog
Section titled “The Agent Profile Dialog”Click anywhere on the agent card (not a button) to open the full profile dialog. It has 8 tabs:
| Tab | Contents |
|---|---|
| Overview | Stats (total tasks, success rate, tokens used, avg response time), model info, creation date, last active, uptime, quick action links |
| Soul | Full Personality Editor with template picker, Markdown editor, and live preview |
| Skills | Toggle skills on/off for this agent. Link to the Skills catalog. |
| Plugins | Toggle plugin modules on/off for this agent. Link to the Plugins page. |
| Tools | Tool permission management — enable/disable individual tool plugins |
| History | Activity log showing tasks, conversations, and automations with status, timestamps, and token usage |
| Channels | View channel connections linked to this agent. Toggle daemon polling. Link to the Channels page. |
| Wallet | Create and manage a crypto wallet on Base blockchain — view address, balances, send USDC |
Changing the Model
Section titled “Changing the Model”You can change an agent’s model at any time without losing conversation history:
- Click the model name (with ✎ icon) on the agent card.
- Select a new model from the dropdown.
- Click Save.
The new model takes effect on the next message.
Deleting an Agent
Section titled “Deleting an Agent”Click the trash icon on the agent card. A confirmation dialog appears: “Are you sure you want to delete {name}? This will remove the agent and its files.” Click Delete to confirm. This action is permanent.