Esta página foi traduzida pela API Cloud Translation.

Configure o preenchimento automático avançado

Esta página descreve a funcionalidade de preenchimento automático avançado do Gemini Enterprise.

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 do Gemini Enterprise. 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 que estão ligadas 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 informações sobre o controlo de acesso, consulte o artigo Identidade e autorizações.

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.

Diferentes tipos de sugestões: com o preenchimento automático avançado, em vez das sugestões de consultas de preenchimento automático normais, pode especificar que quer diferentes tipos de sugestões:
- Sugestões avançadas: como sugestões de preenchimento automático, os utilizadores recebem informações sobre documentos cujos títulos correspondem às letras que escrevem. Para mais informações, consulte o artigo Envie um pedido de preenchimento automático e devolva sugestões formatadas.
- Consultas recentes: como sugestões de preenchimento automático, os utilizadores recebem as consultas recentes que correspondem às letras que escrevem. Para mais informações, consulte o artigo Envie um pedido de preenchimento automático e devolva consultas recentes.

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 arquivos 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:

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 Gemini Enterprise.
  
  Aceda a Apps
2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

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.
APP_ID: o ID da app.
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:

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 Gemini Enterprise.
  
  Aceda a Apps
2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

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.
APP_ID: o ID da app.
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).

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 reforçadas (posicionadas mais acima na lista de sugestões automáticas) se estiverem em francês ou espanhol e ocultadas (posicionadas mais abaixo na lista de sugestões automáticas) se estiverem em inglês.

Envie um pedido de preenchimento automático e devolva sugestões detalhadas

O preenchimento automático avançado devolve conteúdo (documentos) cujos títulos contêm palavras que começam com a consulta.

Além do título do documento, o pedido de preenchimento automático devolve o source_type e o entity_type e, se disponíveis, as propriedades principais: uri, create_time e update_time. Pode ver e editar as principais associações de propriedades no separador Esquema da página da loja de dados.

Tal como acontece com todas as sugestões de preenchimento automático avançadas, as ACLs são respeitadas para todos os documentos sugeridos.

Exemplo

Um funcionário está a consultar o site da intranet da empresa à procura de informações técnicas sobre autorizações de acesso.

O funcionário começa a escrever tec e podem ser devolvidos os seguintes documentos: Data technicians handbook, Access technology guide e Techniques for troubleshooting access issues.

Com as sugestões avançadas, para cada um destes documentos sugeridos, pode apresentar as seguintes informações sobre o documento:

O título do documento (title) e um link para o documento (uri)
Quando foi atualizada pela última vez (update_time)
a origem (source_type), por exemplo, se o documento foi encontrado no Confluence Cloud ou no Slack.

Saber quando um documento foi atualizado e qual a origem do documento ajuda o funcionário a escolher que documento consultar primeiro.

Limitações

O preenchimento automático avançado aplica-se apenas a conetores de terceiros e apenas a determinadas lojas de dados de entidades para esses conetores de terceiros. A tabela seguinte mostra que entidades são suportadas para que conetores.

Conetor de terceiros	Entidades suportadas
Caixa	Ficheiro
Confluence Cloud	Página	Barra de espaços
Dropbox	Ficheiro
Jira Cloud	Problema	Barra de espaços
OneDrive	Ficheiro
Salesforce	Conta	Lead	Oportunidade
ServiceNow	Incidente	Conhecimento
Sharepoint Online	Anexo	Evento	Ficheiro	Página
Slack	Mensagem

Procedimento

Para enviar um pedido de preenchimento automático que devolve uma sugestão avançada, siga estes passos:

REST

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 Gemini Enterprise.
  
  Aceda a Apps
2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

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": ["CONTENT"]
    }'

Substitua o seguinte:

PROJECT_ID: o ID do seu projeto.
APP_ID: o ID da app.
QUERY_STRING: a entrada de preenchimento automático usada para obter sugestões.

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/1234/locations/global/collections/default_collection/engines/my_app/completionConfig:completeQuery" \
- d {
      "query": "C",
      "suggestionTypes": ["CONTENT"]
    }'

{
  "contentSuggestions": [{
    "suggestion": "critical crash in payment module",
    "document": {
      "name": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store/branches/0/documents/10000",
      "derivedStructData": {
        "title": "Critical Crash in Payment Module",
        "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
        "source_type": "jira",
        "entity_type": "issue"
      }
    },
    "dataStore": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store"
  }]
}

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

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 Gemini Enterprise.
  
  Aceda a Apps
2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

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.
APP_ID: o ID da app.
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.

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"
    }
  ]
}

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.