Вызов функций через REST

О чём урок

Этот notebook содержит краткие примеры кода, демонстрирующие, как начать работу с function calling, используя curl. Вы можете запустить его в Google Colab или скопировать/вставить команды curl в свой терминал. Для запуска этого notebook ваш API key должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если вы работаете в другой среде, вы можете сохранить свой ключ в переменной среды. Подробнее см. в разделе Authentication. Function calling позволяет разработчикам создавать описание функции в своем коде, а затем передавать это описание языковой модели в запросе. Ответ от модели включает имя функции, соответствующей описанию, и аргументы для ее вызова. Function calling позволяет использовать функции в качестве инструментов в приложениях генеративного ИИ, и вы можете определить более одной функции в рамках одного запроса. Function calling возвращает JSON с именем функции и аргументами для использования в вашем коде. Функции описываются с помощью function declarations. После того как вы передадите список function declarations в запросе языковой модели, модель вернет объект в формате OpenAPI compatible schema, который включает имена функций и их аргументы, и попытается ответить на запрос пользователя с помощью одной из возвращенных функций. Языковая модель понимает назначение функции, анализируя ее function declaration. Модель фактически не вызывает функцию. Вместо этого разработчик использует объект OpenAPI compatible schema в ответе для вызова функции, которую возвращает модель. При реализации function calling вы создаете одну или несколько function declarations, затем добавляете function declarations в объект tools, который передается модели. Каждая function declaration содержит информацию об одной функции, которая включает следующее: Имя функции Параметры функции в формате OpenAPI compatible schema. Поддерживается выбранное подмножество (добавить ссылку). При использовании curl схема указывается с помощью JSON. Описание функции (необязательно). Для достижения наилучших результатов рекомендуется включать описание. Этот notebook включает примеры curl, которые выполняют REST-вызовы с использованием класса GenerativeModel и его методов. Все модели Gemini поддерживают function calling.

План урока

1. Как работает function calling
2. Поддерживаемые модели
3. Примеры cURL для function calling
4. Пример curl для однократного обращения (single-turn)
5. Примеры curl для многократного обращения (multi-turn)
6. Пример curl, использующий ответ из предыдущего turn
7. Пример curl, который вызывает языковую модель несколько раз