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

# 客服人員指示
<a name="about-aws-devops-agent-agent-instructions"></a>

使用代理程式指示來提供永遠上線的指引， AWS DevOps 代理程式會套用至每個工作階段。工作階段是與客服人員的單一對話或調查。在**客服人員**空間操作員 Web 應用程式的客服人員頁面上，您可以設定套用至所有客服人員的**全域指示**，或設定特定受管客服人員的指示，例如聊天或事件分類。這些指示會儲存為 AGENTS.md 檔案。與當客服人員將技能描述與目前任務相符時隨需[DevOps 代理程式技能](about-aws-devops-agent-devops-agent-skills.md)載入的 不同，無論客服人員正在處理什麼內容，客服人員指示一律會從每個工作階段的開頭開始出現。

## 什麼是客服人員指示
<a name="what-are-agent-instructions"></a>

客服人員指示為您的客服人員提供無條件、全年無休的指引。在每個工作階段開始時，客服人員服務會擷取為客服人員空間設定的指示，並將其內容直接注入客服人員系統提示中。代理程式不會決定是否載入它們；它們永遠存在。

每個客服人員工作階段都會收到來自全域指示和相關客服人員特定指示的指示，例如 Chat。

客服人員指示會儲存為 AGENTS.md 檔案[DevOps 代理程式技能](about-aws-devops-agent-devops-agent-skills.md)，並在幾個重要方面與 不同：


| 面向 | 技能 | 客服人員指示 (AGENTS.md：//) | 
| --- | --- | --- | 
| 名稱和描述 | 必要 | 不適用 | 
| 內容格式 | Markdown 或 ZIP 套件 | 僅限 Markdown | 
| 資源檔案 | 支援 | 不支援 | 
| 內容注入 | 隨需 （客服人員透過技能描述比對來決定） | 一律 （無條件，每個工作階段） | 
| Uniqueness | 每個客服人員空間多個 | 每個代理程式一個 （全域指示一個，每個受管代理程式一個） | 

客服人員指示沒有名稱或描述欄位。基礎 AGENTS.md 檔案僅包含沒有前端、不支援 ZIP 套件，以及沒有資源檔案的 Markdown。

## 為什麼要使用客服人員指示
<a name="why-use-agent-instructions"></a>

客服人員指示可讓您可靠地確保特定指引始終在內容中，而不取決於客服人員的技能載入決策。

**主要優點：**
+ 可**預測性：**無論客服人員正在處理的任務為何，指示一律存在。不需要符合描述，且客服人員無法略過內容。
+ **保證涵蓋範圍：**與根據任務相關性，代理程式可能會或可能不會載入的技能不同，代理程式指示一律會在每個工作階段開始時注入。
+ **站立政策：**使用代理程式指示來站立操作政策、安全準則、編碼標準或任何必須套用至每個工作階段的指引，無例外狀況。
+ **目標範圍：**您可以使用全域指示一次將指示套用至所有客服人員類型，或在指引僅與該客服人員的工作相關時，將指示限制為特定客服人員類型。

## 客服人員指示的運作方式
<a name="how-agent-instructions-work"></a>

當工作階段開始時，代理程式服務會擷取為代理程式空間設定的指示，並在工作階段開始之前將其內容插入代理程式系統提示。這會在每個工作階段中自動發生。代理程式不會評估是否載入它們；它一律會插入內容。

每個新工作階段都會在啟動時載入新指示。如果您更新指示，變更會在儲存後立即生效。已在進行中的工作階段會繼續使用啟動時載入的內容。

範圍決定工作階段收到的指示。全域指示適用於 Agent Space 中的所有代理程式類型，因此每個工作階段都會收到它們。代理程式特定指示僅適用於該特定代理程式類型的工作階段。工作階段會收到來自全域指示和相關客服人員特定指示的指示。

## 代理程式類型範圍
<a name="agent-type-scoping"></a>

範圍控制哪些客服人員工作階段會收到一組指定的指示。有兩種範圍選項：
+ **全域指示：**適用於您的客服人員空間中的所有客服人員類型。每個客服人員工作階段都會收到此內容。
+ **代理程式特定：**僅適用於所選代理程式類型的工作階段。

適用於客服人員特定指示的受管客服人員包括：
+ **聊天** - 聊天工作階段期間的臨機操作問題和請求。
+ **事件分類** - 警示篩選、嚴重性分類和初始範圍。
+ **事件 RCA** - 具有證據收集和驗證的根本原因分析。
+ **事件緩解** - 短期修補和長期修正建議。
+ **評估** - 客服人員效能評分和政策合規檢查。

## 內容大小指引
<a name="content-size-guidance"></a>

每次您開始對話或調查時，客服人員都會先讀取您的完整指示，再執行其他動作。代理程式每個工作階段的工作記憶體數量固定，而您的指示會使用其中一些。檔案越大，您的問題、調查、代理程式讀取的日誌及其推理的剩餘空間就越少。較短的重點指示可讓代理程式有更多容量來解決您的問題。
+ **硬性限制：**25 KB
+ **建議大小：**120 行 （建議用於大多數組態）

將您的指示集中在每個工作階段中必須存在的指導上。對於僅適用於特定任務的專門調查程序，請考慮[DevOps 代理程式技能](about-aws-devops-agent-devops-agent-skills.md)改用 。

## 範例
<a name="example"></a>

下列範例顯示格式正確的客服人員指示，其中包含適用於每個客服人員工作階段的調查指引、回應格式標準和安全要求。

```
# Agent Instructions

## Investigation approach
- Always check CloudWatch alarms and recent deployments before proposing a root cause.

## Response format
- Lead with a one-sentence summary of findings before listing details.
- Include the AWS region and resource identifier for any resource you reference.
- Use bullet points for lists of findings or recommendations.

## Security
- Never log, display, or suggest storing credentials or secrets in plaintext.
- When recommending IAM changes, follow least-privilege principles.
```

## 設定客服人員指示
<a name="setting-agent-instructions"></a>

設定客服人員指示之前，您必須擁有客服人員空間。如需詳細資訊，請參閱[建立 代理程式空間](getting-started-with-aws-devops-agent-creating-an-agent-space.md)。

每個代理程式只有一組指示。當您儲存新內容時，它會覆寫該代理程式的現有內容。

**若要設定全域指示 （適用於所有客服人員）：**

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

1. 選擇**全域指示**旁的**檢視**。

1. 在編輯器中輸入您的 Markdown 說明。

1. 選擇**儲存**。

**若要設定特定代理程式的指示：**

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

1. 在**受管客服人員**下，選擇您要設定的客服人員旁的**檢視**：**聊天**、**事件分類**、**事件 RCA**、**事件緩解**或**評估**。

1. 在編輯器中輸入您的 Markdown 說明。

1. 選擇**儲存**。

## 管理客服人員指示
<a name="managing-agent-instructions"></a>

AWS DevOps Agent 透過 Operator Web App 提供代理程式指示的管理功能。

**檢視指示：**導覽至**客服人員**頁面，然後選擇**全域指示**或特定受管客服人員旁的**檢視**。編輯器會顯示目前的內容。使用**預覽**索引標籤來查看轉譯的 Markdown 或**程式碼**索引標籤來查看原始 Markdown。

**編輯指示：**如上所述開啟代理程式，修改編輯器中的內容，然後選擇**儲存**。

**從檔案上傳指示：**開啟代理程式，然後在編輯器中選擇**上傳**按鈕，從您的電腦上傳 Markdown 檔案。

**下載說明：**開啟代理程式，然後在編輯器中選擇**下載**按鈕，將目前內容下載為檔案。

**刪除指示：**開啟代理程式，在編輯器中選擇**刪除**按鈕，並確認刪除。這個動作無法復原。如果您再次需要內容，請考慮先下載內容。