Интеграция Eniq.ai с Google Таблицами позволяет автоматически экспортировать результаты анализа в Google Таблицы. Это удобно, если необходимо хранить результаты обработки в отдельном документе, передавать их команде, использовать для отчетности или дополнительно работать с данными вручную.
С помощью интеграции можно настроить, какие промпты экспортировать, какие поля передавать в таблицу, как называть столбцы и как формировать названия листов в Google Таблицах.
Подготовка Google Таблицы
Перед созданием интеграции необходимо подготовить Google Таблицу, в которую будут экспортироваться данные.
Сначала создайте новую Google Таблицу или откройте уже существующую. Именно в этот документ Eniq.ai будет передавать результаты анализа.
После этого предоставьте доступ к таблице техническому аккаунту Eniq.ai. Для этого:
Нажмите Поделиться в правом верхнем углу Google Таблицы.
В поле добавления пользователей введите адрес технического аккаунта:
Выберите уровень доступа Редактор.
Нажмите Отправить или Поделиться.
Доступ на редактирование необходим для того, чтобы Eniq.ai мог создавать листы, добавлять столбцы и записывать результаты анализа в таблицу.
Важно: если доступ к таблице не будет предоставлен, Eniq.ai может не получить доступ к документу, и экспорт данных будет работать некорректно.
Для настройки интеграции также необходимо скопировать ID Google Таблицы. ID таблицы находится в URL-адресе документа. Именно это значение нужно будет вставить в Eniq.ai в поле ID таблицы.
Как добавить интеграцию в Eniq.ai
Чтобы создать интеграцию с Google Таблицами, перейдите в раздел Интеграции в левом меню Eniq.ai.
В верхнем меню интеграций выберите вкладку Google Таблицы. Если интеграции еще не созданы, система покажет сообщение о том, что интеграции с Google Таблицами пока не настроены. Чтобы создать первую интеграцию, нажмите Добавить интеграцию.
Заполнение настроек интеграции
После нажатия кнопки Добавить интеграцию откроется окно создания интеграции.
Заполните поля Название интеграции, Описание — необязательно — и ID таблицы, вставив ID Google Таблицы, который вы скопировали из URL-адреса документа.
В блоке Конфигурация именования листов выберите, какие компоненты должны использоваться для формирования названий листов. Например, можно добавить год, месяц, название промпта, представителя или отдел. Необходимо включить как минимум один компонент. Рекомендуем использовать только название промпта.
В блоке Параметры формата можно выбрать формат отображения месяца и символ-разделитель между компонентами названия листа.
В нижней части окна расположен переключатель Активный. Если он включен, интеграция будет активна и сможет передавать данные в Google Таблицу. Если интеграцию необходимо временно отключить, переключатель можно деактивировать.
После заполнения всех настроек нажмите Проверить соединение. Это позволит проверить, правильно ли указан ID таблицы, имеет ли Eniq.ai доступ к Google Таблице и может ли система подключиться к документу.
Если проверка прошла успешно, нажмите Создать.
Как выглядит созданная интеграция
После создания интеграция появится в списке интеграций Google Таблиц.
В этом списке можно увидеть название интеграции, ссылку на Google Таблицу, настройки сопоставления, дату последней синхронизации, статус интеграции и доступные действия.
В столбце Таблица можно нажать Открыть таблицу в новой вкладке, чтобы быстро перейти к Google Таблице, в которую передаются данные.
В столбце Последняя синхронизация отображается время последнего экспорта. Если синхронизация еще не выполнялась, будет указано Никогда.
В столбце Статус можно увидеть, активна ли интеграция. Если интеграция включена, рядом с ней отображается статус Активный.
В столбце Действия доступны иконки для редактирования интеграции, запуска синхронизации и удаления интеграции.
Настройка маппинга промптов
После создания интеграции необходимо указать, какие именно промпты будут экспортироваться в Google Таблицу.
Для этого в строке нужной интеграции нажмите Маппинг промптов.
Откроется окно Сопоставление промптов. В нем отображается список доступных промптов. Напротив каждого промпта расположен переключатель Экспортировать в Google Таблицы. Чтобы результаты определенного промпта передавались в Google Таблицу, включите переключатель напротив этого промпта.
Важно: в Google Таблицу будут экспортироваться только те промпты, для которых включен экспорт.
После выбора необходимых промптов нажмите Сохранить сопоставление промптов.
Системные столбцы, которые добавляются автоматически
Во время экспорта Eniq.ai автоматически создает и заполняет первые пять столбцов Google Таблицы:
Analysis Date — дата проведения анализа.
Entity Creation Time — дата и время создания анализируемого объекта.
Entity Type — тип объекта.
Entity ID — идентификатор объекта.
Responsible User — ответственный пользователь.
Эти столбцы являются базовыми и заполняются системой автоматически. Их не нужно отдельно добавлять через маппинг полей.
С помощью маппинга пользователь настраивает дополнительные столбцы, которые должны размещаться после базовых системных данных. Это могут быть оценки, итоги, рекомендации, информация о клиенте, метаданные и другие поля из результатов выбранного промпта.
Настройка маппинга полей
Маппинг полей определяет, какие данные из результатов анализа будут передаваться в Google Таблицу и в какие столбцы они попадут.
Для настройки нажмите Маппинг полей в строке нужной интеграции. Откроется окно Конфигурация маппинга полей.
Сначала выберите промпт в поле Промпт. После этого система покажет все доступные для экспорта поля.
Поля могут быть сгруппированы по типам:
Стандартные поля — стандартные данные: дата анализа, ID, пользователь и другое.
Поля содержимого — результаты анализа промпта: оценки, рекомендации, итоги и другое.
Метаданные — дополнительные данные, например отдел или представитель.
Системные поля — системная информация об анализе.
Чтобы добавить поле в экспорт, выберите его из списка или нажмите Добавить маппинг. Поле появится в блоке Маппинги полей.
Здесь можно настроить:
Исходное поле — поле из Eniq.ai.
Целевой столбец — название столбца в Google Таблице.
Формат — формат данных: string, number, date, JSON и другие.
После завершения настройки нажмите Сохранить маппинги. После этого Eniq.ai будет автоматически передавать результаты анализа в Google Таблицу в соответствии с выбранными промптами и настроенным маппингом полей.