Интеграция в СуперИнтеллекте — это подключение внешнего сервиса (Notion, Airtable, Supabase, CRM, таблицы, вики) к вашему ИИ-агенту, после которого агент работает с этим сервисом прямо из чата обычными фразами: найти запись, посчитать, создать документ, обновить статус. Этот гайд отвечает на вопрос «как подключить интеграцию к ИИ-агенту» в общем виде — схема одинакова почти для любого коннектора: найти сервис в каталоге, принести свой токен, настроить права и привязать к агенту. Дальше — по шагам, с примерами и разбором частых вопросов.
Что такое интеграции и зачем подключать их к ИИ-агенту
По умолчанию ассистент отвечает на основе своих знаний и того, что вы напишете в чат. Интеграция расширяет его до агента, который умеет действовать: читать ваши данные во внешнем сервисе и, если вы разрешите, менять их. Вместо того чтобы копировать таблицу или текст документа в чат вручную, вы даёте агенту доступ к источнику — и он сам находит нужное, подставляет в ответ и выполняет операции.
Каждый коннектор — это набор инструментов (tools), которые агент вызывает автоматически, когда понимает из вашего запроса, что пора обратиться к сервису. Вам не нужно знать API или писать код: достаточно сформулировать задачу словами.
Где находится раздел «Интеграции»
Все коннекторы живут в разделе «Интеграции» в настройках ИИ-ассистента. Это каталог доступных сервисов: открываете нужного ассистента, переходите в его настройки и находите вкладку «Интеграции». Там и подключается, и настраивается любой коннектор.
- Откройте ассистента, к которому хотите добавить интеграцию.
- Зайдите в его настройки и выберите раздел «Интеграции».
- В каталоге найдите нужный сервис (например, Notion, Airtable, Supabase).
- Нажмите «Подключить» и введите токен — дальше по шагам ниже.
Как подключить любой коннектор: 5 шагов
Схема универсальна: она работает для баз данных, вики и большинства сервисов из каталога. Запомните эти пять шагов — дальше любой конкретный коннектор подключается по той же логике.
- Найдите сервис в разделе «Интеграции» у вашего ассистента.
- Принесите токен (API-ключ) — создайте его в личном кабинете сервиса и скопируйте. Где именно взять токен, всегда написано в карточке коннектора и в его отдельном гайде.
- Настройте права: по умолчанию включено только чтение (read); запись (write) и удаление (delete) включайте осознанно, если агенту действительно нужно менять данные.
- Привяжите коннектор к агенту — сохраните настройки, коннектор появится в списке активных у этого ассистента.
- Проверьте в чате: включите режим «ИИ-агент» и дайте простую команду на чтение, чтобы убедиться, что доступ работает.
Права доступа: read, write, delete
Права — это самый важный элемент настройки. Они определяют, что агенту можно делать с данными сервиса. Устроено по нарастающей: чтение безопасно всегда, запись и удаление меняют ваши данные, поэтому включаются отдельно и осознанно.
| Право | Что позволяет агенту | По умолчанию |
|---|---|---|
| read (чтение) | Искать, читать записи и документы, считать, отвечать на вопросы по вашим данным | Включено |
| write (запись) | Создавать и обновлять записи, страницы, документы; дописывать содержимое | Выключено — включайте осознанно |
| delete (удаление) | Удалять записи, архивировать страницы, снимать связи | Выключено — включайте осторожно |
Практический совет: начните с чтения. Убедитесь, что агент корректно находит и понимает ваши данные, и только потом добавляйте запись — например, чтобы он сам создавал задачи или обновлял статусы. Удаление стоит включать лишь тогда, когда сценарий это прямо требует.
Пример: подключаем Notion за минуту
Разберём на конкретном сервисе, чтобы схема стала осязаемой. Логика та же для Airtable, Supabase и остальных — меняется только место, где берётся токен.
- На notion.so/my-integrations создайте internal-интеграцию и скопируйте её Internal Integration Token.
- Расшарьте на эту интеграцию нужные страницы и базы: в Notion откройте страницу → «⋯» → Add connections → выберите интеграцию.
- В СуперИнтеллекте у ассистента откройте «Интеграции» → Notion → вставьте токен.
- Оставьте только чтение, если пока хотите, чтобы агент искал и читал; сохраните.
- В чате включите «ИИ-агент» и напишите: «Найди в Notion страницу про онбординг и перескажи её кратко».
Примеры команд для агента с интеграциями
Агенту не нужны технические формулировки — он сам подбирает нужный инструмент коннектора под вашу задачу. Несколько рабочих примеров:
- «Найди в базе все сделки в статусе “в работе” и посчитай их сумму» — чтение и подсчёт.
- «Создай запись о новом клиенте: имя, телефон, источник» — запись (нужно право write).
- «Обнови статус задачи №128 на “готово”» — обновление записи.
- «Найди в вики документ по регламенту возвратов и ответь на его основе» — поиск и ответ по базе знаний.
- «Сделай выборку заказов за последнюю неделю и покажи таблицей» — фильтрация и вывод.
Кастомные Действия и вебхуки
Готовые коннекторы закрывают популярные сервисы. Но если у вас свой сервис или нужен нестандартный вызов, пригодятся кастомные Действия — способ научить агента обращаться к произвольному HTTP-API по вашему описанию: какой адрес дёргать, какие параметры передавать, какой заголовок с ключом использовать. Агент вызывает такое Действие так же, как встроенные инструменты коннектора.
Вебхуки решают обратную задачу — позволяют внешней системе или сценарию инициировать обращение к агенту по событию. Оба механизма расширяют агента за пределы каталога, но требуют аккуратности: вы фактически даёте ему доступ к внешнему адресу, поэтому передавайте только те данные и права, которые действительно нужны.
Безопасность токенов: короткий чек-лист
Токен — это ключ к вашим данным, поэтому к нему относятся как к паролю. Несколько правил, которые снижают риски.
- Давайте минимум прав. Если агенту достаточно читать — не включайте запись и удаление.
- Ограничивайте область токена на стороне сервиса: выбирайте только нужные базы, страницы или скоупы, а не весь аккаунт.
- Создавайте отдельный токен под агента — его проще отозвать, не задев другие интеграции.
- Периодически отзывайте и перевыпускайте ключи, особенно если токеном пользовались где-то ещё.
- Не пересылайте токен в открытых чатах и не храните в заметках — вставьте один раз в раздел «Интеграции» и удалите из буфера.
Частые вопросы
Нужно ли уметь программировать, чтобы подключить интеграцию?
Нет. Всё делается в разделе «Интеграции» у ассистента: найти сервис, вставить токен, выбрать права, сохранить. Дальше вы общаетесь с агентом обычными фразами — код и API-запросы он формирует сам.
Где взять токен для подключения?
Токен создаётся в личном кабинете самого сервиса — обычно в разделе настроек «API», «Токены» или «Интеграции». Точное место для каждого коннектора указано в его карточке в каталоге и в отдельном гайде по этому сервису. Вы приносите свой токен, платформа хранит его у себя.
Может ли агент случайно удалить или испортить мои данные?
По умолчанию у коннектора включено только чтение — в этом режиме агент ничего не меняет. Запись и удаление работают, лишь если вы их осознанно включили. Поэтому контроль полностью за вами: выдавайте ровно те права, которые нужны сценарию.
Почему агент не видит мой сервис, хотя интеграция подключена?
Чаще всего причины две. Первая — не включён режим «ИИ-агент» в чате: без него инструменты интеграций недоступны. Вторая — сервису не выдан доступ к нужным данным на своей стороне (например, в Notion страницу нужно расшарить на интеграцию, в Airtable — выбрать базы при создании токена). Проверьте оба пункта.
Один токен на нескольких агентов — это нормально?
Да, один и тот же токен можно использовать для разных ассистентов. Но интеграцию всё равно подключают каждому агенту отдельно, и права можно задавать разные — например, одному агенту только чтение, другому — ещё и запись.
Что почитать дальше
Полный обзор всех доступных коннекторов и их возможностей — в сводном гайде «Все интеграции СуперИнтеллекта» (/guides/ii-agent-notion-airtable-bazy-dannyh). Пошаговый разбор на конкретном сервисе — в гайде по подключению Notion (/guides/kak-podklyuchit-notion-k-ii-agentu), а справка по сервису и его возможностям — на странице /partners/notion. Что нового появилось в интеграциях агента, смотрите в разделе изменений (/changelog/ai-agent-data-connectors).