SearchSpec

Especificação de pesquisa.

Representação JSON
{

  // Union field input can be only one of the following:
  "searchParams": {
    object (SearchParams)
  },
  "searchResultList": {
    object (SearchResultList)
  }
  // End of list of possible types for union field input.
}
Campos
Campo de união input. Parâmetros de pesquisa para controlar o comportamento da pesquisa. Ou forneça uma lista de resultados da pesquisa para gerar uma resposta. input pode ser apenas de um dos tipos a seguir:
searchParams

object (SearchParams)

Parâmetros de pesquisa.

searchResultList

object (SearchResultList)

Lista de resultados da pesquisa.

SearchParams

Parâmetros de pesquisa.

Representação JSON
{
  "maxReturnResults": integer,
  "filter": string,
  "boostSpec": {
    object (BoostSpec)
  },
  "orderBy": string,
  "searchResultMode": enum (SearchResultMode),
  "dataStoreSpecs": [
    {
      object (DataStoreSpec)
    }
  ],
  "naturalLanguageQueryUnderstandingSpec": {
    object (NaturalLanguageQueryUnderstandingSpec)
  }
}
Campos
maxReturnResults

integer

Número de resultados da pesquisa a serem retornados. O valor padrão é 10.

filter

string

A sintaxe do filtro consiste em uma linguagem de expressão para construir um predicado a partir de um ou mais campos dos documentos que estão sendo filtrados. A expressão de filtro diferencia maiúsculas de minúsculas. Isso será usado para filtrar os resultados da pesquisa, o que pode afetar a resposta.

Se esse campo não for reconhecido, um INVALID_ARGUMENT será retornado.

A filtragem na Vertex AI para Pesquisa é feita mapeando a chave de filtro do lado esquerdo (LHS, na sigla em inglês) para uma propriedade de chave definida no back-end da Vertex AI para Pesquisa. Esse mapeamento é definido pelo cliente no esquema dele. Por exemplo, um cliente de mídia pode ter um campo "name" no esquema. Nesse caso, o filtro ficaria assim: filter --> name:'ANY("king kong")'

Para mais informações sobre filtragem, incluindo sintaxe e operadores de filtro, consulte Filtrar.

boostSpec

object (BoostSpec)

Aumentar a especificação para impulsionar determinados documentos nos resultados da pesquisa, o que pode afetar a resposta da consulta. Para mais informações sobre o aumento, consulte Aumento.

orderBy

string

A ordem em que os documentos são retornados. Os documentos podem ser ordenados por um campo em um objeto Document. Deixe em branco se a ordenação for por relevância. A expressão orderBy diferencia maiúsculas de minúsculas. Para mais informações sobre a ordem, consulte Ordem.

Se esse campo não for reconhecido, um INVALID_ARGUMENT será retornado.

searchResultMode

enum (SearchResultMode)

Especifica o modo de resultado da pesquisa. Se não for especificado, o modo de resultado da pesquisa será DOCUMENTS por padrão. Consulte analisar e dividir documentos

dataStoreSpecs[]

object (DataStoreSpec)

Especificações que definem dataStores para filtrar em uma chamada de pesquisa e configurações para esses dataStores. Isso só é considerado para mecanismos com caso de uso de vários dataStores. Para um único DataStore em um mecanismo, use as especificações no nível superior.

naturalLanguageQueryUnderstandingSpec

object (NaturalLanguageQueryUnderstandingSpec)

Opcional. Especificação para ativar recursos de compreensão de linguagem natural para solicitações de pesquisa.

SearchResultList

Lista de resultados da pesquisa.

Representação JSON
{
  "searchResults": [
    {
      object (SearchResult)
    }
  ]
}
Campos
searchResults[]

object (SearchResult)

Resultados da pesquisa.

SearchResult

Resultado da pesquisa.

Representação JSON
{

  // Union field content can be only one of the following:
  "unstructuredDocumentInfo": {
    object (UnstructuredDocumentInfo)
  },
  "chunkInfo": {
    object (ChunkInfo)
  }
  // End of list of possible types for union field content.
}
Campos
Campo de união content. Conteúdo dos resultados da pesquisa. content pode ser apenas de um dos tipos a seguir:
unstructuredDocumentInfo

object (UnstructuredDocumentInfo)

Informações de documentos não estruturados.

chunkInfo

object (ChunkInfo)

Informações do trecho.

UnstructuredDocumentInfo

Informações de documentos não estruturados.

Representação JSON
{
  "document": string,
  "uri": string,
  "title": string,
  "documentContexts": [
    {
      object (DocumentContext)
    }
  ],
  "extractiveSegments": [
    {
      object (ExtractiveSegment)
    }
  ],
  "extractiveAnswers": [
    {
      object (ExtractiveAnswer)
    }
  ]
}
Campos
document

string

Nome do recurso do documento.

uri

string

URI do documento.

title

string

Título.

documentContexts[]

object (DocumentContext)

Lista de contextos de documentos. O conteúdo será usado para geração de respostas. Este é o conteúdo principal do documento, que pode ser longo e abrangente.

extractiveSegments[]

object (ExtractiveSegment)

Lista de segmentos extrativos.

extractiveAnswers[]
(deprecated)

object (ExtractiveAnswer)

Descontinuado: esse campo está descontinuado e não terá efeito na geração de respostas. Use os campos documentContexts e extractiveSegments. Lista de respostas extrativas.

DocumentContext

Contexto do documento.

Representação JSON
{
  "pageIdentifier": string,
  "content": string
}
Campos
pageIdentifier

string

Identificador da página.

content

string

Conteúdo do documento a ser usado para geração de respostas.

ExtractiveSegment

Trecho extraído. Guia: a geração de respostas só vai usar esse campo se "documentContexts" estiver vazio. Esses trechos devem ser mais curtos.

Representação JSON
{
  "pageIdentifier": string,
  "content": string
}
Campos
pageIdentifier

string

Identificador da página.

content

string

Conteúdo do segmento extrativo.

ExtractiveAnswer

Resposta extrativa. Guia

Representação JSON
{
  "pageIdentifier": string,
  "content": string
}
Campos
pageIdentifier

string

Identificador da página.

content

string

Conteúdo da resposta extrativa.

ChunkInfo

Informações do trecho.

Representação JSON
{
  "chunk": string,
  "content": string,
  "documentMetadata": {
    object (DocumentMetadata)
  }
}
Campos
chunk

string

Nome do recurso de bloco.

content

string

Conteúdo textual do bloco.

documentMetadata

object (DocumentMetadata)

Metadados do documento do bloco atual.

DocumentMetadata

Os metadados do documento contêm as informações do documento do bloco atual.

Representação JSON
{
  "uri": string,
  "title": string
}
Campos
uri

string

URI do documento.

title

string

Título do documento.