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

# 建立自訂代理程式
<a name="custom-agents-creating-a-custom-agent"></a>

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

建立自訂代理程式之前，您必須擁有至少具有一個連線整合的代理程式空間。如需詳細資訊，請參閱[建立 代理程式空間](getting-started-with-aws-devops-agent-creating-an-agent-space.md)。

## 使用 表單建立自訂代理程式
<a name="creating-a-custom-agent-using-the-form"></a>

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

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

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

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

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

1. 填寫表單：
   + **名稱** – 代理程式的唯一識別符。僅使用小寫字母、數字和連字號 （最多 64 個字元）。不得以連字號開頭或結尾。範例：`weekly-health-report`
   + **系統提示** – 定義代理程式執行的操作及其操作方式的說明，以 Markdown 撰寫 （最少 10 個字元，最多 50，000 個字元）。如需撰寫有效提示的指引，請參閱[撰寫系統提示](#writing-a-system-prompt)。
   + **Skills** （選用） – 從客服人員空間中選取技能，為客服人員提供額外的網域知識或功能。使用搜尋欄位依名稱尋找技能。

1. 選擇**建立代理程式**。

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

## 使用聊天功能建立自訂代理程式
<a name="creating-a-custom-agent-using-chat"></a>

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

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

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

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

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

1. 聊天會引導您完成協作程序：
   + **意圖釐清** – 確認代理程式的目的和範圍。
   + **重複檢查** – 驗證您的客服人員空間中不存在類似的客服人員。
   + **工具和技能選擇** – 提議客服人員所需的 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.
```

## 撰寫系統提示
<a name="writing-a-system-prompt"></a>

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

**使用以下區段建構您的系統提示：**
+ **目標** – 客服人員應該在單一句子或短段落中完成什麼。
+ **方法** – 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 格式** – 標頭、清單和程式碼區塊可讓客服人員更輕鬆地剖析和遵循提示。

## 設定工具
<a name="configuring-tools"></a>

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.
```

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

## 設定技能
<a name="configuring-skills"></a>

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

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

自訂代理程式也具有內建功能，可用來建立不需要技能指派的成品和建議。如需詳細資訊，請參閱[自訂代理程式輸出](custom-agents-custom-agent-outputs.md)。

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