使用 Arcade 助手 (Beta)

Arcade 助手 (Beta) 使用人工智能 (AI) 根据以自然语言输入的指令生成 ArcGIS Arcade 表达式。

Arcade 可用于在各种制图上下文中创建自定义数据驱动型内容，如设置图层、配置弹出窗口和配置标注。 例如，您可以使用 Arcade 基于您定义的数据值和阈值动态显示图层中现有字段的新信息。 与其他编码语言类似，编写和诊断 Arcade 表达式中的错误可能需要时间。 Arcade 助手 (Beta) 可以通过生成表达式或表达式的一部分来帮助提高此过程的效率，而无需您编写任何代码。

注：

有关助手的详细信息，包括配额消耗、安全和隐私以及限制和偏见，请参阅 Arcade助手 (Beta)。

使用助手

Arcade 助手 (Beta) 使用自然语言生成 Arcade 代码。 为获得最佳效果，请使用清晰易懂的语言，并迭代您收到的回复。

注：

助手在 ArcGIS Online 组织级别进行管理，可能会被您的管理员禁用。

要使用助手，请执行以下操作：

1. 确认您已登录到组织。
2. 单击应用程序启动器 ，然后选择 Map Viewer。 使用打开的新地图，并将图层添加到地图或打开现有地图。
3. 从样式、弹出窗口或标注要素窗格中打开属性表达式编辑器窗口。

   注：

   有关使用表达式设置图层样式的其他信息，请参阅应用样式。 要使用表达式配置弹出窗口，请参阅使用表达式。 要使用表达式配置标注，请参阅应用标注。

4. 单击 Arcade 助手 。

   Arcade 助手窗格随即打开。

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

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

   提示：

   将鼠标悬停在配置文件上下文 按钮上，查看建议的表达式将在图层配置中应用的位置。 将鼠标悬停在图层上下文 按钮上，查看提供给助手用于生成建议表达式的图层元数据。

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

     提示：

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

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

了解最佳实践

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

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

提示：

请参阅以下内容以了解创建用于配置标注的表达式时高效提示和无效提示的对比：

• 高效提示：“标注每个县去年的小麦总产量。 如果某个县没有生产小麦，则不显示标注。” 此提示是高效的，因为它清晰、简洁且可操作。
• 无效提示：“为要素选择标注。” 此提示无效，因为助手未选择如何标注要素。 助手仅根据作者的指示生成表达式。 地图作者应决定他们想要标注哪些要素以及如何标注，然后要求助手生成表达式来实现目标。

上下文限制

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

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

  提示：

  请参阅以下高效提示序列与无效提示序列的示例：

  • 高效连续提示
    • “创建一个 HTML 表格，其中每一行都是一个人口字段。”助手会生成一个没有格式化的表格。
    • “创建一个 HTML 表格，其中每一行都是一个人口字段。 用逗号格式化数字。”创建 HTML 表的上下文与要求字段格式的其他细节一起保留，使其成为高效提示序列。
  • 无效连续提示
    • “创建一个 HTML 表格，其中每一行都是一个人口字段。”
    • “现在用逗号格式化数字。”创建 HTML 表的上下文目前缺失，使其成为无效提示序列。

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

  提示：

  请参阅以下高效提示与无效提示的示例：

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

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

  提示：

  请参阅以下高效提示与无效提示的示例：

  • 高效提示：“如果分数高于 100，则返回‘优’。 如果分数高于 75，则返回‘中等‘。 如果分数在 20-75 之间，则返回‘差‘。 如果分数低于 20，则返回‘极差’。”这个提示很有效，因为值很具体，类别也很明确。
  • 无效提示：“使用自然间断点将分数字段分成多个类别：‘好’，‘中等’，‘差’，‘极差’。”这个提示无效，因为助手不知道要分类的值范围。

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

  提示：

  请参阅以下高效提示与无效提示的示例：

  • 高效提示：“返回华盛顿州境内发生的事件数量。 使用 us_states_2000 图层中的 NAME 字段执行此计算。” 该提示很有效，因为它定义了生成表达式时应该使用的特定地理边界和地图中的图层。
  • 无效提示：“返回华盛顿发生的事件数量。”这个提示无效，因为不清楚我们想要的是华盛顿州还是华盛顿特区。 此外，不清楚执行查询时应该使用地图中的哪个图层。