Sign inGet Started

CLI dla agentów

bird CLI to pojedynczy plik binarny zaprojektowany do sterowania przez agenta. Wyjście jest domyślnie w formacie JSON, błędy trafiają na stderr, a kody wyjścia wskazują kategorię błędu.

Konfiguracja

Najszybsza droga to skonfigurowanie agenta kodującego: wklej jeden prompt, a agent zainstaluje CLI i umiejętności Bird za Ciebie. Aby zainstalować ręcznie:

Przykład kodu
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login

bird auth login uruchamia w przeglądarce przepływ OAuth i zapisuje uprawnienie powiązane z Twoim obszarem roboczym i jego regionem, więc nie musisz konfigurować klucza API ani hosta. bird auth status zawsze kończy się kodem 0 i zgłasza valid: true, gdy token działa. bird whoami zwraca zalogowanego użytkownika (ID, e-mail i imię), czyli tożsamość, jako którą działa agent i którą zwraca narzędzie MCP whoami. Samo bird auth login prosi o dostęp tylko do odczytu, a Mechanizmy kontroli agenta opisują, co ogranicza agenta, gdy może już wysyłać: klucze o ograniczonym zakresie, idempotentne wysyłki, domyślnie blokującą listę krajów dla SMS, dzienne limity wydatków na SMS i portfel przedpłacony.

Kontrakt

  • JSON na stdout; błędy i diagnostyka na stderr; nigdy razem.
  • Kody wyjścia: sześć semantycznych kodów obejmujących błędne użycie, brak zasobu, uwierzytelnianie, konflikt, błędy przejściowe i ogólny kod rezerwowy. Pełna tabela w CLI.
  • Mutacje przyjmują dane z flag, z treści JSON przez --body-file - (stdin) lub z obu źródeł, przy czym flaga ma pierwszeństwo.
  • --example wypisuje prawidłową treść żądania, --dry-run wyświetla podgląd żądania bez wysyłania, a --idempotency-key sprawia, że ponowna próba jest bezpieczna.

Następne kroki