Интеграция Buildin.ai с ИИ-агентом — это подключение вашего рабочего пространства Buildin.ai (страницы и базы данных) к ассистенту СуперИнтеллекта, после которого агент читает и меняет ваши документы и записи обычными фразами в чате: найти страницу, собрать содержимое в Markdown, создать новый документ, обновить статус в базе. Buildin.ai — это блочный редактор и база знаний в духе Notion: контент строится из страниц и структурированных баз данных. Ниже — пошаговый разбор, где взять API-токен, как привязать коннектор к агенту в разделе «Интеграции» и что именно ИИ-агент умеет делать с Buildin.ai.
Что такое коннектор Buildin.ai и зачем он ИИ-агенту
Коннектор — это мост между ИИ-агентом СуперИнтеллекта и API вашего аккаунта Buildin.ai. Вы приносите собственный токен, платформа хранит его на своей стороне, а коннектор привязывается к конкретному ассистенту. После этого агент обращается к Buildin.ai напрямую: сам находит нужную страницу, читает её как Markdown, дописывает блоки или запрашивает базу данных с фильтрами. Всё это происходит в едином окне СуперИнтеллекта — переключаться между вкладками и вручную копировать текст из вики больше не нужно.
Ключевой принцип безопасности: токен ваш, и вы сами решаете, к каким страницам выдать доступ бот-интеграции внутри Buildin.ai, а какие права (чтение / запись / удаление) включить на стороне СуперИнтеллекта. По умолчанию агент работает только на чтение.
Что умеет ИИ-агент с Buildin.ai: 9 инструментов
Коннектор Buildin.ai даёт агенту 9 инструментов, покрывающих полный цикл работы со страницами и базами данных — от поиска и чтения до создания, обновления и удаления блоков.
| Инструмент | Что делает | Право |
|---|---|---|
| buildin_search | Поиск по рабочему пространству — страницы и базы по запросу | Чтение |
| buildin_get_page | Чтение свойств и метаданных страницы | Чтение |
| buildin_get_page_content | Выгрузка содержимого страницы как Markdown | Чтение |
| buildin_get_database | Метаданные базы данных (поля, структура) | Чтение |
| buildin_query_database | Запрос записей базы с фильтрами | Чтение |
| buildin_create_page | Создание новой страницы | Запись |
| buildin_update_page | Обновление существующей страницы | Запись |
| buildin_append_blocks | Дозапись блоков в конец страницы | Запись |
| buildin_delete_block | Удаление блока со страницы | Удаление |
Где взять API-токен Buildin.ai
Для подключения нужен API-токен бот-интеграции Buildin.ai. Он создаётся один раз в настройках вашего аккаунта и затем вставляется в СуперИнтеллекте.
- Откройте Buildin.ai и перейдите в Настройки → Интеграции.
- Создайте новую интеграцию (бота) и скопируйте выданный API Token.
- Выдайте этой интеграции доступ к нужным страницам и базам — только к тем, с которыми должен работать агент.
- Скопированный токен сохраните: он понадобится на следующем шаге при подключении коннектора.
| Что нужно | Где взять |
|---|---|
| API Token | Настройки → Интеграции → создать интеграцию → скопировать токен |
| Доступ к страницам | Открыть нужную страницу/базу для созданной интеграции |
Как подключить Buildin.ai к ИИ-агенту: пошагово
Подключение занимает пару минут. Ключевое поисковое действие — «как подключить Buildin.ai к нейросети / ИИ-агенту» — сводится к четырём шагам в разделе «Интеграции» у вашего ассистента.
- Откройте настройки нужного ИИ-ассистента и перейдите в раздел «Интеграции» — это каталог коннекторов.
- Найдите в каталоге Buildin.ai и вставьте скопированный ранее API-токен. Токен сохраняется на стороне платформы.
- Настройте права коннектора: по умолчанию включено только чтение (read). Запись и удаление включайте, только если агенту действительно нужно менять данные.
- Привяжите коннектор к ассистенту и включите у него кнопку «ИИ-агент» — она активирует работу с инструментами Buildin.ai в чате.
Права доступа и безопасность
Права коннектора — главный инструмент контроля. Модель прав простая: read (чтение), write (запись), delete (удаление). По умолчанию активно только чтение — агент может искать и читать, но ничего не изменит без вашего разрешения.
- Чтение (по умолчанию): buildin_search, buildin_get_page, buildin_get_page_content, buildin_get_database, buildin_query_database.
- Запись (включать осознанно): buildin_create_page, buildin_update_page, buildin_append_blocks.
- Удаление (максимальная осторожность): buildin_delete_block.
Примеры промптов для агента с Buildin.ai
После подключения обращайтесь к агенту обычными фразами — он сам подберёт нужный инструмент. Несколько рабочих примеров:
- «Найди в Buildin.ai страницу про онбординг новых сотрудников и перескажи её основные пункты» — поиск + чтение содержимого как Markdown.
- «Собери контент страницы "Регламент поддержки" и составь по нему короткую памятку» — get_page_content + резюме.
- «Создай новую страницу "Итоги спринта" и добавь туда три раздела с задачами» — create_page + append_blocks.
- «В базе задач покажи все записи со статусом "В работе" и дедлайном на этой неделе» — query_database с фильтрами.
- «Допиши в конец страницы "Changelog" блок с сегодняшними изменениями» — append_blocks (право записи).
- «Удали устаревший блок с прошлогодним прайсом на странице "Услуги"» — delete_block (право удаления).
Частые вопросы
Нужен ли отдельный токен для каждого ассистента?
Токен вставляется один раз и хранится на платформе, а коннектор привязывается к конкретному ассистенту. Вы можете использовать один и тот же API-токен Buildin.ai для нескольких агентов или создать в Buildin.ai отдельные бот-интеграции с разным доступом — это удобно, когда нужно разграничить, кто из агентов какие страницы видит.
Агент видит все мои страницы в Buildin.ai?
Нет. Бот-интеграция Buildin.ai видит только те страницы и базы, к которым вы явно выдали ей доступ в настройках Buildin.ai. Если нужной страницы нет в выдаче поиска — откройте её для интеграции вручную.
Может ли агент случайно удалить данные?
Только если вы включили право удаления. По умолчанию коннектор работает на чтение, и инструмент buildin_delete_block недоступен. Оставляйте удаление выключенным, пока в нём нет прямой необходимости — это исключает нежелательные изменения.
Buildin.ai — это то же самое, что Notion?
Buildin.ai — самостоятельный сервис с похожей на Notion концепцией: страницы, блоки и базы данных. Коннектор СуперИнтеллекта поддерживает эти сущности напрямую — поиск, чтение как Markdown, создание и обновление страниц, дозапись блоков, работу с базами данных.
Что делать, если агент не обращается к Buildin.ai?
Проверьте три вещи: у ассистента включена кнопка «ИИ-агент»; коннектор Buildin.ai привязан к этому ассистенту; токен корректен, а нужные страницы расшарены на интеграцию внутри Buildin.ai. Чаще всего причина — выключенный режим «ИИ-агент» или неоткрытый доступ к странице.
Что дальше
Подключите Buildin.ai в разделе «Интеграции» у вашего ассистента, вставьте токен, оставьте на старте только чтение и включите кнопку «ИИ-агент». Дальше — расширяйте права под конкретные сценарии по мере доверия к автоматизации.
- Страница коннектора Buildin.ai: /partners/buildin
- Все интеграции СуперИнтеллекта: /guides/vse-integracii-superintellekta
- Обновление про коннекторы баз данных и вики: /changelog/ai-agent-data-connectors
