Definisikan agen Anda

Agen adalah konfigurasi yang dapat digunakan kembali dan memiliki versi yang mendefinisikan persona dan kapabilitas. Agen menggabungkan model, prompt sistem, alat, server MCP, dan skill yang membentuk bagaimana 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.



Bidang konfigurasi agen

Anda juga dapat menimpa model, system, tools, mcp_servers, dan skills untuk satu sesi tanpa mengubah agen. Lihat Menimpa konfigurasi agen untuk sebuah sesi.



Membuat agen

Contoh berikut mendefinisikan agen pengkodean yang menggunakan Claude Opus 4.8 dengan akses ke toolset agen bawaan. Toolset ini memungkinkan agen menulis kode, membaca file, mencari di web, dan lainnya. Lihat referensi alat agen untuk daftar lengkap alat yang didukung.

Contoh-contoh ini menggunakan curl, CLI ant, atau salah satu SDK. Jika Anda belum menyiapkannya, quickstart mencakup instalasi dan penyiapan klien.

agent=$(ant beta:agents create \
  --name "Coding Assistant" \
  --model '{id: claude-opus-4-8}' \
  --system "You are a helpful coding agent." \
  --tool '{type: agent_toolset_20260401}' \
  --format json)

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

Respons akan mengembalikan konfigurasi Anda dan menambahkan bidang id, type, version, created_at, updated_at, dan archived_at. version dimulai dari 1 dan bertambah setiap kali pembaruan mengubah agen.

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

default_config pada toolset menunjukkan kebijakan izin default-nya, always_allow, yang berlaku kecuali Anda mengonfigurasinya.



Memperbarui agen

Memperbarui agen menghasilkan versi baru ketika konfigurasi berubah. Bidang version wajib diisi dan harus cocok dengan versi agen saat ini, sehingga Anda selalu memperbarui dari keadaan yang diketahui. Ketidakcocokan versi mengembalikan 409, dan pembaruan pada agen yang diarsipkan akan ditolak.

ant beta:agents update \
  --agent-id "$AGENT_ID" \
  --version "$AGENT_VERSION" \
  --system "You are a helpful coding agent. Always write tests."



Semantik pembaruan

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

• Bidang skalar (model, system, name, description) diganti dengan nilai baru. system dan description dapat dikosongkan dengan memberikan null. model dan name bersifat wajib dan tidak dapat dikosongkan.

• Bidang array (tools, mcp_servers, skills) sepenuhnya diganti oleh array baru. Untuk mengosongkan bidang array sepenuhnya, berikan null atau array kosong.

• multiagent diganti secara keseluruhan, termasuk daftar agents-nya. Berikan null untuk mengosongkannya.

• Metadata digabungkan pada level key. Key yang Anda berikan akan ditambahkan atau diperbarui. Key yang Anda hilangkan akan dipertahankan. Untuk menghapus key tertentu, atur nilainya ke null.

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

• Daftar koordinator tidak diperbarui. Koordinator yang mereferensikan agen ini dalam daftar multiagent.agents mereka tetap menggunakan versi yang disematkan saat koordinator dibuat atau terakhir diperbarui, bahkan jika referensi tersebut menghilangkan version. Untuk mendelegasikan ke versi baru, perbarui koordinator agar daftarnya mereferensikan versi tersebut.



Siklus hidup agen



Mencantumkan versi

Ambil riwayat versi lengkap untuk melacak bagaimana agen telah berubah dari waktu ke waktu. Hasilnya dipaginasi, dan contoh SDK mengambil setiap halaman secara otomatis.

ant beta:agents:versions list --agent-id "$AGENT_ID"



Mengarsipkan agen

Pengarsipan menjadikan agen hanya-baca dan tidak dapat dibatalkan. Sesi yang sudah ada tetap berjalan, tetapi sesi baru tidak dapat mereferensikan agen tersebut. Respons mengatur archived_at ke timestamp pengarsipan.

ant beta:agents archive --agent-id "$AGENT_ID"



Langkah selanjutnya