Scripting dan otomatisasi CLI

Halaman ini membahas alur kerja berorientasi tugas yang dibangun di atas CLI ant. Untuk flag dan opsi output yang mendasarinya, lihat Menggunakan CLI.

Mengelola versi sumber daya API

Untuk menyimpan agen, lingkungan, dan sumber daya Claude Managed Agents lainnya sebagai file di repositori Anda, lihat Mengelola sumber daya sebagai kode dengan ant apply.

Menjalankan agen yang telah diterapkan dari shell

Setelah agen dan lingkungan tersedia, Anda dapat menjalankan sesi dari shell:

1. 1

   Memulai sesi

   Berikan ID agen dan ID lingkungan ke perintah pembuatan sesi. Setelah ant apply, baca ID tersebut dari claude-lock.json: setiap entri di bawah resources memiliki id, dan untuk proyek di Mengelola sumber daya sebagai kode dengan ant apply entrinya adalah ./agents/summarizer.md dan ./environments/cloud.yaml.

   ant beta:sessions create \
     --agent agent_011CYm1BLqPXpQRk5khsSXrs \
     --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
     --title "Summarization task"

   

   Output

   

   {
     "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
     "status": "running"
     /* ... */
   }

2. 2

   Kirim pesan pengguna

   Salin id sesi dari output sebelumnya ke --session-id:

   ant beta:sessions:events send \
     --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
     --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

   
3. 3

   Baca percakapan

   Setelah agen membalas, tampilkan daftar event. --transform dijalankan terhadap setiap event yang terdaftar, sehingga perintah ini mencetak teks dari setiap pesan secara berurutan. --format auto menggantikan penjelajah interaktif yang secara default dibuka oleh perintah list di terminal:

   ant beta:sessions:events list \
     --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
     --transform 'content.0.text' \
     --raw-output \
     --format auto

   

   Output

   

   Summarize the benefits of type safety in one sentence.
   Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.

Pola scripting

CLI dirancang agar dapat dikombinasikan dengan perangkat shell standar.

Merangkai output list ke perintah kedua

--transform id --raw-output pada endpoint list menghasilkan satu ID polos per baris, sehingga alat standar seperti head dan xargs dapat langsung diterapkan. Ambil hasil pertama, lalu teruskan ke perintah lanjutan:

FIRST_AGENT=$(ant beta:agents list --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl

Memeriksa error

Flag --transform-error dan --format-error menerapkan pemfilteran yang sama pada respons error. --raw-output tidak berlaku untuk error, jadi gunakan --format-error yaml untuk skalar tanpa tanda kutip. Ekstrak hanya pesan error-nya:

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Menggunakan CLI dari Claude Code

Claude Code dapat menggunakan CLI ant secara langsung tanpa konfigurasi tambahan. Dengan CLI yang sudah terinstal dan terautentikasi, Anda dapat meminta Claude Code untuk mengoperasikan sumber daya API Anda secara langsung. Misalnya:

• "Tampilkan daftar sesi agen terbaru saya dan rangkum mana saja yang mengalami error."
• "Unggah setiap PDF di ./reports ke Files API dan cetak ID yang dihasilkan."
• "Ambil event untuk sesi session_01... dan beri tahu saya di mana agen tersebut macet."

Claude Code memanggil ant melalui shell, mem-parsing output terstrukturnya, dan menalar hasilnya (tanpa memerlukan kode integrasi khusus).

Mengautentikasi permintaan curl dengan kredensial CLI

Skrip yang memanggil API dengan curl atau klien HTTP lain dapat menggunakan kredensial yang disimpan oleh ant auth login alih-alih "API key" (kunci API) statis. Token akses OAuth ditempatkan di header Authorization sebagai bearer token; header x-api-key hanya untuk kunci API statis.

ant auth print-credentials --access-token mencetak token akses profil aktif, dengan memperbaruinya terlebih dahulu jika sudah kedaluwarsa atau hampir kedaluwarsa:

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hi"}]
  }'

Jalankan ant auth status untuk memastikan organisasi dan workspace mana yang sedang Anda gunakan untuk login; perintah ini memberi peringatan ketika sebuah variabel environment menimpa login Anda.