О чём урок
Gemini API позволяет вам предоставить схему для определения аргументов функции (для вызова функций) или для ограничения ее вывода в JSON или с использованием Enum. Этот учебник содержит несколько примеров использования перечислений.
Примечание: Этот блокнот использует Interactions API, новейший способ взаимодействия с моделями Gemini. Ищете версию generateContent? Проверьте архивную ветку.
Чтобы запустить следующую ячейку, ваш ключ API должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если у вас еще нет ключа API или вы не знаете, как создать Colab Secret, см. Аутентификация для пошагового руководства.
Выберите модель, которую вы хотите использовать в этом руководстве:
В простейшем случае, когда вам нужно, чтобы модель выбрала один вариант из списка, используйте класс enum для определения схемы. Попросите ее идентифицировать этот инструмент:
Ответ должен быть одним из следующих вариантов:
В Interactions API передайте класс enum в качестве schema внутри response_format с типом MIME application/json:
Вы также можете использовать перечисления с типом MIME application/json. В этом простом случае ответ будет обернут в строку JSON:
Для этого примера вам нужен список объектов Recipe, поэтому передайте list[Recipe] в schema в response_format:
Дополнительную информацию см. в документации по структурированному выводу или в справочнике API GenerationConfig.
- Ограниченный вывод используется в примере Суммирование текста, чтобы предоставить модели формат для суммирования истории (жанр, персонажи и т. д.).
- Блокнот Пространственное понимание использует ограниченный вывод JSON для стандартизации вывода обнаружения.
Перечисление — не единственный способ ограничить вывод модели, вы также можете использовать схему JSON. Вызов функций и Выполнение кода — это другие способы улучшить вашу модель, либо позволяя ей использовать ваши собственные функции, либо позволяя ей писать и запускать их.
План урока
- Установка зависимостей
- Настройка ключа API
- Перечисления (Enums)
- Следующие шаги
- Полезные ссылки на API
- Связанные примеры
- Продолжайте изучение Gemini API
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.