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도 반환됩니다.

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개의 세그먼트를 반환합니다.

ChunkSpec

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

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

integer

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

integer

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