在 Experience Builder 中使用 Arcade 助手 (Beta)

Arcade 助手 (Beta) 使用人工智能 (AI) 根据以自然语言输入的指令生成 ArcGIS Arcade 表达式。 为获得最佳效果，请使用清晰易懂的语言，并迭代您收到的回复。

ArcGIS Experience Builder 支持使用 Arcade 添加数据并将高级格式化应用于微件和列表项目。 在所有情况下，您都可以在包含 Arcade 助手 (Beta) 的 Arcade 编辑器中输入脚本。

注：

Arcade 助手 (Beta) 在组织级别进行管理，必须由您的管理员启用。

使用助手

要在 Experience Builder 中使用 Arcade 助手 (beta)，请完成以下步骤：

1. 验证您是否已登录到组织。

   您必须以具有包括使用 AI 助手权限的角色的组织成员身份登录。

2. 在 Experience Builder 中，打开 Arcade 编辑器。

   可以通过以下位置打开 Arcade 编辑器：

   • 添加数据面板
   • “按钮”、“列表”和“文本”微件的动态样式设置
   • “文本”微件工具栏
   • “按钮”微件文本设置
   • “图像”微件源设置
   • 通过 URL 设置链接时的链接设置
3. 单击 Arcade 助手 。

   Arcade 助手窗格随即显示。

4. 通过执行以下操作之一使用助手：
   • 单击建议并对其进行修改以构建适合您数据的提示。
   • 以您的首选语言输入提示以构建 Arcade 表达式。
5. 单击生成执行查询。

   Arcade 助手 (beta) 建议 Arcade 助手窗格中的表达式。

   提示：

   将鼠标悬停在配置文件上下文按钮 上以查看建议的表达式将在图层配置中应用的位置。

6. 要与建议进行交互，请执行以下任何操作：
   • 单击添加到编辑器将表达式添加到表达式构建器窗格。

     提示：

     将鼠标指针定位在要添加内容的表达式构建器窗格中。 例如，在表达式构建器窗格中，移动指针并单击现有代码行的前面。 当单击 Arcade 助手窗格中的添加到编辑器时，建议的表达式将被添加到表达式构建器窗格中的指针位置。

   • 单击替换编辑器中的所有代码 以使用建议的表达式替换表达式构建器窗格中的任何现有内容。
   • 单击将代码复制到剪贴板 以将建议的表达式复制到剪贴板。
   • 要调整提示，请在文本区域中编辑上一个提示或复制粘贴上一个提示，然后单击优化以提交修改后的查询。
   • 要在助手中提供反馈，请单击有帮助 或无帮助 按钮并完成调查。 反馈用于指导进一步开发。
7. 要清除查询历史记录并重新开始，请随时单击重新开始。

了解最佳实践

以下是帮助您使用 Arcade 助手 (Beta) 生成 Arcade 表达式的指南：

• 您的请求需要简明扼要。
• 避免模棱两可和不明确的语言。
• 虽然不需要使用确切的字段名称，但建议提供足够的详细信息。

了解上下文限制

当使用 Arcade 助手 (Beta) 时，请注意以下限制：

• 助手不是聊天机器人。 它不会记住您在之前的提示中提供的信息。 当优化之前的提示时，请务必包含所有相关细节，就像您第一次询问助手一样。

  注：

  以下为高效提示序列和无效提示序列的示例：

  • 高效连续提示：
    • “当未选择任何要素时，返回‘所有区域’。 当已选择要素时，返回所选要素的名称。” 如果选择许多要素，则助手生成的脚本会列出过多地名，导致这些内容无法全部显示在“文本”微件中。
    • “当未选择任何要素时，返回‘所有区域’。 当已选择要素时，返回所选要素的名称。 如果所选要素超过三个，则返回其中三个所选要素的名称。” 将保留原始提示的上下文，同时新增要求将名称数量限制为三个的细节，由此使其成为高效提示序列。
  • 无效连续提示：
    • “当未选择任何要素时，返回‘所有区域’。 当已选择要素时，返回所选要素的名称。”
    • “仅返回最多三个名称。” 原始提示的上下文丢失，由此使其成为无效提示序列。

• 助手不知道任何先前生成的 Arcade 表达式或 Arcade 编辑器中现有的表达式。

  提示：

  以下为高效提示与无效提示的示例：

  • 高效提示：“简化此表达式：<在此处插入表达式>。”这个提示是高效的，因为用户已经提供了足够的上下文，使助手能够生成表达式。
  • 无效提示：“简化编辑器中的表达式。” 该提示无效，因为助手不知道编辑器中的表达式。

• 助手不查询您的数据。 因此，它不知道您正在为其生成表达式的图层中存在的特定数据值。 如果您希望助手根据数据值编写条件逻辑，则必须在提示中提供这些值或允许大语言模型假设这些值。

  提示：

  以下为高效提示与无效提示的示例：

  • 高效提示："如果人口密度高于 500，则返回'高密度'。 如果其介于 100 到 500 之间，则返回‘中等密度’。 如果其低于 100，则返回‘低密度’。 此提示为高效提示，因为值很具体，类别也很明确。
  • 无效提示：“使用自然间断点将人口密度字段划分为多个类别：'高密度'、'中等密度'和'低密度'。” 此提示为无效提示，因为助手并不知道需要分类的数值范围。

• 您无法使用助手来搜索、引用或查询其他图层。 助手的唯一上下文是与表达式关联的图层的字段名称和别名。 此外，助手不知道可能与图层相关的附件和相关表。 因此，使用 FeatureSet 函数生成表达式的支持有限。 如果您希望添加数据或者访问其他图层中的数据，请提供图层标题或项目 ID，以便助手知道要在表达式中包含的信息。 如果未提供此信息，助手将生成一个标题或 ID，当生成的表达式添加到表达式构建器窗格时，您需要手动替换该标题或 ID。

  提示：

  以下为高效提示与无效提示的示例：

  • “返回华盛顿州境内发生的事件数量。 使用 us_states_2000 图层中的 NAME 字段执行此计算。” 该提示很有效，因为它定义了生成表达式时应该使用的特定地理边界和地图中的图层。
  • 无效提示：“返回在华盛顿发生的事件数量。” 此提示为无效提示，因为无法明确是指华盛顿州、华盛顿特区，还是其他类似名称的位置。 此外，不清楚应该使用地图中的哪一个图层来执行查询。