Tentukan agen Anda

Agen adalah konfigurasi yang dapat digunakan kembali dan memiliki versi yang mendefinisikan persona dan kemampuan. Agen menggabungkan model, system prompt, tools, MCP servers, dan skills yang membentuk perilaku Claude selama sesi.

Buat agen sekali sebagai sumber daya yang dapat digunakan kembali dan referensikan berdasarkan ID setiap kali Anda memulai sesi. Agen memiliki versi dan lebih mudah dikelola di banyak sesi.

Bidang konfigurasi agen

Buat agen

Contoh berikut mendefinisikan agen pengkodean yang menggunakan Claude Sonnet 4.6 dengan akses ke toolset agen pre-built. Toolset memungkinkan agen menulis kode, membaca file, mencari web, dan banyak lagi. Lihat referensi agent tools untuk daftar lengkap tools yang didukung.

agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "Coding Assistant",
    "model": "claude-sonnet-4-6",
    "system": "You are a helpful coding agent.",
    "tools": [{"type": "agent_toolset_20260401"}]
  }')

AGENT_ID=$(jq -r '.id' <<< "$agent")
AGENT_VERSION=$(jq -r '.version' <<< "$agent")

Respons mengulangi konfigurasi Anda dan menambahkan bidang id, version, created_at, updated_at, dan archived_at. version dimulai dari 1 dan bertambah setiap kali Anda memperbarui agen.

{
  "id": "agent_01HqR2k7vXbZ9mNpL3wYcT8f",
  "type": "agent",
  "name": "Coding Assistant",
  "model": {
    "id": "claude-sonnet-4-6",
    "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
}

Perbarui agen

Memperbarui agen menghasilkan versi baru. Teruskan version saat ini untuk memastikan Anda memperbarui dari status yang diketahui.

updated_agent=$(curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "version": $AGENT_VERSION,
  "system": "You are a helpful coding agent. Always write tests."
}
EOF
)

echo "New version: $(jq -r '.version' <<< "$updated_agent")"

Semantik pembaruan

• Bidang yang dihilangkan dipertahankan. Anda hanya perlu menyertakan bidang yang ingin Anda ubah.

• Bidang skalar (model, system, name, dll.) diganti dengan nilai baru. system dan description dapat dihapus dengan melewatkan null. model dan name wajib dan tidak dapat dihapus.

• Bidang array (tools, mcp_servers, skills, callable_agents) sepenuhnya diganti oleh array baru. Untuk menghapus bidang array sepenuhnya, teruskan null atau array kosong.

• Metadata digabungkan di tingkat kunci. Kunci yang Anda berikan ditambahkan atau diperbarui. Kunci yang Anda hilangkan dipertahankan. Untuk menghapus kunci tertentu, atur nilainya ke string kosong.

• Deteksi no-op. Jika pembaruan tidak menghasilkan perubahan relatif terhadap versi saat ini, versi baru tidak dibuat dan versi yang ada dikembalikan.

Siklus hidup agen

Daftar versi

Ambil riwayat versi lengkap untuk melacak bagaimana agen telah berubah seiring waktu.

curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID/versions" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  | jq -r '.data[] | "Version \(.version): \(.updated_at)"'

Arsipkan agen

Pengarsipan membuat agen read-only. Sesi yang ada terus berjalan, tetapi sesi baru tidak dapat mereferensikan agen. Respons menetapkan archived_at ke stempel waktu arsip.

archived=$(curl -fsSL -X POST "https://api.anthropic.com/v1/agents/$AGENT_ID/archive" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01")

echo "Archived at: $(jq -r '.archived_at' <<< "$archived")"

Langkah berikutnya

• Konfigurasi tools untuk menyesuaikan kemampuan mana yang dapat digunakan agen.
• Lampirkan skills untuk keahlian khusus domain.
• Mulai sesi yang mereferensikan agen Anda.