Loading...
  • Bangun
  • Admin
  • Model & harga
  • Client SDK
  • Referensi API
Search...
⌘K
Log in
Mulai Cepat
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Bangun/Langkah pertama

Mulai dengan Claude Managed Agents

Buat agen otonom pertama Anda.

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

Konsep inti

ConceptDescription
AgentThe model, system prompt, tools, MCP servers, and skills
EnvironmentConfiguration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure
SessionA running agent instance within an environment, performing a specific task and generating outputs
EventsMessages exchanged between your application and the agent (user turns, tool results, status updates)

Prasyarat

  • Akun Console Anthropic
  • Kunci API

Instal CLI

Periksa instalasi:

ant --version

Instal SDK

Tetapkan kunci API Anda sebagai variabel lingkungan:

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

Buat sesi pertama Anda

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

  1. 1

    Buat agen

    Buat agen yang mendefinisikan model, system prompt, dan alat yang tersedia.

    ant beta:agents create \
      --name "Coding Assistant" \
      --model '{id: claude-opus-4-7}' \
      --system "You are a helpful coding assistant. Write clean, well-documented code." \
      --tool '{type: agent_toolset_20260401}'

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

    Simpan agent.id yang dikembalikan. Anda akan merujuknya di setiap sesi yang Anda buat.

  2. 2

    Buat lingkungan

    Lingkungan mendefinisikan kontainer tempat agen Anda berjalan.

    ant beta:environments create \
      --name "quickstart-env" \
      --config '{type: cloud, networking: {type: unrestricted}}'

    Simpan environment.id yang dikembalikan. Anda akan merujuknya di setiap sesi yang Anda buat.

  3. 3

    Mulai sesi

    Buat sesi yang merujuk agen dan lingkungan Anda.

    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 streaming respons

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

    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:
                        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 akan menulis skrip Python, mengeksekusinya di dalam kontainer, dan memverifikasi bahwa file output telah dibuat. Output Anda akan terlihat 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.

Yang terjadi

Saat Anda mengirim event pengguna, Claude Managed Agents:

  1. Menyediakan kontainer: Konfigurasi lingkungan Anda menentukan cara pembuatannya.
  2. Menjalankan loop agen: Claude memutuskan alat mana yang akan digunakan berdasarkan pesan Anda
  3. Mengeksekusi alat: Penulisan file, perintah bash, dan panggilan alat lainnya berjalan di dalam kontainer
  4. Melakukan streaming event: Anda menerima pembaruan real-time saat agen bekerja
  5. Menjadi idle: Agen memancarkan event session.status_idle ketika tidak ada lagi yang perlu dilakukan

Langkah selanjutnya

Definisikan agen Anda

Buat konfigurasi agen yang dapat digunakan kembali dan berversi

Konfigurasi lingkungan

Sesuaikan pengaturan jaringan dan kontainer

Alat agen

Aktifkan alat tertentu untuk agen Anda

Event dan streaming

Tangani event dan arahkan agen di tengah eksekusi

Was this page helpful?

  • Konsep inti
  • Prasyarat
  • Instal CLI
  • Instal SDK
  • Buat sesi pertama Anda
  • Yang terjadi
  • Langkah selanjutnya