Memulai dengan Claude Managed Agents
Buat agen otonom pertama Anda.
Panduan ini memandu Anda dalam membuat agen, menyiapkan lingkungan, memulai sesi, dan melakukan “streaming” (streaming) respons agen.
Claude Code
Biarkan Claude Code menyiapkan agen Anda untuk Anda
/claude-api managed-agents-onboardKonsep inti
| Konsep | Deskripsi |
|---|---|
| Agen | Model, prompt sistem, alat, server MCP, dan skill |
| Lingkungan | Konfigurasi untuk tempat sesi berjalan: sandbox cloud yang dikelola Anthropic, atau sandbox yang di-hosting sendiri di infrastruktur Anda sendiri |
| Sesi | Instans agen yang sedang berjalan di dalam sebuah environment, melakukan tugas tertentu dan menghasilkan output |
| Event | Pesan yang dipertukarkan antara aplikasi Anda dan agen (giliran pengguna, hasil alat, pembaruan status) |
Sebelum Anda memulai
Buat akun Claude Console
Daftar untuk akun Claude Console, atau masuk ke akun yang sudah Anda miliki.
Pilih cara autentikasi
Masuk dengan CLI direkomendasikan untuk pengembangan lokal.
CLIKunci API
Instal CLI
brew install anthropics/tap/antUntuk lingkungan Linux, unduh biner rilis secara langsung.
VERSION=2.12.1 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 antAnda dapat menemukan semua rilis di halaman rilis GitHub.
Anda juga dapat menginstal CLI dari kode sumber menggunakan
go install, yang memerlukan Go 1.26.10 atau yang lebih baru.go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo installmenempatkan biner di$(go env GOPATH)/bin. Tambahkan direktori tersebut kePATHAnda jika belum ada:export PATH="$PATH:$(go env GOPATH)/bin"Masuk
ant auth loginSetelah login selesai, SDK dan CLI akan mengambil kredensial Anda secara otomatis.
Buat kunci API
Buat kunci API di Claude Console.
Atur variabel lingkungan
SDK dan CLI membaca kunci Anda dari
ANTHROPIC_API_KEY:export ANTHROPIC_API_KEY="your-api-key-here"
Untuk menjalankan contoh CLI, instal CLI:
brew install anthropics/tap/antUntuk lingkungan Linux, unduh biner rilis secara langsung.
VERSION=2.12.1
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 antAnda dapat menemukan semua rilis di halaman rilis GitHub.
Anda juga dapat menginstal CLI dari kode sumber menggunakan go install, yang memerlukan Go 1.26.10 atau yang lebih baru.
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo install menempatkan biner di $(go env GOPATH)/bin. Tambahkan direktori tersebut ke PATH Anda jika belum ada:
export PATH="$PATH:$(go env GOPATH)/bin"Instal SDK
pip install anthropicBuat sesi pertama Anda
Buat agen
Buat agen yang menentukan model, “system prompt” (prompt sistem), dan alat yang tersedia.
CLIant apply coding-assistant.mdcoding-assistant.md--- name: Coding Assistant model: claude-opus-5-5 tools: - type: agent_toolset_20260401 configs: - name: web_search enabled: false - name: web_fetch enabled: false --- You are a helpful coding assistant. Write clean, well-documented code.ant applymencetak ID agen dan mencatatnya diclaude-lock.json. Anda akan mereferensikannya di setiap sesi yang Anda buat.Tipe alat
agent_toolset_20260401mengaktifkan alat agen bawaan (bash, operasi file, pencarian web, dan lainnya). Contoh ini menonaktifkan pencarian web dan pengambilan web karena tugas dalam panduan ini, yaitu menulis skrip Python singkat, tidak menggunakan web. Berikan agen hanya alat yang dibutuhkannya. Lihat Alat untuk daftar lengkap dan opsi konfigurasi per alat.Buat lingkungan
Lingkungan menentukan sandbox tempat agen Anda berjalan. Lingkungan ini menggunakan jaringan
limiteddengan manajer paket diizinkan, sehingga kode yang berjalan di sandbox dapat menjangkau registri paket dan host kode publik. Dengan jaringanlimited, daftarallowed_hostsjuga berlaku untuk pencarian web dan pengambilan web, meskipun keduanya berjalan di luar sandbox. Tanpa host yang tercantum, seperti di lingkungan ini, keduanya tidak mengembalikan halaman atau hasil pencarian. Jika agen Anda sendiri menggunakan alat-alat ini, tambahkan host yang dibutuhkannya ke daftar tersebut.CLIant apply environment.yamlenvironment.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: trueant applyjuga mencatat ID lingkungan diclaude-lock.json. Untuk membuat agen dan lingkungan dengan satu perintah, berikan kedua file:ant apply coding-assistant.md environment.yaml.Mulai sesi
Buat sesi yang mereferensikan agen dan lingkungan Anda.
Pythonsession = client.beta.sessions.create( agent=agent.id, environment_id=environment.id, title="Quickstart session", ) print(f"Session ID: {session.id}")Kirim pesan dan lakukan streaming respons
Buka stream, kirim event pengguna, lalu proses event saat tiba:
Pythonwith client.beta.sessions.events.stream(session.id) as stream: # Kirim pesan pengguna setelah stream terbuka 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", }, ], }, ], ) # Proses event streaming 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.") breakAgen menulis skrip Python, menjalankannya di sandbox, dan memverifikasi bahwa file output telah dibuat. Output Anda akan terlihat mirip dengan 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:
- Menyediakan sandbox: Konfigurasi lingkungan Anda menentukan cara sandbox dibangun.
- Menjalankan loop agen: Claude menentukan alat mana yang akan digunakan berdasarkan pesan Anda.
- Menjalankan alat: Penulisan file, perintah bash, dan panggilan alat lainnya berjalan di dalam sandbox.
- Melakukan streaming event: Anda menerima pembaruan real-time saat agen bekerja.
- Menjadi idle: Agen memancarkan event
session.status_idleketika 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 masing-masing, 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.
Seorang analis riset dalam chat browser yang dibangun dengan Chat SDK dari Vercel. Setiap percakapan adalah satu sesi persisten yang melakukan streaming balasannya sementara feed langsung menampilkan panggilan alat. Mengganti adaptor Chat SDK akan memindahkan handler yang sama ke Slack, Teams, Discord, atau WhatsApp.
Seorang analis spreadsheet dalam chat yang dibangun dari primitif assistant-ui. Sesi menjadi daftar thread, satu reducer mengubah log event sesi menjadi pesan dan kartu alat, dan setiap perintah bash merender gerbang Izinkan/Tolak inline sebelum dijalankan.
Asisten keuangan pribadi dalam chat CopilotKit. Adaptor AG-UI untuk Claude Managed Agents memetakan setiap thread chat ke sesi terkelola dan melakukan streaming balasan token demi token, dan alat kustom merender grafik interaktif secara inline dalam percakapan.
Langkah selanjutnya
Buat konfigurasi agen yang dapat digunakan kembali dan berversi
Sesuaikan pengaturan jaringan dan sandbox
Aktifkan alat tertentu untuk agen Anda
Tangani event dan arahkan agen saat berjalan
Jalankan agen Anda pada jadwal cron berulang
Saring korpus dokumen sekali menjadi wiki pengetahuan, lalu jawab pertanyaan berulang darinya dengan sebagian kecil biaya
Apakah halaman ini membantu?