Agent odpowiadający na pytanie dotyczące API może potrzebować jednego przewodnika po uwierzytelnianiu i jednego opisu endpointu. Załadowanie całej strony dostarcza też materiały niezwiązane z tym zadaniem.
Propozycja llms.txt daje wydawcom miejsce do opisania swoich treści i linkowania do przydatnych stron Markdown.
Co zawiera plik?
Plik zawiera nazwę projektu i może obejmować podsumowanie, wskazówki oraz pogrupowane linki do dalszych informacji.
Propozycja używa formatu Markdown, dzięki czemu ludzie i programy mogą przetwarzać ten sam plik. Listy linków wskazują treści, które agent może pobrać w razie potrzeby.
Indeks dokumentacji może grupować uwierzytelnianie, wysyłanie wiadomości i zdarzenia dostarczenia pod osobnymi nagłówkami. Krótkie opisy pomagają agentowi rozróżnić te cele przed ich pobraniem.
Propozycja dopuszcza też indeksy poniżej katalogu głównego witryny. Indeks umieszczony w ścieżce dokumentacji obejmuje treści znajdujące się pod tą ścieżką.
Czy to samo co robots.txt lub mapa witryny?
Te pliki służą różnym celom: reguły dostępu, odkrywanie adresów URL i uporządkowana ścieżka do treści.
| Plik | Przeznaczenie |
|---|---|
robots.txt | Podaje automatycznym klientom reguły crawlowania |
| Sitemap | Wymienia adresy URL do odkrycia przez wyszukiwarki |
llms.txt | Opisuje treści i linkuje do przydatnych szczegółów dla agentów |
Porównanie propozycji z istniejącymi standardami opisuje llms.txt jako uzupełnienie pozostałych plików. Opublikowanie go nie daje dostępu do chronionych treści.
Plik nie udostępnia też wykonywalnych akcji. Agent potrzebuje osobnego API lub połączenia MCP, żeby wykonywać operacje w obszarze roboczym.
Czy opublikowanie pliku dowodzi, że agenci z niego korzystają?
Opublikowanie czytelnego indeksu potwierdza dostępność. Dowód użycia wymaga zaobserwowania, że klient pobrał treść i z niej skorzystał.
Audyt Lighthouse w Chrome sprawdza, czy przy pobieraniu pliku nie występują błędy serwera. Brakujący plik otrzymuje wynik „nie dotyczy", ponieważ plik jest opcjonalny. Pozytywny wynik tego testu nie mierzy jakości odpowiedzi agenta.
Na potrzeby własnej ewaluacji zapisuj zadanie i dokumenty, które klient pobrał. Sprawdź, czy agent udzielił poprawnej odpowiedzi lub wykonał zamierzoną akcję. Porównuj równoważne przebiegi, oceniając, czy indeks pomógł.
Żądanie w logu dostępu dowodzi pobrania. Samo w sobie nie dowodzi, że klient wykorzystał treść w swojej odpowiedzi. Cytowanie to jeszcze inna obserwacja. Rozdzielaj te wyniki przy raportowaniu.
Jaką dokumentację Bird przekazać agentowi?
Możesz udostępnić indeks llms.txt Bird, gdy agent musi odkryć dokumentację i pobrać odpowiednie strony.
Przewodnik po dokumentacji w formacie maszynowym opisuje indeks, pojedyncze strony Markdown i pełny korpus. Indeks dostarcza linki; pojedyncze strony pozwalają klientowi uzyskać precyzyjną odpowiedź.
llms-full.txt łączy dokumentację ze źródłowymi adresami URL. Ta większa forma nadaje się do przepływu pracy, który wprost wymaga całego korpusu, z uwzględnieniem limitów kontekstu klienta.
Żeby wykonać zadanie związane z wysyłką wiadomości po pobraniu instrukcji, połącz się z serwerem MCP Bird. Dokumentacja dostarcza informacje; uwierzytelnione połączenie daje dostęp do operacji w obszarze roboczym.