Paketstruktur

Jeder Selu-Agent ist ein eigenständiges Verzeichnis oder Git-Repository mit einer klar definierten Struktur. Der Orchestrator liest diese Struktur bei der Installation ein, um den Agenten, seinen System Prompt und eventuelle mitgelieferte Capabilities zu registrieren.

Minimales Layout

Ein Agentenpaket besteht mindestens aus zwei Dateien:

• Ordnermy-agent/

  • agent.yaml
  • agent.md

• agent.yaml: Das maschinenlesbare Manifest. Es enthält Name, Version, Routing-Regeln, Capability-Referenzen und Marketplace-Metadaten des Agenten.
• agent.md: Der System Prompt. Diese Markdown-Datei wird am Anfang jeder LLM-Unterhaltung eingefügt und definiert Persönlichkeit, Anweisungen und Verhaltensgrenzen des Agenten.

Vollständiges Layout mit Capabilities

Die meisten nützlichen Agenten bringen zusätzlich eine oder mehrere Capabilities mit:

• Ordnermy-agent/

  • agent.yaml
  • agent.md
  • Ordnercapabilities/

    • Ordnerweather/

      • manifest.yaml
      • prompt.md
      • Dockerfile
      • Ordnersrc/

        • server.py
    • Ordnercalendar/

      • manifest.yaml
      • prompt.md
      • Dockerfile
      • Ordnersrc/

        • server.go

Jedes Unterverzeichnis in capabilities/ ist eine eigenständige Capability mit eigenem manifest.yaml, optionaler prompt.md, einem Dockerfile und dem benötigten Quellcode.

Aufgaben der Dateien

Datei	Erforderlich	Zweck
agent.yaml	Ja	Metadaten des Agenten, Routing, Capability-Liste, Version
agent.md	Ja	System Prompt, der an das LLM gesendet wird
capabilities/*/manifest.yaml	Pro Capability	Metadaten der Capability, Ressourcenlimits, Parameter
capabilities/*/prompt.md	Nein	Zusätzliche Anweisungen, die an den System Prompt angehängt werden, wenn diese Capability verfügbar ist
capabilities/*/Dockerfile	Pro Capability	Baut das Container-Image für den gRPC-Server der Capability

Konventionen

• Der Name des Wurzelverzeichnisses ist egal. Das Feld name in agent.yaml ist der maßgebliche Bezeichner.
• Capabilities können statt lokal auch per Docker-Image-URI referenziert werden. Details findest du in der agent.yaml-Referenz.
• Halte agent.md fokussiert und unter 2.000 Token. Lange System Prompts erhöhen Latenz und Kosten.

Nächste Schritte

Lies die Detailseiten zu den einzelnen Dateien: agent.yaml, agent.md und Routing und Sessions.