LogBrew para agentes

Esta página explica cómo los agentes deben leer LogBrew sin depender del estado del navegador, contexto oculto ni acceso privado al panel.

Leer Markdown
Primera lectura segura
logbrew status --json

Empieza con el status local y lee logs, incidencias, acciones, trazas, versiones y proyectos solo cuando auth y alcance estén claros.

Mapa de tareas para agentes

Usa este orden cuando un asistente ayude a un desarrollador a configurar LogBrew o leer señales privadas.

  1. Paso 1

    Lee el mapa público

    Carga el índice público de rutas antes de cambiar código de la app para que el asistente empiece con contexto actual de LogBrew.

    curl -L https://logbrew.co/llms.txt
    Usa los espejos Markdown enlazados para contexto público más profundo.
  2. Paso 2

    Elige la tarjeta SDK

    Lee primero el selector de SDK antes de instalar nada y luego usa Copiar prompt de instalación en Add Project para que el asistente siga la plataforma elegida.

    curl -L https://logbrew.co/en/docs.md
    Pide al usuario con sesión iniciada que abra Add Project, copie el prompt de configuración con IA y no ponga credenciales de ingest en el chat.
  3. Paso 3

    Comprueba el status local

    Confirma alcance de API y fuente de auth antes de leer proyectos, logs, incidencias, acciones, trazas o versiones privadas.

    logbrew status --json
    Sigue el campo next seguro para tokens en lugar de adivinar.
  4. Paso 4

    Verifica la primera señal

    Después de que la configuración envíe una señal SDK segura, lee un resultado con alcance y mantén tokens, cookies y datos de proyecto fuera de prompts.

    logbrew logs info --json
    Usa lecturas de incidencias, acciones, trazas, versiones y proyectos solo cuando auth esté lista.
Contexto para asistente de IA

Da a un agente el mapa público de LogBrew antes de que edite tu app o el comando de configuración.

curl -L https://logbrew.co/llms.txt
Lee https://logbrew.co/llms.txt y luego elige la tarjeta SDK correcta en https://logbrew.co/en/docs#docs-sdk-choice-title. Usa npm install @logbrew/sdk @logbrew/node solo para un servicio server-side Node.js; para Next.js, React, iOS, Android o React Native usa la tarjeta elegida y el prompt de Add Project. Pide al usuario con sesión iniciada que abra Add Project y coloque credenciales solo en el entorno de la app correspondiente. Para server-side Node.js, la variable de entorno es LOGBREW_SERVER_API_KEY. Ejecuta node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs solo para servicios Node y luego verifica con logbrew logs info --json. No pidas credenciales en el chat ni en commits.
Usa URL públicas predecibles

Los agentes deben encontrar contexto público de LogBrew mediante páginas localizadas estables, espejos Markdown, llms.txt, robots.txt y sitemap.xml.

  • Usa /en/agents.md cuando el texto plano sea la entrada más segura.
  • Usa /en/docs.md para contexto de comandos y rutas de API.
  • Usa /llms.txt para descubrir recursos públicos legibles para agentes.
Empieza con status seguro para tokens

La CLI debe indicar a los agentes si la auth local, el alcance de la API y los pasos de recuperación están listos sin exponer material de token.

  • Ejecuta logbrew status --json antes de leer proyectos.
  • Sigue los siguientes pasos del JSON y la salida humana en lugar de adivinar.
  • Mantén el material de token fuera de prompts, logs, capturas y páginas públicas.
Prefiere lecturas específicas por recurso

Los agentes deben leer logs, incidencias, acciones, trazas, versiones y proyectos con el mismo vocabulario de recursos que usan las personas.

  • Usa filtros de versión, entorno, proyecto, traza, severidad, estado, nombre y usuario.
  • Usa rutas de detalle de incidencia y traza cuando el identificador sea conocido.
  • Usa espejos Markdown para contexto público y la API autenticada para datos privados de proyecto.
Mantén los datos privados detrás de auth

Las superficies públicas para agentes deben seguir legibles, mientras los datos de panel y proyecto quedan protegidos por auth del backend y metadatos noindex.

  • No leas datos del panel sin una sesión de usuario válida.
  • No publiques nombres privados de proyecto, tokens, trazas ni detalles de despliegue.
  • Usa páginas públicas para aprendizaje general y rutas autenticadas para datos de usuario con alcance.