SummarySpec

검색 응답에 반환되는 요약을 구성하기 위한 사양입니다.

JSON 표현
{
  "summaryResultCount": integer,
  "includeCitations": boolean,
  "ignoreAdversarialQuery": boolean,
  "ignoreNonSummarySeekingQuery": boolean,
  "ignoreLowRelevantContent": boolean,
  "ignoreJailBreakingQuery": boolean,
  "modelPromptSpec": {
    object (ModelPromptSpec)
  },
  "languageCode": string,
  "modelSpec": {
    object (ModelSpec)
  },
  "useSemanticChunks": boolean
}
필드
summaryResultCount

integer

요약을 생성할 상위 결과의 수입니다. 반환된 결과 수가 summaryResultCount보다 적으면 모든 결과로부터 요약이 생성됩니다.

문서 모드의 경우 최대 10개, 청크 모드의 경우 최대 50개의 결과를 사용하여 요약을 생성할 수 있습니다. 청크 모드는 SearchRequest.ContentSearchSpec.search_result_modeCHUNKS로 설정된 경우에 사용됩니다.

includeCitations

boolean

요약에 인용을 포함할지 여부를 지정합니다. 기본값은 false입니다.

이 필드가 true로 설정되면 요약에 인라인 인용 번호가 포함됩니다.

인용을 포함한 요약의 예:

BigQuery는 Google Cloud의 완전 관리형 서버리스 엔터프라이즈 데이터 웨어하우스입니다[1]. BigQuery는 모든 데이터 유형을 지원하고 클라우드 전반에서 작동하며 머신러닝 및 비즈니스 인텔리전스를 기본 제공하는 통합 플랫폼입니다[2, 3].

인용 번호는 반환된 검색 결과를 나타내며 1부터 색인이 생성됩니다. 예를 들어 [1] 은 해당 문장이 첫 번째 검색 결과에 속함을 나타냅니다. [2, 3] 은 해당 문장이 두 번째 및 세 번째 검색 결과에 모두 속함을 의미합니다.

ignoreAdversarialQuery

boolean

악의적인 쿼리를 필터링할지 여부를 지정합니다. 기본값은 false입니다.

Google에서는 검색어 분류를 사용하여 적대적인 질문을 감지합니다. 검색어가 악의적인 쿼리로 분류되면 요약이 반환되지 않습니다. 예를 들어 사용자가 회사에 대한 부정적인 댓글에 관해 질문하거나 안전하지 않은 정책 위반 출력을 생성하도록 설계된 질문을 제출할 수 있습니다. 이 필드가 true로 설정되면 적대적 질문에 대한 요약 생성을 건너뛰고 대신 대체 메시지를 반환합니다.

ignoreNonSummarySeekingQuery

boolean

요약을 원하지 않는 쿼리를 필터링할지 여부를 지정합니다. 기본값은 false입니다.

Google은 검색어 분류를 사용하여 요약을 찾는 검색어를 감지합니다. 검색어가 요약을 원하지 않는 쿼리로 분류되면 요약이 반환되지 않습니다. 예를 들어 why is the sky blueWho is the best soccer player in the world?은 요약을 찾는 질문이지만 SFO airportworld cup 2026는 그렇지 않습니다. 이러한 쿼리는 탐색적인 쿼리일 가능성이 더 높습니다. 이 필드가 true로 설정되면 요약을 원하지 않는 쿼리에 대한 요약 생성을 건너뛰고 대신 대체 메시지를 반환합니다.

ignoreLowRelevantContent

boolean

관련성이 낮은 검색어를 필터링할지 여부를 지정합니다. 기본값은 false입니다.

이 필드가 false으로 설정되면 관련성과 관계없이 모든 검색 결과가 답변을 생성하는 데 사용됩니다. true으로 설정하면 관련성이 높은 검색 결과가 있는 질문에만 답변이 생성됩니다.

ignoreJailBreakingQuery

boolean

(선택사항) 탈옥 쿼리를 필터링할지 여부를 지정합니다. 기본값은 false입니다.

Google은 검색어 분류를 사용하여 브레이크아웃 쿼리를 감지합니다. 검색어가 금지된 질문으로 분류되면 요약이 반환되지 않습니다. 사용자는 어조, 스타일, 언어, 대답의 콘텐츠를 변경하거나 모델이 다른 엔티티로 행동하도록 요청하는 등 쿼리에 요청 사항을 추가할 수 있습니다(예: '경쟁업체 CEO의 어조로 대답해 줘'). 이 필드가 true로 설정되면 jail-breaking 질문에 대한 요약 생성을 건너뛰고 대신 대체 메시지를 반환합니다.

modelPromptSpec

object (ModelPromptSpec)

지정된 경우 사양은 LLM에 제공된 프롬프트를 수정하는 데 사용됩니다.

languageCode

string

요약의 언어 코드입니다. BCP47에 정의된 언어 태그를 사용합니다. 참고: 이 기능은 실험적 기능입니다.

modelSpec

object (ModelSpec)

지정된 경우 사양은 LLM에 제공된 모델 사양을 수정하는 데 사용됩니다.

useSemanticChunks

boolean

true인 경우 상위 검색 결과에서 가장 관련성이 높은 청크에서 답변이 생성됩니다. 이 기능은 요약 품질을 개선합니다. 이 기능을 사용 설정하면 모든 상위 검색 결과가 참조되어 참조 목록에 포함되지는 않으므로 인용 출처 색인은 참조 목록에 나열된 검색 결과만 가리킵니다.

ModelPromptSpec

모델과 함께 사용할 프롬프트의 사양입니다.

JSON 표현
{
  "preamble": string
}
필드
preamble

string

어시스턴트에게 지시하는 프롬프트의 시작 부분에 있는 텍스트입니다. 사용자 가이드에서 예를 확인할 수 있습니다.

ModelSpec

모델 사양입니다.

JSON 표현
{
  "version": string
}
필드
version

string

요약을 생성하는 데 사용된 모델 버전입니다.

지원되는 값은 다음과 같습니다.