Guía operativa para agentes

Da a los agentes rutas estables, JSON estable y siguientes pasos exactos.

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

Abrir docsLeer 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.

Puntos de entrada

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.

Recuperación CLI

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.

Rutas de lectura

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, nivel, 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.

Límites

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.