Betriebsanleitung für Agents

Geben Sie Agents stabile Routen, stabiles JSON und klare nächste Schritte.

Diese Seite erklärt, wie Agents LogBrew lesen sollen, ohne Browserzustand, versteckten Kontext oder privaten Dashboard-Zugriff zu benötigen.

Docs öffnenMarkdown lesen
Erster sicherer Read
logbrew status --json

Beginnen Sie mit lokalem Status. Lesen Sie Logs, Issues, Actions, Traces, Releases und Projekte erst, wenn Auth und Erreichbarkeit klar sind.

Einstiegspunkte

Vorhersehbare öffentliche URLs verwenden

Agents sollten öffentlichen LogBrew-Kontext über stabile lokalisierte Seiten, Markdown-Spiegel, llms.txt, robots.txt und sitemap.xml finden.

  • Nutzen Sie /en/agents.md, wenn Klartext die sicherste Eingabe ist.
  • Nutzen Sie /en/docs.md für Kommando- und API-Routenkontext.
  • Nutzen Sie /llms.txt, um öffentliche agentenlesbare Ressourcen zu entdecken.

CLI-Recovery

Mit token-sicherem Status beginnen

Die CLI sollte Agents mitteilen, ob lokale Authentifizierung, API-Erreichbarkeit und Recovery-Schritte bereit sind, ohne Token-Material offenzulegen.

  • Führen Sie logbrew status --json vor Projekt-Reads aus.
  • Folgen Sie den nächsten Schritten aus JSON und menschlicher Ausgabe, statt zu raten.
  • Halten Sie Token-Material aus Prompts, Logs, Screenshots und öffentlichen Seiten heraus.

Read-Pfade

Ressourcenspezifische Reads bevorzugen

Agents sollten Logs, Issues, Actions, Traces, Releases und Projekte mit demselben Ressourcenvokabular lesen, das Menschen verwenden.

  • Nutzen Sie Filter für Release, Umgebung, Projekt, Trace, Level, Status, Name und Nutzer.
  • Nutzen Sie Issue- und Trace-Detailrouten, wenn eine Kennung bekannt ist.
  • Nutzen Sie Markdown-Spiegel für öffentlichen Kontext und die authentifizierte API für private Projektdaten.

Grenzen

Private Daten hinter Auth halten

Öffentliche Agent-Flächen müssen lesbar bleiben, während Dashboard- und Projektdaten durch Backend-Auth und Noindex-Metadaten geschützt bleiben.

  • Scrapen Sie Dashboard-Daten nicht ohne gültige Nutzersitzung.
  • Veröffentlichen Sie keine privaten Projektnamen, Tokens, Traces oder Deployment-Details.
  • Nutzen Sie öffentliche Seiten für allgemeines Lernen und authentifizierte Routen für begrenzte Nutzerdaten.