View a markdown version of this page

執行自訂代理程式 - AWS DevOps 代理程式

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

執行自訂代理程式

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

隨需執行自訂代理程式

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

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

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

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

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

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

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

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

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

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

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

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

排程自訂代理程式

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

若要建立排程觸發:

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

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

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

  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 表達式,每月某day-of-month或day-of-week必須是 ?(問號)。如需排程表達式語法的詳細資訊,請參閱《Amazon EventBridge 排程器使用者指南》中的排程類型

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

管理觸發條件

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

暫停觸發:

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

刪除觸發條件:

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

取消調用

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

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

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

  2. 選擇軌跡檢視頂端的取消

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

Cancel the running invocation of weekly-health-report.

呼叫狀態會變更為「已取消」。在取消之前完成的任何工作都會保留在軌跡中。發生取消時正在進行的工具呼叫仍可能完成。

工具呼叫結果

在調用期間,自訂代理程式會叫用 MCP 工具來收集資料、執行動作和產生輸出。每個工具呼叫及其結果都會記錄在調用軌跡中。

工具呼叫結果可提供客服人員在調用期間所做動作的透明度:

  • 成功工具呼叫 – 工具傳回代理程式用來繼續其工作的資料。例如, query_cloudwatch_logs會傳回日誌項目,或use_aws傳回 API 回應。

  • 失敗的工具呼叫 – 工具傳回錯誤。代理程式可能會重試、嘗試替代方法,或在其輸出中報告失敗。

您可以在調用軌跡中檢查個別工具呼叫及其結果,以了解客服人員的行為、驗證其是否存取正確的資源,以及對非預期的結果進行疑難排解。如需檢視軌跡的詳細資訊,請參閱檢視調用軌跡