Помощник Arcade (бета) использует искусственный интеллект (ИИ) для генерации выражений ArcGIS Arcade на основе инструкций, введенных на естественном языке.
Arcade может использоваться для создания пользовательского ресурса на основе данных в различных контекстах отображения, таких как оформление слоев, настройка всплывающих окон и настройка надписей. Например, вы можете использовать Arcade для динамического отображения новой информации из существующих полей в слое на основе заданных вами значений данных и пороговых значений. Как и в других языках программирования, написание кода и диагностика ошибок в выражениях Arcade занимает какое-то время. Помощник Arcade (бета) может помочь повысить эффективность этого процесса, генерируя выражение или часть выражения вместо написания кода.
Примечание:
Для получения дополнительной информации о помощнике, включая потребление кредитов, безопасность и конфиденциальность, а также ограничения и необъективность, см. в разделе Помощник Arcade (бета).
Использование помощника
Помощник Arcade (бета) использует естественный язык для генерации кода Arcade. Для получения наилучших результатов используйте понятный и простой язык и итерируйте полученные ответы.
Примечание:
Помощник администрируется на уровне организации ArcGIS Online и может быть отключен вашим администратором.
Чтобы использовать помощник, сделайте следующее:
- Убедитесь, что вы вошли в организацию.
- Щелкните кнопку запуска приложения
и выберите Map Viewer. Используйте новую карту, которая открывается, и добавьте слой на карту или откройте существующую карту. - Откройте окно редактора выражений атрибутов из панели Стили, Всплывающие окна или Надписать объекты.
Примечание:
Дополнительную информацию об оформлении слоя с использованием выражения см. в разделе Применение стиля. Чтобы настроить всплывающие окна с помощью выражения, см. раздел Использование выражений. Чтобы настроить надписи с помощью выражения, см. раздел Применение надписей.
- Щелкните Помощник Arcade
.Откроется панель Помощник Arcade.
- Используйте помощник, выполнив одно из следующих действий:
- Нажмите на предложение и измените его, чтобы создать приглашение, соответствующее вашим данным.
- Введите запрос на предпочитаемом вами языке для построения выражения Arcade.
- Щелкните Создать, чтобы выполнить запрос.
Помощник Arcade (бета) предлагает выражение на панели Помощник Arcade.
Подсказка:
Наведите курсор на кнопку Контекст профиля
, чтобы увидеть, где в конфигурации слоя будет применено предложенное выражение. Наведите курсор на кнопку Контекст слоя 
, чтобы просмотреть метаданные слоя, предоставленные помощнику, которые используются для создания предложенного выражения. - Для работы с предложенным выражением, сделайте одно из следующего:
- Щелкните Добавить в редактор, чтобы добавить выражение на панель конструктора выражений.
Подсказка:
Наведите курсор на панель конструктора выражений, в которую вы хотите добавить содержимое. Например, на панели конструктора выражений наведите курсор и щелкните перед имеющейся строкой кода. Когда вы нажмете кнопку Добавить в редактор на панели Помощник Arcade, предложенное выражение будет добавлено на панель конструктора выражений в том месте, где находится курсор.
- Щелкните Заменить весь код в редакторе
, чтобы заменить любое содержание на панели конструктора выражений предлагаемым выражением. - Щелкните Скопировать код в буфер обмена
, чтобы скопировать предложенное выражение в буфер обмена. - Чтобы внести изменения в приглашение, отредактируйте предыдущее приглашение в текстовой области или скопируйте и вставьте предыдущее приглашение, затем щелкните кнопку Уточнить, чтобы отправить измененный запрос.
- Чтобы оставить отзыв о помощнике, щелкните Полезно
или Бесполезно 
и заполните анкету. Обратная связь используется для руководства дальнейшим развитием.
- Щелкните Добавить в редактор, чтобы добавить выражение на панель конструктора выражений.
Рекомендации
Ниже приводятся рекомендации, которые помогут вам генерировать выражения Arcade с помощью помощника Arcade (бета):
- Излагайте свой запрос ясно и кратко.
- Избегайте двусмысленности и расплывчатости языка.
- Хотя использование точных названий полей не является обязательным, рекомендуется предоставить достаточно подробную информацию.
Подсказка:
Ниже приведен пример продуктивного и не продуктивного запроса при создании выражения для настройки надписей:
- Продуктивный запрос: «Надпишите все округа значением общего урожая пшеницы за прошлый год. Если в округе не выращивается пшеница, не отображайте надпись.» Этот запрос является продуктивным, поскольку является ясным, кратким и применимым на практике.
- Не продуктивный запрос: «Выберите надпись для объектов». Этот запрос непродуктивен, поскольку помощник не выбирает, как надписывать объекты. Помощник генерирует выражения только на основе инструкций автора. Автор карты должен решить, какие объекты он хочет надписать и как, а затем попросить ассистента сгенерировать выражение для достижения своей цели.
Контекстные ограничения
При использовании Помощника Arcade (бета) имейте в виду следующие ограничения:
- Помощник – это не чат-бот. Он не запоминает информацию, которую вы указали в предыдущих запросах. Уточняя предыдущий запрос, обязательно укажите все необходимые детали, как если бы вы задавали его в первый раз.
Подсказка:
Ниже приведен пример продуктивной последовательности запросов в сравнении с непродуктивной последовательностью:
- Продуктивный последовательный запрос:
- “Создать HTML-таблицу, в которой каждая строка является полем численности населения”. Помощник создает таблицу, но без форматирования.
- “Создать HTML-таблицу, в которой каждая строка является полем численности населения. Отформатировать числа с помощью запятых.” Контекст создания HTML-таблицы сохраняется с дополнительной детализацией запроса на форматирование полей, что делает эту последовательность запросов продуктивной.
- Непродуктивный последовательный запрос:
- “Создать HTML-таблицу, в которой каждая строка является полем численности населения.”
- ”Теперь отформатировать числа с помощью запятых.” Контекст создания HTML-таблицы теперь отсутствует, что делает эту последовательность непродуктивной.
- Продуктивный последовательный запрос:
- Помощник не знает о каких-либо ранее сгенерированных выражениях Arcade или о существующих выражениях в редакторе Arcade или на веб-карте.
Подсказка:
Ниже приведен пример продуктивного запроса в сравнении с непродуктивным:
- Продуктивный запрос: “Упростить это выражение: <вставьте выражение здесь>". Этот запрос является продуктивным, поскольку пользователь предоставил достаточно контекста, чтобы помощник мог сгенерировать выражение.
- Непродуктивный запрос: “Упростить выражение в редакторе". Этот запрос непродуктивен, поскольку помощник не знает о выражении в редакторе.
- Помощник не запрашивает ваши данные. Поэтому он не знает о конкретных значениях данных, присутствующих в слое, для которого вы генерируете выражение. Если вы хотите, чтобы ассистент написал условную логику на основе значений данных, вы должны указать их в запросе или разрешить большой языковой модели принимать значения.
Подсказка:
Ниже приведен пример продуктивного запроса в сравнении с непродуктивным:
- Продуктивный запрос: "Если оценка выше 100, вернуть ’хорошо’. Если выше 75, вернуть ’умеренно’. Если оценка находится в диапазоне от 20 до 75, вернуть ’плохо’. Если значение меньше 20, вернуть ’ужасно’." Этот запрос продуктивен, поскольку значения являются конкретными, а категории определены.
- Непродуктивный запрос: “Разделить поле оценки на несколько категорий, используя естественные интервалы: ’хорошо’, ’умеренно’, ’плохо’, ’ужасно’." Этот запрос непродуктивен, поскольку помощник не знает диапазон значений для классификации.
- Вы не можете использовать ассистент для поиска, ссылок или запросов к другим слоям карты. Единственный контекст, который есть у помощника, – это имена полей и псевдонимы слоя, выполняющего выражение. Кроме того, помощник не знает о вложениях и связанных таблицах, которые могут быть связаны со слоем. Поэтому существует ограниченная поддержка генерации выражений с использованием функций FeatureSet. Если требуется доступ к данным из других слоев, вы должны указать название слоя или идентификатор элемента, чтобы помощник знал, какую информацию следует включить в выражение. Если эта информация не будет предоставлена, помощник сгенерирует заголовок или идентификатор, которые вам нужно будет заменить вручную при добавлении сгенерированного выражения на панель конструктора выражений.
Подсказка:
Ниже приведен пример продуктивного запроса в сравнении с непродуктивным:
- Продуктивный запрос: “Вернуть количество инцидентов, произошедших в пределах штата Вашингтон. Для выполнения этого вычисления использовать поле NAME в слое us_states_2000." Этот запрос продуктивен, поскольку он определяет конкретную географическую границу и слой на карте, которые следует использовать при создании выражения.
- Непродуктивный запрос: “Укажите количество инцидентов, произошедших в Вашингтоне”. Этот запрос непродуктивен, поскольку неясно, что выбрать - штат Вашингтон или город Вашингтон в округе Колумбия. Кроме того, неясно, какой слой на карте следует использовать при выполнении запроса.