Supabase — это открытая backend-платформа на PostgreSQL: база данных, авторизация, файловое хранилище и авто-API поверх ваших таблиц. Коннектор «Supabase» в СуперИнтеллекте даёт ИИ-агенту прямой доступ к этой базе: он читает и меняет строки, считает записи, вызывает Postgres-функции и — при подключённом Management-токене — выполняет произвольный SQL. Вы приносите свой ключ, коннектор привязывается к ассистенту в разделе «Интеграции», и агент работает с базой обычными фразами в чате. Этот гайд отвечает на запрос «как подключить Supabase к ИИ-агенту»: где взять токен, как настроить права и что агент умеет.
Что такое интеграция Supabase с ИИ-агентом
Интеграция — это связка вашего проекта Supabase с ИИ-ассистентом СуперИнтеллекта через официальный API. Вместо того чтобы открывать таблицы в дашборде и писать SQL руками, вы описываете задачу словами: «найди последние 10 заказов со статусом paid», «посчитай пользователей за июль», «обнови статус заявки на closed». Агент сам подбирает нужный инструмент, обращается к базе по вашему токену и возвращает результат прямо в чат.
Коннектор Supabase состоит из 12 инструментов, разбитых на два модуля. Модуль «Данные» работает через авто-API Supabase и покрывает повседневный CRUD. Модуль «Админ SQL (Management API)» открывает произвольные SQL-запросы и работу с проектами аккаунта — это мощнее, но и требует отдельного токена с более широкими правами.
Что умеет агент с Supabase
Возможности удобно разделить по двум модулям. Первый закрывает большинство задач и работает по ключу проекта, второй нужен, когда требуется полноценный SQL.
Модуль «Данные»
- Список таблиц и описание структуры: supabase_list_tables, supabase_describe_table — агент видит, какие таблицы и колонки есть в базе.
- Выборка строк с фильтрами, сортировкой и лимитом: supabase_select_rows — «покажи заказы за неделю по убыванию суммы».
- Подсчёт строк: supabase_count_rows — «сколько новых регистраций сегодня».
- Вставка записей: supabase_insert_rows — «добавь лида с email и телефоном».
- Upsert (вставить или обновить): supabase_upsert_rows — обновление по ключу без дублей.
- Обновление по фильтру: supabase_update_rows — «поставь статус shipped всем заказам из этого списка».
- Удаление по фильтру: supabase_delete_rows — «удали тестовые записи с флагом is_test».
- Вызов Postgres-функций: supabase_call_rpc — запуск ваших хранимых процедур и RPC.
Модуль «Админ SQL (Management API)»
- Произвольный SQL-запрос: supabase_run_sql — сложные JOIN, агрегации, аналитика, которую REST-API данных не покрывает.
- Список проектов аккаунта: supabase_list_projects — все проекты под вашим Management-токеном.
- Данные конкретного проекта: supabase_get_project — метаданные и параметры выбранного проекта.
Где взять токен Supabase
Для базового сценария (модуль «Данные») нужны два значения: URL проекта и ключ доступа. Оба лежат в настройках проекта. Для произвольного SQL и списка проектов дополнительно понадобится Management-токен уровня аккаунта.
- Откройте свой проект на supabase.com и перейдите в Settings → API.
- Скопируйте Project URL — это адрес вашего проекта вида https://.supabase.co.
- В разделе API Keys скопируйте ключ service_role (secret). Именно он даёт агенту доступ к данным по таблицам.
- Для модуля «Админ SQL»: откройте Account → Access Tokens и создайте Management PAT (Personal Access Token).
- Сохраните значения — вставлять их будете в разделе «Интеграции» у ассистента.
Как подключить Supabase к ИИ-агенту: пошагово
- Откройте настройки нужного ИИ-ассистента и перейдите в раздел «Интеграции» — это каталог коннекторов.
- Найдите в каталоге Supabase и выберите его.
- Вставьте Project URL и ключ service_role в соответствующие поля. Если планируете произвольный SQL — добавьте Management-токен.
- Настройте права: по умолчанию включено только чтение (read). Запись (write) и удаление (delete) включайте вручную, только если агенту действительно нужно менять данные.
- При желании укажите проект/базу по умолчанию — конкретный проект всё равно можно задавать в каждом запросе.
- Сохраните коннектор и привяжите его к ассистенту.
- В чате с ассистентом включите кнопку «ИИ-агент» — она активирует доступ к инструментам интеграций.
- Проверьте связь простым запросом: «покажи список таблиц в базе».
Инструменты и права: сводная таблица
| Инструмент | Модуль | Что делает | Право |
|---|---|---|---|
| supabase_list_tables | Данные | Список таблиц базы | read |
| supabase_describe_table | Данные | Структура таблицы и колонки | read |
| supabase_select_rows | Данные | Выборка строк с фильтрами | read |
| supabase_count_rows | Данные | Подсчёт строк | read |
| supabase_insert_rows | Данные | Вставка новых записей | write |
| supabase_upsert_rows | Данные | Вставка или обновление по ключу | write |
| supabase_update_rows | Данные | Обновление строк по фильтру | write |
| supabase_delete_rows | Данные | Удаление строк по фильтру | delete |
| supabase_call_rpc | Данные | Вызов Postgres-функций (RPC) | read/write |
| supabase_run_sql | Админ SQL | Произвольный SQL-запрос | read/write |
| supabase_list_projects | Админ SQL | Список проектов аккаунта | read |
| supabase_get_project | Админ SQL | Данные конкретного проекта | read |
Примеры промптов
После подключения агент понимает запросы на естественном языке — не нужно помнить имена инструментов или синтаксис REST-API данных. Несколько рабочих формулировок:
- «Покажи структуру таблицы orders и первые 5 строк.»
- «Сколько записей в users создано за последние 7 дней?»
- «Найди все заказы со статусом pending и суммой больше 5000, отсортируй по дате.»
- «Добавь в таблицу leads запись: имя Иван, email ivan@example.com, источник telegram.»
- «Обнови статус на processed у заявок с id 12, 15 и 18.»
- «Выполни SQL: посчитай выручку по месяцам за 2026 год с группировкой.» (нужен Management-токен и модуль «Админ SQL»)
- «Вызови функцию recalc_stats для воркспейса 42.»
Безопасность и хорошие практики
- Минимум прав. Оставляйте read по умолчанию, включайте write/delete только для агентов, которым это реально нужно.
- Осторожно с service_role. Он обходит RLS — не давайте такой доступ ассистентам с внешними пользователями.
- Management-токен — только при необходимости. Если произвольный SQL и список проектов не нужны, не добавляйте Management PAT вовсе.
- Тестовое окружение. Отрабатывайте сценарии записи/удаления на копии данных или staging-проекте, прежде чем подключать боевую базу.
- Ротация ключей. Если ключ мог утечь, перевыпустите его в Settings → API и обновите в коннекторе.
Частые вопросы
Какой ключ Supabase нужен для подключения?
Для модуля «Данные» — Project URL и ключ service_role из Settings → API. Для модуля «Админ SQL» (произвольный SQL и список проектов) дополнительно нужен Management PAT из Account → Access Tokens. Если админ-функции не требуются, достаточно первых двух значений.
Обходит ли агент политики RLS?
С ключом service_role — да: этот ключ по своей природе игнорирует Row Level Security и видит все строки. Это удобно для доверенного внутреннего ассистента, но опасно для агентов с доступом посторонних. Учитывайте это при настройке прав и не публикуйте ключ.
Может ли агент удалить данные случайно?
Нет, если не выдать право delete. По умолчанию включено только чтение. Удаление и запись — отдельные права, которые вы включаете осознанно. Пока их нет, агент физически не может изменить или удалить строки.
Можно ли подключить несколько проектов Supabase?
Да. Можно задать проект по умолчанию, но конкретный проект указывается в каждом запросе. С Management-токеном агент видит список проектов аккаунта и может работать с нужным из них.
Работает ли коннектор с self-hosted Supabase?
Модуль «Данные» работает с любым проектом, у которого есть доступный Project URL и ключ service_role, — то есть и с self-hosted инсталляцией. Модуль «Админ SQL» через Management API рассчитан на облачные проекты Supabase, где выдаётся Management PAT.
Как включить работу агента с базой?
Подключите коннектор в разделе «Интеграции» у ассистента, привяжите его к агенту и в чате нажмите кнопку «ИИ-агент». После этого ассистент получает доступ к инструментам Supabase и выполняет запросы к вашей базе.
Что почитать дальше
- Страница коннектора: /partners/supabase — обзор возможностей и статус готовности.
- Все интеграции СуперИнтеллекта: /guides/vse-integracii-superintellekta — полный каталог коннекторов баз данных и вики.
- Что нового: /changelog/ai-agent-data-connectors — как появились коннекторы баз данных и вики для ИИ-агента.
