Configure o preenchimento automático avançado

Esta página descreve a funcionalidade de preenchimento automático avançado das aplicações de IA.

Tal como o preenchimento automático básico, o preenchimento automático avançado gera sugestões de consultas com base nos primeiros carateres introduzidos para a consulta.

Antes de ler esta página, familiarize-se com o preenchimento automático básico das aplicações de IA. Consulte o artigo Configure o preenchimento automático.

Principais funcionalidades do preenchimento automático avançado

As principais funcionalidades do preenchimento automático avançado que o distinguem do preenchimento automático básico são as seguintes:

  • Pesquisa combinada: o preenchimento automático avançado pode ser usado com apps de pesquisa combinada, que são apps de pesquisa personalizadas associadas a mais do que um repositório de dados.

  • Controlo de acesso: o preenchimento automático avançado respeita os controlos de acesso. (Os controlos de acesso também são denominados ACLs, listas de controlo de acesso.) O preenchimento automático avançado sugere apenas consultas de pesquisa relacionadas com documentos aos quais o pesquisador tem acesso. Para obter informações sobre o controlo de acesso, consulte o artigo Use o controlo de acesso à origem de dados.

  • Melhoramento de idioma: o preenchimento automático avançado pode ser definido para melhorar as sugestões num ou mais idiomas. Por exemplo, se o idioma do navegador for neerlandês, as sugestões de preenchimento automático nesse idioma podem ser melhoradas. Para mais informações, consulte o artigo Envie um pedido de preenchimento automático com um aumento de idioma.

Antes de começar

Antes de começar a usar o preenchimento automático avançado, faça o seguinte:

  • Reveja e, opcionalmente, edite as definições de preenchimento automático da sua app. Consulte o artigo Atualize as definições de preenchimento automático.

  • Para armazenamentos de dados mais pequenos, defina Ativar preenchimento automático como Agora. Recomendamos esta opção porque os pequenos repositórios de dados podem não conter dados suficientes para fornecer sugestões precisas.

  • Se os seus armazenamentos de dados contiverem informações de identificação pessoal (IIP) ou se usar o modelo de sugestões de consultas do histórico de pesquisas ou de eventos do utilizador, reveja o artigo Proteja-se contra fugas de IIP e configure salvaguardas de prevenção contra a perda de dados (DLP) que possam ser necessárias para evitar fugas de IIP.

Envie pedidos de preenchimento automático

O exemplo seguinte mostra como enviar pedidos de preenchimento automático avançado através do método completionConfig.completeQuery.

REST

Para enviar um pedido de preenchimento automático através da API, siga estes passos:

  1. Encontre o ID da app. Se já tiver o ID da app, avance para o passo seguinte.

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

      Aceda a Apps

    2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

  1. Chame o método completionConfig.completeQuery.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .

    • APP_ID: o ID da app Vertex AI Search.

    • QUERY_STRING: a entrada de preenchimento automático usada para obter sugestões.

Envie um pedido de preenchimento automático com um aumento de idioma

Pode aumentar ou ocultar sugestões de preenchimento automático de acordo com o código de idioma. Por exemplo, pode tornar as sugestões de preenchimento automático em alguns idiomas mais ou menos prováveis de aparecer.

O valor do aumento tem de estar entre -1 e 1. A definição de um número negativo "oculta" as sugestões de preenchimento automático nesse idioma, e um número positivo aumenta o idioma.

Use etiquetas de idioma de duas letras definidas pela BCP 47, por exemplo, en, fr, hi e zh.

REST

Para enviar um pedido de preenchimento automático que inclua um valor de reforço de idioma, siga estes passos:

  1. Encontre o ID da app. Se já tiver o ID da app, avance para o passo seguinte.

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

      Aceda a Apps

    2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

  1. Chame o método completionConfig.completeQuery.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "boostSpec": {
         "conditionBoostSpecs": [{
           "condition": "(langCode: ANY(LANG_CODE))",
           "boost": BOOST_VALUE
         }]
      }
    }'

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .

    • APP_ID: o ID da app Vertex AI Search.

    • QUERY_STRING: a entrada de preenchimento automático usada para obter sugestões.

    • LANG_CODE: o código de duas letras de um ou mais idiomas, entre aspas com carateres de escape. Por exemplo, \"fr\", \"es\" para aplicar o valor do aumento ao espanhol e francês.

    • BOOST_VALUE: um número de vírgula flutuante entre -1 e 1. Quando o valor é negativo, as sugestões automáticas no idioma são despromovidas (aparecem mais abaixo na lista de sugestões). Quando o valor é positivo, as sugestões são promovidas (aparecem mais acima na lista).

Envie um pedido de preenchimento automático e devolva consultas recentes

Devolver, como sugestões, uma lista das consultas mais recentes do utilizador que correspondem ao prefixo da consulta no pedido.

As sugestões de consultas correspondentes são apresentadas da mais recente para a mais antiga. Para usar a pesquisa recente, tem de indicar o pseudo ID do utilizador.

Exemplo

Um funcionário está a consultar o site da intranet da empresa para obter informações sobre a marcação de férias. O funcionário fez as seguintes consultas, apresentadas da mais recente para a mais antiga:

PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences e Can I take unpaid time off?.

Agora, em resposta à introdução de vac na caixa de pesquisa por parte do funcionário, as sugestões de preenchimento automático seriam as seguintes:

  • Vacation blackout periods
  • How much vacation time do I have?
  • Vacation policy
  • Covering a vacant position during absences

Procedimento

Para enviar um pedido de preenchimento automático que devolve as consultas mais recentes do utilizador, siga estes passos:

REST

  1. Encontre o ID da app. Se já tiver o ID da app, avance para o passo seguinte.

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

      Aceda a Apps

    2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

  1. Chame o método completionConfig.completeQuery.

    
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "USER_PSEUDO_ID"
    }'

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .

    • APP_ID: o ID da app Vertex AI Search.

    • QUERY_STRING: a entrada de preenchimento automático usada para obter sugestões.

    • USER_PSEUDO_ID: um identificador com pseudonimização do utilizador. Pode usar um cookie HTTP para este campo, que identifica de forma exclusiva um visitante num único dispositivo. Não defina este campo para o mesmo identificador para vários utilizadores. Esta ação combina os respetivos históricos de consultas. Não inclua informações de identificação pessoal (IIP) neste campo.

Use uma lista de exclusão do preenchimento automático

Pode usar uma lista de recusa para impedir que termos específicos sejam apresentados como sugestões de preenchimento automático.

Embora o preenchimento automático avançado esteja ao nível da app, as listas de recusa estão ao nível do armazenamento de dados. Isto é significativo se a sua app for uma app de pesquisa combinada. Crie uma lista de exclusão para cada arquivo de dados associado à app.

Para obter informações sobre a criação e a utilização de listas de recusa, consulte o artigo Use uma lista de recusa do preenchimento automático.

Use uma lista importada de sugestões de preenchimento automático

Pode optar por fornecer a sua própria lista de sugestões de preenchimento automático em vez de usar sugestões de preenchimento automático geradas a partir de um modelo de dados de preenchimento automático.

Para obter informações sobre como importar uma lista, consulte o artigo Use uma lista importada de sugestões de preenchimento automático.