Definieren Sie Ihren Agent

Ein Agent ist eine wiederverwendbare, versionierte Konfiguration, die Persona und Fähigkeiten definiert. Sie bündelt das Modell, den System-Prompt, die Tools, MCP-Server und Skills, die bestimmen, wie sich Claude während einer Sitzung verhält.

Erstellen Sie den Agent einmal als wiederverwendbare Ressource und referenzieren Sie ihn jedes Mal, wenn Sie eine Sitzung starten, anhand seiner ID. Agents werden versioniert und sind leichter über viele Sitzungen hinweg zu verwalten.

Agent-Konfigurationsfelder

Erstellen Sie einen Agent

Das folgende Beispiel definiert einen Coding-Agent, der Claude Opus 4.7 mit Zugriff auf den vordefinierten Agent-Toolset verwendet. Der Toolset ermöglicht es dem Agent, Code zu schreiben, Dateien zu lesen, das Web zu durchsuchen und vieles mehr. Siehe die Agent-Tools-Referenz für die vollständige Liste der unterstützten Tools.

Die Antwort wiederholt Ihre Konfiguration und fügt die Felder id, version, created_at, updated_at und archived_at hinzu. Die version beginnt bei 1 und wird jedes Mal erhöht, wenn Sie den Agent aktualisieren.

{
  "id": "agent_01HqR2k7vXbZ9mNpL3wYcT8f",
  "type": "agent",
  "name": "Coding Assistant",
  "model": {
    "id": "claude-opus-4-7",
    "speed": "standard"
  },
  "system": "You are a helpful coding agent.",
  "description": null,
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "default_config": {
        "permission_policy": { "type": "always_allow" }
      }
    }
  ],
  "skills": [],
  "mcp_servers": [],
  "metadata": {},
  "version": 1,
  "created_at": "2026-04-03T18:24:10.412Z",
  "updated_at": "2026-04-03T18:24:10.412Z",
  "archived_at": null
}

Aktualisieren Sie einen Agent

Das Aktualisieren eines Agents generiert eine neue Version. Übergeben Sie die aktuelle version, um sicherzustellen, dass Sie von einem bekannten Zustand aus aktualisieren.

Aktualisierungssemantik

• Ausgelassene Felder werden beibehalten. Sie müssen nur die Felder einschließen, die Sie ändern möchten.

• Skalarfelder (model, system, name usw.) werden durch den neuen Wert ersetzt. system und description können durch Übergabe von null gelöscht werden. model und name sind erforderlich und können nicht gelöscht werden.

• Array-Felder (tools, mcp_servers, skills, callable_agents) werden vollständig durch das neue Array ersetzt. Um ein Array-Feld vollständig zu löschen, übergeben Sie null oder ein leeres Array.

Agent-Lebenszyklus

Versionen auflisten

Rufen Sie die vollständige Versionshistorie ab, um zu verfolgen, wie sich ein Agent im Laufe der Zeit verändert hat.

Archivieren Sie einen Agent

Das Archivieren macht den Agent schreibgeschützt. Vorhandene Sitzungen werden weiterhin ausgeführt, aber neue Sitzungen können nicht auf den Agent verweisen. Die Antwort setzt archived_at auf den Archivierungszeitstempel.

Nächste Schritte

• Konfigurieren Sie Tools, um anzupassen, welche Funktionen der Agent verwenden kann.
• Fügen Sie Skills an, um domänenspezifisches Fachwissen zu erhalten.
• Starten Sie eine Sitzung, die auf Ihren Agent verweist.