View a markdown version of this page

建立自訂代理程式 - AWS DevOps 代理程式
使用 表單建立自訂代理程式使用聊天功能建立自訂代理程式從儲存庫匯入自訂代理程式社群自訂代理程式撰寫系統提示設定工具Release Manager 工具設定技能

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

建立自訂代理程式

您可以透過兩種方式建立自訂代理程式：使用 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.

從儲存庫匯入自訂代理程式

您可以直接從 GitHub 儲存庫中的 Markdown 檔案匯入自訂代理程式的系統提示。檔案內容會成為客服人員的系統提示。您可以在版本控制中管理客服人員提示，並使用單一動作將其匯入。

先決條件：

  • 與您的客服人員空間相關聯的 GitHub 帳戶。若要連接 GitHub 帳戶，請參閱 連接 GitHub。任何 GitHub 帳戶連線都可以從公有儲存庫匯入。對於私有儲存庫，關聯的帳戶必須具有儲存庫的讀取存取權。也支援具有資料駐留連線的 GitHub Enterprise Server 和 GitHub Enterprise Cloud。

  • 包含系統提示的 GitHub 儲存庫中的 Markdown 檔案 (.md)。

若要從儲存庫匯入自訂代理程式：

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

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

  3. 在對話方塊中，選擇匯入。對話方塊會變更為從 GitHub 檢視匯入。

  4. 填寫表單：

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

    • 儲存庫 URL – 單一 Markdown (.md) 檔案的連結，其中包含客服人員的系統提示。例如：https://github.com/my-org/my-repo/blob/main/my-agent.md。對於資料駐留的 GitHub Enterprise Server 或 GitHub Enterprise Cloud，請改用您的執行個體 URL。例如：https://github.example.com/my-org/my-repo/blob/main/my-agent.md。如果 URL 結尾不是 .md，則會出現警告。如果檔案不是 Markdown，匯入會失敗。

    • 技能 （選用） – 從客服人員空間中選取技能，為客服人員提供額外的領域知識或功能。

  5. 選擇匯入代理程式。

儲存庫檔案僅提供系統提示。名稱和技能來自 表單。

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

檢視匯入的客服人員：

匯入的客服人員會在客服人員詳細資訊頁面上顯示其名稱旁的 GitHub 徽章同步，以及 GitHub 上上次同步的時間戳記和來源檔案的連結。在自訂客服人員清單中，匯入的客服人員包含其來源檔案的連結。

如果您編輯匯入的客服人員，系統提示會顯示唯讀標籤，其中包含連結至來源檔案的提示。名稱和技能仍可編輯。

同步匯入的客服人員：

當您更新儲存庫中的 Markdown 檔案時，請開啟匯入的客服人員詳細資訊頁面，然後選擇同步以提取最新的系統提示。

限制條件：

  • URL 格式 – 僅接受 GitHub URLs，包括具有資料駐留的 GitHub Enterprise Server 和 GitHub Enterprise Cloud。連接的 GitHub 帳戶必須符合 URL 主機。例如，github.example.com連線只能從 github.example.com URLs匯入，不能從 github.com URLs匯入。

  • 需要 Markdown 檔案 – URL 必須指向單一.md檔案。

  • 檔案大小上限 – 檔案不得超過 1 MB (GitHub API 限制）。

  • 需要 GitHub 帳戶 – 您的代理程式空間必須具有關聯的 GitHub 帳戶才能匯入代理程式。對於私有儲存庫，帳戶必須具有讀取存取權。

社群自訂代理程式

AWS DevOps 代理程式工具儲存庫包含預先建置的自訂代理程式組態，可用於經常性操作任務，例如運作狀態報告、操作檢閱和服務配額監控。儲存庫由 AWS DevOps Agent 服務團隊維護，所有貢獻在新增之前都會經過相同的安全審查列。若要瀏覽可用的項目，請參閱 GitHub 網站上的自訂客服人員目錄。

若要使用社群自訂代理程式，請使用 代理程式頁面上的從儲存庫匯入流程從儲存庫匯入它。複製代理程式 Markdown 檔案的 URL，並將其貼上為儲存庫 URL。如需詳細資訊，請參閱從儲存庫匯入自訂代理程式。

撰寫系統提示

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

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

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

  • 方法 – 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.

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

Release Manager 工具

自訂代理程式可存取 Release Manager 工具。這些工具可讓您的代理程式建立、列出、取得和取消 Release Manager 任務。您的代理程式也可以分析發佈準備度檢閱報告，以呈現問題清單和建議的動作。

若要使用 Release Manager 工具，請透過聊天將工具指派給您的自訂代理程式。例如：

Add the release manager tools to my release-pipeline-agent.

如需版本管理功能的詳細資訊，請參閱 版本管理。

設定技能

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

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

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

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