Memulai dengan Claude Managed Agents

Panduan ini memandu Anda dalam membuat agen, menyiapkan environment, memulai sesi, dan melakukan streaming respons agen.

Konsep inti

Prasyarat

• Sebuah akun Claude Console
• Sebuah kunci API

Instal CLI

brew install anthropics/tap/ant

VERSION=1.36.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

go install github.com/anthropics/anthropic-cli/cmd/ant@latest

export PATH="$PATH:$(go env GOPATH)/bin"

Periksa instalasi:

ant --version

Instal SDK

pip install anthropic

Atur kunci API Anda sebagai variabel environment:

export ANTHROPIC_API_KEY="your-api-key-here"

Buat sesi pertama Anda

1. 1

   Buat agen

   Buat agen yang mendefinisikan model, "system prompt" (prompt sistem), dan alat yang tersedia.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply coding-assistant.md

   coding-assistant.md

   

   ---
   name: Coding Assistant
   model: claude-opus-5-5
   tools:
     - type: agent_toolset_20260401
   ---
   
   You are a helpful coding assistant. Write clean, well-documented code.

   ant apply mencetak ID agen dan mencatatnya di claude-lock.json. Anda akan mereferensikannya di setiap sesi yang Anda buat.

   Tipe alat agent_toolset_20260401 mengaktifkan set lengkap alat agen bawaan (bash, operasi file, pencarian web, dan lainnya). Lihat Alat untuk daftar lengkap dan opsi konfigurasi per alat.

2. 2

   Buat environment

   Environment mendefinisikan sandbox tempat agen Anda berjalan.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   ant apply environment.yaml

   environment.yaml

   

   # yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
   name: quickstart-env
   config:
     type: cloud
     networking:
       type: limited
       allow_package_managers: true

   ant apply juga mencatat ID environment di claude-lock.json. Untuk membuat agen dan environment dengan satu perintah, berikan kedua file: ant apply coding-assistant.md environment.yaml.

3. 3

   Mulai sesi

   Buat sesi yang mereferensikan agen dan environment Anda.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   session = client.beta.sessions.create(
       agent=agent.id,
       environment_id=environment.id,
       title="Quickstart session",
   )
   
   print(f"Session ID: {session.id}")

4. 4

   Kirim pesan dan lakukan streaming respons

   Buka stream, kirim event pengguna, lalu proses event saat tiba:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

   with client.beta.sessions.events.stream(session.id) as stream:
       # Send the user message after the stream opens
       client.beta.sessions.events.send(
           session.id,
           events=[
               {
                   "type": "user.message",
                   "content": [
                       {
                           "type": "text",
                           "text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
                       },
                   ],
               },
           ],
       )
   
       # Process streaming events
       for event in stream:
           match event.type:
               case "agent.message":
                   for block in event.content:
                       if block.type == "text":
                           print(block.text, end="")
               case "agent.tool_use":
                   print(f"\n[Using tool: {event.name}]")
               case "session.status_idle":
                   print("\n\nAgent finished.")
                   break

   Agen menulis skrip Python, menjalankannya di sandbox, dan memverifikasi bahwa file output telah dibuat. Output Anda akan terlihat mirip seperti ini:

   I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
   [Using tool: write]
   [Using tool: bash]
   The script ran successfully. Let me verify the output file.
   [Using tool: bash]
   fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).
   
   Agent finished.

   

Apa yang terjadi

Saat Anda mengirim event pengguna, Claude Managed Agents:

1. Menyediakan sandbox: Konfigurasi environment Anda menentukan bagaimana sandbox dibangun.
2. Menjalankan loop agen: Claude menentukan alat mana yang akan digunakan berdasarkan pesan Anda.
3. Menjalankan alat: Penulisan file, perintah bash, dan pemanggilan alat lainnya berjalan di dalam sandbox.
4. Melakukan streaming event: Anda menerima pembaruan real-time saat agen bekerja.
5. Menjadi idle: Agen mengeluarkan event session.status_idle ketika tidak ada lagi yang perlu dilakukan.

Bangun aplikasi lengkap

Masing-masing quickstart ini memadukan Claude Managed Agents dengan framework chat populer untuk membuat aplikasi lengkap yang dapat dijalankan. Di setiap quickstart, framework merender antarmuka chat sementara sesi terkelola menjalankan loop agen di sisi server: sesi menyimpan transkrip, menjalankan alat di sandbox, dan melakukan streaming event yang dirender oleh front end.

Langkah selanjutnya