本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 用户界面代理
<a name="ui-agents"></a>

用户界面代理是一种原生代理，它理解自然语言指令以执行复杂的浏览器操作。它可以自主浏览网站、点击、键入、读取数据，并生成针对下游自动化步骤进行了优化的结构化输出。示例用例包括在网页上汇总产品或通过浏览网站来获取数据。

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

标题  
 step/UI 代理人姓名

说明  
在此字段中，您可以用自然语言编写代理的提示。编写提示时的最佳做法：  
+ 要清楚明确地说明你想要什么。
+ 构造提示。首先提及 “任务” 或 “角色”，然后提及 “说明”，通过编号步骤完成任务
+ 添加约束条件（例如，仅查看产品部分）并指定何时这样 stop/end 做（例如，在找到相关信息时停止）
+ 提供正面和负面（不要这样做）的例子
+ 明确指定长度要求（例如，少于 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 代理

**字段类型**
+ *字符串*-文本值（名称、描述、摘要）
+ *数*字-数值（计数、分数、百分比）
+ *布尔* True/false 值-值（状态标志、 yes/no 问题）
+ *对象*-嵌套结构（复杂数据分组）
+ *Array*-项目列表（标签、类别、多个值）
+ *文件*-文件引用（文档附件、图像）
+ *数据表-表格*数据（结构化数据集、报告）

**处理复杂类型**

对象和数组可以包含嵌套字段：
+ 单击 “对象” 或 “数组” 字段旁边的展开箭头 (▶)
+ 在嵌套结构中使用 “添加” 字段
+ 将嵌套保持在 2-3 级以获得最佳性能

**示例配置**

以下是用于汇总客户反馈的简单配置：

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

此结构将配置为：
+ 订单编号（字符串，必填）
+ 数字OfOrders （数字，必填）
+ hasShipped（布尔值，必填）
+ 订单详情（对象，必填）
  + 数量（数字，必填）
  + 产品名称（字符串，必填）
+ 标签（字符串数组，可选）

**最佳实践**
+ 使用描述性字段名称-帮助 AI 了解要提取哪些数据
+ 添加清晰的描述-为复杂字段提供上下文
+ 将关键字段标记为必填字段-确保基本数据始终存在
+ 限制嵌套深度-保持结构简单以获得更好的性能
+ 测试您的配置-通过运行代理步骤并验证响应，验证输出是否符合您的预期。

**重要提示**
+ JSON 知识：不熟悉 JSON？ 在 json.org 上学习基础知识
+ 未验证：目前，系统不验证输出结构——确保您的自动化处理缺失或格式错误的数据