Condividi tramite


Passare variabili di contesto dalla pagina web a un agente

Quando il tuo agente viene distribuito sul tuo sito web personalizzato, potresti voler passare variabili di contesto dalla tua pagina web al agente. Puoi passare in modo efficace le variabili di contesto da una pagina web al tuo agente e utilizzare queste variabili per migliorare l'esperienza utente. Le variabili di contesto consentono al tuo agente di fornire interazioni personalizzate e più significative con i visitatori del tuo sito web.

Quando passare le variabili di contesto

  • Trasmettere un ID di monitoraggio dell'analisi web da una pagina web a un agente per analizzare insieme le analisi web e agente.

  • Passa un ID ordine da una pagina web a agente in modo che l'utente non debba digitare nuovamente l'ID ordine per agente. Agente può semplicemente prendere le informazioni sull'ID dell'ordine dalla pagina web.

  • Passa la pagina corrente del sito web in modo che agente possa personalizzare la propria esperienza in base alla pagina web che l'utente sta visitando.

  • Passa la lingua della pagina web a agente in modo che agente possa personalizzare la propria esperienza in base alla lingua della pagina web.

Il passaggio delle variabili di contesto è una procedura in due fasi: prima si passa il contesto dalla pagina web a agente, poi si salva il contesto in agente come variabile.

Passa il contesto dalla tua pagina web a agente

Nel codice JavaScript, dove chiami agente, includi i valori da inviare come contesto. Puoi passare qualsiasi informazione, come un OrderId, dal tuo sito web al tuo agente. Ad esempio, nel seguente frammento di codice vengono inviate tre variabili di contesto:

  • Lingua
  • URL corrente
  • ID ordine

Screenshot del codice JSON che evidenzia le tre variabili di contesto inviate.

Nota

Per altre informazioni, vedi Riutilizzare le variabili tra gli argomenti. Inoltre, per un blocco di codice HTML/JavaScript Webchat.js personalizzato completo, vedere Personalizzare l'aspetto di un agente.

Salva il contesto come variabile in agente

Nell'argomento di sistema Avvio conversazione, aggiungi un nodo "Fare una domanda". Per configurare correttamente l'argomento, ricordati di eseguire le seguenti azioni:

Screenshot della finestra di dialogo delle proprietà delle variabili che l'integrazione delle variabili in Copilot Studio.

Nota

Anche se questo esempio utilizza l'argomento di sistema Avvio conversazione, puoi salvare il contesto ricevuto da una pagina Web in qualsiasi argomento.

Con questa variabile nel tuo agente, puoi usarla per qualsiasi scopo tu voglia, come ottenere i dettagli dell'ordine per l'ID ordine, personalizzare il comportamento della chat per la lingua e così via. Per un esempio di come utilizzare questo concetto per combinare le analisi web e agente, vedere Combina analisi web e agente.