Eseguire la migrazione dall'API Custom Search Site Restricted JSON

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. Per ulteriori informazioni, consulta la pagina Prezzi di Vertex AI Agent Builder.

Configurare Vertex AI Search

Per configurare la ricerca Vertex AI:

  1. Nella console Google Cloud, nella pagina del selettore di progetti, seleziona il progetto che hai utilizzato per l'API JSON Custom Search Site Restricted.

  2. Attiva Vertex AI Agent Builder.

Crea un'app di ricerca

Per creare un'app di ricerca:

  1. Nella console Google Cloud, vai alla pagina Agent Builder.

    Agent Builder

  2. Fai clic su Crea app.

  3. Nella pagina Crea app, fai clic su Crea in Cerca il tuo sito web.

  4. 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.

  5. 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.

  6. Nel campo Nome app, inserisci un nome per l'app.

  7. Nel campo Nome esterno della tua azienda o organizzazione, inserisci il nome comune della tua azienda o organizzazione.

  8. Seleziona globale (Globale) come località per la tua app, poi fai clic su Continua.

  9. Nella pagina Datastore, fai clic su Crea datastore.

  10. Nel riquadro Seleziona un'origine dati, scegli Contenuti dei siti web.

  11. 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.

  12. 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.

  13. Nel riquadro Configura il datastore, inserisci un nome visualizzato per il datastore e fai clic su Crea.

  14. 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.

Esegui il deployment dell'app di ricerca (OAuth 2.0)

Per eseguire il deployment dell'app di ricerca utilizzando l'autenticazione OAuth 2.0:

  1. 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.

  2. Esegui il deployment dell'app di ricerca in uno dei seguenti modi:

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:

  1. Crea la chiave API:

    1. Nella console Google Cloud, vai alla pagina Credenziali.

      Credenziali

    2. Se non sei ancora nel tuo progetto, selezionalo nell'elenco dei progetti nella parte superiore della pagina della console Google Cloud.

    3. 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.

    4. 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/*.

  2. 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