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

Decisions API или структурированный вывод

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

О чём урок

Модель 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 — вопросы не видят друг друга, и добавление или удаление…

План урока

  1. Decisions API или структурированный вывод
  2. Настройка
  3. Установка SDK
  4. Настройка ключа API
  5. Выбор модели
  6. 1. Быстрый старт: Задайте вопрос «да/нет» (noul)
  7. 2. Типы вопросов (noul, choice и score)
  8. 2.1 noul: да или нет

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

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

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

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

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

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