manifest

Manifest の設定と検証

使用するタイミング

• 明示的に依頼された Manifest のテレメトリーまたはゲートウェイ統合を設定します。
• 無関係なプロバイダーのルーティングを変更せずに、許可済みテレメトリーが欠落している原因を診断します。

利用可能性

この AAS ツリーに含まれているのは手順であり、プラグイン、CLI、ゲートウェイではありません。公式ドキュメントを参照して、実際のホスト、インストール済みバージョン、現在サポートされている Manifest 統合を確認してください。以前のコピーに記載されていた claude gateway／claude plugins コマンドは、検証済みの Claude Code 設定手順ではありません。実行したり、ホストの設定パスを推測したりしないでください。

テレメトリーのみの設定と、すべての推論をゲートウェイ経由でルーティングする設定は、別々の変更です。ユーザーが依頼した範囲に従い、既存のプロバイダー、認証情報、その他のホスト設定を保持してください。

手順

1. 現在許可されている統合と対象のアカウント／エンドポイントを確認します。利用可能なツールまたは CLI のヘルプと、正確なパッケージ／ソースのバージョンを確認してください。範囲を限定した編集の前に、影響する設定を非公開の場所にバックアップします。
2. ホストの非公開の認証情報管理機能を使って、既存の許可済み認証情報を再利用します。認証情報がない場合は、サービスまたはサポート対象のローカルシークレットインターフェースにユーザー自身が入力できるようにしてください。チャットへのキーの貼り付けを求めたり、シェル引数にキーを含めたりしないでください。プレフィックスの確認だけでは、認証の証明になりません。
3. ホスト外に送信されるデータ（プロンプト、応答、アカウント識別子、コスト、ツールのトレース、エラーペイロード）を確認します。実際のマスキング／保持制御を選択し、非公開データの送信とプロバイダーへの課金について承認を得てください。本文全体のログ記録が有効な場合に、メタデータのみがテレメトリーとして送信されると想定しないでください。
4. 選択した統合に対応する、具体的でサポート対象の設定を準備します。リモートエンドポイントには HTTPS を使用し、userinfo や意図しないリダイレクトを拒否します。個別に確認済みのセルフホスト可能なサービスには、ローカルのループバックが適切な場合があります。許可された設定項目のみを変更してください。統合で実際に必要な場合に限り、該当するサービスを再起動し、その他の実行中タスクはそのまま維持します。
5. プロバイダーへの呼び出しが許可されている場合に限り、承認済みの合成フィクスチャを 1 件送信します。リクエスト／トレースの正確な内容、返されたモデルまたはテレメトリーの受領記録、課金額、および両端のシークレットをマスキングしたログを検証してください。起動ログや 3 秒待つだけでは、送信を証明できません。認証またはプロバイダーの確認ができない場合は、未検証のままとします。
6. 変更した設定パス、バックアップ、確認できた受領記録、残っている制限事項を報告します。ロールバック／無効化の手順を確認してください。名前が似ているというだけの理由で、競合する診断プラグインを無効化しないでください。

例

ユーザーが既存のローカルエージェントのテレメトリーを依頼した場合、そのエージェントがサポートするエクスポーターを特定し、正確なエンドポイントと非公開の認証情報マッピングを準備して、許可された範囲だけを変更し、既定のモデルプロバイダーを変更せずに合成トレースを 1 件検証します。ゲートウェイ統合しか利用できない場合は、ルーティングを変更する前にその違いを説明してください。

制限事項

• 現在の Manifest のキー、エンドポイント、プラン、統合は変更される可能性があります。実際のアカウントの手順と公式スキーマを使用してください。
• ゲートウェイのフォールバックやリクエストの自動修復により、プロバイダー、データの送信先、パラメーター、再試行コストが変わる場合があります。許可された範囲内でのみ設定してください。
• このガイドをインストールしただけでは、認証、本番環境への送信、課金の正確性、プライバシーは証明されません。