Questa pagina mostra come visualizzare l'anteprima dei risultati di ricerca per le app multimediali utilizzando la consoleGoogle Cloud e come ottenere i risultati di ricerca utilizzando l'API.
Per implementare l'app di ricerca, puoi creare un widget di ricerca da aggiungere alla tua pagina web oppure puoi effettuare chiamate API e integrarle nella tua pagina web o applicazione.
Informazioni sulle modalità di ricerca
Esistono diverse modalità di query di ricerca per le app multimediali:
Query complete: quando gli utenti finali intendono cercare l'intero termine o l'intera frase. Ad esempio, in un'app di streaming musicale, gli utenti digitano l'intero titolo del brano e lo cercano in una sola volta. Questo è un modo preferito di cercare quando si utilizza un'interfaccia di input che consente agli utenti di cercare in una sola volta, ad esempio l'input audio o l'input da tastiera.
Nelle query complete, se la voce include un errore ortografico, gli utenti si aspettano che l'errore venga corretto.
Questo è lo stesso comportamento della ricerca di app non multimediali (personalizzate). Consulta Visualizzare i risultati di ricerca per un'app con dati strutturati o non strutturati.
Query parziali (o di ricerca durante la digitazione): quando gli utenti finali ricevono dinamicamente un nuovo insieme di risultati di ricerca mentre digitano ogni lettera. Ad esempio, in un'app di streaming musicale, gli utenti iniziano a inserire il nome del brano che stanno cercando e, a ogni lettera digitata, i risultati di ricerca si aggiornano e si restringono in modo dinamico.
Modalità automatica: la modalità automatica è un mix di modalità completa e parziale. Con la modalità automatica, lasci che la ricerca multimediale decida se restituire i risultati della query come parziali o completi.
Per determinare la probabile intenzione degli utenti finali, la ricerca multimediale analizza e pondera vari segnali, come il numero di lettere inserite, la velocità di inserimento e se l'inserimento è un'entità riconosciuta, ad esempio il nome di un attore o di un film.
Quale modalità utilizzare
La modalità predefinita per le query di ricerca di contenuti multimediali è la modalità automatica. Tuttavia, ci sono scenari in cui potresti scegliere di ignorare la modalità predefinita e specificare la modalità di query completa o parziale. Ecco alcuni esempi di casi d'uso:
| Scenario | Modalità |
|---|---|
| Sei molto sicuro che le query degli utenti finali siano query complete. Ad esempio, hai una casella di ricerca che include una funzione Invio per contrassegnare la query come completata e l'utente preme Invio. | Query complete |
| Sei molto sicuro che le query degli utenti finali siano intese come query parziali, ovvero si aspettano che l'elenco dei risultati venga aggiornato dopo ogni lettera inserita. | Query parziali |
| Nessuno degli scenari precedenti è applicabile. Consenti alla ricerca multimediale di decidere se restituire i risultati della query in modo parziale o completo. | Auto |
Visualizzare i risultati di ricerca per un'app multimediale
Puoi visualizzare l'anteprima dei risultati di ricerca dalla console Google Cloud o ottenere i risultati di ricerca utilizzando l'API. Per ottenere risultati di ricerca per un'app multimediale:
Console
Per utilizzare la console Google Cloud per visualizzare l'anteprima della ricerca di contenuti multimediali e configurare un widget:
Nella Google Cloud console, vai alla pagina AI Applications.
Fai clic sul nome dell'app di ricerca dei contenuti multimediali.
Fai clic su Configurations (Configurazione).
Fai clic sulla scheda UI.
Nella scheda UI, imposta le opzioni Configurazioni generali e Visualizzazione dati.
Nel riquadro Anteprima, inizia a digitare una query.
Per salvare le configurazioni e renderle disponibili nella scheda Integrazione, fai clic su Salva e pubblica.
REST
Utilizza il metodo engines.servingConfigs.search per
ottenere risultati di ricerca per un'app multimediale:
Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.
Nella Google Cloud console, vai alla pagina AI Applications.
Nella pagina App, trova il nome della tua app e recupera il relativo ID dalla colonna ID.
Esegui questo comando curl per ottenere risultati di ricerca in tempo reale.
Tutti i campi, ad eccezione di
contentSearchSpec, possono essere utilizzati insieme al camposearchAsYouTypeSpec. Per chiarezza, i campi facoltativi sono stati omessi dal comando curl. Per i campi facoltativi, consulta Ottenere risultati di ricerca per un'app con dati strutturati o non strutturati.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/servingConfigs/default_search:search" \ -d '{ "query": "QUERY", "searchAsYouTypeSpec": {"condition": "SPEC_CONDITION"} }'Sostituisci quanto segue:
PROJECT_ID: l'ID del tuo Google Cloud progetto.PROJECT_ID: l'ID del tuo Google Cloud progetto.APP_ID: l'ID dell'app Vertex AI Search per cui vuoi eseguire query.QUERY: il testo della query da cercare.SPEC_CONDITION: la specifica di ricerca durante la digitazione può avere uno dei seguenti valori:ENABLED: per query parzialiDISABLED: per le query completeAUTO: parziale o completo, a seconda di quanto ritenuto opportuno. Se lasci vuoto il campoSPEC_CONDITIONo non lo specifichi, la modalità di ricerca predefinita èAUTO.
Comando di esempio e risultato parziale
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/servingConfigs/default_search:search" \ -d '{ "query": "Mission Impossible", "searchAsYouTypeSpec": {"condition": "DISABLED"} }'
{ "results": [ { "id": "189333", "document": { "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/189333", "id": "189333", "structData": { "uri": "http://mytestdomain.movie/content/189333", "title": "Mission: Impossible - Fallout (2018)", "categories": [ "Action", "Adventure", "Thriller" ], "available_time": "2023-01-01T00:00:00Z", "media_type": "movie", "expire_time": "2033-01-01T00:00:00Z" } } }, { "id": "111781", "document": { "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/111781", "id": "111781", "structData": { "media_type": "movie", "available_time": "2023-01-01T00:00:00Z", "uri": "http://mytestdomain.movie/content/111781", "title": "Mission: Impossible - Rogue Nation (2015)", "categories": [ "Action", "Adventure", "Thriller" ], "expire_time": "2033-01-01T00:00:00Z" } } }, ... { "id": "116507", "document": { "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/116507", "id": "116507", "structData": { "uri": "http://mytestdomain.movie/content/116507", "categories": [ "Comedy" ], "media_type": "movie", "available_time": "2023-01-01T00:00:00Z", "title": "Mission London (2010)", "expire_time": "2033-01-01T00:00:00Z" } } } ], "totalSize": 5628, "attributionToken": "vgL0PQEKDAiZxMbCBhD2koiqAxIkNjg1MWM3OTUtMDAwMC0yOWVmLThhNzUtZDQzYTJjYzdiYmNmIgVNRURJQSpUtreMLa_WoTGs1qExwvCeFaOAlyKrtZwxxcvzF-7r6TGotZwxkPeyMI6RyTDPv-Iw1L_iMJvWty2Ovp0V1LKdFfHr6THs4K8tkvGsMJXxrDCY1rctMAFKEjB4OTYzYjdjNGE0ZGYwN2FhZlKUAXByb2plY3RzLzc1NjIwNjYwODQ3OS9sb2NhdGlvbnMvZ2xvYmFsL2NvbGxlY3Rpb25zL2RlZmF1bHRfY29sbGVjdGlvbi9lbmdpbmVzL3F1aWNrc3RhcnQtbWVkaWEtcmVjb21tZW5kXzE3NDUwMjUyMjYwNDMvc2VydmluZ0NvbmZpZ3MvZGVmYXVsdF9zZWFyY2g", "nextPageToken": "Y2YiJ2NjNmMhNDNk1SN3EGOtYWZ5ITLwADMw0CN5czYxUDO2QiGDI9kgzIEGIs1tmJCMIBM1IgC", "summary": {}, "queryExpansionInfo": {} }