Настройка вызова функций через REST

О чём урок

Указание function_calling_config позволяет вам контролировать поведение Gemini API, когда были заданы tools. Например, вы можете разрешить только вывод свободного текста (отключив function calling), принудительно выбрать из подмножества функций, предоставленных в tools, или позволить ему действовать автоматически. Это руководство предполагает, что вы уже знакомы с function calling. Для введения ознакомьтесь с рецептом Function calling с REST. Этот notebook содержит быстрые примеры кода, которые показывают, как начать работу с function calling, используя curl. Вы можете запустить это в Google Colab, или вы можете скопировать/вставить команды curl в свой терминал. Чтобы запустить этот notebook, ваш API key должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если вы работаете в другой среде, вы можете сохранить свой ключ в переменной окружения. См. Authentication, чтобы узнать больше. Этот пример предоставляет модели некоторые функции, которые управляют гипотетической системой освещения. Использование этих функций требует их вызова в определенном порядке. Например, вы должны включить систему освещения, прежде чем сможете изменить цвет. Хотя вы можете передать их непосредственно модели и позволить ей попытаться вызвать их правильно, указание function_calling_config дает вам точный контроль над функциями, доступными модели. Запишите tools в tools.json, чтобы вы могли ссылаться на него на последующих шагах. Если вы предоставили модели tools, но не хотите использовать их для текущего хода диалога, то укажите NONE в качестве режима. NONE указывает модели не выполнять никаких function calls, и она будет вести себя так, как будто никаких tools не было предоставлено. Чтобы позволить модели решать, отвечать ли текстом или вызывать определенные функции, вы можете указать AUTO в качестве режима. Установка режима на ANY принудит модель выполнить function call. Установив allowed_function_names, модель будет выбирать только из этих функций. Если это не установлено, все функции в tools являются кандидатами для function calling.

План урока

1. Настройка модели с tools
2. Режим только текста: NONE
3. Автоматический режим: AUTO
4. Режим вызова функций: ANY
5. Дальнейшее чтение