О чём урок
Вызов функций позволяет разработчикам создавать описание функции в своем коде, а затем передавать это описание языковой модели в запросе. Ответ от модели включает имя функции, соответствующей описанию, и аргументы для ее вызова. Вызов функций позволяет использовать функции в качестве инструментов в приложениях генеративного ИИ, и Вы можете определить более одной функции в рамках одного запроса.
Этот блокнот содержит примеры кода, которые помогут Вам начать работу. Краткое руководство в документации также является хорошим местом для начала понимания вызова функций.
Примечание: Этот блокнот использует Interactions API, новейший способ взаимодействия с моделями Gemini. Ищете версию generateContent? Проверьте архивную ветку.
Чтобы запустить следующую ячейку, Ваш ключ API должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если у Вас еще нет ключа API или Вы не знаете, как создать Colab Secret, см. Аутентификация для пошагового руководства.
Вызов функций работает на всех моделях Gemini.
Вызовы функций естественным образом вписываются в многооборотные беседы. С помощью Interactions API модель возвращает выходные данные function_call, которые Вы обрабатываете и на которые отвечаете, используя входные данные function_result.
Примечание: Автоматический вызов функций (когда SDK автоматически вызывает Ваши функции) является функцией client.chats.create. С interactions.create Вы обрабатываете вызовы функций вручную, что дает Вам больше контроля.
Ответ от interactions.create содержит список steps. Для текстовых ответов доступ к выводу осуществляется через interaction.steps[-1].content[0].text.
С помощью Interactions API состояние беседы управляется на стороне сервера через previous_interaction_id. Каждый объект взаимодействия содержит выходные данные этого хода, которые могут включать вызовы функций, результаты функций или текстовые ответы.
Эта история показывает поток:
- Пользователь: Отправляет сообщение.
- Модель: Отвечает не текстом, а FunctionCall, запрашивающим enable_lights.
- Пользователь (SDK): ChatSession автоматически выполняет enable_lights(), потому что automatic_function_calling включен. Он отправляет результат обратно как FunctionResponse.
- Модель: Использует результат функции ("Lights enabled.") для формирования окончательного текстового ответа.
ChatSession в…
План урока
- Настройка
- Установка зависимостей
- Настройка ключа API
- Выбор модели
- Настройка функций как инструментов
- Базовый вызов функций с многооборотным взаимодействием
- Изучение вызовов функций и истории выполнения
- Автоматическое выполнение функций (только client.chats)
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.