Gestori del datastore

Nota: i gestori dei datastore sono esclusi dal contratto di servizio Dialogflow.

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 quando crei l'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 e eu multi-regione.
• L'unico tipo di datastore di dati strutturati 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 del data store. 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:

1. Se non l'hai ancora fatto, segui le istruzioni di configurazione.

2. Vai alla console di Agent Builder:

   Console di Agent Builder

3. Seleziona il progetto dal menu a discesa della console.

4. Se non l'hai ancora fatto, leggi e accetta i Termini di servizio, quindi fai clic su Continua e attiva l'API.

5. Fai clic su Crea una nuova app o Nuova app.

6. Seleziona Chat.

7. Fornisci il nome della tua azienda nella sezione Configurazioni agente.

8. Espandi la sezione delle impostazioni di fuso orario e lingua.

9. Seleziona un fuso orario.

10. Seleziona una lingua predefinita.

11. Fornisci un nome per l'agente nella sezione Nome dell'agente.

12. Seleziona una regione o più regioni nella sezione Località dell'agente.

13. Fai clic su Continua.

14. Collega un datastore al tuo agente effettuando una delle seguenti operazioni:

    • Seleziona un datastore esistente che hai creato in precedenza.
    • Crea un nuovo datastore:
      1. Fai clic su Crea nuovo datastore.
      2. Scegli un'source dati.
      3. Fornisci i dati e la configurazione per l'origine del datastore selezionata. La posizione del tuo datastore deve corrispondere alla posizione dell'agente.
      4. Fai clic su Crea per creare il datastore.
      5. Seleziona il nuovo datastore.

15. Fai clic su Crea.

16. L'agente è stato creato e viene visualizzata automaticamente la pagina Datastore disponibili, dove puoi aggiungere altri datastore in base alle tue esigenze.

17. Se hai creato un nuovo datastore per un sito web, devi verificare il tuo dominio.

18. 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

Nota: l'indicizzazione e la gestione corretta dei nuovi contenuti web del datastore da parte dell'agente possono richiedere fino a 4 ore.

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:

1. Vai alla console Dialogflow CX.
2. Seleziona il progetto.
3. Seleziona l'agente.
4. Seleziona il flusso associato all'handler del datastore. Di solito si tratta del flusso di inizio predefinito.
5. Seleziona la pagina associata all'handler del datastore. In genere si tratta della home page.
6. Fai clic su Aggiungi gestore stato nei dati della pagina, poi seleziona data store.
7. 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.
8. Se hai già un datastore, fai clic su Modifica datastore.
9. 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.answers[0] nella sezione L'agente dice per fornire la risposta generativa.

Personalizzazione avanzata delle risposte

In $request.knowledge.* potrebbero essere disponibili informazioni aggiuntive che potrebbero essere utilizzate per personalizzare la risposta. Queste informazioni includono:

• Le fonti identificate della risposta con i seguenti campi: snippet, titolo, uri.
• La confidenza di base per la risposta.
• In caso di un datastore di domande frequenti, la domanda corrispondente alla risposta selezionata.

Nella tabella seguente sono riportati alcuni esempi di come accedere a queste informazioni.

Informazioni	Come accedere
Snippet della principale fonte identificata della risposta principale	$sys.func.GET_FIELD($sys.func.GET($sys.func.IDENTITY($request.knowledge.sources[0]), 0), "snippet")
Titolo della principale fonte identificata della risposta principale	$sys.func.GET_FIELD($sys.func.GET($sys.func.IDENTITY($request.knowledge.sources[0]), 0), "title")
Link alla fonte principale identificata della risposta principale	$sys.func.GET_FIELD($sys.func.GET($sys.func.IDENTITY($request.knowledge.sources[0]), 0), "uri")
Numero di fonti identificate per la risposta principale	$sys.func.COUNT($sys.func.IDENTITY($request.knowledge.sources[0]))
Numero di risposte della knowledge base	$sys.func.COUNT($request.knowledge.answers)
Domanda corrispondente alla risposta principale (solo per le risposte del data store delle domande frequenti)	$request.knowledge.questions[0]
Rafforzare l'affidabilità della risposta principale	$request.knowledge.grounding_confidences[0]

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.