Configure as definições de campos

Esta página mostra-lhe como configurar os campos do esquema para configurar uma app para dados estruturados, para dados não estruturados com metadados ou para dados de Websites com atributos personalizados e estruturados.

As definições de campos ajudam a determinar como o Vertex AI Search usa os campos nos respetivos resultados. Pode usar o separador Esquema na Google Cloud consola para configurar as definições dos campos.

A configuração das definições dos campos só está disponível para apps com arquivos de dados que contenham dados estruturados ou dados não estruturados com metadados.

Definições de campo

As seguintes definições de campos estão disponíveis para muitos tipos de campos nos seus dados de pesquisa ou recomendações, mas não para todos os tipos de dados. Um esquema contém várias definições de campos para campos individuais, e a tabela seguinte contém definições que podem ser aplicadas a um campo num esquema. A utilização de dados estruturados é altamente recomendada para estas definições de campos:

Definição Definição Finalidade Exemplo de utilização
Indexável

A definição de campos como indexáveis permite operações como filtragem, aumento e segmentação detalhada em campos estruturados num documento.

Não é possível definir campos do tipo Object como Indexable.

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

Tenha em atenção que marcar um campo como Indexable aumenta o tamanho do índice de pesquisa e pode tornar a indexação mais lenta.

Num armazém de dados de hotéis, pode definir um campo, como hotel_chain, como indexável. Isto permite-lhe aplicar operações de classificação, filtragem e aumento em hotel_chain. Por exemplo, pode aplicar um filtro para que a pesquisa apresente apenas resultados de pesquisa que contenham a cadeia de hotéis filtrada.
Pesquisável

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

Só é possível marcar como pesquisáveis os campos com valores de texto. Assim, um campo de preço numérico pode ser indexável (para filtragem ou segmentação detalhada), mas não pode ser pesquisável como texto completo.

Definir um campo como Pesquisável melhora a capacidade de memorização desse campo nas consultas de pesquisa, permitindo que os utilizadores encontrem conteúdo, como páginas Web, ao consultar o texto nesses campos. Marcar um campo como pesquisável permite a aplicação da classificação. Consequentemente, marcar um número excessivo de campos como pesquisáveis pode afetar negativamente a precisão da pesquisa, sobrecarregando o algoritmo de classificação e devolvendo demasiados resultados. Isto pode levar a resultados de pesquisa irrelevantes.

Um sistema de pedidos de apoio técnico de um fornecedor de serviços de Internet armazena cada pedido como um documento estruturado. Se estes documentos contiverem campos de texto pesquisáveis, como issue_description ou resolution_notes, um agente do apoio técnico pode executar uma consulta relacionada com o conteúdo nesses campos, como como corrigir velocidades lentas da Internet após a reposição do modem. O sistema apresenta os documentos que contêm qualquer um desses termos de pesquisa, incluindo modem, internet e velocidade, num ou em ambos os campos issue_description ou resolution_notes.

Dinâmico com filtros Fornece filtros sensíveis ao contexto para segmentar melhor o utilizador numa pesquisa. Definir um campo como Dynamic Facetable permite que o sistema gere automaticamente filtros interativos (facetas) com base nos valores únicos presentes no campo. A definição de um campo como Dynamic facetable permite que os utilizadores refinem dinamicamente os resultados da pesquisa selecionando categorias ou atributos derivados diretamente dos seus dados carregados, sem ter de pré-definir manualmente todas as opções de filtro possíveis. Isto permite ao utilizador restringir a pesquisa a conteúdo Web altamente específico. As páginas numa base de conhecimentos corporativa interna, como as políticas de RH, são carregadas com dados como department, document_type ou last_modified_date. Se estes campos estiverem etiquetados como dynamic facetable, um funcionário que pesquise um termo como reembolso de despesas gera dinamicamente filtros interativos com base nos resultados relevantes encontrados. Nesse caso, a interface Web pode apresentar facetas para Departamento: Finanças, Viagens, Tipo de documento: Política, Perguntas frequentes ou Data de modificação: este trimestre, ano passado.
Recuperável Quando uma consulta de pesquisa atinge conteúdo correspondente, o motor de pesquisa pode extrair os valores dos campos recuperáveis para apresentação ou utilização na aplicação, o que significa que as informações do documento original são apresentadas como parte dos resultados da pesquisa. Os campos de chave (identificadores exclusivos para documentos) estão configurados como recuperáveis. Os campos recuperáveis fornecem contexto de pesquisa ao distinguir os campos cujos valores podem ser apresentados dos que só devem ser usados na lógica de pesquisa, mas cujos valores brutos não se destinam a ser apresentados ao utilizador final. Para uma pesquisa de produtos num site de comerciante, product_id, name, price e um image_url são campos típicos que quer definir como recuperáveis. Por outro lado, o internal_tracking_code pode ser indexado e filtrado apenas para fins administrativos, mas não pode ser obtido nos resultados da pesquisa pública.
Concluível Permite que o conteúdo de um campo seja usado para sugestões de consultas de pesquisa. Para mais informações, consulte o artigo Configure o preenchimento automático.

Esta definição permite que os valores nesse campo sejam usados para fornecer sugestões de consultas em tempo real à medida que os utilizadores escrevem. Esta funcionalidade ajuda a direcionar os utilizadores para conteúdo relevante e acelera o processo de pesquisa. Determinados fatores, como a utilização da filtragem de linguagem natural, podem afetar este desempenho.

Se o campo completable estiver definido para product_name, brand e category, quando o utilizador escreve Tech, as sugestões de preenchimento automático podem apresentar:
  • TechCo (do campo brand)
  • TechCo UltraBook X1 (do campo product_name )
  • Technology GameMaster Pro (outro produto do campo category)
Filtrável Permite que as recomendações usem um campo para filtrar os resultados recomendados, determinando os resultados da pesquisa que os seus utilizadores veem. Para informações sobre como filtrar recomendações, consulte o artigo Filtre recomendações. Definir um campo como Filterable ajuda a personalizar as recomendações para os utilizadores. Tenha em atenção que se aplicam limites de filtragem. Uma definição de filtro por idioma e drama pode ter o seguinte aspeto: language_code: ANY("en", "fr") OR categories: ANY("drama").

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

Existem diferenças importantes entre as definições dos campos indexáveis, pesquisáveis e recuperáveis. A tabela resume estas diferenças.

Funcionalidade Indexável Pesquisável Recuperável
Função principal Disponibiliza o conteúdo do campo ao motor de pesquisa Permite consultas de texto completo em relação ao conteúdo dos campos Permite que o valor do campo seja devolvido nos resultados da pesquisa
Análise O conteúdo é processado e colocado num índice. Normalmente, é submetido a uma análise lexical exaustiva. O valor é armazenado tal como está para apresentação.
Pode ser...
…Pesquisável? Sim (muitas vezes, 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/com facetas? Sim (geralmente, também é um pré-requisito para estes) Não diretamente. Estes são atributos separados criados frequentemente num campo indexável. Não diretamente. Estes atributos estão relacionados com a forma como o campo é indexado e consultado, e não apenas apresentado.

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

Limitações

As definições de campos têm as seguintes limitações:

  • Pode configurar até 50 campos como indexáveis, pesquisáveis ou dinamicamente filtráveis.
  • Pode configurar até 30 campos como recuperáveis.
  • Para configurar um campo como dinâmico com filtros, tem de o configurar primeiro como indexável.
  • A alteração da definição indexável requer a reindexação dos dados, o que pode demorar horas, especialmente para grandes armazenamentos de dados.

Se estiver a configurar campos para uma app de pesquisa de multimédia e quiser informações detalhadas sobre os campos no esquema, consulte o artigo Acerca dos documentos multimédia e das bases de dados.

Atualize as definições dos campos

Para atualizar as definições dos campos:

  1. Na Google Cloud consola, aceda à página Aplicações de IA.

    Aplicações de IA

  2. Clique no nome da app que quer editar.

  3. Clique em Dados.

  4. Clique no separador Esquema. Este separador mostra as definições de campo atuais.

  5. Clique em Edit.

  6. Selecione ou desmarque as definições de campos que tem de atualizar. Algumas definições de campo não são suportadas. Por exemplo, não é possível definir campos numéricos como Pesquisável.

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

O que se segue?