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.

Kontrakt

JSON na stdout; błędy i diagnostyka na stderr; nigdy razem.
Kody wyjścia: sześć semantycznych kodów obejmujących użycie, not-found, auth, konflikt, błędy przejściowe i ogólny fallback. 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 ponowienie jest bezpieczne.

Następne kroki

Skonfiguruj agenta kodującego: wklej prompt, a agent zainstaluje CLI i umiejętności.
Umiejętności agenta: czego każda umiejętność uczy Twojego agenta.
Dokumentacja CLI: każde polecenie, flaga i format wyjścia.
Serwer MCP: ta sama powierzchnia Bird co narzędzia MCP, dla agentów wywołujących narzędzia zamiast uruchamiania powłoki.

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikSetting up your coding agent Zrozum koncepcjęWhat is an MCP server, and how does an agent use one to send messages?Poznaj możliwościCoding agents Podążaj ścieżką naukiBuild with AI agents

Uzyskaj brief wdrożeniowy