Configurar o preenchimento automático avançado

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 console Google Cloud , acesse a página Aplicativos de IA.

      Acessar "Apps".

   2. Na página Apps, encontre o nome do app e confira o ID dele 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/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING"
       }'
   

   Substitua:

   • PROJECT_ID: o ID do seu Google Cloud projeto.

   • APP_ID: o ID do app Vertex AI para Pesquisa.

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

REST

Para enviar uma solicitação de preenchimento automático que inclua um valor de reforço 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 console Google Cloud , acesse a página Aplicativos de IA.

      Acessar "Apps".

   2. Na página Apps, encontre o nome do app e confira o ID dele 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/v1beta/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 seu Google Cloud projeto.

   • APP_ID: o ID do app Vertex AI para Pesquisa.

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

   • LANG_CODE: o código de duas letras de um ou mais idiomas, entre aspas escapadas. Por exemplo, \"fr\", \"es\" para aplicar o valor de aumento 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": { "text": "Co"}
        "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 promovidas (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.

REST

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

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

      Acessar "Apps".

   2. Na página Apps, encontre o nome do app e confira o ID dele 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/v1beta/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 seu Google Cloud projeto.

   • APP_ID: o ID do app Vertex AI para Pesquisa.

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

   • USER_PSEUDO_ID: um identificador pseudônimo do usuário. Você pode usar um cookie HTTP para esse campo, que identifica de forma exclusiva 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 deles. Não inclua informações de identificação pessoal (PII) 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/v1beta/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": "2024-11-19T18:27:07.261698Z"
       },
       {
         "suggestion": "holiday freeze",
         "recentSearchTime": "2024-11-19T18:25:45.744021Z"
       },
       {
         "suggestion": "holiday",
         "recentSearchTime": "2024-11-19T18:20:08.916884Z"
       }
     ]
   }