在 Agent Studio 中设计智能体

本页面简要介绍了如何在Google Cloud 控制台中使用 Agent Studio。

Agent Studio 是 Google Cloud 控制台中的一款低代码可视化设计器，可简化智能体开发。您可以直观地映射代理工作流、实时测试回答，并在部署或过渡到代码之前尝试不同的配置。

本文档概述了 Agent Studio，并介绍了如何设置环境、创建和测试代理，以及如何将代理直接部署到生产运行时。

设置环境

在使用 Agent Studio 之前，请先设置Google Cloud。

获取所需的角色

如需获得使用 Agent Studio 所需的权限，请让您的管理员为您授予项目的 Agent Platform User (roles/aiplatform.user) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

创建代理

请按照以下步骤在 Agent Studio 中设计和测试智能体：

  1. 在 Google Cloud 控制台中，前往代理页面。

    前往“代理”

  2. 点击创建代理，打开新代理的 Agent Studio 画布。

  3. 在 Agent Studio 画布中设计并保存代理。您可以在以下标签页之间切换：

    • 流程：直观地呈现智能体的工作流程和控制逻辑，从而创建主智能体和子智能体。

      1. 点击某个代理，打开该代理的详细信息面板。您还可以点击添加子代理商 (+) 来添加子代理商。

      2. 在详细信息面板中配置主代理和子代理：

        1. 名称：添加一个有助于识别代理的名称。

        2. 说明：对代理用途的总结。

        3. 指令：添加指令以引导智能体。

        4. 模型：选择为代理提供支持的模型。

        5. 工具：点击添加工具 (+) 以添加可让智能体完成任务的工具。如需了解详情，请参阅设置和添加工具。

      3. 如需保存代理，请点击画布标题中的保存，然后按照提示操作。如需了解详情，请参阅保存代理。

    • “预览”标签页：在预览窗格中与智能体 Chat，测试其功能和回答。

  4. 点击获取代码即可查看您的代理代码。如果您想在其他地方继续开发代理，可以复制代码并将其粘贴到您选择的代码编辑器中。

智能体完成后，您可以直接从 Agent Studio 部署它。 如需了解详情，请参阅从 Agent Studio 部署代理。

保存代理

您必须先保存代理，然后才能预览或部署代理，因为未保存的代理尚无身份。如需首次保存代理，请执行以下操作：

  1. 在 Agent Studio 画布中，点击保存。

  2. 在保存代理对话框中，输入代理名称。

  3. 点击保存。

首次保存后，Agent Studio 会自动保存您所做的任何后续更改。如果您尝试在保存新代理之前离开画布，Agent Studio 会提示您先保存。

在 Agent Studio 中设置和添加工具

您可以为智能体配置以下工具：

  • Google 搜索：支持智能体使用 Google 搜索执行网页搜索。 默认处于开启状态。

  • 网址上下文：让模型分析发送给代理的提示中的网址。 默认处于开启状态。

  • Agent Platform Search 数据存储区：点击添加 (+)，让您的代理访问 Agent Search 数据存储区中已编入索引的信息。

    如果您没有现有的数据存储区，请参阅自定义搜索使用入门，了解如何创建数据存储区。然后，为服务账号授予对 Agent Platform Search 的访问权限：

    1. 在 Google Cloud 控制台中，前往 IAM 页面。

      前往 Identity and Access Management (IAM)

    2. 点击授予访问权限。

    3. 在新的主账号字段中，输入以下服务账号信息：

      service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com。

    4. 选择 + 添加角色。搜索并选择 Discovery Engine 用户。 点击应用，然后点击保存。

  • MCP 服务器：直接连接 Model Context Protocol (MCP) 服务器。

    1. 如需通过连接到 MCP 服务器来添加 MCP 工具，请点击 MCP 服务器旁边的添加 (+)。
    2. MCP 显示名称：输入 MCP 服务器的名称。
    3. 端点网址：输入 MCP 服务器的端点网址。
    4. 身份验证：自动填充为无。Agent Studio 仅支持不需要身份验证的 MCP 服务器。

    您的代理可以使用已连接的 MCP 服务器中的所有工具。

从 Agent Studio 部署智能体

创建并预览智能体后，您可以将其部署到生产环境。如需从 Agent Studio 部署智能体，请按以下步骤操作：

  1. 在代理列表页面中，点击要部署的代理。 系统会显示所选代理的“代理详情”页面。
  2. 点击部署以打开部署到 Agent Runtime 实例对话框。

  3. （可选）修改代理的显示名称或说明。

  4. 从可用区域列表中选择一个部署区域，然后点击确定。

  5. 点击部署。

部署会创建新的运行时实例，最多可能需要五分钟才能完成。成功后，Agent Studio 画布的 Flow 标签页上会显示一条消息。您的智能体现在已可用于生产用途，并且可以安全地与外部应用集成。

查看已部署的代理

如需查看已部署的代理，请执行以下操作：

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

    前往 Agent Platform

  2. 使用区域列表按部署区域进行过滤。

  3. 属于所选项目的已部署代理会显示在列表中。

  4. 点击指定代理的名称。系统会打开相应代理的指标页面。

  5. 选择测试平台标签页以测试您的代理。

  6. 在聊天窗格中输入测试查询，以验证代理是否成功运行。

如需详细了解代理的可用指标，请参阅查看已部署代理的指标。