Reclassificação dos resultados da pesquisa com o VertexRanker

A Recuperação de Agentes (antiga busca vetorial 2.0) fornece o VertexRanker para a reclassificação semântica, que é alimentada pela API Ranking.

Depois que a Recuperação de Agentes recupera e combina os resultados candidatos (usando a Reciprocal Rank Fusion, RRF), o VertexRanker reavalia os candidatos mesclados em relação à consulta em linguagem natural usando um modelo semântico dedicado. Isso melhora a relevância dos principais resultados, especialmente para consultas em que a pesquisa sozinha perde a nuance. A reclassificação acontece no lado do servidor com chamadas para BatchSearchDataObjects. Não são necessárias fiações adicionais do lado do cliente nem viagens de ida e volta.

VertexRanker

O VertexRanker é configurado como o reclassificador do campo combine.ranker do objeto BatchSearchDataObjectsRequest. É necessário configurar um classificador principal (somente a RRF é compatível). O reclassificador é executado após a etapa de fusão da RRF e substitui a saída pela lista reclassificada semanticamente.

A tabela a seguir lista os campos de configuração do classificador.

O exemplo a seguir demonstra o corpo de uma solicitação.

{
  "searches": [
    { "semantic_search": { "search_text": "running shoes", "search_field": "embedding", "task_type": "RETRIEVAL_QUERY", "top_k": 50 } },
    { "text_search":     { "search_text": "running shoes", "data_field_names": ["title"], "top_k": 50 } }
  ],
  "combine": {
    "top_k": 10,
    "ranker": {
      "rrf": { "weights": [1.0, 1.0] },
      "vertex_ranker": {
        "model": "semantic-ranker-fast@latest",
        "top_n": 50,
        "text_record_spec": {
          "query": "running shoes",
          "title_template": "{title}",
          "content_template": "{body.text}"
        }
      }
    }
  }
}

Os modelos usam caminhos de ponto para campos de dados de objetos de dados, por exemplo, {title} ou {nested.field}. Esses campos precisam existir no esquema da coleção. Caso contrário, a solicitação será rejeitada durante a validação. Se um objeto de dados estiver ausente no campo fornecido, o servidor vai buscar novamente o registro completo no armazenamento de forma transparente para que o modelo ainda possa ser preenchido.

Cota e preços

O VertexRanker na recuperação de agentes usa uma permissão de nível sem custo financeiro com faturamento de excedente baseado no uso. Cada projeto recebe uma permissão sem custo financeiro de uso de classificação por período de 30 dias. O uso dentro dessa permissão não gera custos. Os preços padrão da API Ranking se aplicam ao projeto do consumidor para qualquer uso além dessa permissão.

A tabela a seguir lista os valores de cota.

Atingir a permissão de nível sem custo financeiro não causa falha nas solicitações. Depois que a permissão de 80.000 unidades de classificação for consumida, o uso subsequente do VertexRanker continuará sendo bem-sucedido e será faturado como excedente. A permissão é redefinida 30 dias após o primeiro uso.

As unidades de classificação são calculadas com base no número de registros enviados ao classificador e no tamanho dos modelos de título e conteúdo, usando a mesma contabilidade da API Ranking independente. Consulte os preços da API Ranking para mais detalhes.

Antes de usar o VertexRanker, o Discovery Engine precisa estar ativado no projeto do consumidor. Para mais informações, consulte Condições de falha.

Tratamento de falhas e avisos

O VertexRanker é um reclassificador de melhor esforço. Se a chamada de classificação falhar, a RPC BatchSearchDataObjects ainda será bem-sucedida e retornará os resultados mesclados da RRF truncados para top_k. A falha é informada no campo search_response_metadata.warnings na resposta. O código de status completo da API Ranking é preservado. O código de aviso para status inesperados é UNAVAILABLE com a mensagem de aviso: "Reranking is temporarily unavailable. Returning fused (RRF) results without semantic reranking."

Condições de falha

Toda a RPC BatchSearchDataObjects falha com FAILED_PRECONDITION (sem fallback para RRF) nos casos a seguir.

• API Discovery Engine não ativada : a API Ranking retorna FAILED_PRECONDITION com a mensagem Discovery Engine API is not enabled for the consumer project /<N/>. Please enable the API and try again." Correção: ative a API Discovery Engine no projeto do consumidor.

O cliente precisa ativar o Discovery Engine para que a reclassificação ocorra no projeto do consumidor.

A tabela a seguir lista os códigos de aviso, as causas típicas que geram os avisos e a mensagem que explica o aviso.