View a markdown version of this page

管理自訂代理程式 - AWS DevOps 代理程式

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

管理自訂代理程式

建立自訂代理程式之後,您可以編輯其組態、檢視其調用歷史記錄,並在不再需要時將其刪除。

編輯自訂代理程式

您可以使用表單或透過聊天編輯自訂代理程式。表單可讓您更新名稱、系統提示和技能。若要修改客服人員的工具,請使用聊天功能。

若要使用 表單編輯自訂代理程式:

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

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

  3. 在客服人員詳細資訊頁面上,選擇編輯

  4. 在對話方塊中,選擇表單

  5. 修改您要更新的欄位:

    • 名稱 – 更新客服人員的識別符 (與建立相同的限制條件:小寫、連字號、最多 64 個字元)。

    • 系統提示 – 修改客服人員的指示 (最少 10 個字元,最多 50,000 個字元)。

    • 技能 – 使用搜尋欄位新增或移除技能。

  6. 選擇儲存

您未修改的欄位會保留其目前的值。透過表單編輯時,會保留客服人員指派的工具。

若要使用聊天功能編輯自訂客服人員:

您可以詢問 Chat 來更新任何欄位,包括工具。例如:

Update weekly-health-report to also check for Lambda function errors.
Add the use_kubectl tool to my cluster-audit-agent.
Change the system prompt of certificate-checker to also report certificates expiring within 30 days.

聊天會擷取目前的客服人員組態、套用您請求的變更,並在儲存前確認。您未提及的欄位保持不變。

檢視調用歷史記錄

客服人員詳細資訊頁面會顯示自訂客服人員所有調用的完整歷史記錄,包括狀態、觸發來源和時間戳記。

若要檢視調用歷史記錄:

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

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

  3. 選擇 History (歷程記錄) 索引標籤。

調用資料表會顯示下列資訊:

資料行 說明
調用 叫用代理程式時提供的任務標題或描述。
狀態 目前的調用狀態 (請參閱下文)。
觸發者 呼叫的啟動方式 — 排程執行的觸發器名稱,或隨需呼叫的「手動」。
已開始 調用開始的日期和時間。
上次更新 最近狀態變更的日期和時間。

您可以依狀態篩選呼叫,或依標題搜尋。資料表每 10 秒會自動重新整理一次,以顯示執行調用的更新狀態。

調用狀態:

狀態 說明
等待開始 呼叫會排入佇列並等待排程。
執行中 代理程式正在主動執行。
Succeeded 呼叫已成功完成。
失敗 呼叫發生錯誤並停止。
逾時 調用超過 1 小時的逾時限制。
已取消 呼叫已在完成之前手動取消。

檢視調用軌跡

調用軌跡會顯示客服人員工作的完整追蹤,包括客服人員在單一調用期間產生的每個工具呼叫、結果和文字輸出。

若要檢視調用軌跡:

  1. 歷史記錄索引標籤中,選擇您要檢查的調用。

  2. 檢閱軌跡時間軸。

時間軸會顯示下列步驟類型:

  • 工具呼叫 – 客服人員叫用哪些工具,以及使用哪些參數。

  • 工具結果 – 每個工具傳回的回應。

  • 文字輸出 – 代理程式在調用期間產生的訊息。

  • 產生的輸出 – 代理程式產生的任何成品或建議,以時間軸結尾的連結顯示。

對於執行調用,軌跡會即時更新。您可以選擇軌跡檢視頂端的取消,以取消執行中的調用。

刪除自訂代理程式

重要

刪除自訂代理程式不會影響已在進行中的調用。執行中的調用會繼續,直到完成、逾時或取消為止。不過,刪除後無法再次叫用代理程式。

您可以使用 Chat 刪除自訂代理程式。刪除是永久的,無法復原。

若要刪除自訂代理程式:

要求聊天依名稱刪除客服人員。例如:

Delete the custom agent weekly-health-report.

聊天會在刪除前確認客服人員名稱和類型。如果代理程式具有作用中的觸發條件,則會將其與代理程式一起移除。