fr33dr4g0n/agentry-skill

Agentry - エージェントネイティブな分析とロギング

Agentryは、コーディングエージェント向けのエージェントネイティブな分析とロギングツールです。プロダクト分析、エラーログ、デプロイ属性の追跡を単一のHTTP APIでカバーし、エージェントがユーザーの行動、障害、変更内容を把握できるようにします。

このスキルは、Agentryのインストール・セットアップ、プロダクト分析、ロギング、エラーモニタリング、デプロイ追跡、本番デバッグ、日常的なAgentryデータ参照に使用します。このファイルをAPIリファレンスとして扱わないでください。これはライブドキュメントへのコンパクトなエントリポイントです。

次に取得すべき情報

• Agentryのインストールまたはセットアップ: https://agentry.sh/install.md を取得してください。
• セットアップ後のプロダクト、信頼性、ケース、分析、デプロイに関する質問への回答: https://agentry.sh/agentry.md を取得してください。
• APIサーフェスと3つの書き込み/3つの読み取りモデルの発見: https://api.agentry.sh/ から始めてください。
• 正確なリクエスト/レスポンスの形式を確認: https://api.agentry.sh/v1/openapi.json を取得し、?flow=、?tag=、?path=&method=、または ?index=true でフィルタリングしてください。
• 将来のセッションアダプターのインストールまたは更新: https://api.agentry.sh/adapters を取得し、検出されたエージェントハーネスに一致するすべてのアダプターを書き込んでください。

ブラウザ以外からの直接HTTP呼び出しにはカスタムUser-Agentヘッダーを使用してください。Python-urllibなどのデフォルトクライアントはブロックされる可能性があります。ブラウザのfetchはブラウザ自身のUser-Agentを使用するため、このヘッダーを手動で設定できません。

インストールワークフロー

Agentryをインストールする際は、https://agentry.sh/install.md を取得し、そのフローに従ってください。リポジトリの重要なビジネス上の質問から始め、ファネル/ビジネスロジックフローを確認してください。POST /v1/install/plan に実際のコードベースからイベント、プロパティ、エラーサーフェス、デプロイ証明を導出させます。汎用的なイベントカタログを手動で作成しないでください。

成功を宣言する前に、シグナルマップと実装レポートを保存し、承認されたテレメトリが実際に流れていることを確認してください。

メンタルモデル

Agentryには3つの書き込みパスと3つの読み取り概念があります。

アプリのランタイムデータは AGENTRY_DSN を使用して書き込みます:

• POST /v1/logs/: エラー、例外、運用上の障害用。
• POST /v1/analytics/: プロダクト、ユーザー、ファネル、ビジネスイベント用。

デプロイ属性の書き込みは同じ AGENTRY_DSN を使用し、CI/プロバイダーのデプロイ後自動化からのみ行います（リリース成功後）:

• POST /v1/deploys/: リリース属性追跡用。

AGENTRY_API_KEY を使用して読み取ります:

• ケース: 何が壊れたか。GET /v1/projects/:project_id/cases から始め、次に GET /v1/cases/:case_id を使用します。
• 分析: ユーザーが何をしたか。保存されたシグナルマップ、最新の検証レポート、回答契約、イベント名、プロパティキーから始めます。その後、一般的な読み取りにはクエリブループリントを使用するか、カスタムHogQLには POST /v1/projects/:project_id/analytics/query を使用します。テーブル形式のAgentryクエリ読み取りはオブジェクト形式の rows を返します。エージェント向けエンドポイントからPostHog形式の results を読み取らないでください。
• デプロイ: 何が変更されたか。GET /v1/projects/:project_id/deploys を使用します。

クエリブループリント、イベント名、公開クエリ、ヘルス、次のステップは、これら3つの読み取り概念を補完するものです。公開クエリURLとダッシュボードはオプションの出力サーフェスであり、基盤となるプロダクトの質問に回答可能であることの証明ではありません。

日常的な質問には、クエリブループリントやカスタムHogQLを選択する前に、保存されたシグナルマップ、最新の検証レポート、回答契約、イベント名、プロパティキーを読み取ってください。必要なイベントやプロパティが欠けている場合は、欠けているものを明示し、メトリクスをでっち上げる代わりに該当するプロダクトフローを配線またはトリガーしてください。

認証

AGENTRY_API_KEY は環境変数または ~/.agentry/credentials.json から読み取ります。project_id は AGENTRY_PROJECT_ID またはコミットされた .agentry/config.json から読み取ります。APIキーがない場合は、POST /v1/auth/device でデバイスフローを開始してください。ランタイムデータの取り込みには AGENTRY_DSN を使用します。

信頼できる情報源

エンドポイントの詳細については、このインストール済みファイルに依存しないでください。上記のライブドキュメントを取得してください。それらが信頼できる情報源であり、アダプターとは独立して更新される可能性があります。