Вызов функций из Python

О чём урок

Function calling позволяет разработчикам создавать описание функции в своём коде, а затем передавать это описание языковой модели в запросе. Ответ от модели включает имя функции, соответствующее описанию, и аргументы для её вызова. Function calling позволяет использовать функции в качестве инструментов в приложениях генеративного ИИ, и вы можете определить более одной функции в рамках одного запроса. Этот notebook содержит примеры кода, которые помогут вам начать работу. Quickstart в документации также является хорошим местом для начала изучения function calling. Примечание: Этот notebook использует Interactions API — новейший способ взаимодействия с моделями Gemini. Ищете версию generateContent? Проверьте архивную ветку. Для запуска следующей cell ваш API key должен быть сохранён в Colab Secret с именем GEMINI_API_KEY. Если у вас ещё нет API key или вы не знаете, как создать Colab Secret, см. Authentication для пошагового руководства. Function calling работает со всеми моделями Gemini. Чтобы использовать function calling, передайте список функций параметру tools при создании взаимодействия. С Interactions API инструменты объявляются как словари. SDK также может автоматически генерировать схемы инструментов из функций Python. Вызовы функций естественным образом вписываются в многоходовые беседы. С Interactions API модель возвращает function_call outputs, которые вы обрабатываете и на которые отвечаете, используя function_result inputs. Примечание: Автоматический function calling (где SDK вызывает ваши функции автоматически) является особенностью client.chats.create. С interactions.create вы обрабатываете вызовы функций вручную, что даёт вам больше контроля. Ответ от interactions.create содержит список steps. Для текстовых ответов доступ к output осуществляется через interaction.steps[-1].content[0].text. С Interactions API состояние беседы управляется на стороне сервера через previous_interaction_id. Каждый объект взаимодействия содержит outputs этого хода, которые могут включать вызовы функций, результаты функций или текстовые ответы. Эта история показывает поток: Пользователь: Отправляет сообщение. Модель: Отвечает не текстом, а FunctionCall, запрашивающим enable_lights.

План урока

1. Настройка
2. Установка зависимостей
3. Настройка вашего API key
4. Выбор модели
5. Настройка функций в качестве инструментов
6. Базовый Function Calling с многоходовым взаимодействием
7. Изучение вызовов функций и истории выполнения
8. Автоматическое выполнение функций (только client.chats)