Spezifikation

Agent-Manifest-Spezifikation

Die agent-manifest.json definiert Fähigkeiten, Berechtigungen und Konfiguration Ihres Blueprints.

Feldreferenz

Feld	Typ	Pflicht	Beschreibung
`docs.manifest.fieldNameName`	string	Pflicht	Eindeutiger Bezeichner für den Blueprint (Kebab-Case).
`docs.manifest.fieldVersionName`	string	Pflicht	Semantische Versionszeichenkette (z.B. 1.0.0).
`docs.manifest.fieldDescriptionName`	string	Pflicht	Menschenlesbare Beschreibung der Agentenfunktion.
`docs.manifest.fieldAuthorName`	string	Pflicht	Autorenname oder Organisation.
`docs.manifest.fieldModelName`	object	Pflicht	Modellkonfigurationsobjekt.
`docs.manifest.fieldModelProviderName`	string	Pflicht	KI-Anbieter (z.B. openai, anthropic).
`docs.manifest.fieldModelNameName`	string	Pflicht	Modellname (z.B. gpt-4, claude-3).
`docs.manifest.fieldModelTemperatureName`	number	Optional	Sampling-Temperatur (0.0–2.0).
`docs.manifest.fieldSystemPromptName`	string	Pflicht	Der System-Prompt, der das Agentenverhalten definiert.
`docs.manifest.fieldToolsName`	array	Optional	Array von Tool-Definitionen.
`docs.manifest.fieldToolNameName`	string	Pflicht	Tool-Bezeichner.
`docs.manifest.fieldToolDescriptionName`	string	Pflicht	Was das Tool macht.
`docs.manifest.fieldToolPermissionsName`	array	Pflicht	Von diesem Tool benötigte Berechtigungen.
`docs.manifest.fieldPermissionsName`	array	Optional	Berechtigungsdeklarationen auf oberster Ebene.
`docs.manifest.fieldPermCategoryName`	string	Pflicht	Berechtigungskategorie (Ausführung, Dateisystem, Netzwerk, etc.).
`docs.manifest.fieldPermLevelName`	string	Pflicht	Risikostufe (hoch, mittel, niedrig, keine).
`docs.manifest.fieldPermDescriptionName`	string	Optional	Menschenlesbare Beschreibung der Berechtigung.
`docs.manifest.fieldConfigName`	object	Optional	Laufzeit-Konfigurationsoptionen.
`docs.manifest.fieldConfigMaxTokensName`	number	Optional	Maximale Token pro Anfrage.
`docs.manifest.fieldConfigTimeoutName`	number	Optional	Anfrage-Timeout in Sekunden.
`docs.manifest.fieldConfigRetryName`	number	Optional	Anzahl der Wiederholungsversuche.
`docs.manifest.fieldStatsName`	object	Optional	Erwartete Leistungsstatistiken.
`docs.manifest.fieldStatsHoursSavedName`	number	Optional	Geschätzte eingesparte Stunden pro Nutzung.
`docs.manifest.fieldTagsName`	array	Optional	Array von Tags zur Kategorisierung und Suche.

Vollständiges Beispiel

Eine vollständige agent-manifest.json mit allen gängigen Feldern.

{
  "name": "email-assistant-pro",
  "version": "1.2.0",
  "description": "AI-powered email drafting and management assistant",
  "author": "jane-creator",
  "model": {
    "provider": "openai",
    "name": "gpt-4o",
    "temperature": 0.7
  },
  "system_prompt": "You are a professional email assistant...",
  "tools": [
    {
      "name": "draft_email",
      "description": "Draft a professional email based on context",
      "permissions": ["email:send"]
    },
    {
      "name": "read_inbox",
      "description": "Read and summarize inbox messages",
      "permissions": ["email:read"]
    }
  ],
  "permissions": [
    {
      "category": "email",
      "level": "full",
      "description": "Read and send emails on behalf of the user"
    }
  ],
  "config": {
    "max_tokens": 4096,
    "timeout": 30,
    "retry": 3
  },
  "stats": {
    "estimated_hours_saved": 5
  },
  "tags": ["email", "productivity", "communication"]
}

Best Practices

Semantische Versionierung verwenden

Folgen Sie Semver (MAJOR.MINOR.PATCH), um Änderungen klar zu kommunizieren.

Berechtigungen minimieren

Fordern Sie nur Berechtigungen an, die Ihr Agent tatsächlich benötigt.

Klare Beschreibungen schreiben

Helfen Sie Benutzern zu verstehen, was Ihr Agent tut.

In Sandbox testen

Validieren und testen Sie immer in der Sandbox vor der Veröffentlichung.

Relevante Tags verwenden

Spezifische, durchsuchbare Tags verbessern die Auffindbarkeit.

Zurück zur Dokumentation