Eseguire la migrazione dall'API Custom Search Site Restricted JSON

Se utilizzi l'API Custom Search Site Restricted JSON del Programmable Search Engine, puoi creare e implementare una ricerca di qualità Google limitata al sito 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 ai brevi snippet standard che Vertex AI Search restituisce con i risultati di ricerca, puoi aggiungere funzionalità avanzate alla tua ricerca. Questi includono riepiloghi generati dei risultati di ricerca, ricerca con domande aggiuntive per una ricerca sensibile al contesto che consente di porre domande aggiuntive e risposte estrattive per il testo estratto restituito con ogni risultato di ricerca. Per ottenere queste funzionalità avanzate per la ricerca web è necessaria la verifica del dominio e si incorrono in costi di indicizzazione aggiuntivi.

Puoi anche filtrare o ordinare i risultati di ricerca e applicare i controlli di promozione per visualizzare un link come risultato promozionale.

Per ulteriori informazioni, consulta la pagina Prezzi delle applicazioni AI.

Configura Vertex AI Search

Per configurare Vertex AI Search:

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

  2. Attiva AI Applications.

Crea un'app di ricerca

Per creare un'app di ricerca:

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

    Applicazioni di AI

  2. Fai clic su Crea app.

  3. Nella pagina Crea app, fai clic su Crea in Ricerca su sito con modalità AI.

  4. Assicurati che le funzionalità della versione Enterprise siano attive. Questo campo è obbligatorio per la ricerca sul sito web. Per saperne di più, vedi Funzionalità della versione Enterprise.

  5. Disattiva Funzionalità LLM avanzate. La disattivazione di questa opzione offre funzionalità simili all'API Custom Search Site Restricted JSON del 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, avrai una funzionalità simile all'API Custom Search Site Restricted JSON del Programmable Search Engine. Disattiva questa opzione 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 URL da indicizzare, nel campo Siti da includere, inserisci i pattern URL dei siti web in cui vuoi eseguire la ricerca e fai clic su Continua.

  13. Nel riquadro Configura il datastore, inserisci un nome visualizzato per il datastore, quindi 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 autenticare l'app di ricerca Vertex AI Search: utilizzando OAuth 2.0 o una chiave API. Per informazioni sui vantaggi e svantaggi di ciascun metodo, vedi 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 Autenticarsi per le applicazioni di AI. 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 hai ancora selezionato il 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 dei referrer. Alcune impostazioni della privacy dell'utente non trasmettono 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 AI Applications all'indirizzo https://discoveryengine.googleapis.com/*.

  2. Esegui il deployment dell'app di ricerca utilizzando l'API. Consulta Ottenere risultati di ricerca per un'app con dati del sito web (chiave API) e il metodo servingConfigs.searchLite nel riferimento REST. Per ordinare i risultati delle query di ricerca web, vedi Ordinare i risultati di ricerca web.

Informazioni sull'autenticazione

L'API Custom Search Site Restricted JSON del Programmable Search Engine esegue l'autenticazione utilizzando una chiave API. Mentre, con un paio di 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 chiamate API.

Se scegli di autenticarti tramite OAuth 2.0, devi utilizzare il metodo search e il metodo answer per eseguire query sul tuo sito web. Inoltre, puoi implementare la tua app di ricerca tramite il widget di ricerca no-code.

La seguente tabella elenca le differenze tra l'utilizzo del metodo searchLite con l'autenticazione con 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 siti web pubblici ✔ ✔

Passaggi successivi