Se non hai mai utilizzato Vertex AI Agent Builder, ti consigliamo di seguire il tutorial Iniziare a utilizzare la ricerca generica per creare un'app di dati del sito web di esempio.
Scegliere tra la ricerca di base sul sito web e l'indicizzazione avanzata dei siti web
Vertex AI Agent Builder offre due tipi di datastore dei siti web: ricerca di base del sito web e indicizzazione avanzata del sito web.
Puoi scegliere di attivare l'indicizzazione avanzata dei siti web per indicizzare le pagine web nel tuo datastore di ricerca. L'indicizzazione avanzata dei siti web richiede la verifica del dominio e offre diverse funzionalità aggiuntive rispetto alla ricerca di base sul sito web. Per ulteriori informazioni, consulta la sezione Indicizzazione avanzata dei siti web.
A seconda del tipo di datastore del sito web necessario per le tue esigenze aziendali, seleziona una delle seguenti liste di controllo:
Configura un Google Cloud progetto, attiva Vertex AI Agent Builder e configura il controllo accessi per il progetto. Puoi utilizzare un progetto Google Cloud esistente se ne hai già uno.
Azioni
- Esamina la pagina Prima di iniziare e verifica di aver completato i passaggi.
Scopri come si comporta un'app di ricerca di siti web (un tipo di app di ricerca generica) e i prerequisiti per includere i siti web in un data store di siti web.
Azioni
Consulta le informazioni sulla relazione tra app generiche e datastore in Informazioni su app e datastore e su cosa costituiscono i dati dei siti web. Quando l'indicizzazione avanzata dei siti web è attivata per un datastore, puoi usarlo per la ricerca combinata, in cui più datastore sono collegati a un'app.
Prepara i dati del tuo sito web in base ai requisiti descritti in Dati del sito web.
Crea un data store fornendo i pattern URL dei siti web da includere e i pattern URL da escludere. La procedura di creazione del datastore prevede dei passaggi per attivare l'indicizzazione avanzata dei siti web, che richiede la verifica del dominio.
Azioni
Segui le istruzioni riportate in Creare un datastore utilizzando gli URL dei siti web.
Se la creazione del data store e la verifica del dominio vanno a buon fine, Vertex AI Agent Builder genera un indice iniziale, che viene aggiornato automaticamente in base al criterio del massimo impegno.
La procedura di indicizzazione iniziale potrebbe richiedere diverse ore.
(Facoltativo) Crea un datastore che ti consenta di eseguire l'indicizzazione e l'aggiornamento solo della sitemap. Per farlo, segui le istruzioni riportate in Attivare l'aggiornamento solo della mappa del sito in un data store.
Per comprendere l'indicizzazione e l'aggiornamento basati sulla Sitemap, consulta Indicizzare e aggiornare le pagine web utilizzando la Sitemap.
Crea l'app di ricerca del tuo sito web e collegala al nuovo datastore.
Azioni
- Crea un'app di ricerca. Assicurati di attivare la versione Enterprise.
Vertex AI Search offre molte opzioni di configurazione. Alcune opzioni dipendono dal fatto che tu intenda implementare un widget di ricerca.
Azioni
A seconda del caso d'uso e se prevedi di eseguire il deployment del widget di ricerca predefinito o di integrare le chiamate API di ricerca nel tuo codice, Vertex AI Search offre diverse opzioni di configurazione.
Puoi incorporare nel tuo sito web un widget di ricerca che fornisce automaticamente una barra di ricerca e un'interfaccia di ricerca espandibile. Se prevedi di implementare il widget di ricerca, configura quanto segue:
Risultati del widget di ricerca. Consulta Configurare i risultati per il widget di ricerca.
Aspetti del widget di ricerca (anteprima). Consulta Configurare le sfaccettate per il widget di ricerca.
Completamento automatico. Consulta Aggiornare le impostazioni di completamento automatico.
Ottimizzazione della ricerca (anteprima). Consulta Migliorare i risultati di ricerca con la ottimizzazione della ricerca.
Se prevedi di integrare le chiamate dell'API di ricerca nel tuo server o nella tua applicazione invece di utilizzare il widget, puoi configurare le impostazioni di ricerca utilizzando le seguenti opzioni:
Completamento automatico. A seconda dei dati, configura i suggerimenti di completamento automatico in base ai contenuti dei documenti, ai campi, alla cronologia delle ricerche o agli eventi utente. Consulta Configurare il completamento automatico.
Controlli di pubblicazione. Controlla quando i risultati di ricerca vengono messi in evidenza, nascosti, filtrati o reindirizzati oppure se determinate query sono sinonimi di altre query. Consulta Configurare i controlli di pubblicazione per la ricerca.
Ottimizzazione della ricerca (anteprima). Ottimizza il modello di ricerca con i tuoi dati di addestramento. Consulta Migliorare i risultati di ricerca con la ottimizzazione della ricerca.
Se prevedi di eseguire il deployment dell'app integrando le chiamate dell'API di ricerca nel tuo codice, Vertex AI Search offre opzioni aggiuntive per configurare il modo in cui vengono restituiti i risultati di ricerca.
Azioni
Configura i risultati di ricerca con le seguenti opzioni:
Puoi visualizzare l'anteprima dei risultati di ricerca per verificare se le configurazioni delle app funzionano come previsto.
Azioni
Per visualizzare l'anteprima dei risultati di ricerca, utilizza la console o l'API.
Console. Utilizza la pagina Anteprima della console Vertex AI Agent Builder per visualizzare in anteprima l'impatto delle configurazioni dei widget di ricerca sui risultati. Consulta le istruzioni per Console in Ottenere risultati di ricerca.
API. Se stai integrando le chiamate API nella tua applicazione, puoi effettuare chiamate curl per visualizzare l'anteprima delle configurazioni di ricerca. Consulta le istruzioni per REST in Ottenere risultati di ricerca.
Arricchisci l'indice del tuo data store sfruttando i dati strutturati aggiunti alle tue pagine web.
Azioni
L'aggiunta di dati strutturati alle pagine web è un processo iterativo:
- Modifica i dati strutturati nelle pagine web. Per ulteriori informazioni, consulta la pagina Utilizzare i dati strutturati per l'indicizzazione avanzata dei siti web.
- Aggiorna lo schema del tuo data store con gli attributi dei dati strutturati, se necessario.
- Riconfigura i risultati di ricerca. Consulta il passaggio 6 di questo elenco di controllo.
- Visualizza l'anteprima dei risultati di ricerca. Consulta il passaggio 7 di questo elenco di controllo.
- Ripeti questa procedura, se necessario, per ottenere il comportamento di ricerca richiesto prima di implementare l'app di ricerca.
Quando la versione di anteprima dell'app di ricerca ti soddisfa, condividila con i tuoi utenti eseguendone il deployment sul tuo sito web.
Azioni
Puoi implementare l'app di ricerca in uno dei seguenti modi:
Incorpora il widget di ricerca nel tuo sito web. Vertex AI Search fornisce il codice che puoi copiare nel tuo sito web o nella tua applicazione web. Viene eseguito il deployment del widget di ricerca. Puoi visualizzare l'anteprima dei risultati di ricerca nella console. Consulta la sezione Aggiungere il widget di ricerca a una pagina web.
Integra le chiamate all'API di ricerca nel tuo server o nella tua applicazione. Per avere il controllo completo sulla modalità di visualizzazione dei risultati di ricerca, puoi integrare le chiamate API nel tuo server o nelle tue applicazioni. Per ulteriori informazioni su come effettuare chiamate all'API, vedi Ottenere i risultati di ricerca. Per le risorse delle librerie client, consulta le librerie client di Vertex AI Agent Builder.
Puoi gestire la tua app per assicurarti che nel tuo datastore siano disponibili i dati più recenti e necessari.
Azioni
- Aggiorna i dati.
- (Facoltativo) Se il tuo data store dispone di indicizzazione e aggiornamento basati su Sitemap, invia le Sitemap o gli indici Sitemap e mantienili aggiornati. L'indice dello spazio dati viene aggiornato automaticamente e gli URL inclusi vengono aggiornati quotidianamente. Per comprendere l'indicizzazione e l'aggiornamento basati sulla Sitemap, consulta Indicizzare e aggiornare le pagine web utilizzando la Sitemap.