LogBrew dla agentów

Ta strona wyjaśnia, jak agenci powinni czytać LogBrew bez stanu przeglądarki, ukrytego kontekstu i prywatnego dostępu do pulpitu.

Czytaj w Markdown
Pierwszy bezpieczny odczyt
logbrew status --json

Zacznij od lokalnego statusu. Logi, problemy, akcje, ślady, wydania i projekty czytaj dopiero wtedy, gdy uwierzytelnienie i dostępność są potwierdzone.

Mapa zadań agenta

Trzymaj się tej kolejności, gdy asystent pomaga skonfigurować LogBrew lub czytać prywatne sygnały.

  1. Krok 1

    Przeczytaj publiczną mapę

    Wczytaj publiczny indeks tras, zanim zmienisz kod aplikacji, aby asystent zaczynał od aktualnego kontekstu LogBrew.

    curl -L https://logbrew.co/llms.txt
    Korzystaj z podlinkowanych kopii w Markdown, aby uzyskać więcej publicznego kontekstu.
  2. Krok 2

    Wybierz kartę SDK

    Przeczytaj wybór SDK, zanim cokolwiek zainstalujesz, a potem użyj opcji „Kopiuj prompt instalacji” w oknie „Dodaj projekt”, aby asystent trzymał się wybranej platformy.

    curl -L https://logbrew.co/en/docs.md
    Poproś zalogowanego użytkownika, aby otworzył „Dodaj projekt”, skopiował prompt instalacji i nie wklejał poświadczeń wysyłania na czacie.
  3. Krok 3

    Sprawdź lokalny status

    Potwierdź dostępność API i źródło uwierzytelnienia, zanim odczytasz prywatne projekty, logi, problemy, akcje, ślady lub wydania.

    logbrew status --json
    Korzystaj z pola next, które nie ujawnia tokenu, zamiast zgadywać.
  4. Krok 4

    Sprawdź pierwszy sygnał

    Gdy konfiguracja wyśle bezpieczny sygnał z SDK, odczytaj jeden ograniczony wynik i nie umieszczaj tokenów, plików cookie ani danych projektu w promptach.

    logbrew logs info --json
    Odczytuj problemy, akcje, ślady, wydania i projekty dopiero wtedy, gdy uwierzytelnienie jest gotowe.

Daj agentowi publiczną mapę LogBrew, zanim zmieni twoją aplikację lub polecenie konfiguracji.

curl -L https://logbrew.co/llms.txt
Przeczytaj https://logbrew.co/llms.txt, a potem wybierz pasującą kartę SDK na https://logbrew.co/en/docs#docs-sdk-choice-title. Użyj npm install @logbrew/sdk @logbrew/node tylko dla usługi Node.js działającej po stronie serwera. Dla Next.js, React, iOS, Android lub React Native użyj wybranej karty i promptu z okna „Dodaj projekt”. Poproś zalogowanego użytkownika, aby otworzył „Dodaj projekt” i umieścił poświadczenia tylko w środowisku pasującej aplikacji. Dla Node.js po stronie serwera zmienna środowiskowa to LOGBREW_SERVER_API_KEY. Uruchom node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs tylko dla usług Node, a potem sprawdź wynik poleceniem logbrew logs info --json. Nie proś o poświadczenia na czacie ani w commitach.

Agenci powinni znajdować publiczny kontekst LogBrew przez stałe, przetłumaczone strony, kopie w Markdown, llms.txt, robots.txt i sitemap.xml.

  • Używaj /en/agents.md, gdy zwykły tekst jest najbezpieczniejszym wejściem.
  • Używaj /en/docs.md, aby poznać polecenia i trasy API.
  • Używaj /llms.txt, aby znaleźć publiczne zasoby czytelne dla agentów.

CLI powinno informować agentów, czy lokalne uwierzytelnienie, dostępność API i kroki naprawcze są gotowe, bez ujawniania tokenu.

  • Uruchom logbrew status --json przed odczytem projektów.
  • Wykonuj następne kroki z wyjścia JSON i wyjścia dla ludzi zamiast zgadywać.
  • Nie umieszczaj tokenów w promptach, logach, zrzutach ekranu ani na publicznych stronach.

Agenci powinni czytać logi, problemy, akcje, ślady, wydania i projekty, używając tego samego słownictwa zasobów co ludzie.

  • Używaj filtrów wydania, środowiska, projektu, śladu, ważności, statusu, nazwy i użytkownika.
  • Używaj tras szczegółów problemu i śladu, gdy znasz identyfikator.
  • Używaj kopii w Markdown dla publicznego kontekstu, a uwierzytelnionego API dla prywatnych danych projektu.

Korzystaj z publicznej dokumentacji, aby poznać produkt. Prywatne dane projektu odczytuj przez uwierzytelnione zapytania.

  • Nie pobieraj automatycznie danych z pulpitu bez ważnej sesji użytkownika.
  • Nie publikuj prywatnych nazw projektów, tokenów, śladów ani szczegółów wdrożeń.
  • Korzystaj z publicznych stron do ogólnej nauki, a z uwierzytelnionych tras do ograniczonych danych użytkownika.