エージェント向け LogBrew
このページでは、ブラウザー状態、隠れた文脈、private ダッシュボードアクセスに頼らず、エージェントが LogBrew を読む方法を説明します。
logbrew status --jsonまずローカル status から始めます。auth と到達性が明確になってから、ログ、課題、アクション、トレース、リリース、プロジェクトを読み取ります。
エージェントのタスクマップ
アシスタントが開発者の LogBrew セットアップや private シグナルの読み取りを手伝うときは、この順序を使います。
- ステップ 1
公開マップを読む
アプリコードを変更する前に公開ルートインデックスを読み込み、アシスタントが最新の LogBrew 文脈から始められるようにします。
より深い公開文脈には、リンクされた Markdown ミラーを使います。curl -L https://logbrew.co/llms.txtコピーしました。ターミナルまたはアシスタントに貼り付けて、次のステップへ進んでください。 - ステップ 2
SDK カードを選ぶ
何かをインストールする前に SDK chooser を読み、Add Project の インストールプロンプトをコピー を使って、アシスタントが選択したプラットフォームに従えるようにします。
サインイン済みユーザーに Add Project を開き、インストールプロンプトをコピーし、ingest 資格情報をチャットに置かないよう依頼します。curl -L https://logbrew.co/en/docs.mdコピーしました。ターミナルまたはアシスタントに貼り付けて、次のステップへ進んでください。 - ステップ 3
ローカル status を確認する
private なプロジェクト、ログ、課題、アクション、トレース、リリースを読む前に、API 到達性と auth ソースを確認します。
推測せず、トークン安全な next フィールドに従います。logbrew status --jsonコピーしました。ターミナルまたはアシスタントに貼り付けて、次のステップへ進んでください。 - ステップ 4
最初のシグナルを確認する
セットアップが安全な SDK シグナルを送信した後、範囲付きの結果を 1 つ読み、トークン、Cookie、プロジェクトデータを prompt に出さないようにします。
課題、アクション、トレース、リリース、プロジェクトの読み取りは auth が準備できてから使います。logbrew logs info --jsonコピーしました。ターミナルまたはアシスタントに貼り付けて、次のステップへ進んでください。
AIアシスタント用コンテキスト
アプリやセットアップコマンドを編集する前に、公開LogBrewマップをエージェントへ渡します。
curl -L https://logbrew.co/llms.txtコピーしました。ターミナルまたはアシスタントに貼り付けて、次のステップへ進んでください。https://logbrew.co/llms.txt を読み、次に https://logbrew.co/en/docs#docs-sdk-choice-title で一致するSDKカードを選んでください。npm install @logbrew/sdk @logbrew/node は server-side Node.js サービスだけで使います。Next.js、React、iOS、Android、React Native では選んだカードと Add Project prompt を使ってください。サインイン済みユーザーに Add Project を開いてもらい、認証情報は対応するアプリ環境にだけ設定してもらいます。server-side Node.js の環境変数は LOGBREW_SERVER_API_KEY です。node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs は Node サービスだけで実行し、その後 logbrew logs info --json で確認してください。チャットやコミットで認証情報を求めないでください。コピーしました。ターミナルまたはアシスタントに貼り付けて、次のステップへ進んでください。予測しやすい公開 URL を使う
エージェントは、安定したローカライズページ、Markdown ミラー、llms.txt、robots.txt、sitemap.xml から公開 LogBrew 文脈を見つけるべきです。
- プレーンテキストが最も安全な入力になる場合は /en/agents.md を使います。
- コマンドと API ルートの文脈には /en/docs.md を使います。
- 公開エージェント向けリソースの発見には /llms.txt を使います。
トークン安全な status から始める
CLI は、トークン情報を出さずに、ローカル auth、API 到達性、復旧手順が準備できているかをエージェントへ示す必要があります。
- プロジェクトを読む前に logbrew status --json を実行します。
- 推測せず、JSON と人向け出力にある次の手順に従います。
- トークン情報を prompt、ログ、スクリーンショット、公開ページに出さないでください。
リソース別の読み取りを優先する
エージェントは、人が使う同じリソース語彙で、ログ、課題、アクション、トレース、リリース、プロジェクトを読むべきです。
- リリース、環境、プロジェクト、トレース、重大度、状態、名前、ユーザーのフィルターを使います。
- 識別子が分かっている場合は、課題詳細とトレース詳細のルートを使います。
- 公開文脈には Markdown ミラーを使い、private プロジェクトデータには認証済み API を使います。
Private データを auth の後ろに保つ
公開エージェント面は読みやすく保ち、ダッシュボードとプロジェクトデータは backend auth と noindex メタデータで保護します。
- 有効なユーザーセッションなしでダッシュボードデータを読まないでください。
- private プロジェクト名、トークン、トレース、デプロイ詳細を公開しないでください。
- 一般的な学習には公開ページを使い、範囲付きユーザーデータには認証済みルートを使います。