Porre domande con le Schede adattive

Usa un'Adaptive Card per raccogliere informazioni da un utente durante una conversazione con un agente. Una scheda può contenere testo, grafica, pulsanti e campi di input. Per altre informazioni, vedere Use Schede adattive in Copilot Studio.

Con un nodo Scheda adattiva, l'agente può visualizzare una scheda adattiva contenente uno o più pulsanti di invio e, facoltativamente, uno o più campi di input del modulo. L'agente memorizza l'input dell'utente nelle variabili per utilizzarle in un secondo momento nella conversazione.

Copilot Studio include un progettista di schede adattive predefinito, che offre le funzionalità più utili di Schede adattive Designer.

In alternativa, è possibile:

• Utilizza una rappresentazione JSON per la scheda che vuoi mostrare all'utente.
• Utilizza una formula Power Fx per includere informazioni dinamiche nella scheda.

Puoi anche controllare il comportamento della scheda ad esempio cosa fare quando l'utente immette una risposta non valida o se il nodo può essere interrotto.

Il nodo Scheda adattiva è pensato per le schede interattive, in cui l'utente deve inviare una risposta. Usa i nodi Message e Question per presentare all'utente una scheda non interattiva che mostra le informazioni.

Aggiungere un nodo Scheda adattiva

1. Seleziona l'icona Aggiungi nodo sotto il nodo dopo il quale vuoi aggiungere un nodo Adaptive Card. Poi seleziona Chiedi con Adaptive Card.

2. Seleziona i tre punti (...) del nodo, poi seleziona Proprietà.

3. Nel riquadro delle proprietà del nodo della scheda adattiva, seleziona Modifica scheda adattiva. Viene aperto il pannello di progettazione schede adattive.

4. Aggiungi gli elementi desiderati per la tua scheda e configura le relative proprietà. In alternativa, nel riquadro Card payload editor, sostituisci il payload predefinito con il valore letterale JSON della tua scheda.

   Tip

   La scheda deve contenere almeno un pulsante di invio, in quanto deve essere una scheda interattiva che consente a un utente di inviare informazioni all'agente. In caso contrario, se ha solo lo scopo di mostrare informazioni, è necessario aggiungere la scheda adattiva a un nodo Messaggio.

5. Al termine della progettazione iniziale, seleziona Salva e chiudi il pannello di progettazione. Nel nodo viene visualizzata un'anteprima della scheda. Copilot Studio crea automaticamente variabili di output in base agli input specificati nel codice.

   Tip

   Se le variabili di output generate per la scheda non sono corrette, puoi aggiornare manualmente l'elenco delle variabili e i relativi tipi selezionando Modifica schema nel pannello delle proprietà del nodo Scheda adattiva.

   La scheda adattiva interattiva è pronta. Quando un utente del tuo agente seleziona un pulsante di invio su una scheda, le variabili di output vengono popolate con le informazioni fornite dall'utente nell'interazione con la scheda.

Altre proprietà

Usa le altre proprietà per controllare il comportamento del nodo Adaptive Card , come ad esempio:

• Come l'agente risponde a una risposta non valida
• Se può essere interrotto

Se l'agente è in attesa di un invio da una scheda adattiva e l'utente invia invece un messaggio di testo, questa risposta viene considerata non valida, a meno che il messaggio attivi un'interruzione. In questo caso, le seguenti proprietà determinano il comportamento.

• Numero di nuove richieste: il numero di volte in cui l'agente tenta di ottenere un invio valido dalla scheda. Il valore predefinito è Repeat fino a 2 volte. Puoi anche selezionare Ripeti una volta o Non ripetere. Per ogni nuovo tentativo, la scheda viene rispedita all'utente.

• Richiesta di ripetizione dei tentativi: usare questa proprietà per definire un messaggio da inviare quando si verifica un nuovo tentativo, insieme a una ripetizione della scheda. Per definire un messaggio di riprova, selezionare Personalizza e quindi immettere il nuovo prompt.

• Consenti il passaggio a un altro argomento: se questa opzione è selezionata (impostazione predefinita), un messaggio in arrivo da un utente quando l'agente è in attesa dell'invio di una scheda attiva un'interruzione e passa a un altro argomento. Se si verifica un cambio di argomento, la scheda viene nuovamente inviata all'utente al termine dell'argomento di interruzione.

Comportamento del pulsante di invio per gli agenti con schede consecutive

Per impostazione predefinita, le Schede adattive consentono di selezionare più volte i pulsanti di invio. Se un agente ha schede adattive consecutive e l'utente seleziona un pulsante in una scheda precedente, l'utente potrebbe riscontrare un comportamento imprevisto.

Per distinguere le richieste dalle diverse carte, includi dati identificativi in ogni azione di invio e controllili durante l'elaborazione della risposta. In un client personalizzato, gestisci le submission ripetute o obsolete separatamente dall'identificazione dell'azione selezionata.

Utilizzare un identificatore di invio nei dati di Action.Submit

Se l'agente invia più Schede adattive in una conversazione (ad esempio, schede consecutive, ripetizioni o interruzioni), gli utenti potrebbero premere Invia su una scheda precedente. Includere un identificatore nel payload dati di ogni azione di invio e validarlo durante l'elaborazione della risposta.

Example:

{
  "type": "Action.Submit",
  "title": "Confirm",
  "data": {
    "actionSubmitId": "booking_confirm_card_v3_confirm"
  }
}

Questo identificatore fisso distingue l'azione in questo esempio. Non identifica in modo univoco ogni istanza renderizzata della scheda né impedisce automaticamente gli invii duplicati.

Suggerimento per l'esperienza utente di chat Web per evitare clic obsoleti

Alcuni client di chat mantengono cliccabili le schede precedenti dopo che un utente invia una scheda successiva. Se crei un'esperienza chat Web personalizzata, considera di rendere le card inviate di sola lettura o di aggiornare le card precedenti per ridurre gli invii duplicati accidentali o obsoleti.

Usa le interfacce di gestione delle azioni e invio di attività supportate dal client scelto. Mantieni la gestione dell'invio separata dalle altre azioni della scheda e offri un modo per riprovare quando la consegna fallisce. Rendere una scheda in sola lettura è una misura di usabilità lato client, non un sostituto della convalida degli invii nel tuo agente o servizio.

Utilizzare Power Fx per rendere dinamica la scheda

Puoi utilizzare una formula Power Fx per includere informazioni dinamiche nella scheda facendo riferimento alle variabili dell'argomento o dell'agente.

1. Seleziona i tre punti (...) del nodo, poi seleziona Proprietà.

2. Nel pannello Proprietà nodo scheda adattiva passare a Formula. Se si seleziona Formula , la rappresentazione JSON della scheda viene convertita automaticamente in una formula di Power Fx.

   

   Ad esempio, inizia con il seguente valore letterale JSON per una scheda:

   {
     "$schema": "http://adaptivecards.microsoft.com/schemas/adaptive-card.json",
     "type": "AdaptiveCard",
     "version": "1.5",
     "body": [{
         "type": "ColumnSet",
         "columns": [{
             "type": "Column",
             "width": 2,
             "items": [{
                 "type": "TextBlock",
                 "text": "Tell us about yourself",
                 "weight": "Bolder",
                 "size": "Medium",
                 "wrap": true,
                 "style": "heading"
               }, {
                 "type": "TextBlock",
                 "text": "Enter your name to continue with your booking.",
                 "isSubtle": true,
                 "wrap": true
               }, {
                 "type": "Input.Text",
                 "id": "myName",
                 "label": "Your name",
                 "isRequired": true,
                 "errorMessage": "Please enter your name."
               }
             ]
           }
         ]
       }
     ],
     "actions": [{
         "type": "Action.Submit",
         "title": "Submit",
         "data": {
           "actionSubmitId": "trip_details_submit"
         }
       }
     ]
   }
   

   Ecco la formula risultante Power Fx, con due variabili , Topic.Title e Topic.Subtitle, anziché il testo hardcoded del valore letterale JSON. Questo esempio presuppone che le variabili siano definite nell'argomento.

   {
     '$schema': "http://adaptivecards.microsoft.com/schemas/adaptive-card.json",
     type: "AdaptiveCard",
     version: "1.5",
     body: [
       {
         type: "ColumnSet",
         columns: [
           {
             type: "Column",
             width: 2,
             items: [
               {
                 type: "TextBlock",
                 text: Topic.Title,
                 weight: "Bolder",
                 size: "Medium",
                 wrap: true,
                 style: "heading"
               },
               {
                 type: "TextBlock",
                 text: Topic.Subtitle,
                 isSubtle: true,
                 wrap: true
               },
               {
                 type: "Input.Text",
                 id: "myName",
                 label: "Your name",
                 isRequired: true,
                 errorMessage: "Please enter your name."
               }
             ]
           }
         ]
       }
     ],
     actions: [
       {
         type: "Action.Submit",
         title: "Submit",
         data: {
           actionSubmitId: "trip_details_submit"
         }
       }
     ]
   }