Tentukan agen Anda

Pengaturan agen

Agen adalah konfigurasi yang dapat digunakan kembali dan memiliki versi yang mendefinisikan persona dan kemampuan. Agen menggabungkan model, system prompt, tools, server MCP, dan skills yang membentuk cara Claude berperilaku 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.

Semua permintaan Managed Agents API memerlukan header beta managed-agents-2026-04-01. SDK mengatur header beta secara otomatis.

Bidang konfigurasi agen

Bidang	Deskripsi
`name`	Diperlukan. Nama yang dapat dibaca manusia untuk agen.
`model`	Diperlukan. Claude model yang menggerakkan agen. Semua model Claude 4.5 dan yang lebih baru didukung.
`system`	System prompt yang mendefinisikan perilaku dan persona agen. System prompt berbeda dari pesan pengguna, yang harus mendeskripsikan pekerjaan yang akan dilakukan.
`tools`	Tools yang tersedia untuk agen. Menggabungkan pre-built agent tools, MCP tools, dan custom tools.
`mcp_servers`	Server MCP yang menyediakan kemampuan pihak ketiga yang terstandar.
`skills`	Skills yang menyediakan konteks khusus domain dengan pengungkapan progresif.
`callable_agents`	Agen lain yang dapat dipanggil agen ini untuk orkestrasi multi-agen. Ini adalah fitur pratinjau penelitian; minta akses untuk mencobanya.
`description`	Deskripsi tentang apa yang dilakukan agen.
`metadata`	Pasangan kunci-nilai arbitrer untuk pelacakan Anda sendiri.

Buat agen

Contoh berikut mendefinisikan agen pengkodean yang menggunakan Claude Opus 4.7 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.

Untuk menggunakan Claude Opus 4.6 dengan fast mode, teruskan model sebagai objek: {"id": "claude-opus-4-6", "speed": "fast"}.

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-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
}

Perbarui agen

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

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.

Siklus hidup agen

Operasi	Perilaku
Perbarui	Menghasilkan versi agen baru.
Daftar versi	Ambil riwayat versi lengkap untuk melacak perubahan seiring waktu.
Arsipkan	Agen menjadi read-only. Sesi baru tidak dapat mereferensikannya, tetapi sesi yang ada terus berjalan.

Daftar versi

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

Arsipkan agen

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

Langkah berikutnya

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

ant beta:agents create \
  --name "Coding Assistant" \
  --model '{id: claude-opus-4-7}' \
  --system "You are a helpful coding agent." \
  --tool '{type: agent_toolset_20260401}'