Configurare il completamento automatico avanzato

REST

Per inviare una richiesta di completamento automatico utilizzando l'API:

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera l'ID dall'app colonna ID.

1. Chiama il metodo 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"
       }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo Google Cloud progetto.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • QUERY_STRING: l'input di tipoahead utilizzato per recuperare i suggerimenti.

REST

Per inviare una richiesta di completamento automatico che includa un valore di potenziamento della lingua:

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera l'ID dall'app colonna ID.

1. Chiama il metodo 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
            }]
         }
       }'
   
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo Google Cloud progetto.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • QUERY_STRING: l'input di tipoahead utilizzato per recuperare i suggerimenti.

   • LANG_CODE: il codice di due lettere per una o più lingue, tra virgolette eseguibili. Ad esempio, \"fr\", \"es\" per applicare il valore dell'incremento allo spagnolo e al francese.

   • BOOST_VALUE: un numero a virgola mobile compreso tra -1 e 1. Quando il valore è negativo, i suggerimenti automatici nella lingua vengono retrocessi (vengono visualizzati più in basso nell'elenco dei suggerimenti). Quando il valore è positivo, i suggerimenti vengono promossi (vengono visualizzati più in alto nell'elenco).

   Comando di esempio

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

   In questo esempio, i suggerimenti di completamento automatico per la query Co vengono messi in evidenza (posizionati più in alto nell'elenco dei suggerimenti automatici) se sono in francese o spagnolo e nascosti (posizionati più in basso nell'elenco dei suggerimenti automatici) se sono in inglese.

REST

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera l'ID dall'app colonna ID.

1. Chiama il metodo 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"
       }'
   
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo Google Cloud progetto.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • QUERY_STRING: l'input di tipoahead utilizzato per recuperare i suggerimenti.

   • USER_PSEUDO_ID: un identificatore pseudonimo dell'utente. Puoi utilizzare un cookie HTTP per questo campo, che identifica in modo univoco un visitatore su un singolo dispositivo. Non impostare questo campo sullo stesso identificatore per più utenti. In questo modo, le cronologie delle query verranno combinate. Non includere informazioni che consentono l'identificazione personale (PII) in questo campo.

   Comando e risultato di esempio

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