Se non hai mai utilizzato Vertex AI Search, ti consigliamo di seguire il tutorial Inizia a utilizzare Vertex AI Search per creare un'app di esempio.
Configura un progetto Google Cloud , attiva Vertex AI Search e configura il controllo dell'accesso per il tuo progetto. Se ne hai già uno, puoi utilizzare un progetto Google Cloud esistente.
Azioni
- Consulta la sezione Prima di iniziare e verifica di aver completato i passaggi.
Determina il tipo di dati che renderai disponibili nella tua app di ricerca e preparali per l'importazione in Vertex AI Search.
Puoi basare il tuo datastore sui seguenti tipi di dati:
- Dati non strutturati. Documenti (come PDF, file HTML e file TXT) archiviati in Cloud Storage. Se vuoi, puoi fornire i metadati in un file JSON o in una tabella BigQuery.
- Dati strutturati. Dati forniti con uno schema specifico. Ad esempio, puoi fornire dati in una tabella BigQuery, come file JSON in Cloud Storage o da connettori di terze parti come Jira.
Azioni
Consulta le informazioni sui dati supportati e sulla relazione tra app e datastore in Informazioni su app e datastore.
Prepara i dati in base ai requisiti indicati in Preparare i dati per l'importazione.
Se devi configurare il controllo dell'accesso per limitare i dati che gli utenti possono visualizzare nei risultati dell'app di ricerca, esamina i prerequisiti e segui le istruzioni per il tipo di provider di identità e l'origine dati in Utilizza il controllo dell'accesso all'origine dati.
Crea un datastore e poi importa i dati o configura un connettore di terze parti come origine dati sincronizzata.
La modalità di importazione dei dati dipende dalla loro origine. Ad esempio, se i dati si trovano in Cloud Storage, puoi importarli utilizzando la console o l'API fornendo la posizione del bucket dei dati.
Azioni
- Segui le istruzioni per l'origine dati in Creare un datastore di ricerca.
Crea la tua app di ricerca personalizzata e collegala al nuovo datastore.
Azioni
Vertex AI Search offre molte opzioni di configurazione. Alcune opzioni dipendono dal fatto che tu preveda di eseguire il deployment di 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 un widget di ricerca nel tuo sito web. Il widget fornisce automaticamente una barra di ricerca e un'interfaccia di ricerca espandibile. Se prevedi di eseguire il deployment del widget di ricerca, configura quanto segue:
Risultati del widget Ricerca. Consulta Configurare i risultati per il widget di ricerca.
Filtri del widget Ricerca (anteprima). Consulta Configurare i prospetti per il widget di ricerca.
Se prevedi di integrare le chiamate API di ricerca nel server o nell'applicazione anziché utilizzare il widget, puoi configurare le impostazioni di ricerca utilizzando le seguenti opzioni:
Impostazioni del campo. Per i dati strutturati o per i dati non strutturati con metadati, aggiorna le impostazioni dei campi per perfezionare il modo in cui Vertex AI Search utilizza i metadati per la ricerca. Vedi Configurare i campi per la ricerca.
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. Vedi Configurare il completamento automatico.
Controlli di pubblicazione. Controlla quando i risultati di ricerca vengono promossi, nascosti, filtrati o reindirizzati oppure se determinate query sono associate ad altre query. Vedi Configurare i controlli di pubblicazione.
Ottimizzazione della ricerca (anteprima). Ottimizza il modello di ricerca con i tuoi dati di addestramento. Consulta Migliorare i risultati di ricerca con l'ottimizzazione della ricerca.
Incorporamenti personalizzati (anteprima). Se hai creato i tuoi incorporamenti, potresti preferire utilizzarli anziché quelli generati da Vertex AI Search per arricchire le tue ricerche con un contesto aggiuntivo. Questa funzionalità è disponibile per i datastore con dati strutturati o dati non strutturati con metadati. Consulta Utilizzare incorporamenti personalizzati.
Se prevedi di eseguire il deployment della tua app integrando le chiamate API di ricerca nel tuo codice, Vertex AI Search offre opzioni aggiuntive per configurare la modalità di restituzione dei risultati di ricerca.
Azioni
Configura i risultati di ricerca con le seguenti opzioni:
- Filtra la ricerca personalizzata per dati strutturati o non strutturati.
- Ottieni snippet, risposte estrattive o segmenti estrattivi. Consulta Ottenere snippet e contenuti estratti.
Puoi visualizzare l'anteprima dei risultati di ricerca per verificare se le configurazioni dell'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 Search per visualizzare l'anteprima di come le configurazioni del widget di ricerca influiscono sui risultati. Consulta le istruzioni relative alla console in Visualizzare i risultati di ricerca.
API. Se stai integrando chiamate API nella tua applicazione, effettua chiamate API per visualizzare l'anteprima delle configurazioni di ricerca. Consulta le istruzioni REST in Recuperare i risultati di ricerca.
Quando sei soddisfatto della versione di anteprima dell'app di ricerca, condividila con i tuoi utenti eseguendo il deployment sul tuo sito web.
Azioni
Puoi implementare la tua 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. In questo modo 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 API di ricerca nel server o nell'applicazione. Per avere il controllo completo sulla modalità di visualizzazione dei risultati di ricerca, puoi integrare le chiamate API nel server o nelle applicazioni. Per ulteriori informazioni su come effettuare chiamate API, vedi Ottenere i risultati di ricerca. Per le risorse della libreria client, consulta Librerie client di Vertex AI Search.
Per ottenere risultati di ricerca e navigazione personalizzati, puoi aggiornare gli eventi utente nell'app di ricerca. Per maggiori informazioni, vedi Informazioni sugli eventi utente.
Azioni
Puoi eseguire la manutenzione dell'app per assicurarti che i dati più recenti e necessari siano disponibili nel datastore.