本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 執行自訂代理程式
<a name="custom-agents-executing-custom-agents"></a>

您可以隨需執行自訂代理程式，或設定觸發以自動執行代理程式。

## 隨需執行自訂代理程式
<a name="running-a-custom-agent-on-demand"></a>

您可以立即從客服人員詳細資訊頁面或透過聊天執行自訂客服人員。

**若要從詳細資訊頁面執行自訂代理程式：**

1. 導覽至 DevOps **Agent** Web 應用程式中的客服人員頁面。

1. 選擇您要執行的自訂代理程式。

1. 選擇**立即執行**，以使用其設定的指示執行代理程式。

若要提供特定執行的其他內容，請選擇**立即執行**旁的下拉箭頭，輸入描述代理程式在此調用中應關注的提示，然後選擇**使用提示執行**。提示會與系統提示一起傳遞給客服人員，做為其他內容。

執行開始後，新的調用會出現在**歷史記錄**索引標籤中，狀態為「待定開始」。選擇調用以即時檢視其軌跡。

**若要使用聊天執行自訂代理程式：**

要求聊天依名稱執行代理程式。例如：

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

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

當您在聊天訊息中提供其他內容時，聊天會將其傳遞為該執行的提示。如果您不提供其他內容，代理程式只會使用其設定的系統提示來執行 。

自訂代理程式一次只能執行一個調用。如果代理程式已在執行中，您必須等待目前的調用完成、逾時或取消，才能啟動另一個。

## 排程自訂代理程式
<a name="scheduling-custom-agents"></a>

觸發條件可讓您根據定義的條件自動執行自訂代理程式。 AWS DevOps 代理程式目前支援以排程為基礎的觸發程序，這些觸發程序會使用 EventBridge 相容的 Cron 或 Rate 運算式，以週期性間隔執行代理程式。

**若要建立排程觸發：**

1. 導覽至 DevOps **Agent** Web 應用程式中的客服人員頁面。

1. 選擇您要排程的自訂代理程式。

1. 選擇 **Triggers (觸發條件)** 索引標籤。

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 UTC
     + `cron(0 0 1 * ? *)` – 每月第一天午夜 UTC
     + `cron(0 */6 ? * * *)` – 每 6 小時

當表達式有效時，會出現綠色確認訊息。

1. 選擇**建立**。

對於 cron 表達式，每月某day-of-month或day-of-week必須是 `?`（問號）。如需排程表達式語法的詳細資訊，請參閱《*Amazon EventBridge 排程器使用者指南*》中的排程[類型](https://docs.aws.amazon.com/scheduler/latest/UserGuide/schedule-types.html)。

建立後，觸發條件會出現在清單中，顯示其表達式、建立日期和下一個排定的執行時間。

## 管理觸發條件
<a name="managing-triggers"></a>

**Triggers** 索引標籤會顯示為自訂代理程式設定的所有觸發。對於每個觸發，您可以查看排程表達式、建立的時間，以及下次執行的時間。

**暫停觸發：**

若要暫時停止觸發程序調用代理程式而不將其刪除，請關閉觸發程序旁的切換開關。觸發狀態會變更為「已暫停」，且不會再觸發，直到重新啟用為止。重新開啟切換以繼續排程。

**刪除觸發條件：**

若要永久移除觸發條件，請選擇您要移除的觸發條件旁的刪除圖示 （垃圾桶）。在出現的對話方塊中確認刪除。刪除的觸發無法復原。

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

您可以從調用軌跡檢視或透過聊天取消執行中的調用。

**若要從軌跡檢視取消執行中的調用：**

1. 從**歷史記錄**索引標籤中，選擇執行中的調用。

1. 選擇軌跡檢視頂端的**取消**。

**若要使用聊天取消執行中的調用：**

```
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)。