Ремонт телефонов

Это самое стандартное использование notion. Чаще всего этого будет достаточно. У нас есть сервис ремонта телефонов. Мы хотим что бы бот получал информацию по услуге используя поиск по услуге (например, замена стекла) и модели телефона (например, iPhone 14). Т.е. Бот будет спрашивать "Какое у вас устройство?" и "Какая у вас поломка?" и с этими данными искать в табличке. Исходя из этого давайте сделаем таблицу:

Обратите внимание на заголовок таблицы - table of services, название отражает суть, на английском и не содержит спец символов.

Колонка title не используется для поиска и чтения, по этому мы просто её продублировали, но можете оставить её пустой.

Service содержит список услуг, опять же название не содержит спец символов и оно на английском. В качестве формата мы использовали Select (можно использовать Multi-Select, это не будет ошибкой). Аналогично мы сделали и с device. Главное, что бы поля не содержали слишком много вариантов значений, на основе этих данных будет сделана функция и она ограничена размером 1024 токенов, это довольно много, но можно превысить. Этот вариант хорошо работает с категориями/повторяющимися данными и т.д.

Теперь давайте перейдем к данным, которые мы хотим получить после запроса. Можно было бы разделить на несколько столбиков: продолжительность услуги, цена и т.д., НО нам не надо искать по этим данным и мы хотим что бы бот использовал форматирование текста. Для этого мы добавили столбик типа Text, с явной подсказкой, что делать боту - send this text without changes. Он содержит такие данные:

Как подключать базу вы можете посомтреть в разделе "Подключение", тут мы это пропустим и сразу перейдём к настройке прав доступа.

Тут мы видим, что описания, нет, но в промте указано что он работает в ремонте телефонов и из контекста он понимает что это за поля. Для поиска мы выбрали наши поля Select, для чтения их же + send this text without changes.

Важно, если у вас есть параметры не обязательные для поиска, то поставьте "Опционально". Так бот сможет обращаться к базе без заполнения этих полей. Если у вас не стоит эта настройка, то бот будет всегда спрашивать этот параметр! В нашем случае так и должно быть, но далеко не всегда нужно именно такое взаимодействие.

А теперь давайте посмотрим как это работает, вот сам диалог со страницы диалогов:

Вот запрос в notion и результат:

Мы видим что бот спросил у клиента какая модель телефона и какой вид ремонта требуется. Далее с этими данными он обратился в notion, причем он их преобразовал в правильные, сделал это без ошибок. Под эти параметры подошла ровно одна запись, и бот увидел что там есть столбик, который и надо отправить клиенту с нужными, отформатированными данными, и их он и отправил в ответ.