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

# 客服人員
<a name="actions-agents"></a>
+ **UI 代理**程式 - 適用於 Web 瀏覽器任務的 AI 代理程式。用於動態和智慧型 Web 自動化。只需撰寫指示，即可讓其導覽網站、擷取資料和產生結構化輸出。
+ **自訂代理**程式 - 複雜任務的 AI 代理程式。建立可以理解自然語言指示的代理程式，並使用可用的工具採取動作。用於需要推理、判斷和動態規劃的任務。

## UI 代理程式
<a name="ui-agents"></a>

UI 代理程式是原生代理程式，可了解執行複雜瀏覽器動作的自然語言指示。它可以自動導覽網站、按一下、輸入、讀取資料，並產生針對下游自動化步驟最佳化的結構化輸出。範例使用案例包括摘要網頁上的產品，或透過導覽網站擷取資料。

### Properties
<a name="ui-agent-properties"></a>

Title  
步驟/UI 代理程式的名稱

指示  
在此欄位中，您會以自然語言撰寫客服人員的提示。撰寫提示時的最佳實務：  
+ 清楚且明確地說明您想要的內容。
+ 建構提示。首先提及 'Task' 或 'Role'，然後 'Instructions' 以編號步驟完成任務
+ 新增限制條件 （例如，僅檢閱產品區段），並指定何時停止/結束 （例如，找到相關資訊時停止）
+ 提供正面和負面 （不要這樣做） 範例
+ 明確指定長度需求 （例如少於 100 個字） 或輸出格式 （例如 MM/DD/YY 格式的日期）
以三引號 (""") 包裝文字以撰寫多行提示。例如：  

```
"""Task: Locate the company's latest annual report.
* Visit the provided URL.
* Look for the annual report. The report may be titled 'Annual Report', 'Financial Report', 'Year in Review', or similar variations..."""
```

結構化輸出 （選用）  
客服人員回應：指派此操作輸出的變數名稱

### 如何設定結構化輸出欄位
<a name="ui-agent-structured-output"></a>

**新增欄位**
+ 按一下新增欄位以建立新的輸出欄位
+ 輸入輸出名稱 - 這會成為 JSON 屬性名稱
+ 從下拉式清單中選取類型
+ 如果欄位必須一律存在，則勾選必要
+ 新增描述以引導 AI 代理器

**欄位類型**
+ *字串* - 文字值 （名稱、描述、摘要）
+ *數字* - 數值 （計數、分數、百分比）
+ *布林值* - 是/否值 （狀態旗標，是/否問題）
+ *物件* - 巢狀結構 （複雜資料群組）
+ *Array* - 項目清單 （標籤、類別、多個值）
+ *檔案* - 檔案參考 （文件附件、影像）
+ *資料表* - 表格式資料 （結構化資料集、報告）

**使用複雜類型**

物件和陣列可包含巢狀欄位：
+ 按一下物件或陣列欄位旁的展開箭頭 (▶)
+ 在巢狀結構中使用新增欄位
+ 保持最多 2-3 個層級的巢狀化，以獲得最佳效能

**範例組態**

以下是摘要客戶意見回饋的簡單組態：

```
{
  "orderId": "12345",
  "numberOfOrders": 3,
  "hasShipped": true,
  "orderDetails": {
    "quantity": 2,
    "productName": "ABC",
  },
  "tags": ["electronics", "urgent"]
}
```

此結構會設定為：
+ orderId （字串，必要）
+ numberOfOrders （數字，必要）
+ hasShipped （布林值，必要）
+ orderDetails （物件，必要）
  + 數量 （數字，必要）
  + productName （字串，必要）
+ tags （字串陣列，選用）

**最佳實務**
+ 使用描述性欄位名稱 - 協助 AI 了解要擷取的資料
+ 新增明確描述 - 提供複雜欄位的內容
+ 將關鍵欄位標記為必要 - 確保基本資料永遠存在
+ 限制巢狀深度 - 讓結構保持簡單，以獲得更好的效能
+ 測試您的組態 - 透過執行代理程式步驟並驗證回應來驗證輸出是否符合您的期望。

**重要說明**
+ JSON 知識：不熟悉 JSON？ 前往 https：//json.org 了解基本概念
+ 無驗證：目前，系統不會驗證輸出結構 - 確保您的自動化處理遺失或格式不正確的資料

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

自訂代理程式是一種智慧型動作，可處理自然語言輸入，以使用整合的工具呼叫功能自動化複雜的步驟。它主要使用整合做為其工具界面，同時提供可擴展性以使用程式碼做為工具，以及其他原生動作human-in-the-loop任務。代理程式提供結構化、可預測的輸出，最佳化以無縫整合到下游自動化步驟。

### Properties
<a name="custom-agent-properties"></a>
+ **標題**：步驟/自訂代理程式的名稱
+ **模式**： 模式會根據您的使用案例定義代理程式的運作方式。三種可用的模式為：快速、專業和自訂。Fast 非常適合簡單的任務，例如摘要、分類和大量自動化，而 Pro 非常適合涉及推理和協調多個工具或動作的複雜任務。Fast 和 Pro 是全受管模式，不需要預先設定。在自訂模式中，您將需要 Bedrock 執行期連接器，並且可以選擇要使用的模型 （如下所述）。當您已針對特定 Bedrock 模型進行提示微調、特別需要代理程式的特定 Bedrock 模型，或想要在 Bedrock 上包含您自己的自訂或微調模型時，這是理想的選擇。在自訂模式中，由於您透過整合從 Bedrock 取得自己的模型，因此模型推論會分別向與該 Bedrock 整合相關聯的帳戶計費。
+ **指示**：在此欄位中，您會以自然語言撰寫客服人員的提示。撰寫提示時的最佳實務：
  + 清楚且明確地說明您想要的內容。
  + 建構提示。首先提及 'Task' 或 'Role'，然後 'Instructions' 以編號步驟完成任務
  + 若要改善工具呼叫準確性並引導客服人員，請在提示中明確指定每個步驟要使用的工具，如果適用的話。
  + 明確指定長度需求 （例如少於 100 個字） 或輸出格式 （例如 MM/DD/YY 格式的日期）
  + 以三引號 (""") 包裝文字以撰寫多行提示。例如：

    ```
    """You are content summarization agent.
    Summarize the last two paragraphs of the provided text, focusing only on the main conclusion."""
    ```
+ **動作**：動作是一種工具，可讓 AI 代理器與外部系統互動或執行特定任務。這是選用的。您可以執行自訂代理程式，無需任何動作。以下是可在自訂代理程式中使用的不同動作
  + **一般動作**
    + **建立使用者任務** - 如果啟用，此工具可讓客服人員在執行期間卡住並需要協助時觸發Human-in-the-Loop(HITL) 任務。客服人員會暫停並等待人工輸入。HITL 任務會顯示在任務中心。為了獲得最佳結果，作者可以在提示中指定代理程式應該何時叫用 HITL。預設會選取此項。自動化會持續執行，直到任務完成為止。
    + **程式碼** - 程式碼動作會在受限的 python 環境中產生並執行 python 程式碼，與程式碼動作相同，以解決涉及計算、資料處理和檔案處理的任務。與程式碼產生器不同，它會主動建立和執行指令碼以完成目標、使用 Excel、PDF 檔案、各種資料格式和可用的整合
      + **關鍵功能：**
        + **檔案操作**：處理多標籤 Excel 檔案、擷取內容、執行日期計算、套用條件式格式化，以及將結果上傳至 S3
        + **資料轉換**：在 JSON 和資料表格式之間轉換、轉換資料、重新命名資料欄和聯結資料表
        + **進階運算**：產生數值序列並執行自動化驗證
  + **整合**：如果您已將 Salesforce、MS Exchange 或 Bedrock 等特定整合動作新增至自動化群組，則其對應的動作會顯示在此處，以供自訂代理程式使用。然後，作者可以選取要用作代理程式工具的相關動作。

    可做為自訂代理程式中工具/動作的整合清單
    + Amazon S3
    + Amazon Bedrock Data 自動化
    + Amazon Comprehend
    + Amazon Textract
    + 自訂 REST API
    + 自訂 MCP 連接器
    + Microsoft Outlook
    + Salesforce
+ **結構化輸出 （選用）**

  設定 AI 代理器以傳回下游步驟可處理的結構化 JSON 輸出。此功能非常適合文字摘要、報告產生、資料轉換，以及從非結構化內容擷取統計資料。此為選用欄位。如果您未定義結構化輸出，代理程式預設會以自然語言傳回輸出。當您的輸出具有已定義的結構時，請使用結構化輸出，例如清單、資料表或 JSON。
**注意**  
自訂代理程式的結構化輸出組態遵循與 UI 代理程式相同的格式。如需詳細的組態指示，請參閱 UI 代理程式結構化輸出一節。
+ **客服人員回應**：指派客服人員輸出的變數名稱。如果已定義，回應會遵循 JSON 結構描述中的結構化輸出格式，否則為自由格式文字。

### 在自訂代理程式中使用自訂模型 （使用您自己的底版模型）
<a name="custom-agent-byom"></a>

整合您在 AWS Bedrock 中託管的所需或自訂微調模型與 Quick Suite 自動化工作流程。

開始之前，請確定您有下列項目：
+ 在 AWS Bedrock 中部署和存取的微調模型
+ 建立連接器的 Quick Suite Admin 存取權
+ 具有 Bedrock 調用模型許可的 IAM 角色
+ 您的模型 ID （例如 `us.anthropic.claude-3-5-sonnet-20241022-v2:0`)

**步驟 1：**遵循中的詳細說明建立 Bedrock 執行期動作整合 [AWS 服務動作連接器](builtin-services-integration.md)

**步驟 2：**設定您的自動化群組

建立自動化群組並連接整合：
+ **建立自動化群組** - 遵循 中的詳細說明 [設定任務](getting-started-quick-automate.md#automate-setup-tasks)
+ **設定整合** - 遵循 中的詳細說明 [設定任務](getting-started-quick-automate.md#automate-setup-tasks)
+ 設定完成後，連接器會出現在您的可用資產清單中

**步驟 3：**設定自訂代理程式

新增並設定自訂代理程式以使用您的微調模型：
+ 在自動化工作流程中，新增自訂代理程式
+ 設定下列代理程式設定：
  + **客服人員標題**：輸入客服人員的描述性名稱
  + **指示**：輸入根據您的使用案例量身打造的自訂提示
  + **模式**：選取自訂
  + **連接器**：選擇 Bedrock 執行期連接器 （選取自訂模式時需要）
  + **自訂模型**：輸入您的模型 ID （例如 `us.anthropic.claude-3-5-sonnet-20241022-v2:0`) - 選取自訂模式時為必要

**後續步驟**

設定完成後，您的自訂代理程式會根據您提供的指示，使用微調後的模型來處理請求。您現在可以將此代理程式納入您的 Quick Automate 工作流程。

**注意**  
確保您的模型 ID 已正確格式化，且與您的 AWS Bedrock 帳戶中部署的模型相符。您可以在已佈建模型下的 AWS Bedrock 主控台中找到模型 ID。

### 自訂代理程式測試
<a name="custom-agent-testing"></a>

自訂代理程式測試可讓您獨立於完整的自動化工作流程測試個別代理程式。此功能可協助您驗證客服人員行為、偵錯提示，以及更有效率地重複執行，而無需執行整個工作流程。

#### 先決條件
<a name="custom-agent-testing-prerequisites"></a>
+ 具有至少一個已設定自訂代理程式的自動化工作流程
+ 在您的工作區中執行自動化的適當許可

#### 開始測試
<a name="custom-agent-testing-start"></a>
+ 在工作流程畫布中，將滑鼠游標移到您要測試的客服人員卡上
+ 選擇顯示在卡片頂端的**單位測試**按鈕
+ 在開啟的變數集合視窗中，檢閱客服人員提示中自動偵測到的變數
  + 提示預覽會以反白方式顯示所有偵測到的變數
+ 輸入每個變數的值
  + 值必須使用有效的表達式語法
  + 如果值包含無效的語法，則會顯示錯誤訊息並防止測試執行

#### 監控測試執行
<a name="custom-agent-testing-monitor"></a>

在測試執行期間，您可以在畫面右側的稽核面板中監控進度。測試會略過所有先前的工作流程步驟，並僅執行選取的代理程式。您可以獲得與完整工作流程執行相同的記錄體驗。

#### 檢閱測試結果
<a name="custom-agent-testing-results"></a>

測試完成後，請檢閱測試面板中的下列資訊：
+ 指標卡 （測試面板頂端的監控索引標籤）
  + 總執行時間
  + 使用的工具數量
  + 建立的任務數量
+ 在 之間登入
+ 監看變數索引標籤 （測試面板的基礎一致性）
  + 輸入 - 檢視輸入變數及其值
  + 輸出 - 檢查代理程式執行的輸出結果
  + 對於結構化輸出，請按一下檢視詳細資訊按鈕，選擇 JSON 檢視器以開啟檢視輸出對話方塊：
    + 欄位索引標籤 - 使用樹狀結構檢視導覽資料
    + 欄位 - 在欄位索引標籤中選取樹狀節點，反白顯示對應的值
    + 輸出欄位 - 對應 JSON 金鑰的值

### 搭配 Build with Assistant 使用自訂代理程式
<a name="custom-agent-build-with-assistant"></a>

自訂代理程式目前的原則是必須特別提及，才能持續叫用它，以下是提示中顯示它所需的項目：

```
- Function names: `use_inline_agent`
- Representation names: "Custom Agent", "Inline Agent" → use `use_inline_agent`
- Generic terms: "agentic skills" → default to `use_inline_agent`
```

否則，模型偏好以決定性方式撰寫工作流程。

雖然實際上，當沒有適當的動作可用時，規劃器可能會選擇自訂代理程式做為解決方法。但是，為了在工作流程中持續叫用自訂代理程式，建議在提示中使用上述片語。

### 代理程式使用案例範例
<a name="custom-agent-examples"></a>

**使用案例 1：電子郵件分類和指派代理程式**

**角色：**您是電子郵件分類和指派代理程式

**說明：**請遵循下列步驟：
+ 步驟 1：根據所提供參考表的類別欄將傳入的電子郵件分類為知識
+ 步驟 2：使用電子郵件系統傳送通知：
  + 從：【system\$1email】
  + 收件人：【team\$1distribution\$1email】
  + 主旨：【分類結果】
  + 內文：包含簡短摘要，說明來自原始電子郵件的分類推理和關鍵點
+ 步驟 3：針對所有有效的類別 (「未知」除外），在 Salesforce 中以下列方式建立新案例：
  + 主旨：【原始電子郵件主旨】
  + 描述：來自電子郵件內文的摘要問題
  + 優先順序：根據內容緊急程度 (High/Medium/Low)
  + 類型：選取適當的類型 Question/Problem/Feature請求/其他）
  + 狀態：'New'
  + 類別：【步驟 1 的分類結果】
+ 步驟 4：如果分類為「未知」：
  + 向主管呈報以進行手動檢閱
  + 新增說明為何分類不確定的備註
  + 根據從主管收到的類別，遵循步驟 2 和 3 並停止
  + 如果從主管收到的類別不明或無效，請停止