Definir as configurações de campos

Nesta página, mostramos como configurar os campos de esquema para configurar um app para dados estruturados, dados não estruturados com metadados ou dados de sites com atributos personalizados e estruturados.

As configurações de campo ajudam a determinar como a Vertex AI para Pesquisa usa campos nos resultados. Use a guia Esquema no consoleGoogle Cloud para configurar as opções de campo.

A configuração de campos está disponível apenas para apps com repositórios de dados que contêm dados estruturados ou não estruturados com metadados.

Configurações de campo

As configurações de campo a seguir estão disponíveis para muitos tipos de campo nos seus dados de pesquisa ou recomendações, mas não para todos os tipos de dados. Um esquema contém várias configurações de campo para campos individuais, e a próxima tabela contém configurações que podem ser aplicadas a um campo em um esquema. Recomendamos usar dados estruturados para estas configurações de campo:

Configuração Definição Finalidade Exemplo de caso de uso
Indexável

Definir campos como indexáveis permite operações como filtragem, reforço e atributos em campos estruturados dentro de um documento.

Campos do tipo Object não podem ser definidos como Indexable.

Marcar um campo como Indexable permite pesquisas mais rápidas.

Marcar um campo como Indexable aumenta o tamanho do índice de pesquisa e pode diminuir a velocidade da indexação.

 Em um repositório de dados de hotel, é possível definir um campo, como hotel_chain, como indexável. Isso permite aplicar operações de classificação, filtragem e reforço em hotel_chain. Por exemplo, você pode aplicar um filtro para que a pesquisa mostre apenas resultados que contenham a rede de hotéis filtrada.
Pesquisável

Os campos com maior probabilidade de serem relacionados a pesquisas são designados como Searchable. Um campo pode ser pesquisável sem ser indexável ou recuperável.

Somente campos com valores de texto podem ser marcados como pesquisáveis. Assim, um campo de preço numérico pode ser indexado (para filtragem ou facetagem), mas não pode ser pesquisado como texto completo.

 Definir um campo como Pesquisável melhora o recall desse campo nas consultas de pesquisa, permitindo que os usuários encontrem conteúdo, como páginas da Web, consultando o texto nesses campos. Marcar um campo como pesquisável permite que a classificação seja aplicada. Consequentemente, marcar um número excessivo de campos como pesquisáveis pode afetar negativamente a precisão da pesquisa, supersaturando o algoritmo de classificação e retornando muitos resultados. Isso pode levar a resultados de pesquisa irrelevantes.

O sistema de tíquetes de suporte de um provedor de serviços de Internet armazena cada tíquete como um documento estruturado. Se esses documentos contiverem campos de texto pesquisáveis, como issue_description ou resolution_notes, um representante de suporte poderá fazer uma consulta relacionada ao conteúdo desses campos, como como corrigir a lentidão da Internet após a redefinição do modem. O sistema mostraria os documentos que contêm qualquer um desses termos de pesquisa, incluindo modem, internet, velocidade, em um ou nos dois campos issue_description ou resolution_notes.
Tabela dinâmica Fornece filtros contextuais para segmentar melhor o usuário em uma pesquisa. Definir um campo como Dynamic Facetable permite que o sistema gere automaticamente filtros interativos (facetas) com base nos valores exclusivos presentes no campo. Definir um campo como Dynamic facetable permite que os usuários refinem dinamicamente os resultados da pesquisa selecionando categorias ou atributos derivados diretamente dos dados ingeridos, sem precisar pré-definir manualmente todas as opções de filtro possíveis. Isso permite que o usuário restrinja a pesquisa a conteúdo da Web altamente específico. As páginas de uma base de conhecimento corporativa interna, como políticas de RH, são ingeridas com dados como department, document_type ou last_modified_date. Se esses campos forem marcados como dynamic facetable, uma pesquisa de um funcionário por um termo como reembolso de despesas vai gerar filtros interativos de forma dinâmica com base nos resultados relevantes encontrados. Nesse caso, a interface da Web pode mostrar facetas para Departamento: Finanças, Viagens, Tipo de documento: Política, Perguntas frequentes ou Data da última modificação: Este trimestre, Ano passado.
Recuperável Quando uma consulta de pesquisa encontra conteúdo correspondente, o mecanismo de pesquisa pode extrair os valores dos campos recuperáveis para exibição ou uso no aplicativo. Isso significa que as informações do documento original são mostradas como parte dos resultados da pesquisa. Os campos de chave (identificadores exclusivos de documentos) são configurados como recuperáveis. Os campos recuperáveis fornecem contexto de pesquisa ao distinguir campos cujos valores podem ser mostrados daqueles que só devem ser usados na lógica de pesquisa, mas cujos valores brutos não devem ser mostrados ao usuário final. Para uma pesquisa de produtos no site de um comerciante, product_id, name, price e um image_url são campos típicos que você quer definir como recuperáveis. Por outro lado, o internal_tracking_code pode ser indexado e filtrado apenas para fins administrativos, mas não recuperado em resultados de pesquisa públicos.
Concluível Permite que o conteúdo de um campo seja usado para sugestões de consulta de pesquisa. Para mais informações, consulte Configurar o preenchimento automático.

Essa configuração permite que os valores desse campo sejam usados para fornecer sugestões de consultas em tempo real à medida que os usuários digitam. Esse recurso ajuda a direcionar os usuários para conteúdo relevante e acelera o processo de pesquisa. Alguns fatores, como o uso da filtragem por linguagem natural, podem afetar esse desempenho.

 Se o campo completable estiver definido como product_name, brand e category, quando o usuário digitar Tech, as sugestões de preenchimento automático poderão mostrar:
  • TechCo (do campo brand)
  • TechCo UltraBook X1 (do campo product_name)
  • Tecnologia GameMaster Pro (outro produto do campo category)
Filtrável Permite que as recomendações usem um campo para filtrar os resultados recomendados, determinando quais resultados da pesquisa seus usuários veem. Para informações sobre como filtrar recomendações, consulte Filtrar recomendações. Definir um campo como Filterable ajuda a personalizar as recomendações para os usuários. Há limites de filtragem. Uma configuração de filtro por idioma e drama pode ter esta aparência: language_code: ANY("en", "fr") OR categories: ANY("drama").

Diferenças entre as configurações usadas com frequência

Há diferenças importantes entre as configurações de campo indexável, pesquisável e recuperável. A tabela resume essas diferenças.

Recurso Indexável Pesquisável Recuperável
Função principal Disponibiliza o conteúdo do campo para o mecanismo de pesquisa Permite consultas de texto completo no conteúdo do campo Permite que o valor do campo seja retornado nos resultados da pesquisa.
Análise O conteúdo é processado e colocado em um índice. Geralmente passa por uma análise lexical extensa. O valor é armazenado como está para exibição.
Será que...
...Pesquisável? Sim (geralmente um pré-requisito) N/A Não necessariamente (pode ser recuperável sem ser pesquisável)
...Recuperável? Não necessariamente Não necessariamente N/A
...Filtrável/ordenável/transformável em atributo? Sim (geralmente um pré-requisito para eles também) Não diretamente. Esses são atributos separados, geralmente criados em um campo indexável. Não diretamente. Esses atributos se relacionam à forma como o campo é indexado e consultado, não apenas exibido.

Na prática, muitos campos cruciais para a experiência do usuário (como títulos, descrições e informações de identificação) costumam ser definidos como indexable, searchable e retrievable.

Limitações

As configurações de campo têm as seguintes limitações:

  • É possível configurar até 50 campos como indexáveis, pesquisáveis ou com facetas dinâmicas.
  • É possível configurar até 30 campos como recuperáveis.
  • Para configurar um campo como atributo dinâmico, ele precisa ser configurado primeiro como indexável.
  • Para mudar a configuração indexável, é necessário indexar os dados de novo, o que pode levar horas, principalmente para grandes armazenamentos de dados.

Se você estiver configurando campos para um app de pesquisa de mídia e quiser informações detalhadas sobre os campos no esquema, consulte Sobre documentos de mídia e repositórios de dados.

Atualizar as configurações de campo

Para atualizar as configurações de campo:

  1. No console Google Cloud , acesse a página Aplicativos de IA.

    Aplicativos de IA

  2. Clique no nome do app que você quer editar.

  3. Clique em Dados.

  4. Clique na guia Esquema. Esta guia mostra as configurações atuais dos campos.

  5. Clique em Editar.

  6. Selecione ou desmarque as configurações de campo que você precisa atualizar. Algumas configurações de campo não são compatíveis. Por exemplo, campos numéricos não podem ser definidos como Pesquisável.

  7. Clique em Salvar para aplicar as alterações.

A seguir