View a markdown version of this page

配置代理生成器 - AWS 上的生成式人工智能应用程序构建者

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

配置代理生成器

Agent Builder 为创建可用于生产的 AI 代理提供了全面的配置选项。本节介绍如何配置和管理 Agent Builder 部署。

系统提示符配置

系统提示符定义了您的代理的行为、个性和能力。要配置系统提示符,请执行以下操作:

  1. 在代理生成器向导中,导航到配置代理步骤。

  2. 在文本编辑器中编辑系统提示模板。

  3. 包括以下内容的明确说明:

    • 代理人的角色和目的

    • 如何使用可用工具(MCP 服务器)

    • 响应格式首选项

    • 行为指南

  4. 如果需要,使用重置为默认值按钮恢复原始模板。

代理提示的最佳实践:

  • 具体说明代理的能力和局限性

  • 提供所需行为的清晰示例

  • 包括工具使用说明以及何时调用这些工具

  • 定义回复格式期望

  • 为代理行为设定界限

MCP 服务器集成

模型上下文协议 (MCP) 服务器为代理提供对企业工具和数据源的访问权限。要配置 MCP 服务器,请执行以下操作:

  1. 在 “配置代理” 步骤中,找到 “MCP 服务器” 部分。

  2. 在下拉菜单中从可用的 MCP 服务器中进行选择。

注意

在部署代理之前,必须对 MCP 服务器进行配置和访问。代理将自动发现和使用已配置的 MCP 服务器公开的工具。有关服务器设置和工具配置,请参阅 MCP 文档。

内存设置

Agent Builder 为维护上下文和知识提供了两种类型的内存:

短期记忆

默认情况下,所有代理都处于启用状态:

  • 维护会话中的对话背景

  • 自动捕获用户消息和代理回复

  • 由 actorID 和 sessionID 整理以实现适当的隔离

  • 无需配置

长期记忆

用于跨会话存储见解的可选功能:

  1. 在 “配置代理” 步骤中,找到 “内存配置” 部分。

  2. 切换启用长期记忆以激活。

  3. 启用后,代理可以:

    • 提取和存储对话中的重要信息

    • 从之前的会话中检索相关上下文

    • 积累有关用户偏好和历史记录的知识

注意

长期记 AgentCore 忆使用具有语义记忆策略和默认保留设置的内存。

监视代理生成器部署

Agent Builder 通过 CloudWatch 仪表板和指标提供全面监控。

访问 CloudWatch 仪表板

  1. 导航到您的 AWS 账户中的 CloudWatch 控制台。

  2. 从左侧导航栏中选择 “仪表板”。

  3. 找到名为的仪表板AgentBuilder-<UseCaseId>

  4. 查看实时指标和历史性能数据。

日志访问和分析

代理日志可在 CloudWatch 日志中找到:

  1. 在 AWS 控制台中导航到 “ CloudWatch 日志”。

  2. 查找前缀为的日志组。/aws/bedrock-agentcore/runtimes/

  3. 使用 CloudWatch Insights 查询和分析日志。

  4. 搜索特定的请求 IDs 或错误模式。