LogBrew per gli agenti
Questa pagina spiega come gli agenti devono leggere LogBrew senza stato del browser, contesto nascosto o accesso alla dashboard privata.
logbrew status --jsonParti dallo stato locale, poi leggi log, problemi, azioni, tracce, release e progetti solo quando autenticazione e raggiungibilità sono chiare.
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.
Usa le copie Markdown collegate per un contesto pubblico più approfondito.curl -L https://logbrew.co/llms.txtCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio. - 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.
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.curl -L https://logbrew.co/en/docs.mdCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio. - 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.
Segui il campo next, che non espone token, invece di tirare a indovinare.logbrew status --jsonCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio. - 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.
Leggi problemi, azioni, tracce, release e progetti solo quando l’autenticazione è pronta.logbrew logs info --jsonCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.
Dai a un agente la mappa pubblica di LogBrew prima che modifichi la tua app o il comando di configurazione.
curl -L https://logbrew.co/llms.txtCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.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.Copiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.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.
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.
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.
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.