# LogBrew para agentes Esta página explica como os agentes devem ler o LogBrew sem depender do estado do navegador, de contexto oculto ou de acesso privado ao painel. ## Primeira leitura segura ```bash logbrew status --json ``` ## Contexto para o assistente de IA Dê a um agente o mapa público do LogBrew antes que ele edite seu app ou o comando de configuração. prompt de instalação ```text Leia https://logbrew.co/llms.txt e escolha o card de SDK correspondente em https://logbrew.co/en/docs#docs-sdk-choice-title. Use npm install @logbrew/sdk @logbrew/node apenas para um serviço Node.js no servidor; para Next.js, React, iOS, Android ou React Native, use o card escolhido e o prompt de Adicionar projeto. Peça ao usuário conectado para abrir Adicionar projeto e colocar as credenciais apenas no ambiente do app correspondente. Para Node.js no servidor, a variável de ambiente é LOGBREW_SERVER_API_KEY. Execute node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs apenas para serviços Node e depois verifique com logbrew logs info --json. Não peça credenciais no chat nem em commits. ``` # Mapa de tarefas do agente Siga esta ordem quando um assistente ajudar um desenvolvedor a configurar o LogBrew ou a ler sinais privados. ## Passo 1: Leia o mapa público Carregue o índice público de rotas antes de alterar o código do app. Assim, o assistente parte do contexto atual do LogBrew. ```bash curl -L https://logbrew.co/llms.txt ``` Next: Use os espelhos em Markdown indicados para ter mais contexto público. ## Passo 2: Escolha o card do SDK Leia o seletor de SDK antes de instalar qualquer coisa. Depois, use Copiar prompt de instalação em Adicionar projeto para que o assistente siga a plataforma escolhida. ```bash curl -L https://logbrew.co/en/docs.md ``` Next: Peça ao usuário conectado para abrir Adicionar projeto, copiar o prompt de instalação e manter as credenciais de ingestão fora do chat. ## Passo 3: Confira o status local Confirme o acesso à API e a origem da autenticação antes de ler projetos, logs, problemas, ações, traces ou versões privados. ```bash logbrew status --json ``` Next: Siga o campo next, que não expõe tokens, em vez de adivinhar. ## Passo 4: Verifique o primeiro sinal Depois que a configuração enviar um sinal seguro do SDK, leia um resultado com escopo definido. Mantenha tokens, cookies e dados do projeto fora dos prompts. ```bash logbrew logs info --json ``` Next: Leia problemas, ações, traces, versões e projetos só depois que a autenticação estiver pronta. ## Use URLs públicas previsíveis Os agentes devem encontrar o contexto público do LogBrew em páginas localizadas estáveis, espelhos em Markdown, llms.txt, robots.txt e sitemap.xml. - Use /en/agents.md quando texto simples for a entrada mais segura. - Use /en/docs.md para ter contexto de comandos e rotas da API. - Use /llms.txt para descobrir recursos públicos que agentes conseguem ler. ## Comece por um status que não expõe tokens A CLI deve dizer aos agentes se a autenticação local, o acesso à API e as etapas de recuperação estão prontos, sem expor tokens. - Execute logbrew status --json antes de ler projetos. - Siga as próximas etapas da saída JSON ou da saída legível em vez de adivinhar. - Mantenha tokens fora de prompts, logs, capturas de tela e páginas públicas. ## Prefira leituras por recurso Os agentes devem ler logs, problemas, ações, traces, versões e projetos com o mesmo vocabulário de recursos usado pelas pessoas. - Use filtros de versão, ambiente, projeto, trace, gravidade, status, nome e usuário. - Use as rotas de detalhes de problema e de trace quando souber o identificador. - Use os espelhos em Markdown para contexto público e a API autenticada para dados privados do projeto. ## Mantenha os dados privados sob autenticação Use a documentação pública para orientação sobre o produto. Use leituras autenticadas para dados privados do projeto. - Não extraia dados do painel sem uma sessão de usuário válida. - Não publique nomes de projetos privados, tokens, traces ou detalhes de implantação. - Use páginas públicas para aprendizado geral e rotas autenticadas para dados de usuário com escopo definido. ## Public agent links - Agents: https://logbrew.co/pt-BR/agents - Agents Markdown: https://logbrew.co/pt-BR/agents.md - Docs Markdown: https://logbrew.co/pt-BR/docs.md - Home Markdown: https://logbrew.co/pt-BR/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml