Ваши данные лежат в таблице Airtable, база знаний — в Notion, а часть учёта — в собственной базе на Supabase. ИИ-агенту не обязательно быть слепым к этому: он может читать и писать в ваши базы данных и вики прямо во время диалога. В этом гайде разберём, как подключить ИИ-агента к базе данных — по шагам, с указанием, где взять токен для каждого из семи коннекторов, и что агент реально умеет делать с вашими данными.
Что такое коннектор базы данных для ИИ-агента
Коннектор базы данных для ИИ-агента — это подключение, которое даёт агенту набор инструментов для работы с вашим внешним сервисом (таблицей, базой или вики) прямо из чата. Вы один раз приносите свой токен доступа, привязываете коннектор к агенту — и дальше он на естественном языке ищет записи, читает документы, создаёт новые строки и обновляет данные, вызывая нужные инструменты сам. Никакого кода и экспорта-импорта: агент работает с живыми данными в реальном времени.
Ключевой принцип: агент работает от имени вашего токена, а не от общего ключа платформы. Что доступно этому токену в исходном сервисе — то доступно и агенту. По умолчанию включается только чтение, а запись и удаление вы разрешаете осознанно.
Семь коннекторов: к чему можно подключить агента
Сейчас доступно семь коннекторов к базам данных и вики. У каждого — свой набор инструментов и полный CRUD: агент не только читает, но и создаёт, изменяет и удаляет данные (операции разбиты по правам чтение / запись / удаление).
| Коннектор | Тип | Что делает агент | Где взять токен |
|---|---|---|---|
| Airtable | База и записи | Ищет базы и таблицы, читает записи с фильтром по формуле, создаёт, обновляет, делает upsert и удаляет записи, работает с комментариями | Personal Access Token на airtable.com/create/tokens |
| Notion | Вики + базы | Поиск по пространству, чтение страниц как Markdown, создание и обновление страниц, запросы к базам, комментарии, архивирование | Токен internal-интеграции на notion.so/my-integrations |
| Supabase | Данные + Админ SQL | Список и описание таблиц, выборка с фильтрами, вставка/upsert/обновление/удаление, вызов RPC-функций, произвольный SQL | Project URL + ключ из Settings → API; для SQL — Management PAT |
| NocoDB | Таблицы (API v2) | Базы, таблицы и схема, чтение с where-фильтром, CRUD записей, связи «многие-ко-многим» | xc-token в Настройках аккаунта → Tokens |
| Outline | Вики | Полнотекстовый поиск, чтение и список документов, создание/обновление/перемещение/архивирование, ответ на вопрос по базе знаний | API key в Settings → API & Apps |
| Yonote | Вики (аналог Notion, РФ) | Поиск, чтение, создание, обновление, перемещение и архивирование документов, структура коллекций, комментарии | API-токен в Настройках → API-токены |
| Buildin.ai | Страницы + базы | Поиск, чтение страниц как Markdown, создание и обновление страниц, запросы к базам, работа с блоками | API Token бот-интеграции в Настройках → Интеграции |
Как подключить коннектор: 6 шагов
Подключение любого из семи коннекторов устроено одинаково. Всё живёт в разделе «Интеграции» вашего кабинета, а сам коннектор привязывается к конкретному ИИ-агенту.
- Откройте раздел «Интеграции» в кабинете и найдите нужный коннектор в списке провайдеров (Airtable, Supabase, NocoDB, Notion, Outline, Yonote, Buildin.ai).
- Получите токен у сервиса-источника (подробно по каждому — ниже).
- Вставьте токен в поле подключения коннектора; при желании задайте базу или проект по умолчанию.
- Выберите права для агента: по умолчанию — только чтение; включите запись и удаление осознанно, если агент должен менять данные.
- Привяжите настроенный коннектор к нужному ИИ-агенту в его настройках.
- Проверьте в чате: попросите агента найти запись в таблице или создать документ в вики — он вызовет нужный инструмент и вернёт результат.
Где взять токен для каждого сервиса
Airtable — Personal Access Token
Airtable использует Personal Access Token (PAT). Создайте его на странице airtable.com/create/tokens: выдайте скоупы data.records:read, data.records:write и schema.bases:read, затем в разделе Access выберите конкретные базы, к которым агент получит доступ. Скопируйте токен (он показывается один раз) и вставьте в поле коннектора. При желании укажите base_id базы по умолчанию — но агент умеет находить базы и таблицы сам.
- airtable_list_bases / airtable_list_tables — находит нужную базу и таблицу
- airtable_list_records — читает записи с серверной фильтрацией по формуле, сортировкой и проекцией полей
- airtable_search_records / airtable_get_record — текстовый поиск и чтение одной записи
- airtable_create_records / update / upsert / delete_records — создаёт, обновляет, делает upsert по 1–3 ключевым полям и удаляет до 10 записей за раз
- airtable_list_comments / airtable_create_comment — читает и добавляет комментарии к записям
Notion — токен internal-интеграции
Для Notion создайте internal-интеграцию на notion.so/my-integrations и скопируйте её токен. Важный шаг, который часто забывают: саму интеграцию нужно расшарить на нужные страницы и базы — в Notion откройте страницу → «•••» → Connections → добавьте вашу интеграцию. Без этого агент не увидит контент, даже с правильным токеном. Агент умеет искать по пространству (notion_search), читать страницы как Markdown, создавать и обновлять их, дозаписывать блоки в конец, запрашивать базы с фильтрами, работать с комментариями и архивировать страницы вместо удаления.
Supabase — Project URL, service-ключ и (для SQL) Management PAT
У Supabase два модуля. Для модуля «Данные» возьмите Project URL (Settings → API) и ключ service_role/secret (Settings → API Keys). Для модуля «Админ SQL (Management API)», где агент выполняет произвольный SQL и видит проекты аккаунта, дополнительно нужен Management PAT (Account → Access Tokens). Агент умеет: список и описание таблиц, выборку с фильтрами/сортировкой/лимитом, подсчёт строк, вставку/upsert/обновление/удаление, вызов Postgres-функций (RPC), а с Management-токеном — произвольные SQL-отчёты.
NocoDB — xc-token
NocoDB работает и в облаке (app.nocodb.com), и на self-hosted-инстансе (API v2). Возьмите URL инстанса и создайте xc-token в Настройках аккаунта → Tokens. Агент получает список баз и таблиц, схему, чтение записей с where-фильтром/сортировкой/пагинацией, полный CRUD и — что отличает NocoDB — работу со связями «многие-ко-многим»: читать связанные записи, связывать и отвязывать их (например, привязать задачу к проекту, контакт к компании).
Outline, Yonote, Buildin.ai — вики и базы знаний
Эти три коннектора закрывают работу с корпоративной вики. Outline (self-hosted или app.getoutline.com): API key в Settings → API & Apps → New API key; агент умеет полнотекстовый поиск, чтение и создание документов, дозапись через append, коллекции и даже готовый ответ на вопрос по базе знаний (outline_answer_question). Yonote — российский аналог Notion: API-токен в Настройках → API-токены; поиск, чтение, создание, обновление, перемещение, архивирование документов и структура коллекций-дерева. Buildin.ai: API Token бот-интеграции в Настройках → Интеграции, плюс нужно выдать интеграции доступ к нужным страницам; поиск, чтение страниц как Markdown, создание и обновление, запросы к базам.
Что агент умеет делать с данными: полный CRUD
Главное отличие этих коннекторов — агент не просто читает, а полноценно управляет данными. Операции разбиты по правам: read (чтение), write (создание и обновление) и delete (удаление). По умолчанию включается только чтение — это безопасный старт.
- Чтение — поиск записей и документов, выборка с серверными фильтрами и проекцией полей, чтение страниц как Markdown, подсчёт строк
- Запись — создание записей и страниц, обновление, upsert без дублей, дозапись блоков в конец документа (append) без перезаписи существующего
- Удаление / архивирование — удаление записей пачками (до 10–50 за вызов), архивирование страниц вместо жёсткого удаления в вики
Сценарии: зачем это бизнесу
Ниже — рабочие сценарии, где агент с коннектором заменяет ручной труд по перекладыванию данных.
- Агент-администратор вики — находит и читает статьи в Notion / Outline / Yonote / Buildin.ai, отвечает сотрудникам по регламентам, а по итогам обсуждения создаёт или дописывает страницу.
- CRM и учёт на Airtable или NocoDB — агент заносит лиды и заявки из переписки, обновляет статусы сделок, ищет клиента по имени или телефону и подтягивает историю в чат.
- Аналитика по своей БД Supabase — считает строки, выбирает данные с фильтрами, вызывает Postgres-функции, а с Management-токеном выполняет произвольные SQL-отчёты.
- Онбординг и внутренний FAQ — агент отвечает новым сотрудникам, вытаскивая ответы из вики (например, через outline_answer_question).
- Ведение таблицы задач и контента — создаёт записи, проставляет исполнителей и дедлайны, делает upsert, чтобы не плодить дубликаты.
- Массовая правка данных — создаёт, обновляет и удаляет записи пачками: обновление прайса, статусов, справочников за один вызов.
Коннекторы данных и «Действия» агента
Коннекторы к базам решают задачу «читать и писать в ваши данные». Если же вам нужно, чтобы агент отправлял заявки во внешнюю CRM или дёргал ваш API по вебхуку, посмотрите отдельный блок «Действия» в настройках агента — там настраиваются лиды в Bitrix24, amoCRM, произвольный HTTP-вебхук и мини-CRM. Подробно об этом — в гайде Действия ИИ-агента: amoCRM, Bitrix24 и вебхуки. А как поднять самого агента во внешних каналах — в гайде Как подключить ИИ-агента на сайт.
Частые вопросы
Как подключить ИИ-агента к базе данных?
Откройте раздел «Интеграции» в кабинете, выберите нужный коннектор (Airtable, Notion, Supabase, NocoDB, Outline, Yonote или Buildin.ai), вставьте свой токен доступа, выберите права (по умолчанию — чтение) и привяжите коннектор к вашему ИИ-агенту. После этого агент вызывает нужные инструменты прямо в чате.
Где взять токен Airtable для подключения к ИИ?
Airtable использует Personal Access Token. Создайте его на airtable.com/create/tokens, выдайте скоупы data.records:read, data.records:write и schema.bases:read, выберите нужные базы и скопируйте токен — он показывается один раз. Затем вставьте его в поле коннектора Airtable в разделе «Интеграции».
Может ли агент не только читать, но и писать в мою базу?
Да. У всех семи коннекторов полный CRUD: чтение, создание, обновление и удаление. Права разбиты — по умолчанию включается только чтение, а запись и удаление вы включаете осознанно. Агент создаёт записи, обновляет статусы, делает upsert без дублей и дописывает контент в документы вики.
Что делать, если Notion недоступен из России?
Notion закрыт для аккаунтов из РФ с сентября 2024 года — это ограничение самого сервиса. Используйте российский аналог Yonote или Buildin.ai: агент работает с ними так же — поиск, чтение, создание и обновление документов. Токен берётся в настройках соответствующего сервиса.
Насколько безопасно давать агенту доступ к моей базе?
Агент работает строго от имени вашего токена — не больше прав, чем вы этому токену выдали. Токен хранится на стороне платформы и не отдаётся наружу. Мы рекомендуем выдавать минимально необходимые права: оставлять только чтение, где запись не нужна, и не давать Supabase service-ключ или Management-токен, если задача этого не требует.
Можно ли подключить несколько баз к одному агенту?
Да. Для Airtable, NocoDB и Supabase можно задать базу или проект по умолчанию, но конкретную базу агент может указывать в каждом вызове — один коннектор обслуживает несколько баз. Можно также подключить к агенту сразу несколько разных коннекторов (например, Notion для вики и Airtable для CRM).
Читайте дальше: Мини-CRM ИИ-агента: заявки и аналитика, Как продавать доступ к ИИ-агенту и новость ИИ-агент подключается к CRM и базам данных.