Core capabilities
Agents
Configurable work roles — combine a model, behavior boundaries, and a set of skills.
What it is
Ottermind Agents are intelligent task executors that receive user instructions and complete work based on their configured model, role, and Skills. Think of an Agent as a configurable work role. By configuring Agents, you set suitable models, behavior boundaries, and available Skills for different tasks, making execution more stable and closer to expectations.
With Agents, you can
- Divide work by creating different Agents for different tasks.
- Control behavior with Role.
- Extend capabilities through Skills.
- Manage models, descriptions, bound Skills, and edit, duplicate, or delete Agents.
Agents are suitable for long-term reuse and clearly defined responsibilities. They are not suitable for one-off, very simple tasks, or tasks with unclear permissions and data scope.
Manage your agents
In the left sidebar of Ottermind, select Agents to view Agents in the current workspace. Each card shows the Agent name, description, default model, bound Skills, and available actions.
| Field | Meaning |
|---|---|
default | The system default Agent. |
Default Model | The model used by this Agent by default. |
Skills | Capability packages available to this Agent. |
Start Task | Start a new task with this Agent. |
Create an agent
Click New Agent to create an Agent. Fill in Name, Description, Default model, and Role, then add Skills as needed.
| Field | Requirement |
|---|---|
| Name | Required. Used to identify the Agent. |
| Description | A short description of the applicable scenario. |
| Default model | Required. Affects speed, cost, and capability limits. |
| Role | Explains who the Agent is, how it should work, and what boundaries it has. |
| Skills | Optional. Determines which capabilities the Agent can use. |
After saving, the new Agent will appear in the Agents list.
Choose a default model
In Default model, choose the model used by the Agent by default. The model affects task speed, cost, and capability limits. Available models and descriptions may change — use the current interface as the source of truth.
Add or remove skills
In the Skills section of the Agent edit page, click +, then search and select Skills to bind. After binding, the Agent will automatically decide whether to use these Skills during tasks.
After removing a Skill, the Agent can no longer use that capability. If the task depends on that Skill, the result may be incomplete or fail.
Edit an agent
Click the Agent, or open the menu in the lower-right corner of the Agent card and choose Edit. You can change the name, description, default model, role, and Skills. Click Save to apply changes.
Usage notes
Role should define responsibilities and boundaries
Role explains the Agent's responsibilities, working style, and limits. Do not write only a generic persona.
Good
You are an assistant for product documentation. Prioritize concise, verifiable usage instructions, and do not invent unconfirmed features.
Bad
You are the strongest assistant and can do anything.
Skills define available capabilities
An Agent can only use Skills that are both bound and enabled. Binding too many Skills may increase the risk of misuse; binding too few may prevent the Agent from completing specific tasks.
Permissions and data security
An Agent may access files, call external services, or perform actions through bound Skills. Do not bind high-permission Skills to Agents that do not need them. Before handling sensitive data, confirm the data source, access scope, and compliance requirements.
FAQ
Why didn't my Agent use a certain Skill?
The Skill may not be bound, may be disabled, the task description may not match the applicable scenario, or the input may not meet requirements.
Can I delete the default Agent?
The default Agent is a system base Agent. It is generally not recommended to delete or heavily modify it. If you need specialized capabilities, create a new Agent.
What should I do if the result is not as expected?
Check the task description, Role, Default model, and bound Skills. When giving feedback, explain what is wrong, what the correct standard is, and whether you want a revision or a redo.