LogBrew für Agents

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

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

Agent-Aufgabenkarte

Nutzen Sie diese Reihenfolge, wenn ein Assistent einem Entwickler beim Einrichten von LogBrew oder beim Lesen privater Signale hilft.

  1. Schritt 1

    Öffentliche Karte lesen

    Laden Sie den öffentlichen Routenindex, bevor App-Code geändert wird, damit der Assistent mit aktuellem LogBrew-Kontext startet.

    curl -L https://logbrew.co/llms.txt
    Nutzen Sie die verlinkten Markdown-Spiegel für tieferen öffentlichen Kontext.
  2. Schritt 2

    SDK-Karte wählen

    Lesen Sie den SDK-Chooser, bevor etwas installiert wird, und nutzen Sie dann Installations-Prompt kopieren in Add Project, damit der Agent der gewählten Plattform folgt.

    curl -L https://logbrew.co/en/docs.md
    Bitten Sie den angemeldeten Nutzer, Add Project zu öffnen, den KI-Setup-Prompt zu kopieren und Ingest-Berechtigungen nicht in den Chat zu legen.
  3. Schritt 3

    Lokalen Status prüfen

    Bestätigen Sie API-Erreichbarkeit und Auth-Quelle, bevor private Projekte, Logs, Issues, Actions, Traces oder Releases gelesen werden.

    logbrew status --json
    Folgen Sie dem token-sicheren next-Feld, statt zu raten.
  4. Schritt 4

    Erstes Signal verifizieren

    Nachdem das Setup ein sicheres SDK-Ereignis gesendet hat, lesen Sie ein begrenztes Ergebnis und halten Tokens, Cookies und Projektdaten aus Prompts heraus.

    logbrew logs info --json
    Nutzen Sie Issue-, Action-, Trace-, Release- und Projekt-Reads erst, wenn Auth bereit ist.
KI-Assistentenkontext

Geben Sie einem Agenten die öffentliche LogBrew-Übersicht, bevor er Ihre App oder den Setup-Befehl bearbeitet.

curl -L https://logbrew.co/llms.txt
Lies https://logbrew.co/llms.txt und wähle danach die passende SDK-Karte unter https://logbrew.co/en/docs#docs-sdk-choice-title. Verwende npm install @logbrew/sdk @logbrew/node nur für einen server-side Node.js Service; für Next.js, React, iOS, Android oder React Native nutze die gewählte Karte und den Add Project Prompt. Bitte den angemeldeten Nutzer, Add Project zu öffnen und Berechtigungen nur in der passenden App-Umgebung abzulegen. Für server-side Node.js heißt die Env-Variable LOGBREW_SERVER_API_KEY. Führe node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs nur für Node Services aus und prüfe danach mit logbrew logs info --json. Frage im Chat oder in Commits nicht nach Berechtigungen.
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.
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.
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, Schweregrad, 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.
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.