Umiejętności agenta

Bird publikuje umiejętności agenta (agent skills): spakowane pliki procedur, które uczą agenta kodującego przepływów pracy bird CLI. Umiejętność przekazuje agentowi ścieżkę sukcesu operacji, sprawdzenia stanu do wykonania w pierwszej kolejności oraz pułapki marnujące iteracje pętli. Te wskazówki pomagają agentowi trafić na poprawne polecenie bez odkrywania na nowo 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, do którego następnie logujesz się raz 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 wymaganiem uwierzytelnienia nie mają żadnej 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 per klient 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, następnie codex plugin add bird@bird-ai. W GitHub Copilot uruchom copilot plugin marketplace add messagebird/bird-ai, następnie copilot plugin install bird@bird-ai. Factory Droid nie ma formatu pluginu do odczytania: sklonuj messagebird/bird-ai i skopiuj oba katalogi umiejętności z plugins/bird/skills/ do .factory/skills/ ręcznie.

Umiejętności

W pluginie dostępne są dwie umiejętności.

bird-cli to umiejętność ogólna. Kieruje żądanie do jednej referencji na grupę poleceń CLI, dzięki czemu agent ładuje stronę odpowiadającą operacji, którą właśnie wykonuje, i nic więcej. Jej tablica routingu obejmuje wysyłanie i sprawdzanie wiadomości na każdym kanale obsługiwanym przez Bird, konfigurację wymaganą przez każdy kanał przed wysyłką, 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. Plik SKILL.md umiejętności zawiera tę tabelę i jest źródłem prawdy: ta strona celowo jej nie kopiuje, ponieważ druga kopia to kopia, która się dezaktualizuje.

Każdy wpis dzieli jeden nawyk warty wspomnienia tutaj, ponieważ to ten, w którym agenty się mylą: wysłanie zwraca 202 ze status: accepted, co oznacza, że Bird przyjął wiadomość i dostarczenie jest wciąż w toku. Umiejętności uczą agenta odczytać wiadomość ponownie, aby poznać ostateczny wynik, zamiast ogłaszać sukces przy accepted.

email-audit to umiejętność specjalistyczna. Uruchamia bird email tools audit <domain>, aby rozwiązać i ocenić aktywne rekordy DMARC, SPF, DKIM, BIMI i MX domeny, a następnie odczytuje znaleziska oznaczone poziomem ważności jako priorytetyzowaną listę poprawek. Jest oparta wyłącznie na DNS, więc nie wymaga uwierzytelnienia i nie wysyła żadnych e-maili.

Wspólne wymaganie: najpierw uwierzytelnienie

Prawie każda operacja trafia do działającego API Bird, więc bird-cli rozpoczyna każdą z nich od potwierdzenia poświadczeń za pomocą bird auth status. Sprawdzenie jest idempotentne i nie robi nic, gdy CLI już raportuje valid: true, więc jest bezpieczne do uruchamiania za każdym razem na początku. Bez tego brak logowania wygląda identycznie jak rzeczywisty błąd API i może skierować agenta na niewłaściwą ścieżkę debugowania.

Wyjątkami są operacje, które odczytują coś publicznego, a nie Twój workspace: email-audit rozwiązuje DNS, a wyszukiwanie w dokumentacji odczytuje opublikowaną dokumentację. Ż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 brakuje poświadczeń, umiejętność kieruje agenta przez bird auth login i z powrotem do zadania. Uwierzytelnienie odbywa się przez przeglądarkę, z przepływem device-code dla hostów bez interfejsu graficznego, więc przepływ pracy nie zatrzymuje się na prośbie o uwierzytelnienie.

Błędy ujawniają się wszędzie tak samo

Ponieważ każda operacja jest cienką warstwą nad działającym API, błędy wracają przez jednolity kontrakt CLI, a nie przez obsługę błędów per-umiejętność:

JSON domyślnie: Sukcesy wypisują ustrukturyzowany JSON na stdout, a błędy trafiają na stderr, więc pętla agenta może parsować wyniki bez wyciągania informacji z prozy.
Semantyczne kody wyjścia: jeden z sześciu kodów informuje agenta o kategorii błędu, zanim odczyta komunikat. Zobacz pełną tabelę w CLI. Agent rozgałęzia się na podstawie kategorii bez parsowania komunikatu: wyjście 4 oznacza ponowne uruchomienie kroku uwierzytelnienia, a wyjście 3 oznacza, że ID zasobu jest błędne, 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, jak używać istniejącego kontraktu. Zobacz CLI dla agentów, aby poznać pełny kontrakt, w tym formaty wyjścia i konfigurację.

Komponowanie umiejętności w pętlę agenta

Ponieważ każda referencja to jedna samosprawdzająca się operacja z odczytywalnym maszynowo wynikiem, komponują się w pętlę bez kodu łączącego. Na przykład „wyślij e-mail o premierze i potwierdź, że dotarł" rozkłada się następująco:

Uwierzytelnienie: Uruchom bird auth status; logowanie tylko w razie potrzeby.
Znajdź nadawcę: Użyj referencji domen, aby wybrać adres from na zweryfikowanej domenie. Wyjście 0 plus zweryfikowana domena w JSON oznacza, ż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_…> dopóki liczniki nie pokażą delivered. Jeśli pokażą bounced, zgłoś błąd.

Warunek „gotowe gdy" każdego kroku jest sprawdzalny na podstawie wyjścia JSON poprzedniego kroku, i to właśnie sprawia, że pętla jest niezawodna: agent nigdy nie musi wnioskować o stanie z prozy.

Umiejętności, plugin i MCP

Umiejętności to jeden z trzech sposobów skierowania agenta na Bird i nakładają się na siebie, zamiast ze sobą konkurować:

bird CLI to powierzchnia wykonawcza. Umiejętności zakładają agenta zdolnego do pracy z powłoką, który może je uruchamiać.
Serwer MCP to alternatywa dla agentów, które wywołują narzędzia zamiast uruchamiać polecenia; operacje są równoważne, różni się transport.
Onboarding AI to prowadzona ścieżka konfiguracji, która podłącza dowolne z powyższych w kilka minut.

To, czy instalacja pluginu konfiguruje również serwer MCP, zależy od klienta. Claude Code pozwala pluginowi zadeklarować zdalny serwer MCP, więc instalacja bird-ai tam rejestruje https://mcp.bird.com za Ciebie. Pozostałe klienty obsługują zdalny MCP, ale ich pluginy nie mogą wstępnie zadeklarować serwera. W Cursor, Codex i Copilot plugin instaluje umiejętności; w Droid kopiujesz pliki umiejętności ręcznie. Każdy klient poza Claude Code wymaga ręcznego dodania serwera, używając jednoliniowej konfiguracji w przewodniku po serwerze MCP.

Żaden plugin nie może uwierzytelnić się za Ciebie. Hostowany serwer jest chroniony przez OAuth, więc w każdym kliencie, w tym 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ą widoczne, ale każde wywołanie kończy się błędem. Kroki uwierzytelnienia per klient opisują resztę.

Klient	Umiejętności przez plugin	Serwer MCP zarejestrowany	Logowanie
Claude Code	Tak	Tak, zadeklarowany 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

Następne kroki

Skonfiguruj swojego agenta kodującego: konfiguracja jednym promptem, która instaluje plugin za Ciebie.
Serwer MCP: powierzchnia narzędziowa dołączona do pluginu i sposób ręcznego dodania.
CLI dla agentów: powierzchnia poleceń, której uczą umiejętności, dla agentów zdolnych do pracy z powłoką.
Onboarding AI: prowadzona, kompleksowa konfiguracja z podłączonym korpusem dokumentacji.