ContentSearchSpec

콘텐츠 검색의 동작을 구성하기 위한 사양입니다.

JSON 표현 
{
  "snippetSpec": {
    object (SnippetSpec)
  },
  "summarySpec": {
    object (SummarySpec)
  },
  "extractiveContentSpec": {
    object (ExtractiveContentSpec)
  },
  "searchResultMode": enum (SearchResultMode),
  "chunkSpec": {
    object (ChunkSpec)
  }
}
필드
snippetSpec

object (SnippetSpec)

snippetSpec이 지정되지 않으면 스니펫이 검색 응답에 포함되지 않습니다.
summarySpec

object (SummarySpec)

summarySpec가 지정되지 않으면 요약이 검색 응답에 포함되지 않습니다.
extractiveContentSpec

object (ExtractiveContentSpec)

extractiveContentSpec이 제공되지 않으면 검색 응답에 추출 답변이 없습니다.
searchResultMode

enum (SearchResultMode)

검색 결과 모드를 지정합니다. 지정하지 않으면 검색 결과 모드는 기본적으로 DOCUMENTS입니다.
chunkSpec

object (ChunkSpec)

검색 응답에서 반환할 청크 사양을 지정합니다. SearchRequest.ContentSearchSpec.search_result_mode가 CHUNKS로 설정된 경우에만 사용할 수 있습니다.

SnippetSpec

검색 응답에서 스니펫을 구성하기 위한 사양입니다.

JSON 표현 
{
  "maxSnippetCount": integer,
  "referenceOnly": boolean,
  "returnSnippet": boolean
}
필드
maxSnippetCount
(deprecated)

integer

[지원 중단됨] 이 필드는 지원 중단되었습니다. 스니펫 반환을 제어하려면 returnSnippet 필드를 사용하세요. 이전 버전과의 호환성을 위해 maxSnippetCount > 0인 경우 스니펫이 반환됩니다.
referenceOnly
(deprecated)

boolean

[지원 중단됨] 이 필드는 지원 중단되었으며 스니펫에 영향을 미치지 않습니다.
returnSnippet

boolean

true이면 스니펫을 반환합니다. 스니펫을 생성할 수 없는 경우 '이 페이지에 사용할 수 있는 스니펫이 없습니다'가 반환됩니다. SUCCESS 또는 NO_SNIPPET_AVAILABLE이 포함된 snippetStatus도 반환됩니다.

SummarySpec

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

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

integer

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

문서 모드의 경우 최대 10개, 청크 모드의 경우 최대 50개의 결과를 사용하여 요약을 생성할 수 있습니다. 청크 모드는 SearchRequest.ContentSearchSpec.search_result_mode이 CHUNKS로 설정된 경우에 사용됩니다.
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 blue와 Who is the best soccer player in the world?은 요약을 찾는 질문이지만 SFO airport와 world cup 2026는 그렇지 않습니다. 이러한 쿼리는 탐색적인 쿼리일 가능성이 더 높습니다. 이 필드가 true로 설정되면 요약을 원하지 않는 쿼리에 대한 요약 생성을 건너뛰고 대신 대체 메시지를 반환합니다.
ignoreLowRelevantContent

boolean

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

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

boolean

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

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

object (MultiModalSpec)

(선택사항) 멀티모달 사양
modelPromptSpec

object (ModelPromptSpec)

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

string

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

object (ModelSpec)

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

boolean

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

MultiModalSpec

멀티모달 사양: 지정된 소스의 이미지를 반환합니다. 여러 소스가 지정된 경우 선택은 품질 기반 결정입니다.

JSON 표현 
{
  "imageSource": enum (ImageSource)
}
필드
imageSource

enum (ImageSource)

(선택사항) 답변으로 반환되는 이미지의 소스입니다.

ImageSource

이미지 소스를 지정합니다.

열거형
IMAGE_SOURCE_UNSPECIFIED 지정되지 않은 이미지 소스 (다중 모달 기능은 기본적으로 사용 중지됨)
ALL_AVAILABLE_SOURCES 서비스가 사용 가능한 모든 소스에서 선택을 결정할 때의 동작입니다.
CORPUS_IMAGE_ONLY 답변에 코퍼스의 이미지를 포함합니다.
FIGURE_GENERATION_ONLY 대답에서 그림 생성을 트리거합니다.

ModelPromptSpec

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

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

string

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

ModelSpec

모델 사양입니다.

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

string

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

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

ExtractiveContentSpec

검색 응답에서 추출 콘텐츠를 구성하기 위한 사양입니다.

JSON 표현 
{
  "maxExtractiveAnswerCount": integer,
  "maxExtractiveSegmentCount": integer,
  "returnExtractiveSegmentScore": boolean,
  "numPreviousSegments": integer,
  "numNextSegments": integer
}
필드
maxExtractiveAnswerCount

integer

각 검색 결과에 반환되는 추출 답변의 최대 수입니다.

추출 답변은 원본 문서에서 추출된 그대로의 답변으로, 검색어에 대한 정확하고 맥락에 맞는 답변을 제공합니다.

일치하는 답변 수가 maxExtractiveAnswerCount보다 적으면 모든 답변을 반환합니다. 그렇지 않으면 maxExtractiveAnswerCount을 반환합니다.

각 SearchResult에 대해 최대 5개의 답변이 반환됩니다.
maxExtractiveSegmentCount

integer

각 검색 결과에 반환되는 추출 세그먼트의 최대 개수입니다. DataStore이 DataStore.ContentConfig.CONTENT_REQUIRED으로 설정되거나 DataStore.solution_types이 SOLUTION_TYPE_CHAT인 경우에만 적용됩니다.

추출 세그먼트는 원본 문서에서 추출된 텍스트 세그먼트로, 검색어와 관련이 있으며 일반적으로 추출 답변보다 더 자세합니다. 그런 다음 이 세그먼트를 LLM의 입력으로 사용하여 요약과 답변을 생성할 수 있습니다.

일치하는 세그먼트 수가 maxExtractiveSegmentCount보다 적으면 모든 세그먼트를 반환합니다. 그렇지 않으면 maxExtractiveSegmentCount을 반환합니다.
returnExtractiveSegmentScore

boolean

각 검색 결과의 추출 세그먼트에서 신뢰도 점수를 반환할지 여부를 지정합니다. 이 기능은 신규 데이터 스토어 또는 허용 목록에 추가된 데이터 스토어에서만 사용할 수 있습니다. 데이터 스토어를 허용 목록에 추가하려면 고객 엔지니어에게 문의하세요. 기본값은 false입니다.
numPreviousSegments

integer

선택한 각 세그먼트의 인접 세그먼트도 포함할지 여부를 지정합니다. 선택된 각 세그먼트 앞에 최대 numPreviousSegments개의 세그먼트를 반환합니다.
numNextSegments

integer

선택한 각 세그먼트 뒤에 최대 numNextSegments개의 세그먼트를 반환합니다.

SearchResultMode

검색 결과 모드를 지정합니다. 지정하지 않으면 검색 결과 모드는 기본적으로 DOCUMENTS입니다.

열거형
SEARCH_RESULT_MODE_UNSPECIFIED 기본값
DOCUMENTS 검색 결과의 문서를 반환합니다.
CHUNKS 검색 결과에서 청크를 반환합니다. DocumentProcessingConfig.chunking_config이 지정된 경우에만 사용할 수 있습니다.

ChunkSpec

검색 응답에서 반환할 청크 사양을 지정합니다. SearchRequest.ContentSearchSpec.search_result_mode가 CHUNKS로 설정된 경우에만 사용할 수 있습니다.

JSON 표현 
{
  "numPreviousChunks": integer,
  "numNextChunks": integer
}
필드
numPreviousChunks

integer

현재 청크에서 반환할 이전 청크의 수입니다. 허용되는 최댓값은 3입니다. 지정하지 않으면 이전 청크가 반환되지 않습니다.
numNextChunks

integer

현재 청크에서 반환할 다음 청크의 수입니다. 허용되는 최댓값은 3입니다. 지정하지 않으면 다음 청크가 반환되지 않습니다.