使用代理

使用 Agent Platform SDK

使用 Agent Platform SDK 时，无论代理是在本地运行还是远程部署，用于查询代理的代码都是相同的 。由于不同框架支持的操作集各不相同，因此我们针对特定于框架的模板提供了使用说明：

框架 说明
智能体开发套件 根据 Google 内部最佳实践设计，适用于构建 AI 应用的开发者或需要快速开发原型并部署基于代理的强大解决方案的团队。
Agent2Agent（预览版） Agent2Agent (A2A) protocol 是一种开放标准，旨在让 AI 代理之间实现无缝通信和协作。
LangChain 由于具有预定义配置和抽象，因此更易于用于基本应用场景。
LangGraph 用于定义工作流的基于图表的方法，具有高级人机协同 (human-in-the-loop) 和快退/重放功能。
AG2（以前称为 AutoGen） AG2 提供多代理对话框架，作为构建 LLM 工作流的高级抽象。
LlamaIndex（预览版） LlamaIndex 的查询流水线提供了一个高级接口，用于创建检索增强生成 (RAG) 工作流。
自定义 未使用框架专用模板开发和部署的代理。

使用在 localhost 上提供的代理

如果您通过 API 服务器提供代理，该服务器正在监听 http://localhost:PORT_NUMBER上的请求，那么您将向以下地址发送请求：

http://localhost:PORT_NUMBER/API_PATH

其中

  • PORT_NUMBER 是服务器正在监听的端口号（例如 8080）
  • API_PATH 是相应 API 端点的路径（例如 run 或 run_sse）

通过底层 API 使用已部署的代理

如果您已部署代理，那么您 将向相应端点发送请求：

https://LOCATION-aiplatform.googleapis.com/reasoningEngines/v1/projects/PROJECT_NUMBER/locations/<var>LOCATION</var>/reasoningEngines/RESOURCE_ID/api/API_PATH

其中

此端点相当于将 localhost 基本网址替换为已部署的代理基本网址。

举几个例子，如果您从 ADK API 服务器 从 Dockerfile 或 容器映像 部署，请按如下方式调用 API 端点：

运行代理（单个响应） 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the capital of France?"}]
  }
}'

运行代理（流式传输） 

curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/api/run_sse -d '{
  "appName": "my_sample_agent",
  "userId": "u_123",
  "sessionId": "s_abc",
  "newMessage": {
    "role": "user",
    "parts": [{"text": "What is the weather in New York?"}]
  },
  "streaming": true
}'

在 Google Cloud 控制台中使用已部署的代理

对于使用智能体开发套件 (ADK) 开发的已部署代理，您可以使用 Google Cloud 控制台与代理互动：

  1. 在 Google Cloud 控制台中，前往 Agent Platform 部署页面。

    前往 Agent Platform 部署页面

    属于所选项目的运行时会显示在列表中。您可以使用过滤条件 字段，按指定的列过滤列表。

  2. 点击运行时的名称。

  3. 点击 Playground 标签页。

  4. 您可以输入消息 与代理互动，然后点击新建会话 以与代理开始新的会话。

  5. 如果您通过 OpenTelemetry 启用了 跟踪记录，则可以在互动期间查看有关代理行为的详细信息：

    • 跟踪记录 ：与代理对话的跟踪记录。

    • 事件：与代理对话期间调用的 API 和事件详细信息的图表。

    • 状态：与代理对话期间有关代理状态的信息。

    • 会话：与代理关联的会话列表。如需了解详情，请参阅使用 Google Cloud 控制台或 API 调用进行管理

Playground 支持

您可以使用以下框架来试用代理：

框架 与代理 Chat 查看会话
智能体开发套件 (ADK) 支持 支持。需要代理实现 Agent Platform 会话 以实现持久性。
Agent2Agent (A2A) 支持。需要代理实现 Agent Platform 会话 以实现持久性。 支持。需要代理使用 Agent Platform 会话，并且代理必须 发送 user_id 值作为上下文对象的一部分。如需查看如何将 user_id 值作为代理执行器的一部分传递的示例，请参阅“开始使用 A2A”笔记本。

后续步骤