View a markdown version of this page

Estruturas de agentes compatíveis - Base da Amazônia AgentCore

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Estruturas de agentes compatíveis

O Amazon Bedrock AgentCore Evaluations avalia agentes criados com várias estruturas de agentes. O que um agente emite como telemetria e como essa telemetria é estruturada dependem da estrutura do agente com a qual você cria e da biblioteca de instrumentação usada para registrá-la.

Para cada estrutura suportada, esta seção descreve:

  • As bibliotecas de instrumentação que você pode usar.

  • Como instrumentar seu agente.

  • Qual a aparência dos períodos e registros de eventos resultantes.

  • Como o serviço de avaliação localiza os valores de que precisa, como a solicitação do usuário, a resposta do agente e as chamadas da ferramenta.

AgentCore As avaliações suportam as seguintes estruturas e bibliotecas de instrumentação. Várias estruturas são suportadas em Python e. TypeScript O Python e TypeScript as versões de uma biblioteca emitem nomes de escopo diferentes, então cada linguagem tem sua própria linha. Para uma determinada estrutura e biblioteca de instrumentação, o serviço de avaliação extrai os mesmos valores de qualquer idioma.

Estrutura de agentes Biblioteca de instrumentação Linguagem Nome do escopo Versão recomendada

Strands Agents

Built-in (SDK para agentes Strands)

Python

strands.telemetry.tracer

Mais recente

Strands Agents

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

OpenTelemetry (opentelemetry-instrumentation-openai-agents)

Python

opentelemetry.instrumentation.openai_agents

>= 0.61.0

Agentes OpenAI

OpenInference (openinference-instrumentation-openai-agents)

Python

openinference.instrumentation.openai_agents

>= 1.5.0

Agentes OpenAI

OpenTelemetry, ADOT-native

TypeScript

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

>= 0.12.0

Agentes OpenAI

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

TypeScript

@arizeai/openinference-instrumentation-openai-agents

>= 0.2.2

SDK de IA 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

Google ADK

OpenInference (openinference-instrumentation-google-adk)

Python

openinference.instrumentation.google_adk

>= 0.1.13

SDK do agente Claude

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

Python

openinference.instrumentation.claude_agent_sdk

>= 0.1.3

Cada intervalo que seu agente emite carrega um nome de escopo, que identifica a biblioteca de instrumentação que o produziu. O serviço de avaliação lê esse nome para saber com qual biblioteca está lidando e, portanto, se ele pode processar a extensão e quais atributos procurar. O nome do escopo é o valor do scope.name campo em cada registro de intervalo e evento.

Os nomes dos atributos e a localização do conteúdo da conversa diferem de acordo com a estrutura e a biblioteca de instrumentação. Para ver os atributos e exemplos de extensões de uma única estrutura, consulte a página dessa estrutura.

nota

Instrumentar seu agente é apenas uma parte da produção de telemetria que o serviço de avaliação pode ler. Seu agente também deve ter a observabilidade ativada para exportar sua telemetria para a Amazon. CloudWatch

Para saber como AgentCore fornece essa telemetria, onde o serviço encontra os valores de que precisa e as etapas de configuração para sua opção de hospedagem, consulte Configuração e entrega de telemetria.