View a markdown version of this page

建立自訂代理程式 - AWS DevOps 代理程式
使用 表單建立自訂代理程式使用聊天功能建立自訂代理程式撰寫系統提示設定工具設定技能

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

建立自訂代理程式

您可以透過兩種方式建立自訂代理程式：在 DevOps Agent Web 應用程式中使用 表單，或在聊天中透過引導式對話。這兩種方法都會產生相同的自訂代理程式組態，存放在您的代理程式空間中。

建立自訂代理程式之前，您必須擁有至少具有一個連線整合的代理程式空間。如需詳細資訊，請參閱建立 代理程式空間。

使用 表單建立自訂代理程式

表單可讓您透過指定名稱、系統提示和選用技能，快速建立自訂代理程式。若要將 MCP 工具指派給客服人員，請在建立客服人員後使用聊天功能。

若要使用 表單建立自訂代理程式：

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

  2. 在自訂客服人員區段中，選擇建立客服人員。

  3. 在對話方塊中，選擇表單。

  4. 填寫表單：

    • 名稱 – 代理程式的唯一識別符。僅使用小寫字母、數字和連字號 （最多 64 個字元）。不得以連字號開頭或結尾。範例：weekly-health-report

    • 系統提示 – 定義代理程式執行的操作及其操作方式的說明，以 Markdown 撰寫 （最少 10 個字元，最多 50，000 個字元）。如需撰寫有效提示的指引，請參閱撰寫系統提示。

    • Skills （選用） – 從客服人員空間中選取技能，為客服人員提供額外的網域知識或功能。使用搜尋欄位依名稱尋找技能。

  5. 選擇建立代理程式。

建立後，系統會將您重新導向至客服人員的詳細資訊頁面，您可以在其中檢視組態、執行客服人員或設定觸發條件。

使用聊天功能建立自訂代理程式

聊天提供建立自訂客服人員的引導式對話體驗。當您想要將 MCP 工具指派給客服人員，或需要撰寫系統提示的協助時，建議使用此方法。

若要使用聊天功能建立自訂代理程式：

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

  2. 在自訂客服人員區段中，選擇建立客服人員。

  3. 在對話方塊中，選擇聊天。對話方塊會關閉，並在聊天面板中開啟新的對話，其中包含預先編寫的訊息。

  4. 聊天會引導您完成協作程序：

    • 意圖釐清 – 確認代理程式的目的和範圍。

    • 重複檢查 – 驗證您的客服人員空間中不存在類似的客服人員。

    • 工具和技能選擇 – 提議客服人員所需的 MCP 工具和技能，並要求您確認。

    • 輸出類型 – 決定代理程式是否應該產生文字回應、成品或建議。

    • 系統提示草稿 – 撰寫系統提示並呈現供您檢閱。您可以反覆運算，直到您滿意為止。

    • 確認 – 建議名稱，並在建立代理程式之前確認所有設定。

您也可以隨時直接要求 Chat 來建立自訂代理程式。例如：

Create an agent that generates a weekly report of all investigations from the past week.
Create a custom agent for checking certificate expiration across all accounts.
Make me an agent that audits DynamoDB table configurations daily.

撰寫系統提示

系統提示是自訂代理程式中最重要的部分。它定義了代理程式的目的、方法、限制條件和預期的輸出。撰寫良好的提示會產生一致、可靠的結果。

使用以下區段建構您的系統提示：

  • 目標 – 客服人員應該在單一句子或短段落中完成什麼。

  • 方法 – Step-by-step程序，參考其應呼叫的特定工具名稱和順序。

  • 限制條件 – 代理程式應執行和不應執行的操作的界限。例如，唯讀存取、要考慮的時間範圍或要排除的服務。

  • 輸出 – 代理程式應該產生什麼以及採用什麼格式。指定是否應該產生文字、建立成品或建立建議。

系統提示範例：

You are a DevOps reporting agent specializing in summarizing investigation activity.

## Goal
Generate a concise weekly report of all investigations from the past 7 days.

## Approach
1. Call `list_investigations` to fetch investigations from the last 7 days.
2. For each investigation, retrieve its title, status, root cause, and resolution time.
3. Group investigations by status and root cause category.
4. Identify trends: services most affected, average resolution time, recurring root causes.

## Constraints
- Only include investigations from the past 7 days.
- Read-only access — do not modify, close, or reassign investigations.

## Output
Produce a single artifact titled "Weekly Investigation Report" containing:
- A table listing each investigation with title, status, and resolution time.
- A chart showing investigation counts by root cause category.
- A summary paragraph with key trends and recommendations.

有效系統提示的提示：

  • 請具體說明工具 – list_investigations直接參考工具名稱 （例如，、use_aws、query_cloudwatch_logs)，以便客服人員知道要呼叫哪些工具。

  • 定義成功條件 – 描述什麼是良好的輸出，以便客服人員知道何時完成。

  • 設定界限 – 明確說明代理程式不應採取哪些動作來防止意外動作。

  • 使用 Markdown 格式 – 標頭、清單和程式碼區塊可讓客服人員更輕鬆地剖析和遵循提示。

設定工具

MCP 工具會決定您的自訂代理程式在調用期間可執行的動作。您可以從 Agent Space 中可用的完整集合中選取工具，包括來自連線 AWS 帳戶、可觀測性平台、CI/CD 管道、票證系統和自訂 MCP 伺服器的工具。

工具只能透過聊天設定。若要在建立代理程式時指派工具，請使用聊天建立方法。若要在現有客服人員上新增或變更工具，請要求聊天功能更新客服人員。例如：

Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
Update certificate-checker to also use the list_resources tool.
Remove the use_kubectl tool from cluster-audit-agent.

選取工具時，請遵循最低權限原則：僅指派客服人員完成其任務所需的工具。這可降低意外動作的風險，並讓客服人員保持專注。

設定技能

技能為您的自訂代理程式提供額外的領域知識、調查程序或專業功能。當自訂代理程式執行時，它會載入其指派的技能，並且可以在調用期間參考其指示。

您可以在建立期間指派技能 （使用表單或聊天），或稍後透過編輯客服人員來新增技能。指派給自訂客服人員的技能必須已存在於您的客服人員空間中。如需建立技能的詳細資訊，請參閱 DevOps 代理程式技能。

自訂代理程式也具有內建功能，可用來建立不需要技能指派的成品和建議。如需詳細資訊，請參閱自訂代理程式輸出。

每個自訂代理程式最多可以指派 200 個技能。選擇與客服人員目的相關的技能，以減少內容耗用並改善客服人員焦點。