Umiejętności agenta

Bird publikuje umiejętności agenta: spakietyzowane pliki procedur, które uczą agenta programistycznego przepływów pracy bird CLI. Umiejętność podaje ścieżkę sukcesu operacji, sprawdzenia stanu do wykonania na początku i pułapki, które marnują iteracje pętli. Te wskazówki pomagają agentowi dojść do poprawnej komendy bez ponownego odkrywania flag i trybów awarii z wyjścia --help.

Dostarczane są jako plugin marketplace bird-ai, jedno źródło, które Claude Code, Cursor, Codex i GitHub Copilot odczytują jako plugin. Factory Droid zamiast tego kopiuje pliki umiejętności ręcznie (zobacz Instalacja pluginu). W Claude Code instalacja pluginu rejestruje również hostowany serwer MCP, w którym następnie logujesz się jednorazowo za pomocą /mcp (zobacz Umiejętności, plugin i MCP).

Każda referencja koduje jedną operację na zadanie. Agent wybiera tę, która pasuje do żądania. Poza wspólnym warunkiem wstępnym uwierzytelniania nie mają ustalonej kolejności.

Instalacja pluginu

Marketplace znajduje się pod adresem messagebird/bird-ai. Plugin jest zgodny ze specyfikacją Agent Plugins, więc klient implementujący tę specyfikację instaluje go z tego repozytorium w obecnej postaci, razem z umiejętnościami i serwerem MCP.

Poniższe kroki dla poszczególnych klientów opisują resztę. W Claude Code uruchom:

Przykład kodu

claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-ai

W Cursor dodaj marketplace i zainstaluj plugin bird z Settings > Plugins. W Codex uruchom codex plugin marketplace add messagebird/bird-ai, a potem codex plugin add bird@bird-ai. W GitHub Copilot uruchom copilot plugin marketplace add messagebird/bird-ai, a potem copilot plugin install bird@bird-ai. Factory Droid nie ma formatu pluginów do odczytu: sklonuj messagebird/bird-ai i ręcznie skopiuj oba katalogi umiejętności z plugins/bird/skills/ do .factory/skills/.

Umiejętności

Plugin zawiera dwie umiejętności.

bird-cli to umiejętność ogólna. Kieruje żądanie do jednej referencji na grupę komend CLI, więc agent ładuje stronę dotyczącą bieżącej operacji i nic więcej. Tablica routingu obejmuje wysyłanie i sprawdzanie wiadomości na każdym kanale, który obsługuje Bird, konfigurację wymaganą przed wysyłką na każdym kanale, weryfikację jednorazowym kodem, wyszukiwanie odbiorców, kontakty i grupy odbiorców, preferencje wiadomości, provisioning Realtime, webhooki, klucze API, zgłoszenia do supportu i wyszukiwanie w dokumentacji. Własny SKILL.md umiejętności zawiera tę tablicę i jest listą źródłową: ta strona celowo jej nie kopiuje, bo druga kopia to kopia, która się dezaktualizuje.

Wszystkie wpisy mają jedną cechę wspólną wartą wymienienia, bo to ta, w której agenty się mylą: wysyłka zwraca 202 z status: accepted, co oznacza, że Bird przyjął wiadomość, a dostarczenie wciąż jest w toku. Umiejętności uczą agenta odczytywać wiadomość ponownie, aby poznać końcowy wynik, zamiast deklarować sukces na etapie accepted.

email-audit to umiejętność specjalistyczna. Uruchamia bird email tools audit <domain>, aby rozwiązać i ocenić na żywo rekordy DMARC, SPF, DKIM, BIMI i MX domeny, a następnie odczytuje oznaczone poziomem istotności wyniki jako priorytetyzowaną listę poprawek. Działa wyłącznie na DNS, więc nie wymaga uwierzytelniania i nie wysyła poczty.

Wspólny warunek wstępny: najpierw się uwierzytelnij

Niemal każda operacja trafia do działającego Bird API, więc bird-cli zaczyna każdą z nich od potwierdzenia poświadczeń za pomocą bird auth status. Sprawdzenie jest idempotentne i nic nie robi, gdy CLI już zwraca valid: true, więc bezpiecznie jest uruchamiać je za każdym razem na początku. Bez niego brakujące logowanie kończy się identycznie jak prawdziwy błąd API i może skierować agenta na złą ścieżkę debugowania.

Wyjątkiem są operacje odczytujące dane publiczne, a nie Twój obszar roboczy: email-audit rozwiązuje DNS, a wyszukiwanie w dokumentacji czyta opublikowane dokumenty. Żadna z nich nie wymaga logowania i żadna nie jest blokowana przez jego brak.

Przykład kodu

bird auth status --format json
# gate on "valid": true, then run the operation

Jeśli poświadczenia są niedostępne, umiejętność kieruje agenta przez bird auth login i z powrotem do zadania. Uwierzytelnianie odbywa się przez przeglądarkę, z przepływem device-code dla hostów bez interfejsu graficznego, więc proces nie zatrzymuje się na monicie o uwierzytelnienie.

Błędy pojawiają się wszędzie w ten sam sposób

Ponieważ każda operacja jest cienką nakładką na działający API, błędy wracają przez jednolity kontrakt CLI, a nie przez obsługę błędów specyficzną dla umiejętności:

Domyślnie JSON: sukcesy wypisują ustrukturyzowany JSON na stdout, a błędy trafiają na stderr, więc pętla agenta może parsować wyniki bez analizowania prozy.
Semantyczne kody wyjścia: jeden z sześciu kodów informuje agenta o kategorii błędu, zanim ten odczyta komunikat. Pełna tabela znajduje się w CLI. Agent rozgałęzia się na podstawie kategorii bez parsowania komunikatu: kod wyjścia 4 oznacza ponowne uruchomienie kroku uwierzytelniania, a kod wyjścia 3 oznacza błędne ID zasobu, więc ponowna próba nie pomoże.

To ten sam kontrakt, który CLI prezentuje ludziom i skryptom. Umiejętności nie dodają żadnej warstwy; uczą agenta korzystać z istniejącego kontraktu. Pełny kontrakt, w tym formaty wyjścia i konfigurację, znajdziesz w CLI dla agentów.

Składanie umiejętności w pętlę agenta

Ponieważ każda referencja to jedna samosprawdzająca się operacja z maszynowo odczytywalnym wynikiem, składają się w pętlę bez kodu łączącego. Na przykład "send the launch email and confirm it delivered" rozkłada się następująco:

Uwierzytelnij: Uruchom bird auth status; zaloguj się tylko w razie potrzeby.
Znajdź nadawcę: Użyj referencji domen, aby wybrać adres from na zweryfikowanej domenie. Kod wyjścia 0 plus zweryfikowana domena w JSON oznaczają, że ten krok jest zakończony; w przeciwnym razie wejdź w pętlę tworzenia i weryfikacji.
Wyślij: Użyj referencji e-mail, aby uruchomić bird email send …. Pomyślne żądanie zwraca 202, ID em_… i status: accepted.
Potwierdź wynik: Użyj ponownie referencji e-mail, aby uruchomić bird email get <em_…>, aż liczniki pokażą delivered. Jeśli pokażą bounced, zgłoś błąd.

Warunek "done when" każdego kroku można sprawdzić na podstawie wyjścia JSON poprzedniego kroku, i to właśnie czyni pętlę niezawodną: agent nigdy nie musi wywnioskować stanu z prozy.

Umiejętności, plugin i MCP

Umiejętności to jeden z trzech sposobów skierowania agenta na Bird i uzupełniają się, zamiast konkurować:

bird CLI to powierzchnia wykonawcza. Umiejętności zakładają agenta z dostępem do powłoki, który może go uruchomić.
Serwer MCP to alternatywa dla agentów, które wywołują narzędzia zamiast uruchamiać komendy; operacje są równoważne, różni się transport.
AI onboarding to prowadzona ścieżka konfiguracji, która pozwala podłączyć dowolną z nich w kilka minut.

To, czy instalacja wtyczki konfiguruje jednocześnie serwer MCP, zależy od klienta. Claude Code pozwala wtyczce zadeklarować zdalny serwer MCP, więc instalacja bird-ai rejestruje https://mcp.bird.com automatycznie. Wtyczka OpenCode również rejestruje serwer: domyślnie https://mcp.bird.com/dynamic lub pełny https://mcp.bird.com przy włączonym eksperymentalnym trybie kodu OpenCode. Pozostałe klienty obsługują zdalne MCP, ale ich wtyczki nie mogą wstępnie zadeklarować serwera. W Cursor, Codex i Copilot wtyczka instaluje umiejętności; w Droid kopiujesz pliki umiejętności ręcznie. Te klienty wymagają ręcznego dodania serwera, korzystając z jednoliniowej konfiguracji opisanej w przewodniku po serwerze MCP.

Żaden plugin nie jest w stanie uwierzytelnić Cię za Ciebie. Hostowany serwer jest chroniony przez OAuth, więc w każdym kliencie, w tym w Claude Code, logujesz się raz po zarejestrowaniu serwera: w Claude Code to /mcp, następnie wybierz bird, a potem Authenticate. Dopóki tego nie zrobisz, narzędzia są wyświetlane, ale każde wywołanie kończy się błędem. Resztę opisują kroki uwierzytelniania dla poszczególnych klientów.

Klient	Umiejętności przez plugin	Zarejestrowany serwer MCP	Logowanie
Claude Code	Tak	Tak, deklarowany przez plugin	Ty: /mcp > bird > Authenticate
Cursor	Tak	Ręcznie, dodaj zdalny serwer raz	Ty: Needs login w Tools & Integrations
Codex	Tak	Ręcznie, dodaj zdalny serwer raz	Ty: codex mcp login bird
GitHub Copilot	Tak	Ręcznie, dodaj zdalny serwer raz	VS Code otwiera przeglądarkę przy pierwszym uruchomieniu
Factory Droid	Ręcznie, skopiuj pliki umiejętności	Ręcznie, dodaj zdalny serwer raz	Ty: /mcp wewnątrz droid
OpenCode	Tak	Tak, deklarowany przez wtyczkę	Ty: opencode mcp auth bird

Następne kroki

Skonfiguruj swojego agenta programistycznego: jednokomendowa konfiguracja, która zainstaluje plugin za Ciebie.
Serwer MCP: powierzchnia narzędziowa dołączona do pluginu i sposób ręcznego dodania.
CLI dla agentów: powierzchnia komend, których uczą umiejętności, dla agentów z dostępem do powłoki.
AI onboarding: prowadzona, kompleksowa konfiguracja z podłączonym korpusem dokumentacji.

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