О чём урок
Gemini API имеет настраиваемые параметры безопасности. Этот блокнот покажет вам, как их использовать. Вы напишете запрос, который будет заблокирован, увидите причину блокировки, а затем настроите фильтры, чтобы разблокировать его.
Безопасность — важная тема, и вы можете узнать больше, перейдя по ссылкам в конце этого блокнота. А пока сосредоточьтесь только на коде.
Если вы хотите быстро опробовать Gemini API, вы можете использовать команды curl для вызова методов в REST API.
Этот блокнот содержит команды curl, которые вы можете запустить в Google Colab или скопировать в свой терминал.
Чтобы запустить этот блокнот, ваш ключ API должен быть сохранен в секрете Colab с именем GEMINI_API_KEY. Если вы работаете в другой среде, вы можете сохранить свой ключ в переменной среды. Подробнее см. в разделе Аутентификация.
Результат, возвращаемый методом Model.generate_content, представляет собой genai.GenerateContentResponse.
Выше вы можете видеть, что объект ответа предоставляет вам обратную связь по безопасности относительно запроса двумя способами:
- Атрибут prompt_feedback.safety_ratings содержит список оценок безопасности для входного запроса.
- Если ваш запрос заблокирован, поле prompt_feedback.block_reason объяснит причину.
Если запрос заблокирован из-за оценок безопасности, вы не получите никаких кандидатов в ответе.
Настройте параметры безопасности, и запрос больше не будет заблокирован:
С новыми настройками blocked_reason больше не установлен.
И возвращается ответ кандидата.
Вы можете проверить response.text на наличие ответа.
Для незаблокированного запроса объект ответа содержит список объектов candidate (пока только 1). Каждый кандидат включает finish_reason:
FinishReason.STOP означает, что модель завершила вывод нормально.
FinishReason.SAFETY означает, что safety_ratings кандидата превысили пороговое значение safety_settings запроса.
Узнайте больше из этих статей о рекомендациях по безопасности и настройках безопасности.
- Настройки безопасности можно установить в конструкторе genai.GenerativeModel. Их также можно передавать с каждым запросом в GenerativeModel.generate_content или ChatSession.send_message.
- genai.GenerateContentResponse возвращает SafetyRatings для запроса в GenerateContentResponse.prompt_feedback и для каждого…
План урока
- Настройка ключа API
- Обратная связь по запросу
- Настройки безопасности
- Оценки кандидатов
- Узнать больше
- Полезные ссылки на API
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.