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 |
|
Mais recente |
|
Strands Agents |
Built-in (SDK para agentes Strands) |
TypeScript |
|
|
|
LangGraph |
OpenTelemetry ( |
Python |
|
|
|
LangGraph |
OpenInference ( |
Python |
|
|
|
LangGraph |
OpenTelemetry, ADOT-native |
TypeScript |
|
|
|
LangGraph |
OpenTelemetry ( |
TypeScript |
|
|
|
LangGraph |
OpenInference ( |
TypeScript |
|
|
|
Agentes OpenAI |
OpenTelemetry ( |
Python |
|
|
|
Agentes OpenAI |
OpenInference ( |
Python |
|
|
|
Agentes OpenAI |
OpenTelemetry, ADOT-native |
TypeScript |
|
|
|
Agentes OpenAI |
OpenInference ( |
TypeScript |
|
|
|
SDK de IA Vercel |
OpenTelemetry, ADOT-native |
TypeScript |
|
|
|
LlamaIndex |
OpenTelemetry ( |
Python |
|
|
|
LlamaIndex |
OpenInference ( |
Python |
|
|
|
Google ADK |
OpenInference ( |
Python |
|
|
|
SDK do agente Claude |
OpenInference ( |
Python |
|
|
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.