View a markdown version of this page

支援的代理程式架構 - Amazon Bedrock AgentCore

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

支援的代理程式架構

Amazon Bedrock AgentCore Evaluations 會評估使用數個代理程式架構建置的代理程式。代理程式發出什麼作為遙測,以及遙測的結構方式,取決於您使用 建置的代理程式架構,以及您用來記錄它的檢測程式庫。

對於每個支援的架構,本節說明:

  • 您可以使用的檢測程式庫。

  • 如何檢測您的代理程式。

  • 產生的跨度和事件記錄的外觀。

  • 評估服務如何找到所需的值,例如使用者提示、客服人員回應和工具呼叫。

AgentCore Evaluations 支援下列架構和檢測程式庫。Python 和 TypeScript 都支援數個架構。Python 和 TypeScript 版本的程式庫會發出不同的範圍名稱,因此每種語言都有自己的資料列。對於指定的架構和檢測程式庫,評估服務會從任一語言擷取相同的值。

客服人員架構 檢測程式庫 Language 範圍名稱 建議的版本

Strands 代理程式

內建 (Strands Agents SDK)

Python

strands.telemetry.tracer

最新

Strands 代理程式

內建 (Strands Agents SDK)

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 原生

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 原生

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 原生

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

Claude 代理程式開發套件

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

Python

openinference.instrumentation.claude_agent_sdk

>= 0.1.3

您的代理程式發出的每個範圍都有一個範圍名稱,用於識別產生它的檢測程式庫。評估服務會讀取此名稱,以告知其正在處理的程式庫,以及因此是否可以處理跨度和要尋找的屬性。範圍名稱是每個範圍和事件記錄上 scope.name 欄位的值。

屬性名稱和對話內容的位置會因架構和檢測程式庫而有所不同。如需單一架構的屬性和範例範圍,請參閱該架構的頁面。

注意

檢測您的代理程式只是產生遙測的一部分,評估服務可以讀取。您的代理程式也必須啟用可觀測性,以便將其遙測匯出至 Amazon CloudWatch。

如需 AgentCore 如何交付該遙測、服務在其中尋找所需的值,以及託管選項的設定步驟,請參閱遙測設定和交付。