Se non hai mai utilizzato la ricerca di agenti, ti consigliamo di seguire il tutorial Inizia a utilizzare la ricerca personalizzata per creare un'app di esempio.
Configura un Google Cloud progetto, attiva la ricerca di agenti e configura il controllo dell'accesso per il progetto. Se ne hai già uno, puoi utilizzare unprogetto esistente. Google Cloud
Azioni
- Esamina 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 nella ricerca di agenti.
Puoi basare il tuo datastore sui seguenti tipi di dati:
- Dati non strutturati. Documenti (ad esempio file PDF, HTML e TXT) archiviati in Cloud Storage. Facoltativamente, puoi fornire 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
Esamina le informazioni sui dati supportati e sulla relazione tra app e datastore in Informazioni su app e data store.
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 della tua app di ricerca, esamina i prerequisiti e segui le istruzioni per il tipo di provider di identità e l'origine dati in Utilizzare il controllo dell'accesso all'origine dati.
Crea un datastore e poi importa i dati al suo interno oppure 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 la tua origine dati in Creare un datastore di ricerca.
Crea la tua app di ricerca personalizzata e collegala al nuovo datastore.
Azioni
La ricerca di agenti per la ricerca personalizzata supporta due modelli di determinazione dei prezzi:
- Generale: un modello con pagamento a consumo basato sul consumo.
- Configurabile: un modello di determinazione dei prezzi misto che ti consente di separare le funzionalità e creare un pacchetto di abbonamento più in linea con i tuoi casi d'uso specifici. Questo modello di determinazione dei prezzi ti consente di pagare solo le funzionalità di cui hai bisogno e di sfruttare le loro potenti funzionalità. Offre due abbonamenti e componenti aggiuntivi facoltativi. Dopo aver attivato questo modello di determinazione dei prezzi a livello di progetto, puoi selezionare i prezzi configurabili per le tue app e i tuoi datastore.
Azioni
Per impostazione predefinita, un progetto è impostato sul modello con pagamento a consumo. Tuttavia, per passare ai prezzi configurabili:
- Segui le istruzioni per configurare i prezzi configurabili per la ricerca personalizzata.
La ricerca di agenti offre molte opzioni di configurazione. Alcune opzioni dipendono dal fatto che tu intenda o meno eseguire il deployment di un widget di ricerca.
Azioni
A seconda del tuo 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, la ricerca di agenti 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.
Facet del widget Ricerca (anteprima) Consulta Configurare i filtri 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 dei campi. Per i dati strutturati o per i dati non strutturati con metadati, aggiorna le impostazioni dei campi per perfezionare la modalità di utilizzo dei metadati da parte della ricerca di agenti per la ricerca. Consulta 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. Consulta 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. Consulta 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 della ricerca.
Incorporamenti personalizzati (anteprima). Se hai creato i tuoi incorporamenti, potresti preferire utilizzarli anziché quelli generati dalla ricerca di agenti per arricchire le ricerche con un contesto aggiuntivo. Questa funzionalità è disponibile per i datastore con dati strutturati o dati non strutturati con metadati. Consulta Utilizzare gli incorporamenti personalizzati.
Se prevedi di eseguire il deployment dell'app integrando le chiamate API di ricerca nel tuo codice, la ricerca di agenti 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 estritti.
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 della ricerca di agenti per visualizzare l'anteprima dell'impatto delle configurazioni del widget di ricerca sui risultati. Consulta le istruzioni relative alla console in Ottenere i risultati di ricerca.
API. Se stai integrando le chiamate API nella tua applicazione, effettua chiamate API per visualizzare l'anteprima delle configurazioni di ricerca. Consulta le REST istruzioni in Ottenere 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 eseguire il deployment dell'app di ricerca in uno dei seguenti modi:
Incorpora il widget di ricerca nel tuo sito web. La ricerca di agenti 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 Aggiungere il widget di ricerca a una pagina web.
Integra le chiamate API di ricerca nel server o nell'applicazione. Per un controllo completo della modalità di visualizzazione dei risultati di ricerca, puoi integrare le chiamate API nel server o nelle applicazioni. Per saperne di più su come effettuare chiamate API, consulta Ottenere i risultati di ricerca. Per le risorse della libreria client, consulta Librerie client della ricerca di agenti.
Per ottenere risultati di ricerca e navigazione personalizzati, puoi aggiornare gli eventi utente nella tua app di ricerca. Per saperne di più, consulta Informazioni sugli eventi utente per le app personalizzate.
Azioni
Puoi gestire l'app per assicurarti che i dati più recenti e necessari siano disponibili nel datastore.