# エージェント向け LogBrew
このページでは、ブラウザー状態、隠れた文脈、private ダッシュボードアクセスに頼らず、エージェントが LogBrew を読む方法を説明します。

## 最初の安全な読み取り
```bash
logbrew status --json
```

## AIアシスタント用コンテキスト
アプリやセットアップコマンドを編集する前に、公開LogBrewマップをエージェントへ渡します。

AIセットアッププロンプト

```text
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 で確認してください。チャットやコミットで認証情報を求めないでください。
```

# エージェントのタスクマップ
アシスタントが開発者の LogBrew セットアップや private シグナルの読み取りを手伝うときは、この順序を使います。

## ステップ 1: 公開マップを読む
アプリコードを変更する前に公開ルートインデックスを読み込み、アシスタントが最新の LogBrew 文脈から始められるようにします。

```bash
curl -L https://logbrew.co/llms.txt
```

Next: より深い公開文脈には、リンクされた Markdown ミラーを使います。

## ステップ 2: SDK カードを選ぶ
何かをインストールする前に SDK chooser を読み、Add Project の インストールプロンプトをコピー を使って、アシスタントが選択したプラットフォームに従えるようにします。

```bash
curl -L https://logbrew.co/en/docs.md
```

Next: サインイン済みユーザーに Add Project を開き、インストールプロンプトをコピーし、ingest 資格情報をチャットに置かないよう依頼します。

## ステップ 3: ローカル status を確認する
private なプロジェクト、ログ、課題、アクション、トレース、リリースを読む前に、API 到達性と auth ソースを確認します。

```bash
logbrew status --json
```

Next: 推測せず、トークン安全な next フィールドに従います。

## ステップ 4: 最初のシグナルを確認する
セットアップが安全な SDK シグナルを送信した後、範囲付きの結果を 1 つ読み、トークン、Cookie、プロジェクトデータを prompt に出さないようにします。

```bash
logbrew logs info --json
```

Next: 課題、アクション、トレース、リリース、プロジェクトの読み取りは auth が準備できてから使います。

## 予測しやすい公開 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 プロジェクト名、トークン、トレース、デプロイ詳細を公開しないでください。
- 一般的な学習には公開ページを使い、範囲付きユーザーデータには認証済みルートを使います。

## Public agent links
- Agents: https://logbrew.co/ja/agents
- Agents Markdown: https://logbrew.co/ja/agents.md
- Docs Markdown: https://logbrew.co/ja/docs.md
- Home Markdown: https://logbrew.co/ja/page.md
- llms.txt: https://logbrew.co/llms.txt
- Sitemap: https://logbrew.co/sitemap.xml