View a markdown version of this page

执行自定义代理 - AWS DevOps 代理人
按需运行自定义代理安排自定义代理管理触发器取消调用工具调用结果

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

执行自定义代理

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

按需运行自定义代理

您可以立即从代理详细信息页面或通过聊天运行自定义代理。

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

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

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

  3. 选择 “立即运行” 以使用其配置的指令执行代理。

要为特定运行提供更多上下文，请选择 “立即运行” 旁边的下拉箭头，输入描述代理在此调用中应重点关注的内容的提示，然后选择 “带提示运行”。该提示与其系统提示符一起作为附加上下文传递给代理。

运行开始后，新的调用将显示在 “历史记录” 选项卡中，状态为 “待启动”。选择调用以实时查看其轨迹。

要使用 Chat 运行自定义代理，请执行以下操作：

让 Chat 按名称运行代理。例如：

Run my weekly-investigation-report agent.
Run certificate-checker and focus on certificates expiring in the next 7 days.

当您在聊天消息中提供其他上下文时，Chat 会将其作为运行提示进行传递。如果您不提供其他上下文，则代理仅在配置的系统提示符下运行。

自定义代理一次只能运行一次调用。如果代理已经在运行，则必须等待当前调用完成、超时或取消后才能启动另一次调用。

安排自定义代理

触发器允许您根据定义的条件自动运行自定义代理。 AWS DevOps 代理目前支持基于计划的触发器，这些触发器使用 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 UTC

      • cron(0 0 1 * ? *)— 每个月的第一天午夜 UTC

      • cron(0 */6 ? * * *)— 每 6 小时一次

当表达式有效时，将显示一条绿色确认消息。

  1. 选择创建。

对于 cron 表达式，月中某一天或一周中的某一必须是?（问号）。有关计划表达式语法的更多信息，请参阅 Amazon EventBridge Scheduler 用户指南中的计划类型。

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

您也可以以编程方式创建触发器。使用 S AWS DK 调用devops-agent客户端的CreateTrigger操作，这需要aidevops:CreateTrigger权限。或者，在中将触发器建模为AWS::DevOpsAgent::Trigger资源 AWS CloudFormation。基于时间表的触发器引用其运行的自定义代理，因此请先创建代理。有关AWS::DevOpsAgent::Trigger资源类型的更多信息，请参阅管理资产。

管理触发器

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

暂停触发器：

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

删除触发器：

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

取消调用

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

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

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

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

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

Cancel the running invocation of weekly-health-report.

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

工具调用结果

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

工具调用结果可以透明地了解代理在调用期间的操作：

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

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

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