Skip to main content

Agents

An agent in DAEMI is more than a model configuration. It's a persistent entity with a name, a role, a personality, a memory, and a set of tools it can use to act in the world.


What Makes an Agent

Every agent is defined by a YAML profile — a single file that describes everything DAEMI needs to bring it to life.

FieldPurpose
agent_idUnique identifier, used for memory collection naming, routing, API calls
nameDisplay name in the Console
roleOne-line description of what this agent does
personalityTone, traits, and behavioral tendencies
memory.transfer_policyHow memories flow from session to session
llmLLM provider override (defaults to system setting if enabled: false)

Anatomy of a Profile

agent_id: koda
name: Koda
role: Coding Agent
personality:
tone: focused, pragmatic
traits:
- high conscientiousness
- detail-oriented
- direct communicator
memory:
transfer_policy: carry_all
llm:
enabled: false # use system default provider

This is a complete, valid profile. DAEMI will:

  1. Load it at startup
  2. Initialize memory store entries for koda
  3. Make it available in the Console as a selectable agent
  4. Apply the personality to every LLM prompt involving this agent

How Agents Run

When you start a session with an agent:

  1. Profile loads — personality, role, and memory policy are read
  2. LTM query — DAEMI searches the agent's LTM for context relevant to your first message
  3. STM initializes — a fresh short-term memory context begins for this session
  4. Conversation begins — each turn writes to STM; the agent can call tools via the tool graph
  5. Session ends — STM is distilled into LTM based on transfer_policy

Agents vs. Teams

A standard agent operates on its own. A team is a special agent type that orchestrates multiple member agents toward a shared goal.

# Standard agent
agent_id: koda
type: agent # default, can be omitted

# Team
agent_id: tema
type: team
members:
- role: Frontend
name: Rona
- role: Backend
name: Baca

From the Console's perspective, teams and agents look the same — you start a session and talk. Internally, DAEMI handles the orchestration.

→ See Teams for multi-agent orchestration details.


Go Deeper