本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置代理生成器
Agent Builder 为创建可用于生产的 AI 代理提供了全面的配置选项。本节介绍如何配置和管理 Agent Builder 部署。
系统提示符配置
系统提示符定义了您的代理的行为、个性和能力。要配置系统提示符,请执行以下操作:
-
在代理生成器向导中,导航到配置代理步骤。
-
在文本编辑器中编辑系统提示模板。
-
包括以下内容的明确说明:
-
代理人的角色和目的
-
如何使用可用工具(MCP 服务器)
-
响应格式首选项
-
行为指南
-
-
如果需要,使用重置为默认值按钮恢复原始模板。
代理提示的最佳实践:
-
具体说明代理的能力和局限性
-
提供所需行为的清晰示例
-
包括工具使用说明以及何时调用这些工具
-
定义回复格式期望
-
为代理行为设定界限
MCP 服务器集成
模型上下文协议 (MCP) 服务器为代理提供对企业工具和数据源的访问权限。要配置 MCP 服务器,请执行以下操作:
-
在 “配置代理” 步骤中,找到 “MCP 服务器” 部分。
-
在下拉菜单中从可用的 MCP 服务器中进行选择。
注意
在部署代理之前,必须对 MCP 服务器进行配置和访问。代理将自动发现和使用已配置的 MCP 服务器公开的工具。有关服务器设置和工具配置,请参阅 MCP 文档。
内存设置
Agent Builder 为维护上下文和知识提供了两种类型的内存:
短期记忆
默认情况下,所有代理都处于启用状态:
-
维护会话中的对话背景
-
自动捕获用户消息和代理回复
-
由 actorID 和 sessionID 整理以实现适当的隔离
-
无需配置
长期记忆
用于跨会话存储见解的可选功能:
-
在 “配置代理” 步骤中,找到 “内存配置” 部分。
-
切换启用长期记忆以激活。
-
启用后,代理可以:
-
提取和存储对话中的重要信息
-
从之前的会话中检索相关上下文
-
积累有关用户偏好和历史记录的知识
-
注意
长期记 AgentCore 忆使用具有语义记忆策略和默认保留设置的内存。
监视代理生成器部署
Agent Builder 通过 CloudWatch 仪表板和指标提供全面监控。
访问 CloudWatch 仪表板
-
导航到您的 AWS 账户中的 CloudWatch 控制台。
-
从左侧导航栏中选择 “仪表板”。
-
找到名为的仪表板
AgentBuilder-<UseCaseId>。 -
查看实时指标和历史性能数据。
日志访问和分析
代理日志可在 CloudWatch 日志中找到:
-
在 AWS 控制台中导航到 “ CloudWatch 日志”。
-
查找前缀为的日志组。
/aws/bedrock-agentcore/runtimes/ -
使用 CloudWatch Insights 查询和分析日志。
-
搜索特定的请求 IDs 或错误模式。