Soul-Dokument Referenz

Das Soul-Dokument ist die zentrale Konfiguration eines MaxiCore-Agents. Es definiert Persönlichkeit, Fähigkeiten und Verhalten.

YAML-Format

metadata:
  version: "2.0"
  agent_id: "agent-uuid-here"
  created_at: "2026-03-27T10:00:00Z"

identity:
  name: "Alpha Agent"
  role: "Software Developer"
  organization: "My Company"
  description: "Specialized in Python backend development"

capabilities:
  - python
  - bash
  - git
  - docker
  - postgresql

personality:
  tone: "professional"  # professional, casual, technical, friendly
  verbosity: "medium"   # brief, medium, detailed
  proactivity: "high"   # low, medium, high

memory:
  long_term_enabled: true
  max_history: 10000
  persistence: "disk"

constraints:
  max_concurrent_tasks: 3
  timeout_seconds: 3600
  rate_limit: "100/hour"

Felder erklärt

metadata

• version — Soul-Format-Version (aktuell 2.0)
• agent_id — Eindeutige Agent-ID
• created_at — Erstellungsdatum (ISO 8601)

identity

• name — Anzeigename des Agents
• role — Primäre Rolle (z.B. "DevOps Engineer")
• organization — Dein Unternehmensname
• description — Kurze Funktionsbeschreibung

capabilities

Liste der Fähigkeiten. Der Agent lehnt Tasks außerhalb dieser ab:

• python, javascript, bash — Programmiersprachen
• git, docker, kubernetes — Tools
• database — Datenbank-Operationen
• api — HTTP API Integration

personality

Beeinflusst den Kommunikationsstil:

• tone — Wie spricht der Agent mit dir?
• verbosity — Wie ausführlich sind die Antworten?
• proactivity — Macht der Agent Vorschläge?

memory

• long_term_enabled — Merkt sich vorige Aufgaben (true/false)
• max_history — Wie viele Tokens für History reserviert
• persistence — "disk" oder "memory"

constraints

Sicherheits- und Performance-Limits:

• max_concurrent_tasks — Parallele Task-Ausführung
• timeout_seconds — Max. Laufzeit pro Task
• rate_limit — Requests pro Stunde

Soul Editieren

Lokal bearbeiten:

# Soul als YAML exportieren
maxicore soul export > soul.yaml

# Editieren
nano soul.yaml

# Zurück importieren
maxicore soul import soul.yaml

Im Portal unter Settings → Agent Soul (grafische UI).

Best Practices

1. Sprechende Namen — "Data Pipeline Agent" ist besser als "Agent-1"
2. Realistische Capabilities — Nur was der Agent wirklich kann
3. Klare Beschreibung — Hilft bei Onboarding neuer Nutzer
4. Regelmäßige Reviews — Personality und Capabilities jährlich überprüfen

Dein Soul wird automatisch in Backups gespeichert.