本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
执行自定义代理
您可以按需执行自定义代理,也可以将触发器配置为自动运行。
按需运行自定义代理
您可以立即从代理详情页面或通过 Chat 运行自定义代理。
要从详情页面运行自定义代理,请执行以下操作:
在您的代理 Web 应用程序中导航到 DevOps 代理页面。
选择要运行的自定义代理。
选择 Run Now 以使用其配置的指令执行代理。
要为特定运行提供其他上下文,请选择 “立即运行” 旁边的下拉箭头,输入提示描述代理在此次调用中应重点关注的内容,然后选择带提示运行。该提示与其系统提示一起作为附加上下文传递给代理。
运行开始后,新的调用将出现在 “历史记录” 选项卡中,状态为 “待启动”。选择调用以实时查看其轨迹。
要使用 Chat 运行自定义代理,请执行以下操作:
让 Chat 按名字运行代理。例如:
Run my weekly-investigation-report agent.
Run certificate-checker and focus on certificates expiring in the next 7 days.
当您在聊天消息中提供其他上下文时,Chat 会将其作为该运行的提示传递。如果您不提供其他上下文,则代理仅使用其配置的系统提示符运行。
一个自定义代理一次只能运行一个调用。如果代理已经在运行,则必须等待当前调用完成、超时或取消后再启动另一个调用。
安排自定义代理
触发器允许您根据定义的条件自动运行自定义代理。 AWS DevOps Agent 目前支持基于调度的触发器,这些触发器使用 EventBridge-compatible cron 或速率表达式定期执行代理。
要创建计划触发器,请执行以下操作:
在您的代理 Web 应用程序中导航到 DevOps 代理页面。
选择要安排的自定义代理。
选择触发器选项卡。
选择 +(创建)按钮。
在对话框的输入字段中输入计划表达式。表达式必须是以下格式之一:
速率表达式-以固定间隔运行。格式:
rate(value unit)。示例:rate(1 hour)— 每小时rate(30 minutes)— 每 30 分钟一次rate(7 days)— 每 7 天一次
Cron 表达式 — 按特定计划运行。格式:
cron(minutes hours day-of-month month day-of-week year)。示例:cron(0 9 ? * MON-FRI *)— 每个工作日上午 9:00(世界标准时间)cron(0 0 1 * ? *)— 每个月的第一天午夜(UTC)cron(0 */6 ? * * *)— 每 6 小时
表达式有效时,会显示一条绿色的确认消息。
选择创建。
对于 cron 表达式,必须?恰好是月中的某一天或一周中的某一天(问号)。有关计划表达式语法的更多信息,请参阅 Amazon EventBridge 计划程序用户指南中的计划类型。
创建后,触发器将出现在列表中,显示其表达式、创建日期和下次计划运行时间。
管理触发器
触发器选项卡显示为自定义代理配置的所有触发器。对于每个触发器,您可以看到计划表达式、其创建时间以及下次运行的时间。
暂停触发器:
要在不删除代理的情况下暂时停止触发器调用代理,请关闭触发器旁边的切换开关。触发器状态更改为 “已暂停”,并且在重新启用之前不再触发。重新打开开关以恢复日程安排。
删除触发器:
要永久删除触发器,请选择要移除的触发器旁边的删除图标(垃圾桶)。在出现的对话框中确认删除。已删除的触发器无法恢复。
取消调用
您可以从调用轨迹视图或通过聊天取消正在运行的调用。
要从轨迹视图中取消正在运行的调用,请执行以下操作:
从 “历史记录” 选项卡中,选择正在运行的调用。
选择轨迹视图顶部的 “取消”。
要使用 Chat 取消正在运行的调用,请执行以下操作:
Cancel the running invocation of weekly-health-report.
调用状态更改为 “已取消”。取消之前完成的任何工作都将保留在轨迹中。取消时正在进行的工具调用可能仍会完成。
工具调用结果
在调用期间,自定义代理调用 MCP 工具来收集数据、执行操作和生成输出。每次工具调用及其结果都记录在调用轨迹中。
工具调用结果可以透明地了解代理在调用期间所做的事情:
成功调用工具-工具返回代理用于继续工作的数据。例如,
query_cloudwatch_logs返回日志条目或use_aws返回 API 响应。工具调用失败-工具返回错误。代理可以重试、尝试其他方法或在其输出中报告失败。
您可以检查调用轨迹中的单个工具调用及其结果,以了解代理的行为,验证其访问的资源是否正确,并对意外结果进行故障排除。有关查看轨迹的更多信息,请参阅查看调用轨迹。