View a markdown version of this page

支持的代理框架 - 亚马逊基岩 AgentCore

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

支持的代理框架

亚马逊基岩评估 AgentCore 评估使用多个代理框架构建的代理。代理以遥测方式发出的内容以及遥测的结构取决于您构建的代理框架以及用于记录它的仪器库。

对于每个支持的框架，本节介绍了：

  • 您可以使用的仪器库。

  • 如何为您的代理人进行仪器。

  • 生成的跨度和事件记录是什么样子。

  • 评估服务如何找到所需的值，例如用户提示、代理响应和工具调用。

AgentCore 评估支持以下框架和仪器库。Python 和都支持多个框架 TypeScript。Python 和库 TypeScript 版本发出的作用域名称不同，因此每种语言都有自己的行。对于给定的框架和仪器库，评估服务从任一语言中提取相同的值。

代理框架 仪器库 语言 范围名称 建议的版本

Strands Agents

Built-in （Strands 代理软件开发工具包）

Python

strands.telemetry.tracer

最新

Strands Agents

Built-in （Strands 代理软件开发工具包）

TypeScript

strands-agents

@strands-agents/sdk >= 1.5.0

LangGraph

OpenTelemetry (opentelemetry-instrumentation-langchain)

Python

opentelemetry.instrumentation.langchain

>= 0.55.0

LangGraph

OpenInference (openinference-instrumentation-langchain)

Python

openinference.instrumentation.langchain

>= 0.1.62

LangGraph

OpenTelemetry, ADOT-native

TypeScript

@aws/aws-distro-opentelemetry-instrumentation-langchain

>= 0.12.0

LangGraph

OpenTelemetry (@traceloop/instrumentation-langchain)

TypeScript

@traceloop/instrumentation-langchain

>= 0.27.0

LangGraph

OpenInference (@arizeai/openinference-instrumentation-langchain)

TypeScript

@arizeai/openinference-instrumentation-langchain

>= 4.0.14

OpenAI 代理

OpenTelemetry (opentelemetry-instrumentation-openai-agents)

Python

opentelemetry.instrumentation.openai_agents

>= 0.61.0

OpenAI 代理

OpenInference (openinference-instrumentation-openai-agents)

Python

openinference.instrumentation.openai_agents

>= 1.5.0

OpenAI 代理

OpenTelemetry, ADOT-native

TypeScript

@aws/aws-distro-opentelemetry-instrumentation-openai-agents

>= 0.12.0

OpenAI 代理

OpenInference (@arizeai/openinference-instrumentation-openai-agents)

TypeScript

@arizeai/openinference-instrumentation-openai-agents

>= 0.2.2

Vercel AI SDK

OpenTelemetry, ADOT-native

TypeScript

@aws/aws-distro-opentelemetry-instrumentation-vercel-ai

>= 0.12.0

LlamaIndex

OpenTelemetry (opentelemetry-instrumentation-llamaindex)

Python

opentelemetry.instrumentation.llamaindex

>= 0.61.0

LlamaIndex

OpenInference (openinference-instrumentation-llama-index)

Python

openinference.instrumentation.llama_index

>= 4.4.1

谷歌 ADK

OpenInference (openinference-instrumentation-google-adk)

Python

openinference.instrumentation.google_adk

>= 0.1.13

克劳德特工 SDK

OpenInference (openinference-instrumentation-claude-agent-sdk)

Python

openinference.instrumentation.claude_agent_sdk

>= 0.1.3

您的代理发出的每个跨度都有一个作用域名称，该名称标识生成该跨度的工具库。评估服务读取这个名称来判断它正在处理哪个库，从而判断它是否可以处理跨度以及需要查找哪些属性。范围名称是每个跨度和事件记录上scope.name字段的值。

属性名称和对话内容的位置因框架和工具库而异。有关单个框架的属性和示例跨度，请参阅该框架的页面。

注意

对代理进行仪表只是生成评估服务可以读取的遥测数据的一部分。您的代理还必须启用可观察性，以便将其遥测数据导出到亚马逊。 CloudWatch

有关如何 AgentCore 提供遥测数据、服务在哪里找到所需值以及托管选项的设置步骤，请参阅遥测设置和交付。

主题