docs / guides / build-an-agent

Een agent bouwen

Maak een persistente persona met eigen system prompt, toon en learning. Drie minuten via de UI of een directe edit van het persona-bestand.

Via de UI

  1. Open http://localhost:8765 en ga naar Agents → New.
  2. Kies een start-template (of begin blanco). De 15 ingebouwde persona's werken allemaal als startpunt.
  3. Edit de system prompt, toon en taal. Voeg domain rules toe: gewogen statements die gedrag begrenzen.
  4. Save. De persona belandt in data/agents/<agent_id>/agent.json.

Door het bestand direct te bewerken

Persona's zijn JSON-bestanden. Je kan een bestaande forken, velden bewerken en Soriku pikt de wijziging op bij de volgende request. Handig voor version control.

cp data/agents/code-architect/agent.json data/agents/my-architect/agent.json
# bewerk het nieuwe bestand
$EDITOR data/agents/my-architect/agent.json
# restart niet nodig, de manager leest on demand

Minimale persona

{
"id": "my-architect",
"slug": "my-architect",
"name": "My Architect",
"role": "reasoning",
"category": "architect",
"persona": {
"tone": "direct",
"language": "auto",
"tagline": "Ontwerpt systemen, stelt harde vragen."
},
"intelligence": {
"system_prompt": "Je bent een software-architect. Wees concreet, benoem trade-offs, prefereer eenvoud.",
"domain_rules": [
{ "rule": "Identificeer altijd de constraint die het ontwerp drijft.", "weight": 1.0 }
]
}
}

Gebruik de persona

Geef x_agent_id mee in chat-requests, of kies de agent in de UI-sidebar. De system prompt en het geheugen van de persona worden automatisch geïnjecteerd.

Volledige persona-schema reference →