ИП Горелов Максим Николаевич 8 (915) 093-74-75
Что такое функция?
Функции — внешние инструменты (фрагменты кода), к которым могут обращаться LLM модели для решения задач пользователей. Модель не исполняет функции, но самостоятельно принимает решение о том как, когда и с какими параметрами их следует вызвать. При принятии решения о вызове функции модель исходит из доступных знаний, данных текущего разговора и описания функции. После обращения к функции модель может обработать результат ее работы.
Что такое параметры?
Это входные данные, которые функция использует для выполнения своей задачи. Они позволяют сделать функцию гибкой и многоразовой, так как она может работать с разными данными без изменения своего кода. Например, функция для генерации изображений может принимать параметры query
(описание изображения) и resolution
(разрешение), чтобы создавать разные картинки по запросу. Параметры нужны, чтобы функция знала, что именно ей нужно обработать или какие условия учесть при выполнении действия.
Как научить ИИ агента использовать эти параметры в функции?
Чтобы объяснить ИИ, какой параметр нужно передать, вы должны включить в промпт бота четкие инструкции. Эти инструкции должны описывать:
Когда нужно вызвать функцию (условие или триггер).
Какую функцию вызвать (по названию или номеру).
Какие параметры и из какой информации в диалоге их брать.
Например, если у вас есть функция для отправки лида (№26), и она принимает параметры name
, phone
, email
, вы можете написать в промпте:
"Если клиент пришлет свой номер телефона, то сразу же вызови функцию №26 (отправка лида). В качестве phone
передай номер телефона клиента, в качестве name
используй имя, которое клиент указал в диалоге, а email
возьми, если клиент его предоставил."
ИИ будет анализировать диалог и, когда увидит соответствующее условие (например, клиент назвал свой номер телефона), он попытается извлечь нужные данные и передать их в указанную функцию.
Как научить ИИ агента правильно отвечать после выполнения функции?
Чтобы агент не отправлял технические данные, ему нужно дать инструкции что отвечать после того, как функция была вызвана.
Например для 26-й функции (отправка уведомлений) это выглядит так:
Если клиент пришлёт номер телефона, то сразу же вызови функцию отправки лида, а в качестве результата вышли клиенту дословно: «спасибо, заявка принята»
Например для 15й функции (генерация картинки) это выглядит так:
Если клиент попросит создать или нарисовать изображение, то сразу же вызови функцию 15, а в качестве результата вышли ему полученную ссылку.
Функция предоставляет расширенные возможности для работы с XML файлами как с базами данных, позволяя выполнять сложные запросы, фильтрацию и извлечение данных с поддержкой различных форматов вывода.
Параметры, которые можно передать в функцию get_filtered_xml_data:
url - URL XML файла для обработки. Обязательный параметр, указывает адрес XML файла.
xpath_query - XPath запрос для точного поиска элементов. Имеет наивысший приоритет, игнорирует element_tag. По умолчанию пустая строка.
element_tag - имя тега для поиска элементов. Поддерживает множественные теги через разделитель ';;'. По умолчанию пустая строка.
attributes_filter - объект для фильтрации по атрибутам элементов. Поддерживает wildcards (* и ?) и множественные паттерны через ';;'. По умолчанию пустой объект.
text_filter - строка для поиска в текстовом содержимом элементов. Поддерживает множественные паттерны через ';;'. По умолчанию пустая строка.
match_mode - режим сопоставления условий фильтрации. Возможные значения: "any", "all". По умолчанию "any".
case_sensitive - учитывать ли регистр при поиске по тексту и атрибутам. По умолчанию False.
limit - максимальное количество возвращаемых результатов (0 = без ограничений). Применяется после фильтрации. По умолчанию 0.
output_format - формат вывода результатов. Возможные значения: "dict", "list", "text". По умолчанию "dict".
include_parent - включать ли информацию о родительском элементе в результат (только для output_format='dict'). По умолчанию False.
include_siblings - включать ли информацию о соседних элементах (siblings) в результат (только для output_format='dict'). По умолчанию False.
"Получи данные из XML файла по ссылке https://example.com/data.xml, найди все элементы с тегом 'product' где атрибут 'category' содержит 'electronics', и выведи результаты в формате словаря."
"Выполни XPath запрос '//book[price>50]' для XML файла по URL https://library.com/books.xml с ограничением 10 результатов и выводом в текстовом формате."
"Отфильтруй данные из XML https://store.com/inventory.xml по тегам 'item;;product', где текст содержит 'discount;;sale', режим сопоставления 'any', без учета регистра, и включи информацию о родительских элементах."
ИП Горелов Максим Николаевич ИНН 500104951533 ОГРН 309500106900065