node-sdk

Known Agents SDKは、Known Agentsプラットフォームとやり取りするための公式Node.jsクライアントです。サーバー側のTypeScriptまたはJavaScriptアプリケーションが、サイトを訪れるAIエージェントやその他のボットに関する詳細な分析データを収集することを可能にします。 主な機能： * **訪問イベント追跡** – ミドルウェアで`trackPageviewOrRESTCall`を使用し、ページビューやRESTコールを記録します。イベントはキューに蓄積され、サイズまたは時間間隔に基づいて自動的にフラッシュされます。 * **MCPコール追跡** – Model Context Protocolベースのサービスでは、`trackMCPCall`がリクエスト、レスポンス、トランスポートの詳細を記録し、Agentic Commerce Protocol（ACP）およびUniversal Commerce Protocol（UCP）の相互作用を自動処理します。 * **アジェンティック・コマーシャル対応** – ACPまたはUCPのRESTレスポンスを処理する際、`trackPageviewOrRESTCall`にレスポンス本文を含めることで購入フローのデータを取得できます。 * **自動robots.txt生成** – `AgentType`のリストを渡して`generateRobotsTXT`を呼び出すと、特定のクローラーカテゴリをブロックまたは許可するプレーンテキストのrobots.txtが生成されます。この文字列は定期的（例：毎日）に再生成し、`/robots.txt`で提供可能です。 * **Agent Identification API** – `identifyAgent`（単一リクエスト）または`identifyAgents`（バッチ）を使用して、着信リクエストを識別・検証します。応答には認証ステータス、エージェントメタデータ、ASN情報、およびそのリクエストが自動化されている可能性を示す自動化スコアが含まれます。 インストールはnpmで簡単に行えます：`npm install @knownagents/sdk`。knownagents.comでサインアップしアクセストークンを取得した後は、`new KnownAgents('YOUR_ACCESS_TOKEN')`でクライアントをインスタンス化します。`flushQueueSize`および`flushIntervalInMilliseconds`の設定によりイベントのバッチ処理をカスタマイズできます。 本SDKはTypeScript ≥ 4.7を要件とし、Node.js 18 LTS以降で動作します。サポートについてはGitHubリポジトリにissueをオープンしてください。 総じて、このライブラリはAIエージェント向けの包括的なサーバーサイドソリューションを提供し、WebサービスへのAI駆動型インターraクションの監視と制御を容易にします。