GenerateContentResponse

Ответ модели, поддерживающей несколько кандидатов.

Примечание о рейтингах безопасности и фильтрации контента. Они сообщаются как для приглашения в GenerateContentResponse.prompt_feedback , так и для каждого кандидата в finishReason и safetyRatings . Контракт API заключается в следующем: - либо возвращаются все запрошенные кандидаты, либо не возвращаются никакие кандидаты - кандидаты не возвращаются только в том случае, если с подсказкой что-то не так (см. promptFeedback ) - обратная связь о каждом кандидате сообщается в finishReason и safetyRatings .

JSON-представление
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  }
}
Поля
candidates[]

object ( Candidate )

Ответы кандидата от модели.

promptFeedback

object ( PromptFeedback )

Возвращает отзыв о приглашении, связанный с фильтрами содержимого.

Кандидат

Кандидат на ответ, созданный на основе модели.

JSON-представление
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Поля
content

object ( Content )

Только вывод. Сгенерированный контент, возвращенный из модели.

finishReason

enum ( FinishReason )

Необязательный. Только вывод. Причина, по которой модель перестала генерировать токены.

Если пусто, модель не прекратила генерировать токены.

safetyRatings[]

object ( SafetyRating )

Список оценок безопасности кандидата-ответчика.

В каждой категории может быть не более одного рейтинга.

citationMetadata

object ( CitationMetadata )

Только вывод. Информация о цитировании кандидата, созданного моделью.

Это поле может быть заполнено информацией о декламации любого текста, включенного в content . Это отрывки, которые «зачитаны» из материалов, защищенных авторским правом, в основных учебных данных LLM.

tokenCount

integer

Только вывод. Количество токенов для этого кандидата.

index

integer

Только вывод. Индекс кандидата в списке кандидатов.

FinishReason

Определяет причину, по которой модель перестала генерировать токены.

Перечисления
FINISH_REASON_UNSPECIFIED Значение по умолчанию. Это значение не используется.
STOP Естественная точка остановки модели или предусмотренная последовательность остановок.
MAX_TOKENS Достигнуто максимальное количество токенов, указанное в запросе.
SAFETY Кандидатский контент был отмечен по соображениям безопасности.
RECITATION Контент-кандидат был помечен по причине цитирования.
OTHER Неизвестно почему.

Рейтинг безопасности

Рейтинг безопасности части контента.

Рейтинг безопасности содержит категорию вреда и уровень вероятности вреда в этой категории для части контента. Контент классифицируется по безопасности по ряду категорий вреда, и сюда включена вероятность классификации вреда.

JSON-представление
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Поля
category

enum ( HarmCategory )

Необходимый. Категория для этого рейтинга.

probability

enum ( HarmProbability )

Необходимый. Вероятность вреда для этого контента.

blocked

boolean

Был ли этот контент заблокирован из-за такого рейтинга?

ВредВероятность

Вероятность того, что часть контента является вредоносной.

Система классификации дает вероятность того, что контент небезопасен. Это не указывает на тяжесть вреда для части контента.

Перечисления
HARM_PROBABILITY_UNSPECIFIED Вероятность не указана.
NEGLIGIBLE Контент имеет ничтожную вероятность оказаться небезопасным.
LOW Контент имеет низкую вероятность оказаться небезопасным.
MEDIUM Контент имеет средний шанс оказаться небезопасным.
HIGH Контент имеет высокую вероятность оказаться небезопасным.

Метаданные цитирования

Коллекция источников для части контента.

JSON-представление
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Поля
citationSources[]

object ( CitationSource )

Ссылки на источники для конкретного ответа.

ЦитированиеИсточник

Ссылка на источник части конкретного ответа.

JSON-представление
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Поля
startIndex

integer

Необязательный. Начало сегмента ответа, приписываемого этому источнику.

Индекс указывает начало сегмента, измеряется в байтах.

endIndex

integer

Необязательный. Конец присвоенного сегмента, эксклюзивный.

uri

string

Необязательный. URI, который считается источником части текста.

license

string

Необязательный. Лицензия на проект GitHub, указанный в качестве источника для сегмента.

Информация о лицензии необходима для цитирования кода.

ПодсказкаОбратная связь

Набор метаданных обратной связи, указанный в приглашении GenerateContentRequest.content .

JSON-представление
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Поля
blockReason

enum ( BlockReason )

Необязательный. Если установлено, приглашение блокируется и кандидаты не возвращаются. Перефразируйте свою подсказку.

safetyRatings[]

object ( SafetyRating )

Оценки за безопасность подсказки. В каждой категории может быть не более одного рейтинга.

БлокПричина

Указывает, по какой причине приглашение было заблокировано.

Перечисления
BLOCK_REASON_UNSPECIFIED Значение по умолчанию. Это значение не используется.
SAFETY Подсказка заблокирована по соображениям безопасности. Вы можете проверить safetyRatings , чтобы понять, какая категория безопасности заблокировала его.
OTHER Подсказка заблокирована по неизвестным причинам.