Ответ из заданного списка вариантов (enum)

О чём урок

Gemini API позволяет предоставить схему для определения аргументов функций (для вызова функций) или для ограничения его output в JSON или с использованием Enum. В этом руководстве приведены примеры использования enums. Примечание: Этот notebook использует Interactions API, новейший способ взаимодействия с моделями Gemini. Ищете версию generateContent? Проверьте архивную ветку. Для запуска следующей cell ваш API key должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если у вас еще нет API key или вы не знаете, как создать Colab Secret, см. Аутентификация для пошагового руководства. Выберите model, которую вы хотите использовать в этом руководстве: В простейшем случае, когда вам нужно, чтобы model выбрала один вариант из списка, используйте класс enum для определения схемы. Попросите ее идентифицировать этот инструмент: Ответ должен быть одним из следующих вариантов: В Interactions API передайте класс enum в качестве schema внутри response_format с mime type application/json: Вы также можете использовать enums с mime_type application/json. В этом простом случае ответ будет обернут в JSON-строку: Помимо простых задач с множественным выбором, enum может быть использован в любом месте схемы для JSON или вызова функций. Например, попросите ее составить список названий рецептов и используйте enum Grade, чтобы присвоить каждому из них оценку популярности: Для этого примера вам нужен список объектов Recipe, поэтому передайте list[Recipe] в schema в response_format: Ознакомьтесь с документацией по structured output или справочником по GenerationConfig API для получения более подробной информации. Ограниченный output используется в примере Суммаризация текста, чтобы предоставить model формат для суммирования истории (жанр, персонажи и т.д.). Примеры Обнаружение объектов используют ограниченный JSON output для унификации output обнаружения. Enum — не единственный способ ограничить output model; вы также можете использовать схему JSON. Вызов функций и Выполнение кода — это другие способы улучшить вашу model, позволяя ей использовать ваши собственные функции или давая ей возможность писать и запускать их.

План урока

1. Установка зависимостей
2. Настройка вашего API key
3. Enums
4. Дальнейшие шаги
5. Полезные ссылки на API
6. Связанные примеры
7. Продолжите изучение Gemini API