Поиск в таблице

Дадим возможность ИИ-агенту работать с полями в таблице и искать нужную для него информацию.

Задача: Имеется простая таблица с полями.

  • "наименование", тип поля: Текст с умным поиском (text_vector)

  • "категория", тип поля: Текст (text)

  • "цена", тип поля: Число с точкой (float)

  • "в_наличии": тип поля: Логическое (boolean)

Необходимо, чтобы ИИ-агент мог выполнять поиск по таблице, а затем выдавать ответы на основе найденной информации.

Структура таблицы для теста

Настройка ИИ-агента

Чтобы ИИ-агент мог искать информацию в базе данных, необходимо создать соответствующую функцию. Ниже приведена пошаговая инструкция.

Примите во внимание, что поиск можно вести только по нужным вам полям — не обязательно использовать все существующие. При нахождении строки, ИИ-агент получит всю её информацию по всем полям. Например, поиск можно настроить по типу: «название», «название + цена», «название + параметр + цена». Однако имейте в виду, что чрезмерное количество параметров (более 4–5) может привести к тому, что нужная информация не будет найдена в таблице.

  1. Перейдите в раздел «Функции».

  2. Создайте новую функцию с понятным для ИИ названием (на английском языке, латиницей), например: get_info_from_database

  3. Добавьте переменные, указав каждую как "необязательный параметр". В этом случае ИИ-агент сможет выполнять поиск по одному или нескольким параметрам — даже при получении неполной информации. (Подробнее о необязательных параметрах можно прочитать в статье Советы по работе и настройке таблиц)

    • name — название товара.

    • category — категория товара. Сделайте поле листовым и добавьте значения: Мебель, Освещение, Текстиль. (Подробнее о листовых значениях можно прочитать в статье)

    • is_available — логический оператор наличия товара. Сделайте поле листовым и добавьте два значения: true, false.

  4. В разделе «Отправка результатов» включите опцию «Поиск в таблице»

  5. Нажмите на раздел «Поиск в таблице»

  6. Выберите таблицу, в которой будет осуществляться поиск.

  7. Нажмите «Новое поле» и настройте параметры поиска.

  8. Добавим первое поле

  9. Развернём выпадающие параметры (подробнее про их настройки можно прочитать в этой статье) и настроим их:

    • Поле в таблице → выберите наименование. Это поле имеет тип «Текст с умным поиском (text_vector)», что позволяет выполнять поиск по смыслу и значительно быстрее.

    • Оператор → оставьте «По схожести». Для text_vector мы настоятельно рекомендуем использовать именно его, в противном случае используйте другой тип поля (например, "текст").

    • Источник значения → выберите «Значение из параметра функции». Поскольку мы используем "динамическое" значение, полученное от клиента.

    • Параметр функцииname.

    • Настройки Порога схожести оставим по умолчанию. После тестов, если вы не довольны результатом, можете сделать их более или менее строгими.

  10. Добавим второй параметр и выберем его параметры

    • Поле в таблице → выберите категория.

    • Оператор«Равно (=)», так как поле принимает фиксированные значения.

    • Источник значения«Значение из параметра функции».

    • Параметр функцииcategory.

  11. Добавим третий параметр и выберем его параметры

    • Поле в таблице → выберите в_наличии.

    • Оператор«Равно (=)».

    • Источник значения«Значение из параметра функции».

    • Параметр функцииis_available.

  12. Перейдём к блоку "Настройка результатов". Здесь вы можете настроить следующие параметры:

    • Максимальное количество результатов: выбор источника значения и количества строк, выдаваемых ИИ-агентом на запрос клиента. Сейчас для нас достаточно 5 строк (например, показать 5 вариантов мебели на один запрос), однако, если ваш случай требует показать клиенту больше, вы можете настроить значение под себя. Чем больше результатов, тем больше расход токенов.

    • Возвращаемые поля: выберите только те поля, к которым вы хотите дать доступ ИИ-агенту. Пример: в таблице могут быть служебные поля, информацию из которых не нужно передавать клиентам. Также это позволит экономить токены.

    • Настройки результатов поиска по схожести: используется для тестирования проверки схожести между запросом клиента и ответом ИИ-агента (только для полей с умным поиском). Рекомендуем выключать его после окончания тестирования, чтобы экономить токены.

  13. Сохраните функцию.

  14. Протестируйте работу новой функции в диалоге с ИИ-агентом и удостоверьтесь, что он научился получать данные из вашей таблицы и выдавать их согласно запросу клиента.

Last updated