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 最多會傳回五個答案。
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。如未指定，系統不會傳回任何後續區塊。