Airtable — это облачный сервис на стыке таблицы и базы данных: данные хранятся в базах (bases), внутри которых есть таблицы, записи, поля разных типов и связи между таблицами. Подключение Airtable к ИИ-агенту СуперИнтеллекта превращает эти базы в рабочий инструмент, которым можно управлять прямо в чате обычными фразами: найти запись, посчитать строки по условию, создать или обновить запись, оставить комментарий. Ниже — пошаговый разбор: что умеет агент с Airtable, где взять токен, как настроить права и привязать коннектор к ассистенту.
Что такое интеграция Airtable с ИИ-агентом
Интеграция Airtable — это коннектор в разделе «Интеграции» у вашего ИИ-ассистента. Вы один раз приносите собственный токен доступа к своему аккаунту Airtable, платформа сохраняет его на своей стороне, а коннектор привязывается к конкретному агенту. После этого агент обращается к вашим базам через официальный API Airtable: сам находит нужную базу и таблицу, читает и фильтрует записи, а с явно выданными правами — создаёт, обновляет и удаляет их.
Ключевой принцип: доступ идёт по вашему токену и в рамках тех прав, которые вы назначили. Никаких лишних полномочий — по умолчанию агент работает только на чтение, а запись и удаление вы включаете осознанно.
Что умеет агент с Airtable: 11 инструментов
Коннектор Airtable даёт агенту 11 инструментов в модуле «Базы и записи». Агент оперирует ими автоматически — вы формулируете задачу словами, а он подбирает нужный инструмент.
| Что делает агент | Инструмент | Право |
|---|---|---|
| Находит нужную базу в аккаунте | airtable_list_bases | read |
| Показывает таблицы внутри базы | airtable_list_tables | read |
| Читает записи с фильтром по формуле, сортировкой и выбором полей | airtable_list_records | read |
| Делает удобный текстовый поиск по записям | airtable_search_records | read |
| Берёт одну запись по идентификатору | airtable_get_record | read |
| Создаёт новые записи | airtable_create_records | write |
| Частично обновляет поля записи | airtable_update_records | write |
| Делает upsert по 1–3 ключевым полям (создать или обновить) | airtable_upsert_records | write |
| Удаляет до 10 записей за раз | airtable_delete_records | delete |
| Читает комментарии к записи | airtable_list_comments | read |
| Добавляет комментарий к записи | airtable_create_comment | write |
Где взять токен Airtable (Personal Access Token)
Для подключения нужен Personal Access Token (PAT) — персональный токен доступа Airtable. Это современная замена устаревшим API-ключам: токен создаётся с точным набором прав (scopes) и привязывается к выбранным базам, а не ко всему аккаунту сразу.
- Откройте airtable.com/create/tokens (Airtable → аккаунт → Developer hub → Personal access tokens).
- Нажмите «Create new token», задайте понятное имя, например «SuperIntellect agent».
- В разделе Scopes добавьте права: data.records:read (чтение записей), data.records:write (запись, если планируете создание/обновление) и schema.bases:read (чтение структуры баз и таблиц).
- В разделе Access выберите конкретные базы, к которым агент получит доступ — только те, что действительно нужны.
- Создайте токен и сразу скопируйте его: значение показывается один раз, позже его не посмотреть — только пересоздать.
| Скоуп | Зачем нужен | Когда добавлять |
|---|---|---|
| schema.bases:read | Видеть список баз, таблиц и структуру полей | Всегда |
| data.records:read | Читать, искать и считать записи | Всегда |
| data.records:write | Создавать, обновлять, upsert, комментировать, удалять записи | Только если агент должен менять данные |
Как подключить Airtable к ИИ-агенту: пошагово
Когда токен на руках, подключение занимает пару минут. Всё делается в разделе «Интеграции» у нужного ассистента.
- Откройте настройки нужного ИИ-ассистента и перейдите в раздел «Интеграции» — это каталог коннекторов.
- Найдите в каталоге Airtable и откройте карточку коннектора.
- Вставьте свой Personal Access Token в поле токена и сохраните — он останется на стороне платформы.
- Настройте права: по умолчанию включено только чтение (read). Если агент должен создавать и менять записи — включите write, для удаления — delete.
- При желании укажите базу по умолчанию, чтобы не называть её в каждом запросе (конкретную базу всё равно можно указывать в отдельных вызовах).
- Привяжите коннектор к этому ассистенту.
- В чате с ассистентом включите режим «ИИ-агент» — без него коннекторы не работают: именно этот режим разрешает агенту вызывать инструменты.
Права read / write / delete: как не дать лишнего
Права на платформе и скоупы токена работают в связке. Токен задаёт «потолок» возможностей (что физически разрешено в Airtable), а переключатели прав у коннектора — что из этого разрешено агенту прямо сейчас. По умолчанию активен только read.
- read — агент читает, ищет и считает записи, смотрит структуру баз. Безопасный режим для старта.
- write — агент создаёт записи, обновляет поля, делает upsert и оставляет комментарии.
- delete — агент удаляет записи (до 10 за один вызов). Включайте только при реальной необходимости.
Примеры промптов для агента
С подключённым Airtable вы общаетесь с агентом обычными фразами — он сам переведёт их в вызовы нужных инструментов. Несколько рабочих примеров:
- «Покажи все базы и таблицы, к которым у тебя есть доступ в Airtable» — агент вызовет list_bases и list_tables.
- «Найди в таблице ‘Клиенты’ записи со статусом ‘В работе’, отсортируй по дате и покажи только имя и сумму» — серверная фильтрация через list_records.
- «Сколько сделок закрыто в этом месяце?» — подсчёт по условию.
- «Найди запись по email ivan@example.com и покажи её целиком» — search_records плюс get_record.
- «Создай запись о новом лиде: имя, телефон, источник — сайт» — create_records (нужно право write).
- «Обнови статус этой записи на ‘Оплачено’» — update_records.
- «Занеси клиента, а если он уже есть по email — обнови данные» — upsert_records по ключевому полю.
- «Оставь к записи комментарий: перезвонить завтра» — create_comment.
Частые вопросы
Какой токен нужен для интеграции Airtable?
Personal Access Token (PAT), создаётся на airtable.com/create/tokens. Устаревшие API-ключи не нужны. Добавьте токену скоупы data.records:read, data.records:write и schema.bases:read и выберите конкретные базы. Значение токена показывается один раз — скопируйте его сразу.
Безопасно ли хранить токен на платформе?
Токен сохраняется на стороне платформы и используется только для вызовов к вашим базам Airtable в рамках выданных прав. Вы контролируете риск на двух уровнях: скоупами и набором баз при создании PAT и переключателями read/write/delete у коннектора. Начните с чтения и расширяйте права по мере доверия.
Может ли агент случайно удалить или испортить данные?
Нет, пока вы не включите соответствующие права. По умолчанию активно только чтение. Создание и обновление требуют права write, удаление — delete. Пока эти переключатели выключены, агент физически не может изменить базу, даже если его об этом попросить.
Можно ли подключить несколько баз Airtable?
Да. При создании PAT добавьте в его доступ все нужные базы. У коннектора можно задать базу по умолчанию, но конкретную базу разрешено указывать в каждом запросе — агент переключается между ними по вашей формулировке.
Почему агент не выполняет действия с Airtable?
Чаще всего причины две: в чате не включён режим «ИИ-агент» (без него коннекторы не вызываются) или у коннектора не выданы нужные права — например, вы просите создать запись, а включён только read. Проверьте оба пункта, а также что токен не истёк и в его доступе есть нужная база.
Что дальше
- Страница коннектора: /partners/airtable — что умеет интеграция и зачем её подключать.
- Все интеграции СуперИнтеллекта: /guides/vse-integracii-superintellekta — обзор доступных коннекторов баз данных и вики.
- Обновление платформы: /changelog/ai-agent-data-connectors — как появились коннекторы баз данных для ИИ-агента.
Итог: подключить Airtable к ИИ-агенту — это принести свой Personal Access Token, вставить его в разделе «Интеграции» у ассистента, настроить права (по умолчанию — только чтение), привязать коннектор к агенту и включить режим «ИИ-агент» в чате. После этого управление базами и записями Airtable становится частью обычного диалога с ассистентом.
