Candidate

모델에서 생성된 응답 후보입니다.

JSON 표현
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "groundingAttributions": [
    {
      object (GroundingAttribution)
    }
  ],
  "index": integer
}
필드
content

object (Content)

출력 전용. 모델에서 반환된 생성된 콘텐츠

finishReason

enum (FinishReason)

선택사항입니다. 출력 전용. 모델이 토큰 생성을 중지한 이유입니다.

비어 있으면 모델이 토큰 생성을 중지하지 않은 것입니다.

safetyRatings[]

object (SafetyRating)

응답 후보의 안전성 평점 목록입니다.

카테고리당 최대 하나의 평점이 있습니다.

citationMetadata

object (CitationMetadata)

출력 전용. 모델 생성 후보의 인용 정보입니다.

이 필드는 content에 포함된 텍스트에 관한 암송 정보로 채워질 수 있습니다. 이는 기본 LLM 학습 데이터의 저작권 보호 자료에서 '인용'된 문구입니다.

tokenCount

integer

출력 전용. 이 후보의 토큰 수입니다.

groundingAttributions[]

object (GroundingAttribution)

출력 전용. 근거를 제시하는 답변에 기여한 소스의 기여 분석 정보입니다.

이 필드는 GenerateAnswer 호출의 경우 채워집니다.

index

integer

출력 전용. 후보 목록에서 후보의 색인입니다.

FinishReason

모델이 토큰 생성을 중지한 이유를 정의합니다.

열거형
FINISH_REASON_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
STOP 모델 또는 제공된 정차 시퀀스의 자연스러운 중지 지점입니다.
MAX_TOKENS 요청에 지정된 최대 토큰 수에 도달했습니다.
SAFETY 후보 콘텐츠는 안전상의 이유로 신고되었습니다.
RECITATION 후보 콘텐츠는 암송을 위해 신고되었습니다.
OTHER 알 수 없는 이유입니다.

GroundingAttribution

답변에 기여한 출처의 저작자 표시입니다.

JSON 표현
{
  "sourceId": {
    object (AttributionSourceId)
  },
  "content": {
    object (Content)
  }
}
필드
sourceId

object (AttributionSourceId)

출력 전용. 이 기여 분석에 기여한 소스의 식별자입니다.

content

object (Content)

이 저작자 표시를 구성하는 소스 콘텐츠 그라운딩

AttributionSourceId

이 기여 분석에 기여한 소스의 식별자입니다.

JSON 표현
{

  // Union field source can be only one of the following:
  "groundingPassage": {
    object (GroundingPassageId)
  },
  "semanticRetrieverChunk": {
    object (SemanticRetrieverChunk)
  }
  // End of list of possible types for union field source.
}
필드

통합 필드 source.

source는 다음 중 하나여야 합니다.

groundingPassage

object (GroundingPassageId)

인라인 문구의 식별자입니다.

semanticRetrieverChunk

object (SemanticRetrieverChunk)

Semantic Retriever를 통해 가져온 Chunk의 식별자입니다.

GroundingPassageId

GroundingPassage 내 부품의 식별자입니다.

JSON 표현
{
  "passageId": string,
  "partIndex": integer
}
필드
passageId

string

출력 전용. GenerateAnswerRequestGroundingPassage.id와 일치하는 문구의 ID입니다.

partIndex

integer

출력 전용. GenerateAnswerRequestGroundingPassage.content 내 부분의 색인입니다.

SemanticRetrieverChunk

SemanticRetrieverConfig를 사용하여 GenerateAnswerRequest에 지정된 시맨틱 리트리버를 통해 검색된 Chunk의 식별자입니다.

JSON 표현
{
  "source": string,
  "chunk": string
}
필드
source

string

출력 전용. 요청의 SemanticRetrieverConfig.source와 일치하는 소스의 이름입니다. 예: corpora/123 또는 corpora/123/documents/abc

chunk

string

출력 전용. 속성 텍스트가 포함된 Chunk의 이름입니다. 예: corpora/123/documents/abc/chunks/xyz