Se utilizzi l'API JSON Custom Search Site Restricted di Programmable Search Engine, puoi creare e implementare una ricerca limitata ai siti di qualità Google in pochi minuti utilizzando Vertex AI Search. Per eseguire il deployment dell'app, puoi utilizzare il widget di ricerca copiando il codice dalla console Google Cloud direttamente in una pagina web, senza dover scrivere codice. In alternativa, puoi implementare un deployment dell'API per controllare l'aspetto della funzionalità di ricerca sul tuo sito web.
Per ulteriori informazioni sull'utilizzo dell'API, consulta la scheda REST di Ottenere risultati di ricerca per un'app con dati del sito web e il metodo servingConfigs.search
nel riferimento REST.
Oltre agli snippet brevi standard che Vertex AI Search restituisce con i risultati di ricerca, puoi aggiungere funzionalità avanzate alla tua ricerca. Sono inclusi i riepiloghi generati dei risultati di ricerca, la ricerca con domande aggiuntive per la ricerca basata sul contesto che consente domande aggiuntive e le risposte estrattive per il testo estratto restituito con ogni risultato di ricerca. Per usufruire di queste funzionalità avanzate per la ricerca web è necessaria la verifica del dominio e sono previsti costi di indicizzazione aggiuntivi.
Puoi anche filtrare o ordinare i risultati di ricerca e applicare i controlli di promozione per mostrare un link come risultato promosso.
Per ulteriori informazioni, consulta la pagina Prezzi di Vertex AI Agent Builder.
Configurare Vertex AI Search
Per configurare la ricerca Vertex AI:
Nella console Google Cloud, nella pagina del selettore di progetti, seleziona il progetto che hai utilizzato per l'API JSON Custom Search Site Restricted.
Crea un'app di ricerca
Per creare un'app di ricerca:
Nella console Google Cloud, vai alla pagina Agent Builder.
Fai clic su Crea app.
Nella pagina Crea app, fai clic su Crea in Cerca il tuo sito web.
Assicurati che le funzionalità della versione Enterprise siano attive. Questo campo è obbligatorio per la ricerca sul sito web. Per saperne di più, consulta le funzionalità della versione Enterprise.
Disattiva Funzionalità LLM avanzate. Se disattivi questa opzione, hai a disposizione una funzionalità simile a quella dell'API JSON Custom Search Site Restricted di Programmable Search Engine. Disattiva questa opzione se non hai bisogno del riepilogo della ricerca o della ricerca con follow-up. Per saperne di più, consulta Funzionalità LLM avanzate.
Nel campo Nome app, inserisci un nome per l'app.
Nel campo Nome esterno della tua azienda o organizzazione, inserisci il nome comune della tua azienda o organizzazione.
Seleziona globale (Globale) come località per la tua app, poi fai clic su Continua.
Nella pagina Datastore, fai clic su Crea datastore.
Nel riquadro Seleziona un'origine dati, scegli Contenuti dei siti web.
Disattiva l'indicizzazione Indicizzazione avanzata dei siti web. Se disattivi questa opzione, hai a disposizione funzionalità simili a quelle dell'API JSON Custom Search Site Restricted del Programmable Search Engine. Disattiva questa impostazione se non hai bisogno del riepilogo della ricerca o della ricerca con follow-up oppure se non possiedi i domini specificati. Per ulteriori informazioni, consulta la sezione Indicizzazione avanzata dei siti web.
Nel riquadro Specifica i pattern di URL da indicizzare, nel campo Siti da includere, inserisci i pattern di URL dei siti web in cui vuoi eseguire ricerche e poi fai clic su Continua.
Nel riquadro Configura il datastore, inserisci un nome visualizzato per il datastore e fai clic su Crea.
Nella pagina Datastore, seleziona il nuovo datastore e fai clic su Crea.
Esegui il deployment dell'app di ricerca
Decidi come intendi autenticare la tua app di ricerca Vertex AI Search: utilizzando OAuth 2.0 o una chiave API. Per informazioni sui vantaggi e svantaggi di ciascun metodo, consulta Informazioni sull'autenticazione.
Per eseguire il deployment dell'app di ricerca con OAuth 2.0
Per eseguire il deployment dell'app di ricerca con una chiave API
Esegui il deployment dell'app di ricerca (OAuth 2.0)
Per eseguire il deployment dell'app di ricerca utilizzando l'autenticazione OAuth 2.0:
Per configurare OAuth 2.0, consulta la sezione Su Google Cloud in Eseguire l'autenticazione in Vertex AI Agent Builder. Assicurati di aggiungere il ruolo Utente Discovery Engine o Visualizzatore Discovery Engine all'account di servizio.
Esegui il deployment dell'app di ricerca in uno dei seguenti modi:
Utilizza il widget di ricerca. Esegui il deployment della tua app di ricerca senza scrivere codice. Per ulteriori informazioni, consulta Aggiungere il widget di ricerca a una pagina web.
Utilizza l'API. Utilizza l'API per controllare l'aspetto della funzionalità di ricerca sul tuo sito web. Per saperne di più, consulta la scheda REST di Ottenere i risultati di ricerca per un'app con i dati del sito web e il metodo
servingConfigs.search
nella documentazione di riferimento REST. Per alfabetizzare i risultati delle query di ricerca web, vedi Ordinare i risultati di ricerca web.
Esegui il deployment dell'app di ricerca (chiave API)
Per eseguire il deployment dell'app di ricerca utilizzando una chiave API per l'autenticazione, segui questi passaggi:
Crea la chiave API:
Nella console Google Cloud, vai alla pagina Credenziali.
Se non sei ancora nel tuo progetto, selezionalo nell'elenco dei progetti nella parte superiore della pagina della console Google Cloud.
Fai clic su Crea credenziali e poi seleziona Chiave API. Non aggiungere limitazioni per i referrer. Alcune impostazioni della privacy dell'utente non fanno transitare l'URL referrer.
- Prendi nota della chiave API generata, che utilizzerai quando chiamerai il metodo
searchLite
.
- Prendi nota della chiave API generata, che utilizzerai quando chiamerai il metodo
Per una maggiore sicurezza, aggiungi una limitazione HTTP alla tua chiave API per limitare l'accesso al servizio Vertex AI Agent Builder in
https://discoveryengine.googleapis.com/*
.
Esegui il deployment dell'app di ricerca utilizzando l'API. Consulta la sezione Ottenere i risultati di ricerca per un'app con i dati del sito web (chiave API) e il metodo
servingConfigs.searchLite
nel riferimento REST. Per ordinare i risultati delle query di ricerca web, consulta Ordinare i risultati di ricerca web.
Informazioni sull'autenticazione
L'API JSON Custom Search Site Restricted di
Programmable Search Engine si autentica utilizzando una chiave API. Tuttavia, con alcune eccezioni, Vertex AI Search richiede OAuth 2.0.
Se vuoi continuare a utilizzare una chiave API per l'autenticazione, devi utilizzare il metodo searchLite
tramite le chiamate API.
Se scegli di eseguire l'autenticazione tramite OAuth 2.0, devi utilizzare il metodo search
e il metodo answer
per eseguire query sul tuo sito web. Inoltre, puoi eseguire il deployment della tua app di ricerca tramite il widget di ricerca senza codice.
La seguente tabella elenca le differenze tra l'utilizzo del metodo searchLite
con l'autenticazione tramite chiave API e i metodi search
e answer
con l'autenticazione OAuth 2.0.
Funzionalità/metodi | Metodo searchLite |
Metodo search |
---|---|---|
Autenticazione | Chiave API | OAuth 2.0 |
Widget Ricerca disponibile | ✘ | ✔ |
Riepiloghi della ricerca | ✔ | ✔ |
Cercare su siti web pubblici | ✔ | ✔ |
Passaggi successivi
Se devi filtrare i risultati di ricerca, consulta Espressioni di filtro per la ricerca di base sul sito web.
Se devi fornire la ricerca di immagini, consulta Cercare immagini su siti web.
Se devi ordinare i risultati di ricerca, ad esempio in base alla data, consulta Ordinare i risultati di ricerca per la ricerca di base sul sito web.
Se hai bisogno di una ricerca in più passaggi, consulta la sezione Comandi per le domande di follow-up.