Agents
User agents in Korras Agents follow a CrewAI-inspired model: each agent has a mission, role, backstory, tools, skills, and a model selection.
Creating an agent
With the Agent Builder
- Open Chat and switch to Build mode
- Describe the agent you want in natural language
- Confirm the builder’s plan as it scaffolds files and attachments
On first turn, the builder typically:
- Creates and activates a recipe
- Creates and activates a task pack
- Scaffolds workspace files (
mission.md,role.md,backstory.md) - Attaches catalog tools and skills
- Invokes the Tool Builder if a capability is missing
- Finalizes the agent
Lifecycle
Agents move through a simple lifecycle:
- Draft — still being defined
- Ready — scaffolded and usable
- Archived — retired from active use
Mission, role, and backstory
| File | Purpose |
|---|---|
mission.md | What the agent is responsible for |
role.md | How the agent should behave and decide |
backstory.md | Context that shapes tone and judgment |
Edit these in the agent workspace when you need finer control than the builder’s first draft.
Tools and skills
- Tools — callable capabilities (platform tools or custom MCP tools)
- Skills — reusable markdown instruction libraries
Attach only what the agent needs. Extra tools increase surface area without improving focus.