Configurar o preenchimento automático avançado

Esta página descreve o recurso avançado de preenchimento automático da Pesquisa do agente.

Assim como o preenchimento automático básico, o avançado gera sugestões de consulta com base nos primeiros caracteres inseridos.

Antes de ler esta página, conheça o preenchimento automático básico da Pesquisa do agente. Consulte Configurar o preenchimento automático.

Principais recursos do preenchimento automático avançado

Os principais recursos do preenchimento automático avançado que o distinguem do básico são os seguintes:

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

• Controle de acesso:o preenchimento automático avançado respeita os controles de acesso. Eles também são chamados de ACLs (listas de controle de acesso). O preenchimento automático avançado só sugere consultas de pesquisa relacionadas a documentos a que o pesquisador tem acesso. Para mais informações sobre o controle de acesso, consulte Usar o controle de acesso à fonte de dados.

• Impulso de idioma:o preenchimento automático avançado pode ser definido para impulsionar sugestões em um ou mais idiomas. Por exemplo, se o idioma do navegador for holandês, as sugestões de preenchimento automático nesse idioma poderão ser impulsionadas. Para mais informações, consulte Enviar uma solicitação de preenchimento automático com um impulso de idioma.

• Consultas recentes:com o preenchimento automático avançado, em vez de sugestões de consulta de preenchimento automático comuns, os usuários podem receber as consultas recentes que correspondem ao prefixo das letras digitadas. Para mais informações, consulte Enviar uma solicitação de preenchimento automático e retornar consultas recentes.

Antes de começar

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

• Revise e, opcionalmente, edite as configurações de preenchimento automático do seu app. Consulte Atualizar as configurações de preenchimento automático.

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

• Se seus repositórios de dados contiverem informações de identificação pessoal (PII) ou se você usar o modelo de sugestões de consulta do histórico de pesquisa ou de eventos do usuário, consulte Proteger contra vazamentos de PII e configure as proteções de prevenção contra perda de dados (DLP) que podem ser necessárias para evitar vazamentos de PII.

Enviar solicitações de preenchimento automático

A seguir, mostramos como enviar solicitações de preenchimento automático avançado usando o completionConfig.completeQuery método.

REST

Para enviar uma solicitação de preenchimento automático usando a API, siga estas etapas:

1. Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.

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

      Acessar "Apps".

   2. Na página Apps, encontre o nome do seu app e acesse o ID dele na coluna ID.

2. Chame o completionConfig.completeQuery método.

   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:

   • PROJECT_ID: o ID do Google Cloud projeto.

   • APP_ID: o ID do app da Pesquisa do agente.

   • QUERY_STRING: a entrada de digitação antecipada usada para buscar sugestões.

Enviar uma solicitação de preenchimento automático com um impulso de idioma

É possível impulsionar ou ocultar sugestões de preenchimento automático de acordo com o código do idioma. Por exemplo, é possível fazer com que as sugestões de preenchimento automático em alguns idiomas apareçam com mais ou menos frequência.

O valor do impulso precisa estar entre -1 e 1. Definir um número negativo "oculta" as sugestões de preenchimento automático nesse idioma, e um número positivo impulsiona o idioma.

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

REST

Para enviar uma solicitação de preenchimento automático que inclua um valor de impulso de idioma, siga estas etapas:

1. Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.

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

      Acessar "Apps".

   2. Na página Apps, encontre o nome do seu app e acesse o ID dele na coluna ID.

2. Chame o completionConfig.completeQuery método.

   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:

   • PROJECT_ID: o ID do Google Cloud projeto.

   • APP_ID: o ID do app da Pesquisa do agente.

   • QUERY_STRING: a entrada de digitação antecipada usada para buscar sugestões.

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

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

   Exemplo de comando

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
   -d '{
        "query": "hol",
        "boostSpec": {
           "conditionBoostSpecs": [{
             "condition": "(langCode: ANY(\"es\", \"fr\"))",
             "boost": 0.75 }, {
             "condition": "(langCode: ANY(\"en\"))",
             "boost": -1
           }]
         }
       }'
    

   Neste exemplo, as sugestões de preenchimento automático para a consulta Co são impulsionadas (colocadas mais acima na lista de sugestões automáticas) se estiverem em francês ou espanhol e ocultas (colocadas mais abaixo na lista de sugestões automáticas) se estiverem em inglês.

Enviar uma solicitação de preenchimento automático e retornar consultas recentes

Retorne, como sugestões, uma lista das consultas mais recentes do usuário que correspondem ao prefixo da consulta na solicitação.

As sugestões de consulta correspondentes são listadas da mais recente para a mais antiga. Para usar a pesquisa recente, o pseudoID do usuário precisa ser fornecido.

Exemplo

Um funcionário está consultando o site da intranet da empresa para receber informações sobre como tirar férias. O funcionário fez as seguintes consultas, listadas 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 ao funcionário que digita vac na caixa de pesquisa, 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 uma solicitação de preenchimento automático que retorne as consultas mais recentes do usuário, siga estas etapas:

REST

1. Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.

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

      Acessar "Apps".

   2. Na página Apps, encontre o nome do seu app e acesse o ID dele na coluna ID.

2. Chame o completionConfig.completeQuery método.

   
   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:

   • PROJECT_ID: o ID do Google Cloud projeto.

   • APP_ID: o ID do app da Pesquisa do agente.

   • QUERY_STRING: a entrada de digitação antecipada usada para buscar sugestões.

   • USER_PSEUDO_ID: um identificador pseudonimizado do usuário. É possível usar um cookie HTTP para esse campo, que identifica um visitante em um único dispositivo. Não defina esse campo com o mesmo identificador para vários usuários. Isso combinaria os históricos de consultas. Não inclua informações de identificação pessoal (PII) nesse campo.

   Exemplo de comando e resultado

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
   -d '{
         "query": "hol",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId": "test_user"
       }'
   
   {
     "recentSearchSuggestions": [
       {
         "suggestion": "holiday readiness",
         "recentSearchTime": "2025-05-19T18:27:07.261698Z"
       },
       {
         "suggestion": "holiday freeze",
         "recentSearchTime": "2025-05-19T18:25:45.744021Z"
       },
       {
         "suggestion": "holiday",
         "recentSearchTime": "2025-05-19T18:20:08.916884Z"
       }
     ]
   }
   

Observação: se você especificar suggestionTypes como RECENT_SEARCH, todos os parâmetros boostSpec, queryModel ou includeTailSuggestions no comando curl serão ignorados.

Usar uma lista de bloqueio de preenchimento automático

É possível usar uma lista de bloqueios para evitar que termos específicos apareçam como sugestões de preenchimento automático.

Embora o preenchimento automático avançado esteja no nível do app, as listas de bloqueio estão no nível do repositório de dados. Isso é importante se o app for de pesquisa combinada. Crie uma lista de bloqueio para cada repositório de dados conectado ao app.

Para informações sobre como criar e usar listas de bloqueio, consulte Usar uma lista de bloqueio de preenchimento automático.

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

É possível fornecer sua própria lista de sugestões de preenchimento automático em vez de usar as sugestões geradas por um modelo de dados de preenchimento automático.

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