# サポートされているエージェントフレームワーク
<a name="supported-frameworks"></a>

Amazon Bedrock AgentCore Evaluations は、一般的なエージェントフレームワークで構築されたエージェントを評価します。エージェントがテレメトリとして出力する内容とそのテレメトリの構造は、 で構築する**エージェントフレームワーク**と、その記録に使用する**計測ライブラリ**によって異なります。

サポートされているフレームワークごとに、このセクションでは以下について説明します。
+ 使用できる計測ライブラリ。
+ エージェントを計測する方法。
+ 結果のスパンとイベントレコードはどのようなものか。
+ ユーザープロンプト、エージェントのレスポンス、ツール呼び出しなど、評価サービスが必要な値を見つける方法。

AgentCore Evaluations は、以下のフレームワークと計測ライブラリをサポートしています。これらのライブラリの Python バージョンのみをサポートしています。


| エージェントフレームワーク | 計測ライブラリ | スコープ名 | 推奨バージョン | 
| --- | --- | --- | --- | 
| Strands Agents | 組み込み (Strands Agents SDK) |  `strands.telemetry.tracer`  | 最新 | 
| LangGraph | OpenTelemetry (`opentelemetry-instrumentation-langchain`) |  `opentelemetry.instrumentation.langchain`  |  `>= 0.55.0`  | 
| LangGraph | OpenInference (`openinference-instrumentation-langchain`) |  `openinference.instrumentation.langchain`  |  `>= 0.1.62`  | 
| OpenAI エージェント | OpenTelemetry (`opentelemetry-instrumentation-openai-agents`) |  `opentelemetry.instrumentation.openai_agents`  |  `>= 0.61.0`  | 
| OpenAI エージェント | OpenInference (`openinference-instrumentation-openai-agents`) |  `openinference.instrumentation.openai_agents`  |  `>= 1.5.0`  | 
| LlamaIndex | OpenTelemetry (`opentelemetry-instrumentation-llamaindex`) |  `opentelemetry.instrumentation.llamaindex`  |  `>= 0.61.0`  | 
| LlamaIndex | OpenInference (`openinference-instrumentation-llama-index`) |  `openinference.instrumentation.llama_index`  |  `>= 4.4.1`  | 
| Google ADK | OpenInference (`openinference-instrumentation-google-adk`) |  `openinference.instrumentation.google_adk`  |  `>= 0.1.13`  | 
| Claude エージェント SDK | OpenInference (`openinference-instrumentation-claude-agent-sdk`) |  `openinference.instrumentation.claude_agent_sdk`  |  `>= 0.1.3`  | 

**スコープ名**は、各スパンとイベントレコードの `scope.name`フィールドの値です。評価サービスはこれを使用して、スパンを処理できるかどうかを判断します。

## サービスがセッションを読み取る方法
<a name="supported-frameworks-how-read"></a>

フレームワークに関係なく、評価サービスはスパンと**イベントレコード**の **2 つのテレメトリシグナルからセッションを再構築します**。各スパンをタイプ別に分類し、そこからコンテンツを抽出します。

1.  フレームワーク固有の属性から**スパンタイプを特定します**。スパンは、**呼び出しエージェントスパン** (最上位のエージェント実行）、**実行ツールスパン** (単一のツール呼び出し）、または**推論スパン** (単一のモデル呼び出し) です。

1.  各スパンの属性または相関イベントレコードから**関連する値を抽出します**。たとえば、**ユーザープロンプト**はエージェント入力のヒューマン (user-role) メッセージから取得され、**エージェントのレスポンス**はエージェント出力の AI (assistant-role) メッセージから取得されます。

正確な属性名とコンテンツの場所は、フレームワークと計測ライブラリによって異なります。[スパン、イベントレコード、テレメトリシグナル](supported-frameworks-telemetry.md)のページでは、スパンとイベントレコードの構造とコンテンツが存在する場所について説明します。フレームワークごとのページでは、サポートされている各フレームワークの属性とサンプルデータについて説明します。

## オブザーバビリティを設定する
<a name="supported-frameworks-setup"></a>

エージェントを計測することは、評価サービスが読み取ることができるテレメトリの生成の一部です。評価をエンドツーエンドで機能させるには、エージェントでオブザーバビリティを有効にし、スパンとイベントレコードを Amazon CloudWatch にエクスポートする必要があります。以下のステップを実行します。

1. 評価の前提条件である CloudWatch トランザクション検索を有効にします。[AgentCore オブザーバビリティの有効化](observability-configure.md#observability-configure-builtin)」を参照してください。

1. ホストされている場所に基づいて、エージェントのオブザーバビリティを有効にします。
   + Amazon Bedrock AgentCore ランタイムでホストされているエージェントについては、[AgentCore でホストされているエージェントのエージェントコードでオブザーバビリティを有効にする](observability-configure.md#observability-configure-custom)」を参照してください。
   + Amazon Elastic Container Service (Amazon ECS)、Amazon Elastic Kubernetes Service (Amazon EKS)、 AWS Lambda、またはその他の環境でホストされているエージェントについては、[AgentCore の外部でホストされているエージェントのオブザーバビリティの有効化](observability-configure.md#observability-configure-3p)」を参照してください。

## サンプルエージェント
<a name="supported-frameworks-samples"></a>

次のサンプルは、Amazon Bedrock AgentCore ランタイム外でホストされている Strands エージェントを示し、ADOT を使用してテレメトリを Amazon CloudWatch にエクスポートしています。これらは、評価 API ではなくオブザーバビリティの設定に焦点を当てています。サンプルは Strands を使用しますが、同じホスティングおよびテレメトリエクスポートパターンが LangGraph などのサポートされている他のフレームワークに適用されます。
+  **Amazon EKS:** [Amazon EKS で EKS がホストするエージェントと Strands エージェントのオブザーバビリティ](https://github.com/awslabs/agentcore-samples/tree/main/06-workshops/06-AgentCore-observability/06-Agentcore-observability-for-eks-hosted-agent)。 [https://github.com/awslabs/agentcore-samples/tree/main/03-integrations/agents-hosted-outside-runtime/agents-on-eks](https://github.com/awslabs/agentcore-samples/tree/main/03-integrations/agents-hosted-outside-runtime/agents-on-eks)
+  **Amazon ECS:** [Amazon ECS でエージェントをストランドします](https://github.com/awslabs/agentcore-samples/tree/main/03-integrations/agents-hosted-outside-runtime/agents-on-ecs)。
+  ** AWS Lambda:** [AWS Lambda でエージェントをストランドします](https://github.com/awslabs/agentcore-samples/tree/main/03-integrations/agents-hosted-outside-runtime/agents-on-aws-lambda/02-agent-in-lambda)。

**Topics**