入口
予測しやすい公開 URL を使う
エージェントは、安定したローカライズページ、Markdown ミラー、llms.txt、robots.txt、sitemap.xml から公開 LogBrew 文脈を見つけるべきです。
- プレーンテキストが最も安全な入力になる場合は /en/agents.md を使います。
- コマンドと API ルートの文脈には /en/docs.md を使います。
- 公開エージェント向けリソースの発見には /llms.txt を使います。
エージェント運用ガイド
エージェントに安定したルート、安定した JSON、正確な次の手順を渡します。
このページでは、ブラウザー状態、隠れた文脈、private ダッシュボードアクセスに頼らず、エージェントが LogBrew を読む方法を説明します。
最初の安全な読み取り
logbrew status --jsonまずローカル status から始めます。auth と到達性が明確になってから、ログ、課題、アクション、トレース、リリース、プロジェクトを読み取ります。
CLI 復旧
トークン安全な status から始める
CLI は、トークン情報を出さずに、ローカル auth、API 到達性、復旧手順が準備できているかをエージェントへ示す必要があります。
- プロジェクトを読む前に logbrew status --json を実行します。
- 推測せず、JSON と人向け出力にある次の手順に従います。
- トークン情報を prompt、ログ、スクリーンショット、公開ページに出さないでください。
読み取りパス
リソース別の読み取りを優先する
エージェントは、人が使う同じリソース語彙で、ログ、課題、アクション、トレース、リリース、プロジェクトを読むべきです。
- リリース、環境、プロジェクト、トレース、レベル、状態、名前、ユーザーのフィルターを使います。
- 識別子が分かっている場合は、課題詳細とトレース詳細のルートを使います。
- 公開文脈には Markdown ミラーを使い、private プロジェクトデータには認証済み API を使います。
境界
Private データを auth の後ろに保つ
公開エージェント面は読みやすく保ち、ダッシュボードとプロジェクトデータは backend auth と noindex メタデータで保護します。
- 有効なユーザーセッションなしでダッシュボードデータを読まないでください。
- private プロジェクト名、トークン、トレース、デプロイ詳細を公開しないでください。
- 一般的な学習には公開ページを使い、範囲付きユーザーデータには認証済みルートを使います。