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.

Ler Markdown
Primeira leitura segura
logbrew status --json

Comece pelo status local. Leia logs, problemas, ações, traces, versões e projetos só depois de confirmar a autenticação e o acesso à API.

Mapa de tarefas do agente

Siga esta ordem quando um assistente ajudar um desenvolvedor a configurar o LogBrew ou a ler sinais privados.

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

    curl -L https://logbrew.co/llms.txt
    Use os espelhos em Markdown indicados para ter mais contexto público.
  2. 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.

    curl -L https://logbrew.co/en/docs.md
    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.
  3. 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.

    logbrew status --json
    Siga o campo next, que não expõe tokens, em vez de adivinhar.
  4. 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.

    logbrew logs info --json
    Leia problemas, ações, traces, versões e projetos só depois que a autenticação estiver pronta.

Dê a um agente o mapa público do LogBrew antes que ele edite seu app ou o comando de configuração.

curl -L https://logbrew.co/llms.txt
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.

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.

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.

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.

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.