# LogBrew per gli agenti
Questa pagina spiega come gli agenti devono leggere LogBrew senza stato del browser, contesto nascosto o accesso alla dashboard privata.

## Prima lettura sicura
```bash
logbrew status --json
```

## Contesto per l’assistente AI
Dai a un agente la mappa pubblica di LogBrew prima che modifichi la tua app o il comando di configurazione.

prompt di installazione

```text
Leggi https://logbrew.co/llms.txt, poi scegli la scheda SDK corrispondente in https://logbrew.co/en/docs#docs-sdk-choice-title. Usa npm install @logbrew/sdk @logbrew/node solo per un servizio Node.js lato server; per Next.js, React, iOS, Android o React Native, usa la scheda scelta e il prompt di Aggiungi progetto. Chiedi all'utente che ha effettuato l'accesso di aprire Aggiungi progetto e di inserire le credenziali solo nell'ambiente dell'app corrispondente. Per Node.js lato server, la variabile d'ambiente è LOGBREW_SERVER_API_KEY. Esegui node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs solo per i servizi Node, poi verifica con logbrew logs info --json. Non chiedere credenziali in chat o nei commit.
```

# Mappa delle attività per agenti
Segui questo ordine quando un assistente aiuta uno sviluppatore a configurare LogBrew o a leggere segnali privati.

## Passaggio 1: Leggi la mappa pubblica
Carica l’indice pubblico delle route prima di modificare il codice dell’app, così l’assistente parte dal contesto attuale di LogBrew.

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

Next: Usa le copie Markdown collegate per un contesto pubblico più approfondito.

## Passaggio 2: Scegli la scheda dell’SDK
Leggi il selettore degli SDK prima di installare qualsiasi cosa, poi usa Copia prompt di installazione in Aggiungi progetto, così l’assistente segue la piattaforma scelta.

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

Next: Chiedi all’utente che ha effettuato l’accesso di aprire Aggiungi progetto, copiare il prompt di installazione e tenere le credenziali di ingestione fuori dalla chat.

## Passaggio 3: Controlla lo stato locale
Conferma la raggiungibilità dell’API e l’origine dell’autenticazione prima di leggere progetti, log, problemi, azioni, tracce o release privati.

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

Next: Segui il campo next, che non espone token, invece di tirare a indovinare.

## Passaggio 4: Verifica il primo segnale
Dopo che la configurazione ha inviato un segnale SDK sicuro, leggi un risultato limitato e tieni token, cookie e dati del progetto fuori dai prompt.

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

Next: Leggi problemi, azioni, tracce, release e progetti solo quando l’autenticazione è pronta.

## Usa URL pubblici prevedibili
Gli agenti devono trovare il contesto pubblico di LogBrew tramite pagine localizzate stabili, copie Markdown, llms.txt, robots.txt e sitemap.xml.

- Usa /en/agents.md quando il testo semplice è l’input più sicuro.
- Usa /en/docs.md per il contesto di comandi e route API.
- Usa /llms.txt per scoprire le risorse pubbliche leggibili dagli agenti.

## Parti da uno stato che non espone token
La CLI deve indicare agli agenti se autenticazione locale, raggiungibilità dell’API e passaggi di ripristino sono pronti, senza esporre materiale dei token.

- Esegui logbrew status --json prima di leggere i progetti.
- Segui i prossimi passaggi indicati nell’output JSON e in quello leggibile, invece di tirare a indovinare.
- Tieni il materiale dei token fuori da prompt, log, screenshot e pagine pubbliche.

## Preferisci letture specifiche per risorsa
Gli agenti devono leggere log, problemi, azioni, tracce, release e progetti con lo stesso vocabolario di risorse usato dalle persone.

- Usa i filtri per release, ambiente, progetto, traccia, gravità, stato, nome e utente.
- Usa le route di dettaglio di problemi e tracce quando conosci un identificatore.
- Usa le copie Markdown per il contesto pubblico e l’API autenticata per i dati privati dei progetti.

## Tieni i dati privati dietro l’autenticazione
Usa la documentazione pubblica per indicazioni sul prodotto. Usa letture autenticate per i dati privati dei progetti.

- Non estrarre dati dalla dashboard senza una sessione utente valida.
- Non pubblicare nomi di progetti privati, token, tracce o dettagli di deploy.
- Usa le pagine pubbliche per informazioni generali e le route autenticate per i dati limitati dell’utente.

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