Коннектор Make.com — документация Entity Enricher

Коннектор Make.com

Добавьте один модуль Make в любой сценарий, сопоставьте сущность из предыдущего шага и получите структурированный, проверенный по схеме объект JSON, объединённый из нескольких моделей, — с многоязычным выводом на 40 языках, полученным за один проход LLM. 9 полноценных модулей с динамическими выпадающими списками и обработкой ошибок с учётом ограничений тарифа, разработанные для модели оплаты Make за операцию.

Создано для Make

Entity Enricher уже поставляется с коннектором n8n, который потребляет поток Server-Sent Events. Модули Make не могут нативно потреблять SSE — каждый модуль представляет собой один атомарный HTTP-вызов. Чтобы поддерживать обогащение как единую операцию Make, бэкенд предоставляет отдельный эндпоинт POST /api/single/enrich/sync, который оборачивает потоковый процесс на стороне сервера и возвращает итоговый результат слияния в одном ответе.

n8n connector
POST /enrich/stream → job_id
GET /llm/stream/{id}
GET /llm/stream/{id}
... (events)
[final bundle out]
Make.com connector
POST /enrich/sync
(server awaits internally)
[final bundle out]

Многоязычное обогащение за один проход

Выберите несколько языков в поле Languages, и Entity Enricher заполнит каждое многоязычное свойство на всех выбранных языках за один вызов LLM — а не N последовательных обращений на каждый язык. 40 языков охватывают основные европейские, азиатские, ближневосточные и африканские рынки.

Результат одного вызова Enrich Entity с languages = ["en", "fr", "de", "ja"]:

{
  "names": {
    "primary": {
      "en": "Aspirin",
      "fr": "Aspirine",
      "de": "Aspirin",
      "ja": "アスピリン"
    }
  },
  "indications": {
    "en": "Pain, fever, inflammation; antiplatelet therapy.",
    "fr": "Douleur, fièvre, inflammation ; antiagrégant plaquettaire.",
    "de": "Schmerz, Fieber, Entzündung; Thrombozytenaggregationshemmer.",
    "ja": "痛み、発熱、炎症;抗血小板療法。"
  }
}

Последующие модули Make могут напрямую сопоставлять любой язык: {{enrichEntity.result.names.primary.fr}}. Выпадающий список «Языки» показывает полный список из 40 языков с уведомлением об ограничении тарифа, когда профиль вашей организации ограничивает количество доступных для выбора языков.

Модуль Make: раскрывающийся список с множественным выбором языков, показывающий 40 поддерживаемых языков

Установка

Исходный код приложения Make находится в публичном репозитории TOT-Concept (синхронизирован с монорепозиторием Entity Enricher). Пока v1.0 не появится в маркетплейсе Make, загружайте его вручную через Developer Hub:

  1. Войдите в свою организацию Make как разработчик.
  2. Перейдите в Приложения → Создать новое приложение → Custom App.
  3. Либо загрузите каталог make-app-entity-enricher/ в виде .zip, либо вставьте каждый файл .json / .imljson в соответствующую вкладку редактора.
  4. Добавьте подключение по API-ключу, используя ключ из Entity Enricher → Настройки → API-ключи (формат ent_XXXXXXXXXXXX). Подключение автоматически проверяется через /api/enrichment/options.
Make: форма настройки подключения по API-ключу

Динамические выпадающие списки

Каждое выбираемое поле в модулях Make заполняется RPC-вызовом, который обращается к API Entity Enricher во время настройки. Закреплённые схемы отображаются первыми (отмечены 📌), метки моделей включают цену за миллион токенов, а организации с ограничениями тарифа видят уведомление при достижении квоты.

Модуль Make: открытый раскрывающийся список схем с закреплёнными схемами вверху

Предварительные требования

Ключ APIСоздайте ключ доступа организации в Entity Enricher. См. документацию по API-ключам. Используйте ключ доступа организации (с собственной ролью) для интеграций между сервисами.
Базовый URLURL вашего экземпляра Entity Enricher — по умолчанию https://entityenricher.ai. Переопределяйте только для развёртываний на собственном сервере.
OAuth 2.0Появится в v0.4 вместе с аутентификацией по API-ключу, как только заработает сервер авторизации Entity Enricher. Пользовательские сценарии смогут подключать собственные аккаунты через стандартный OAuth-процесс Make.

Обогащение сущности в действии

Центральный модуль предоставляет поля ввода с динамическими выпадающими списками: схема, модели (множественный выбор), языки (множественный выбор), стратегия, необязательные модели классификации и арбитража, веб-поиск, схема ответа, строгий структурированный вывод, тайм-аут и переключатели метаданных. Свяжите сущность из любого предыдущего модуля через поле Entity data.

Когда выбрано 2+ моделей, результат автоматически объединяется на стороне сервера. Панель вывода Make показывает is_fused: true, список source_models и сводку fusion с подсчётом совпавших и конфликтующих полей:

Панель вывода Make: результат обогащения, слитый из нескольких моделей

Доступные модули

9 модулей в 5 категориях. Модули поиска выдают по одному бандлу на результат для последующих цепочек Iterator/Aggregator; модули действий выдают один бандл.

КатегорияМодульОписание
EnrichmentEnrich EntityОбогащение за один вызов со слиянием нескольких моделей. Возвращает итоговый объединённый результат (или результат лучшей отдельной модели). Автоматически отменяется при предупреждении классификации.
SchemasList SchemasВозвращает один bundle Make для каждой сохранённой схемы, готовый для цепочек Iterator/Aggregator.
SchemasGet Schema DetailsПолное содержимое схемы, включая области экспертизы, свойства и ключи поиска.
RecordsList RecordsПоиск по прошлым записям обогащения с фильтрами (тип, успешность, свободный текст).
RecordsGet RecordПолучить один результат обогащения с полными метриками по каждому промпту.
FusionMerge ResultsПовторно объедините несколько результатов обогащения, при желании с другим арбитром LLM.
AttachmentsUpload AttachmentЗагрузите файл (переданный как буфер из вышестоящего модуля, например HTTP ▸ Get a File) и получите ID вложения для использования в Enrich Entity.
AttachmentsDelete AttachmentУдалить вложение по ID — удобный шаг очистки после обогащения.
ConfigurationGet OptionsДоступные модели, языки, стратегии и ограничения тарифа организации.

Рабочие процессы с несколькими сущностями: паттерн итератора

Сценарии Make тарифицируются за операцию. Вместо переноса модуля Batch Enrich из коннектора n8n приложение Make использует встроенный Iterator от Make + Enrich Entity. Каждая итерация независима, сбои не каскадируются, а тарификация точно отражает то, что было обработано.

[trigger: array of entities]
[Make: Iterator] (splits into N bundles)
[this app: Enrich Entity] (one operation per entity)
[Make: Aggregator] (recombines, optionally with skip-on-error)
[downstream: upsert to CRM / database]

Ключевые функции

Многоязычность на 40 языках

Один вызов Enrich Entity заполняет каждое многоязычное свойство на всех выбранных языках — за один проход LLM, а не за N последовательных обращений. Сопоставляйте любой язык напрямую: {{result.names.primary.fr}}.

Обогащение в один вызов

Отдельная конечная точка POST /api/single/enrich/sync оборачивает потоковый процесс на стороне сервера. Одна операция Make = один бандл. Без опроса, без шаблонов из двух модулей.

Динамические выпадающие списки (RPC)

7 RPC-вызовов получают схемы, модели, языки, стратегии, модели классификации/арбитража и параметры веб-поиска на этапе настройки — закреплённые схемы отображаются первыми, метки моделей включают цены.

Мультимодельное авто-слияние

Выберите 2+ модели, и результат автоматически объединяется. Итоговый набор включает is_fused, source_models[] и сводку слияния fusion: {agreed_fields, conflicted_fields, total_fields}.

Предварительная классификация

Необязательная дешёвая модель-классификатор проверяет, что сущность соответствует ожидаемому типу схемы, прежде чем запускается обогащение. Несоответствия приводят к типизированной ошибке DataError вместо галлюцинированных данных.

Учёт лимитов плана и кредитов

Ошибки HTTP 402 (ограничения тарифа или нехватка кредитов) преобразуются в типизированную ошибку Make OutOfMoneyError. Сообщение повторяет понятное человеку описание от бэкенда (с URL для пополнения счёта, когда кредиты закончились), а также машиночитаемый код — используйте код в обработчике ошибок сценария, чтобы оповещать людей, переключаться на более дешёвые модели или ставить на паузу.

Блокировки выпадающего списка веб-поиска

Выпадающий список Web Search читает parameters.models и отключается, когда ни одна из выбранных моделей не объявляет supports_web_search.

Нет пакетного модуля

Сценарии Make тарифицируются за операцию. Рабочие процессы с несколькими сущностями используют встроенный Iterator от Make + Enrich Entity, обеспечивая детальную обработку ошибок для каждой сущности и точную тарификацию.

Настраиваемый тайм-аут

Тайм-аут по умолчанию 300 секунд на вызов, в пределах [10, 900]. Задание автоматически отменяется на стороне сервера, если не завершается вовремя, возвращая типизированную ошибку ConnectionError.

Контракт ошибок

Каждый статус, который может вернуть бэкенд, сопоставлен с типизированной ошибкой Make, чтобы обработчики ошибок сценария могли ветвиться по режиму сбоя, а не разбирать строки.

Сценарий Make: обработчик ошибок с ветвлением по OutOfMoneyError
HTTPТип ошибки MakeКогда срабатывает
400DataErrorСхема не найдена, отсутствуют ключи поиска, недопустимые модели или языки.
401InvalidCredentialsНеверный или отсутствующий ключ API.
402OutOfMoneyErrorПревышен лимит плана ИЛИ недостаточно кредитов. Message = body.detail.detail (для человека, включает URL для пополнения при insufficient_credits) + body.detail.code (для машины). Ветвление по коду: insufficient_credits, model_limit_exceeded, language_limit_exceeded, concurrent_job_limit_reached, daily/weekly/monthly_prompt_limit_exceeded.
403AccessDeniedErrorНедостаточная роль или область действия.
404InvalidConfigurationErrorСхема или запись не найдена.
422DataErrorПредупреждение классификации. body.detail.classification содержит status, reasoning, confidence, entity_description.
429RateLimitErrorОграничение частоты запросов провайдера (временное).
499RuntimeErrorЗадание отменено.
502ConnectionErrorОшибка вышестоящего LLM-провайдера (например, переполнение контекста).
504ConnectionErrorИстекло timeout_seconds; задача автоматически отменена на стороне сервера.

Идеи рабочих процессов

Enrichment CRMЗапускайте при новых контактах HubSpot/Salesforce, обогащайте данными о компании, обновляйте запись в CRM.
Конвейер таблицЧитайте сущности из Google Sheets, Iterator + Enrich Entity, записывайте результаты обратно на новый лист.
Условный повторный арбитражСначала выполните слияние по правилам; если conflicted_fields > 5, выполните повторное слияние с арбитром LLM через Merge Results — не запуская заново затратное обогащение.
Маршрутизация по лимиту тарифаПри OutOfMoneyError оповестить сотрудника в Slack и приостановить сценарий до сброса окна квоты.
Запланированное обновлениеЗапуск по расписанию cron (триггер Make Schedule) для повторного обогащения устаревших записей с помощью новейших моделей.

Дальнейшие шаги