View a markdown version of this page

执行自定义代理 - AWS DevOps 代理人

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

执行自定义代理

您可以按需执行自定义代理,也可以将触发器配置为自动运行。

按需运行自定义代理

您可以立即从代理详情页面或通过 Chat 运行自定义代理。

要从详情页面运行自定义代理,请执行以下操作:

  1. 在您的代理 Web 应用程序中导航到 DevOps 代理页面。

  2. 选择要运行的自定义代理。

  3. 选择 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 或速率表达式定期执行代理。

要创建计划触发器,请执行以下操作:

  1. 在您的代理 Web 应用程序中导航到 DevOps 代理页面。

  2. 选择要安排的自定义代理。

  3. 选择触发器选项卡。

  4. 选择 +(创建)按钮。

  5. 在对话框的输入字段中输入计划表达式。表达式必须是以下格式之一:

    • 速率表达式-以固定间隔运行。格式: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 小时

表达式有效时,会显示一条绿色的确认消息。

  1. 选择创建

对于 cron 表达式,必须?恰好是月中的某一天或一周中的某一天(问号)。有关计划表达式语法的更多信息,请参阅 Amazon EventBridge 计划程序用户指南中的计划类型

创建后,触发器将出现在列表中,显示其表达式、创建日期和下次计划运行时间。

管理触发器

触发器选项卡显示为自定义代理配置的所有触发器。对于每个触发器,您可以看到计划表达式、其创建时间以及下次运行的时间。

暂停触发器:

要在不删除代理的情况下暂时停止触发器调用代理,请关闭触发器旁边的切换开关。触发器状态更改为 “已暂停”,并且在重新启用之前不再触发。重新打开开关以恢复日程安排。

删除触发器:

要永久删除触发器,请选择要移除的触发器旁边的删除图标(垃圾桶)。在出现的对话框中确认删除。已删除的触发器无法恢复。

取消调用

您可以从调用轨迹视图或通过聊天取消正在运行的调用。

要从轨迹视图中取消正在运行的调用,请执行以下操作:

  1. 从 “历史记录” 选项卡中,选择正在运行的调用。

  2. 选择轨迹视图顶部的 “取消”。

要使用 Chat 取消正在运行的调用,请执行以下操作:

Cancel the running invocation of weekly-health-report.

调用状态更改为 “已取消”。取消之前完成的任何工作都将保留在轨迹中。取消时正在进行的工具调用可能仍会完成。

工具调用结果

在调用期间,自定义代理调用 MCP 工具来收集数据、执行操作和生成输出。每次工具调用及其结果都记录在调用轨迹中。

工具调用结果可以透明地了解代理在调用期间所做的事情:

  • 成功调用工具-工具返回代理用于继续工作的数据。例如,query_cloudwatch_logs返回日志条目或use_aws返回 API 响应。

  • 工具调用失败-工具返回错误。代理可以重试、尝试其他方法或在其输出中报告失败。

您可以检查调用轨迹中的单个工具调用及其结果,以了解代理的行为,验证其访问的资源是否正确,并对意外结果进行故障排除。有关查看轨迹的更多信息,请参阅查看调用轨迹。