View a markdown version of this page

Marcos de agentes compatibles - Base amazónica AgentCore

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Marcos de agentes compatibles

Amazon Bedrock AgentCore Evaluations evalúa los agentes creados con varios marcos de agentes. Lo que un agente emite como telemetría y cómo se estructura esa telemetría dependen del marco de agentes con el que cree y de la biblioteca de instrumentación que utilice para grabarlo.

Para cada marco compatible, en esta sección se describe:

  • Las bibliotecas de instrumentación que puede usar.

  • Cómo instrumentar a su agente.

  • Qué aspecto tienen los intervalos y los registros de eventos resultantes.

  • Cómo localiza el servicio de evaluación los valores que necesita, como la solicitud del usuario, la respuesta del agente y las llamadas a las herramientas.

AgentCore Evaluations es compatible con los siguientes marcos y bibliotecas de instrumentación. Tanto en Python como en Python se admiten varios marcos. TypeScript Python y TypeScript las versiones de una biblioteca emiten diferentes nombres de ámbito, por lo que cada idioma tiene su propia fila. Para una biblioteca de infraestructura e instrumentación determinada, el servicio de evaluación extrae los mismos valores de cualquier idioma.

Marco de agentes Biblioteca de instrumentación Idioma Nombre del ámbito Versión recomendada

Strands Agents

Built-in (SDK de Strands Agents)

Python

strands.telemetry.tracer

La más reciente

Strands Agents

Built-in (SDK de agentes de 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

Agentes de OpenAI

OpenTelemetry (opentelemetry-instrumentation-openai-agents)

Python

opentelemetry.instrumentation.openai_agents

>= 0.61.0

Agentes de OpenAI

OpenInference (openinference-instrumentation-openai-agents)

Python

openinference.instrumentation.openai_agents

>= 1.5.0

Agentes de OpenAI

OpenTelemetry, ADOT-native

TypeScript

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

>= 0.12.0

Agentes de OpenAI

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

TypeScript

@arizeai/openinference-instrumentation-openai-agents

>= 0.2.2

SDK de IA de Vercel

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

SDK de Google

OpenInference (openinference-instrumentation-google-adk)

Python

openinference.instrumentation.google_adk

>= 0.1.13

SDK de Claude Agent

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

Python

openinference.instrumentation.claude_agent_sdk

>= 0.1.3

Cada intervalo que emite su agente lleva un nombre de ámbito, que identifica la biblioteca de instrumentación que lo produjo. El servicio de evaluación lee este nombre para saber de qué biblioteca se trata y, por lo tanto, si puede procesar el intervalo y qué atributos debe buscar. El nombre del ámbito es el valor del scope.name campo en cada intervalo y registro de eventos.

Los nombres de los atributos y la ubicación del contenido de la conversación varían según el marco y la biblioteca de instrumentación. Para ver los atributos y los intervalos de ejemplo de un único marco, consulte la página de ese marco.

nota

Instrumentar a su agente es solo una parte de la producción de telemetría que el servicio de evaluación puede leer. Tu agente también debe tener habilitada la observabilidad para poder exportar su telemetría a Amazon. CloudWatch

Para saber cómo AgentCore entrega esa telemetría, dónde el servicio encuentra los valores que necesita y los pasos de configuración de tu opción de alojamiento, consulta Configuración y entrega de la telemetría.