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

# 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 了解基本概念
+ 無驗證：目前，系統不會驗證輸出結構 - 確保您的自動化處理遺失或格式不正確的資料