本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
執行自訂代理程式
您可以隨需執行自訂代理程式,或設定觸發以自動執行代理程式。
隨需執行自訂代理程式
您可以立即從客服人員詳細資訊頁面或透過聊天執行自訂客服人員。
若要從詳細資訊頁面執行自訂代理程式:
導覽至 DevOps Agent Web 應用程式中的客服人員頁面。
選擇您要執行的自訂代理程式。
選擇立即執行,以使用其設定的指示執行代理程式。
若要提供特定執行的其他內容,請選擇立即執行旁的下拉箭頭,輸入描述代理程式在此調用中應關注的提示,然後選擇使用提示執行。提示會與系統提示一起傳遞給客服人員,做為其他內容。
執行開始後,新的調用會出現在歷史記錄索引標籤中,狀態為「待定開始」。選擇調用以即時檢視其軌跡。
若要使用聊天執行自訂代理程式:
要求聊天依名稱執行代理程式。例如:
Run my weekly-investigation-report agent.
Run certificate-checker and focus on certificates expiring in the next 7 days.
當您在聊天訊息中提供其他內容時,聊天會將其傳遞為該執行的提示。如果您不提供其他內容,代理程式只會使用其設定的系統提示來執行 。
自訂代理程式一次只能執行一個調用。如果代理程式已在執行中,您必須等待目前的調用完成、逾時或取消,才能啟動另一個。
排程自訂代理程式
觸發條件可讓您根據定義的條件自動執行自訂代理程式。 AWS DevOps 代理程式目前支援以排程為基礎的觸發程序,這些觸發程序會使用 EventBridge 相容的 Cron 或 Rate 運算式,以週期性間隔執行代理程式。
若要建立排程觸發:
導覽至 DevOps Agent Web 應用程式中的客服人員頁面。
選擇您要排程的自訂代理程式。
選擇 Triggers (觸發條件) 索引標籤。
選擇 + (建立) 按鈕。
在對話方塊中,在輸入欄位中輸入排程表達式。表達式必須是下列其中一種格式:
速率表達式 – 以固定間隔執行。格式:
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 UTCcron(0 0 1 * ? *)– 每月第一天午夜 UTCcron(0 */6 ? * * *)– 每 6 小時
當表達式有效時,會出現綠色確認訊息。
選擇建立。
對於 cron 表達式,每月某day-of-month或day-of-week必須是 ?(問號)。如需排程表達式語法的詳細資訊,請參閱《Amazon EventBridge 排程器使用者指南》中的排程類型。
建立後,觸發條件會出現在清單中,顯示其表達式、建立日期和下一個排定的執行時間。
管理觸發條件
Triggers 索引標籤會顯示為自訂代理程式設定的所有觸發。對於每個觸發,您可以查看排程表達式、建立的時間,以及下次執行的時間。
暫停觸發:
若要暫時停止觸發程序調用代理程式而不將其刪除,請關閉觸發程序旁的切換開關。觸發狀態會變更為「已暫停」,且不會再觸發,直到重新啟用為止。重新開啟切換以繼續排程。
刪除觸發條件:
若要永久移除觸發條件,請選擇您要移除的觸發條件旁的刪除圖示 (垃圾桶)。在出現的對話方塊中確認刪除。刪除的觸發無法復原。
取消調用
您可以從調用軌跡檢視或透過聊天取消執行中的調用。
若要從軌跡檢視取消執行中的調用:
從歷史記錄索引標籤中,選擇執行中的調用。
選擇軌跡檢視頂端的取消。
若要使用聊天取消執行中的調用:
Cancel the running invocation of weekly-health-report.
呼叫狀態會變更為「已取消」。在取消之前完成的任何工作都會保留在軌跡中。發生取消時正在進行的工具呼叫仍可能完成。
工具呼叫結果
在調用期間,自訂代理程式會叫用 MCP 工具來收集資料、執行動作和產生輸出。每個工具呼叫及其結果都會記錄在調用軌跡中。
工具呼叫結果可提供客服人員在調用期間所做動作的透明度:
成功工具呼叫 – 工具傳回代理程式用來繼續其工作的資料。例如,
query_cloudwatch_logs會傳回日誌項目,或use_aws傳回 API 回應。失敗的工具呼叫 – 工具傳回錯誤。代理程式可能會重試、嘗試替代方法,或在其輸出中報告失敗。
您可以在調用軌跡中檢查個別工具呼叫及其結果,以了解客服人員的行為、驗證其是否存取正確的資源,以及對非預期的結果進行疑難排解。如需檢視軌跡的詳細資訊,請參閱檢視調用軌跡。