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

# 执行自定义代理
<a name="custom-agents-executing-custom-agents"></a>

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

## 按需运行自定义代理
<a name="running-a-custom-agent-on-demand"></a>

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

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

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

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

1. 选择 **Run Now** 以使用其配置的指令执行代理。

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

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

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

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

```
Run my weekly-investigation-report agent.
```

```
Run certificate-checker and focus on certificates expiring in the next 7 days.
```

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

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

## 安排自定义代理
<a name="scheduling-custom-agents"></a>

触发器允许您根据定义的条件自动运行自定义代理。 AWS DevOps Agent 目前支持基于调度的触发器，这些触发器使用 EventBridge-compatible cron 或速率表达式定期执行代理。

**要创建计划触发器，请执行以下操作：**

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

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

1. 选择**触发器**选项卡。

1. 选择 **\+**（创建）按钮。

1. 在对话框的输入字段中输入计划表达式。表达式必须是以下格式之一：
   + **速率表达式**-以固定间隔运行。格式：`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 计划程序用户指南*中的计划[类型](https://docs.aws.amazon.com/scheduler/latest/UserGuide/schedule-types.html)。

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

## 管理触发器
<a name="managing-triggers"></a>

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

**暂停触发器：**

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

**删除触发器：**

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

## 取消调用
<a name="canceling-an-invocation"></a>

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

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

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

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

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

```
Cancel the running invocation of weekly-health-report.
```

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

## 工具调用结果
<a name="tool-call-results"></a>

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

工具调用结果可以透明地了解代理在调用期间所做的事情：
+ **成功调用工具**-工具返回代理用于继续工作的数据。例如，`query_cloudwatch_logs`返回日志条目或`use_aws`返回 API 响应。
+ **工具调用失败**-工具返回错误。代理可以重试、尝试其他方法或在其输出中报告失败。

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