Урок из полного доступа, первые уроки курса бесплатно Официальный курс Gemini API Cookbook на русском
Урок 14 · Текст · ~5 мин

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

Урок 14 из 71 курса «Gemini API: быстрый старт»: официальный курс Gemini API Cookbook (Гугл Джемини) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Вызов функций позволяет разработчикам создавать описание функции в своем коде, а затем передавать это описание языковой модели в запросе. Ответ от модели включает имя функции, соответствующей описанию, и аргументы для ее вызова. Вызов функций позволяет использовать функции в качестве инструментов в приложениях генеративного ИИ, и Вы можете определить более одной функции в рамках одного запроса.

Этот блокнот содержит примеры кода, которые помогут Вам начать работу. Краткое руководство в документации также является хорошим местом для начала понимания вызова функций.

Примечание: Этот блокнот использует 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. Каждый объект взаимодействия содержит выходные данные этого хода, которые могут включать вызовы функций, результаты функций или текстовые ответы.

Эта история показывает поток:

  1. Пользователь: Отправляет сообщение.
  2. Модель: Отвечает не текстом, а FunctionCall, запрашивающим enable_lights.
  3. Пользователь (SDK): ChatSession автоматически выполняет enable_lights(), потому что automatic_function_calling включен. Он отправляет результат обратно как FunctionResponse.
  4. Модель: Использует результат функции ("Lights enabled.") для формирования окончательного текстового ответа.

ChatSession в…

План урока

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

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Google Gemini 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Google Gemini (2 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Урок входит в темы

Полезные гиды