# 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.

## Pierwszy bezpieczny odczyt
```bash
logbrew status --json
```

## Kontekst dla asystenta AI
Daj agentowi publiczną mapę LogBrew, zanim zmieni twoją aplikację lub polecenie konfiguracji.

prompt instalacji

```text
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.
```

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

## Krok 1: Przeczytaj publiczną mapę
Wczytaj publiczny indeks tras, zanim zmienisz kod aplikacji, aby asystent zaczynał od aktualnego kontekstu LogBrew.

```bash
curl -L https://logbrew.co/llms.txt
```

Next: Korzystaj z podlinkowanych kopii w Markdown, aby uzyskać więcej publicznego kontekstu.

## 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.

```bash
curl -L https://logbrew.co/en/docs.md
```

Next: Poproś zalogowanego użytkownika, aby otworzył „Dodaj projekt”, skopiował prompt instalacji i nie wklejał poświadczeń wysyłania na czacie.

## Krok 3: Sprawdź lokalny status
Potwierdź dostępność API i źródło uwierzytelnienia, zanim odczytasz prywatne projekty, logi, problemy, akcje, ślady lub wydania.

```bash
logbrew status --json
```

Next: Korzystaj z pola next, które nie ujawnia tokenu, zamiast zgadywać.

## 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.

```bash
logbrew logs info --json
```

Next: Odczytuj problemy, akcje, ślady, wydania i projekty dopiero wtedy, gdy uwierzytelnienie jest gotowe.

## Używaj przewidywalnych publicznych adresów URL
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.

## Zacznij od statusu, który nie ujawnia tokenu
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.

## Preferuj odczyty dla konkretnych zasobów
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.

## Chroń prywatne dane uwierzytelnieniem
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.

## Public agent links
- Agents: https://logbrew.co/pl/agents
- Agents Markdown: https://logbrew.co/pl/agents.md
- Docs Markdown: https://logbrew.co/pl/docs.md
- Home Markdown: https://logbrew.co/pl/page.md
- llms.txt: https://logbrew.co/llms.txt
- Sitemap: https://logbrew.co/sitemap.xml