CLI untuk agen
bird CLI adalah satu binary yang dibuat untuk dijalankan oleh agen. Output berupa JSON secara default, error dikirim ke stderr, dan exit code membawa kategori kegagalan.
Persiapan
Cara tercepat adalah menyiapkan coding agent Anda: tempel satu prompt dan agen Anda menginstal CLI beserta skill Bird untuk Anda. Untuk menginstal secara manual:
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth loginbird auth login menjalankan alur OAuth di browser dan menyimpan grant yang terikat pada workspace Anda dan region-nya, sehingga Anda tidak perlu mengonfigurasi key atau host API. bird auth status selalu keluar dengan 0 dan melaporkan valid: true setelah token berfungsi. bird whoami mengembalikan pengguna yang sedang masuk (ID, email, dan nama), yaitu identitas yang digunakan agen saat bertindak dan yang dikembalikan oleh tool MCP whoami. bird auth login tanpa opsi tambahan meminta akses baca saja, dan Kontrol agen mencantumkan hal-hal yang membatasi agen setelah agen dapat mengirim: key dengan cakupan terbatas, pengiriman idempoten, daftar negara SMS yang ditolak secara default, batas pengeluaran SMS harian, dan dompet prabayar.
Kontrak
- JSON ke stdout; error dan diagnostik ke stderr; tidak pernah tercampur.
- Exit code: enam kode semantik mencakup usage, not-found, auth, conflict, kegagalan sementara, dan fallback umum. Lihat tabel lengkapnya di CLI.
- Mutasi menerima input dari flag, body JSON melalui
--body-file -(stdin), atau keduanya, dengan flag yang diutamakan. --examplemencetak body request yang valid,--dry-runmenampilkan pratinjau request tanpa mengirimnya, dan--idempotency-keymembuat percobaan ulang menjadi aman.
Langkah selanjutnya
- Siapkan coding agent Anda: tempel satu prompt dan agen Anda menginstal CLI beserta skill.
- Skill agen: apa yang diajarkan setiap skill kepada agen Anda.
- Referensi CLI: setiap command, flag, dan bentuk output.
- Server MCP: surface Bird yang sama dengan tool MCP, untuk agen yang memanggil tool alih-alih menjalankan shell.
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.