CLI, SDK, dan pustakaant CLI

Scripting dan otomatisasi CLI

Kelola versi sumber daya API sebagai YAML, rangkai perintah ant CLI dalam skrip, dan operasikan sumber daya dari Claude Code.

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

Anda dapat menggunakan CLI untuk mengelola versi sumber daya API seperti skill, agent, environment, atau deployment sebagai file YAML di repositori Anda dan menjaganya tetap sinkron dengan Claude API.

Untuk informasi lebih lanjut tentang sumber daya ini, lihat Managed Agents.

Definisikan agent Anda

Tulis definisi agent ke summarizer.agent.yaml:

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Buat agent
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Catat id dari respons tersebut. Anda akan meneruskannya ke perintah pembuatan session pada langkah selanjutnya.
Simpan summarizer.agent.yaml ke dalam repositori Anda dan jaga agar tetap sinkron dengan API di pipeline CI Anda. Perintah update memerlukan ID agent dan versi saat ini sebagai flag:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Definisikan environment
Sebuah session berjalan di dalam environment, yang mendefinisikan sandbox tempat session tersebut dieksekusi. Tulis definisi environment ke summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Buat environment
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Catat id dari respons tersebut. Anda akan meneruskannya ke perintah pembuatan session pada langkah selanjutnya.
Simpan summarizer.environment.yaml ke dalam repositori Anda dan jaga agar tetap sinkron dengan API di pipeline CI Anda. Perintah update memerlukan ID environment sebagai flag:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Mulai session

Tempelkan id agent dan id environment dari output sebelumnya ke dalam perintah pembuatan session:

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

Output

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

Kirim pesan pengguna

Salin id session 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."}]}'

Baca percakapan
--transform dijalankan terhadap setiap event yang terdaftar, sehingga ini mencetak teks dari setiap pesan secara berurutan. --format auto menggantikan explorer interaktif yang secara default dibuka oleh perintah list di terminal:
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
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.
```
Untuk memantau session saat sedang berjalan, gunakan ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Event ditulis ke stdout saat diterima.

Pola scripting

CLI dirancang untuk dapat dikomposisikan dengan tooling 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 diterapkan secara langsung. Tangkap 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 mendapatkan skalar tanpa tanda kutip. Ekstrak hanya pesan error:

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

Output

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. Dengan CLI yang sudah terinstal dan terautentikasi, Anda dapat meminta Claude Code untuk mengoperasikan sumber daya API Anda secara langsung. Misalnya:

"Daftarkan session agent terbaru saya dan rangkum mana yang mengalami error."
"Unggah setiap PDF di ./reports ke Files API dan cetak ID yang dihasilkan."
"Ambil event untuk session session_01... dan beri tahu saya di mana agent tersebut terhenti."

Claude Code menjalankan perintah shell ke ant, mem-parsing output terstruktur, dan melakukan penalaran atas hasilnya (tidak diperlukan kode integrasi khusus).

Was this page helpful?

CLI, SDK, dan pustakaant CLI

Scripting dan otomatisasi CLI

Kelola versi sumber daya API sebagai YAML, rangkai perintah ant CLI dalam skrip, dan operasikan sumber daya dari Claude Code.

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 informasi lebih lanjut tentang sumber daya ini, lihat Managed Agents.

Definisikan agent Anda

Tulis definisi agent ke summarizer.agent.yaml:

summarizer.agent.yaml

name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

Buat agent
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Catat id dari respons tersebut. Anda akan meneruskannya ke perintah pembuatan session pada langkah selanjutnya.
Simpan summarizer.agent.yaml ke dalam repositori Anda dan jaga agar tetap sinkron dengan API di pipeline CI Anda. Perintah update memerlukan ID agent dan versi saat ini sebagai flag:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Definisikan environment
Sebuah session berjalan di dalam environment, yang mendefinisikan sandbox tempat session tersebut dieksekusi. Tulis definisi environment ke summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Buat environment
ant beta:environments create < summarizer.environment.yaml
Output
{ "id": "env_01595EKxaaTTGwwY3kyXdtbs", "name": "summarizer-env" /* ... */ }
Catat id dari respons tersebut. Anda akan meneruskannya ke perintah pembuatan session pada langkah selanjutnya.
Simpan summarizer.environment.yaml ke dalam repositori Anda dan jaga agar tetap sinkron dengan API di pipeline CI Anda. Perintah update memerlukan ID environment sebagai flag:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Mulai session

Tempelkan id agent dan id environment dari output sebelumnya ke dalam perintah pembuatan session:

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

Output

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

Kirim pesan pengguna

Salin id session 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."}]}'

Baca percakapan
--transform dijalankan terhadap setiap event yang terdaftar, sehingga ini mencetak teks dari setiap pesan secara berurutan. --format auto menggantikan explorer interaktif yang secara default dibuka oleh perintah list di terminal:
ant beta:sessions:events list \ --session-id session_01JZCh78XvmxJjiXVy3oSi7K \ --transform 'content.0.text' --format auto --raw-output
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.
```
Untuk memantau session saat sedang berjalan, gunakan ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Event ditulis ke stdout saat diterima.

Pola scripting

CLI dirancang untuk dapat dikomposisikan dengan tooling shell standar.

Merangkai output list ke perintah kedua

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

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

Output

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

Menggunakan CLI dari Claude Code

"Daftarkan session agent terbaru saya dan rangkum mana yang mengalami error."
"Unggah setiap PDF di ./reports ke Files API dan cetak ID yang dihasilkan."
"Ambil event untuk session session_01... dan beri tahu saya di mana agent tersebut terhenti."

Claude Code menjalankan perintah shell ke ant, mem-parsing output terstruktur, dan melakukan penalaran atas hasilnya (tidak diperlukan kode integrasi khusus).

Was this page helpful?