ИП Горелов Максим Николаевич 8 (915) 093-74-75
Что такое функция?
Функции — внешние инструменты (фрагменты кода), к которым могут обращаться LLM модели для решения задач пользователей. Модель не исполняет функции, но самостоятельно принимает решение о том как, когда и с какими параметрами их следует вызвать. При принятии решения о вызове функции модель исходит из доступных знаний, данных текущего разговора и описания функции. После обращения к функции модель может обработать результат ее работы.
Что такое параметры?
Это входные данные, которые функция использует для выполнения своей задачи. Они позволяют сделать функцию гибкой и многоразовой, так как она может работать с разными данными без изменения своего кода. Например, функция для генерации изображений может принимать параметры query
(описание изображения) и resolution
(разрешение), чтобы создавать разные картинки по запросу. Параметры нужны, чтобы функция знала, что именно ей нужно обработать или какие условия учесть при выполнении действия.
Как научить ИИ агента использовать эти параметры в функции?
Чтобы объяснить ИИ, какой параметр нужно передать, вы должны включить в промпт бота четкие инструкции. Эти инструкции должны описывать:
Когда нужно вызвать функцию (условие или триггер).
Какую функцию вызвать (по названию или номеру).
Какие параметры и из какой информации в диалоге их брать.
Например, если у вас есть функция для отправки лида (№26), и она принимает параметры name
, phone
, email
, вы можете написать в промпте:
"Если клиент пришлет свой номер телефона, то сразу же вызови функцию №26 (отправка лида). В качестве phone
передай номер телефона клиента, в качестве name
используй имя, которое клиент указал в диалоге, а email
возьми, если клиент его предоставил."
ИИ будет анализировать диалог и, когда увидит соответствующее условие (например, клиент назвал свой номер телефона), он попытается извлечь нужные данные и передать их в указанную функцию.
Функция позволяет выполнять различные запросы к API Росреестра, включая получение сведений об объектах, поиск по адресу и работу с многоквартирными домами.
Параметры, которые можно передать в функцию rosreestr_api_request:
request_type - тип запроса к API Росреестра. Доступные варианты:
macro_regions
child_regions
region_types
gkn_object
egrp_object_by_id
egrp_object_by_cad_num
both_db_by_cad_num
search_gkn_by_cad_num
search_gkn_by_address
search_egrp_by_address
mkd_flats
mkd_flats_full
mkd_flats_list
token - токен для доступа к API Росреестра.
cad_num - кадастровый номер объекта недвижимости требуется для запросов, связанных с конкретным объектом .
region_id - ID региона требуется для запросов child_regions и region_types .
object_id - ID объекта в ЕГРП требуется для запроса egrp_object_by_id .
macroRegionId - ID макрорегиона требуется для поиска по адресу .
regionId - ID региона требуется для поиска по адресу .
settlementId - ID населенного пункта опционально для поиска по адресу .
street - название улицы опционально для поиска по адресу .
house - номер дома опционально для поиска по адресу .
apartment - номер квартиры опционально для поиска по адресу .
params - дополнительные параметры для POST-запроса используется только для mkd_flats_list .
"Получить информацию о кадастровом объекте с кадастровым номером '1234567890123' с токеном 'your_api_token'."
"Искать объекты по адресу с ID макрорегиона '1', ID региона '2', улицей 'Ленина' и номером дома '10' с токеном 'your_api_token'."
"Получить список квартир в многоквартирном доме с ID 'house_id' с токеном 'your_api_token'."
ИП Горелов Максим Николаевич ИНН 500104951533 ОГРН 309500106900065