Gli handler dei datastore sono un tipo speciale di handler di stato che possono fornire risposte dell'agente generate dall'LLM in base ai contenuti del tuo sito web e ai dati caricati.
Per creare questo gestore, fornisci datastore durante la creazione dell'agente.
Utilizzando questi gestori del datastore, il tuo agente può conversare sui contenuti con gli utenti finali.
Limitazioni
Si applicano le seguenti limitazioni:
- Al momento, questa funzionalità supporta solo alcune lingue in GA. Consulta la colonna datastore nel riferimento alle lingue.
- Sono supportate solo le seguenti regioni:
global
,us
multi-regione eeu
multi-regione. - L'unico tipo di datastore strutturato supportato è Domande frequenti.
- Le app con datastore suddivisi in chunk e non suddivisi in chunk non sono supportate.
Controllo degli accessi
Se sei il proprietario del progetto, disponi di tutte le autorizzazioni necessarie per creare un gestore datastore. Se non sei il proprietario del progetto, devi disporre dei seguenti ruoli:
- Dialogflow Admin
- Discovery Engine Admin
Per ulteriori informazioni, consulta la guida al controllo dell'accesso.
Crea un agente
Per creare un agente che utilizza gestori di datastore:
- Se non l'hai ancora fatto, segui le istruzioni di configurazione.
Vai alla console di Agent Builder:
Seleziona il progetto dal menu a discesa della console.
Se non l'hai ancora fatto, leggi e accetta i Termini di servizio, quindi fai clic su Continua e attiva l'API.
Fai clic su Crea una nuova app o Nuova app.
Seleziona Chat.
Fornisci il nome della tua azienda nella sezione Configurazioni agente.
Espandi la sezione delle impostazioni relative a fuso orario e lingua.
Seleziona un fuso orario
Seleziona una lingua predefinita.
Fornisci un nome per l'agente nella sezione Nome dell'agente.
Seleziona una regione o più regioni nella sezione Località dell'agente.
Fai clic su Continua.
Collega un datastore al tuo agente effettuando una delle seguenti operazioni:
- Seleziona un datastore esistente che hai creato in precedenza.
- Crea un nuovo datastore:
- Fai clic su Crea nuovo datastore.
- Scegli un'origine dati.
- Fornisci i dati e la configurazione per l'origine del datastore selezionata. La posizione del tuo datastore deve corrispondere alla posizione dell'agente.
- Fai clic su Crea per creare il datastore.
- Seleziona il nuovo datastore.
Fai clic su Crea.
L'agente è stato creato e viene visualizzata automaticamente la pagina Datastore disponibili, dove puoi aggiungere altri datastore in base alle tue esigenze.
Se hai creato un nuovo datastore per un sito web, devi verificare il tuo dominio.
Per aprire l'agente con la console Dialogflow CX, fai clic su Anteprima nel riquadro a sinistra. Nella console, puoi modificare o aggiungere gestori di datastore, eseguire il deployment dell'agente e, facoltativamente, aggiungere flussi che gestiranno gli scenari non coperti dai datastore.
Testa l'agente
Puoi utilizzare il simulatore per testare l'agente.
Esegui il deployment del tuo agente
Esistono molti modi per eseguire il deployment dell'agente:
L'opzione più semplice è utilizzare un'integrazione, che fornisce un'interfaccia utente per l'agente. Ogni integrazione fornisce istruzioni per il deployment.
L'integrazione di Messenger di Dialogflow CX è un'opzione particolarmente valida per gli handler dei datastore. che include opzioni per le funzionalità di generazione.
Puoi creare la tua interfaccia utente e utilizzare l'API Conversational Agents (Dialogflow CX) per le interazioni. L'implementazione dell'interfaccia utente è sotto il controllo del deployment.
Intenzioni speciali
Oltre a gestire le domande sui contenuti che fornisci, l'agente può gestire i seguenti tipi di domande:
- Identificazione dell'agente: gestisce domande come "Chi sei?" o "Sei una persona?".
- Riassegnazione a un agente umano: gestisce domande come "Voglio parlare con una persona" o "Voglio parlare con una persona reale".
Ciò viene ottenuto tramite intent e percorsi intent generati automaticamente.
Aggiungere o modificare i gestori dei datastore per un agente esistente
I gestori del datastore sono un tipo speciale di gestore dello stato. Ciò significa che puoi applicarle a flussi o pagine e che vengono valutate utilizzando le stesse regole di ambito.
Per aggiungere o modificare un gestore dell'archivio dati:
- Vai alla console Dialogflow CX.
- Seleziona il progetto.
- Seleziona l'agente.
- Seleziona il flusso associato all'handler del datastore. Di solito si tratta del flusso di inizio predefinito.
- Seleziona la pagina associata all'handler del datastore. In genere si tratta della home page.
- Fai clic su Aggiungi gestore stato nei dati della pagina, poi seleziona data store.
- Se devi creare un datastore, viene visualizzata l'interfaccia utente di Vertex AI Agent Builder. Consulta le informazioni sul datastore per aiutarti a effettuare le selezioni.
- Se hai già un datastore, fai clic su Modifica datastore.
- Apporta gli aggiornamenti necessari e salva quando hai finito. Di seguito sono riportate le informazioni sulle impostazioni specifiche del datastore.
Risposte dell'agente
Nella sezione Risposte dell'agente, puoi fornire risposte personalizzate che fanno riferimento alle risposte generative.
Utilizza $request.knowledge.questions[0]
nella sezione L'agente dice per fornire la risposta generativa.
Opzioni di risposta del datastore
Puoi aggiornare il campo Numero massimo di link per indicare il numero massimo di link supplementari da fornire con le risposte generative.