Урок 4. Notion: база + документы#
Цель: понять, как использовать Notion для агентов, если нужны не только данные, но и документы.
Что такое Notion#
Notion — это гибрид базы данных, вики и рабочего пространства. Вы можете:
- создавать базы данных (таблицы, доски, календари)
- вести документы (страницы с текстом, изображениями, встроенными файлами)
- связывать базы и документы (база клиентов → страница клиента с историей)
- работать совместно с командой
Когда использовать Notion для агентов#
Используйте Notion, если:
- нужна база данных + документация (клиенты + заметки о встречах)
- команда уже работает в Notion
- нужны гибкие представления (таблица, доска, календарь, галерея)
- нужен контекст для агента (например, агент читает базу знаний из страниц Notion)
Как устроена база данных в Notion#
База данных в Notion — это коллекция страниц, где:
- каждая страница — это одна запись (клиент, задача, проект)
- у каждой страницы есть свойства (имя, статус, дата, теги)
- внутри страницы может быть контент (текст, таблицы, файлы)
Пример: база «Клиенты»
- Свойства: Имя, Email, Статус, Дата регистрации, Теги
- Контент страницы: История встреч, заметки, файлы договоров
Как подключить Notion к агенту#
Шаг 1. Создать базу данных
- создайте страницу в Notion
- добавьте блок «Database» (таблица, доска, календарь)
- настройте свойства (имя, текст, число, дата, статус, теги)
Шаг 2. Получить API-ключ
- зайдите на developers.notion.com
- создайте интеграцию (Integration)
- скопируйте Internal Integration Token
Шаг 3. Дать доступ интеграции к базе
- откройте базу данных в Notion
- нажмите
⋮(три точки) → «Add connections» → выберите свою интеграцию
Шаг 4. Подключить через интеграцию
- в Zapier / Make / n8n выберите модуль «Notion»
- введите API-ключ
- выберите базу данных
- настройте действие: «Прочитать страницы», «Создать страницу», «Обновить страницу»
Шаг 5. Протестировать
- запустите тест
- убедитесь, что данные читаются и записываются корректно
Пример: агент с базой знаний в Notion#
Задача: бот поддержки отвечает на вопросы клиентов, используя базу знаний из Notion.
Структура:
- База данных «Вопросы-ответы» в Notion
- Свойства: Вопрос (текст), Категория (тег), Ответ (текст в контенте страницы)
Логика агента:
- Клиент пишет вопрос в бот
- Агент ищет похожий вопрос в базе Notion (через поиск по тексту или тегам)
- Если вопрос найден → агент читает контент страницы (ответ) и отправляет клиенту
- Если вопрос не найден → агент предлагает связаться с оператором
Инструменты: Coze (для бота) + Notion (для базы знаний) + интеграция через API или n8n.
Ограничения Notion для агентов#
- API медленный (запросы могут занимать 1–3 секунды)
- Нет массовых операций (нельзя обновить 100 записей за один запрос)
- Лимиты API (3 запроса в секунду на бесплатном тарифе)
Notion хорош для небольших баз (до 1000 записей) и задач, где важен контекст (документы + данные).