О чём урок
Модель Gemini Decision (gemini-decision-1) и Decisions API (client.decisions / /v1beta/decisions) отвечают на один или несколько типизированных вопросов о ваших данных в одном запросе. Вы отправляете input (текст, JSON, изображения, аудио, видео или PDF) и карту questions.
На каждый вопрос вы получаете калиброванные вероятности по результатам вместе с лучшим ответом — вероятность «да/нет» (noul), вероятности вариантов и лучший выбор (choice) или взвешенную по вероятности оценку по рубрике и вероятности уровней (score) — плюс оценку confidence. Поскольку ничего не генерируется, нет выходного текста для парсинга и нет выходных токенов, за которые нужно платить (total_output_tokens = 0).
Типичные применения: * Маршрутизация запроса к модели, очереди, агенту или инструменту. * Проверка входных и выходных данных на соответствие множеству правил политики одновременно. * Определение того, какие инструменты нужны агенту, или нужно ли сжимать, эскалировать или останавливать. * Фильтрация, оценка или ранжирование больших наборов данных по рубрике. * Реагирование на состояние пользовательского интерфейса, аудио, видеокадры или документы в реальном времени.
Decisions API требует версию 3.2 или новее официального SDK google-genai (pip install -U google-genai).
Чтобы запустить следующие ячейки, сохраните ваш ключ API в Colab Secret с именем GEMINI_API_KEY. Если у вас еще нет ключа API или вы не знаете, как создать Colab Secret, см. Аутентификация для пошагового руководства.
Поскольку gemini-decision-1 и Decisions API доступны только на конечной точке v1beta, в то время как google-genai 3.x по умолчанию использует v1, явно передайте http_options={"api_version": "v1beta"} при инициализации genai.Client.
Decisions API использует модель gemini-decision-1:
Каждый запрос client.decisions.create принимает: * model: ID модели (gemini-decision-1). * input: Общий контекст (str, словарь Content или список блоков Content), оцениваемый один раз для всех вопросов. * questions: Карта ключей вопросов, определенных вызывающей стороной ([A-Za-z0-9_-]+, до 64 символов), к определениям вопросов (type, instructions и необязательные/обязательные criteria).
Каждый вопрос оценивается независимо от input — вопросы не видят друг друга, и добавление или удаление…
План урока
- Decisions API или структурированный вывод
- Настройка
- Установка SDK
- Настройка ключа API
- Выбор модели
- 1. Быстрый старт: Задайте вопрос «да/нет» (noul)
- 2. Типы вопросов (noul, choice и score)
- 2.1 noul: да или нет
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.