Condividi tramite


Visualizzare un modulo con un pulsante Invia in Copilot Studio

Nota

Questo articolo si applica solo ai chatbot classici. Per estendere gli agenti creati in Copilot Studio, non è necessario utilizzare Bot Framework Composer. Tutte le funzionalità descritte in questo articolo sono disponibili per gli agenti, direttamente in Copilot Studio.

Ottimizza un chatbot classico puoi migliorare il tuo bot sviluppando interazioni personalizzate con Bot Framework Composer e quindi aggiungerle a un copilota creato in Copilot Studio.

In questo esempio imparerai come visualizzare un modulo con un pulsante Invia in Copilot Studio utilizzando Composer.

Importante

L'integrazione di Composer non è disponibile per gli utenti che hanno solo la licenza licenza Microsoft Copilot Studio per Teams. Devi avere una licenza Microsoft Copilot Studio di valutazione o completa.

Prerequisiti

Creare un nuovo trigger

  1. In Copilot Studio, apri il copilota dell'esempio 3. Se non hai ancora completato l'esempio 3, vedi Utilizzare Ricerca Bing come fallback in Copilot Studio.

  2. Apri il tuo bot in Composer. Per istruzioni su come procedere, vedi Introduzione a Bot Framework Composer.

  3. In Esplora bot, vai alla finestra di dialogo principale. Seleziona Altre opzioni (...), quindi seleziona Aggiungi nuovo trigger.

  4. Nella finestra Crea trigger:

    1. Per Qual è il tipo di questo trigger?, seleziona Intento riconosciuto.

    2. Per Qual è il nome di questo trigger?, inserisci StartTrial.

    3. Per Frasi trigger, copia e incolla quanto segue:

      - start trial
      - sign up to try
      - register to try service
      
    4. Seleziona Invia.

    Screenshot della finestra Crea un trigger.

  5. Vai alla pagina Risposte bot, seleziona Servizio di consegna pasti Contoso, quindi seleziona Mostra codice.

  6. Copia e incolla quanto segue nella vista codice:

    # adaptivecardjson_StartTrialForm()
    - ```
    {
        "type": "AdaptiveCard",
        "body": [
            {
                "type": "TextBlock",
                "size": "Medium",
                "weight": "Bolder",
                "text": "Register for a meal plan trial:"
            },
            {
                "type": "Input.Text",
                "placeholder": "Please enter your Name",
                "id": "Name"
            },
            {
                "type": "Input.Text",
                "placeholder": "Please enter your Address",
                "id": "Address",
                "isMultiline": true
            },
            {
                "type": "Input.Number",
                "placeholder": "How many weeks",
                "id": "Weeks"
            },
            {
                "type": "ActionSet",
                "actions": [
                    {
                        "type": "Action.Submit",
                        "title": "Submit",
                        "style": "positive"
                    }
                ]
            }
        ],
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.2"
    }
    ```
    

    Ogni campo di input in questa scheda adattiva ha un ID univoco: Nome, Indirizzo e Settimane.

  7. Copia e incolla il seguente codice nella stessa vista codice:

    # AdaptiveCard_StartTrialForm()
    [Activity
        Attachments = ${json(adaptivecardjson_StartTrialForm())}
    ]
    

    Screenshot dell'attività aggiunta alle risposte del bot.

Aggiungi logica conversazione

  1. Vai alla pagina Crea e seleziona il trigger StartTrial.

  2. Nell'area del contenuto, seleziona Aggiungi (+), Fai una domanda, quindi Testo.

  3. Nel riquadro delle proprietà, in Risposte del bot, seleziona Mostra codice.

    Avviso

    Aggiungendo l'espressione nel passaggio successivo all'editor di risposta al posto dell'editor di codice farà sì che il bot risponda con JSON non elaborato invece di una scheda adattiva.

  4. Copia e incolla la seguente espressione:

    - ${AdaptiveCard_StartTrialForm()}
    
  5. Seleziona la scheda Input utente nel riquadro proprietà, quindi esegui le operazioni seguenti:

    1. Per Proprietà, inserisci user.name.
    2. Per Value, inserisci =turn.activity.value.Name.
  6. Nell'area del contenuto, seleziona Aggiungi (+), Gestisci proprietà, quindi seleziona Imposta proprietà.

  7. Nel riquadro Proprietà, esegui le seguenti operazioni:

    1. In Assegnazioni, seleziona Aggiungi nuovo per aggiungere una casella Proprietà e una casella Valore.
    2. Per Proprietà, inserisci user.address
    3. Per Valore, inserisci =turn.activity.value.Address.
    4. Seleziona Aggiungi nuova una seconda volta per aggiungere un'altra Proprietà e un altro Valore.
    5. Per Proprietà, inserisci user.weeks.
    6. Per Valore, inserisci =turn.activity.value.Weeks.
  8. Nell'area del contenuto, seleziona Aggiungi (+) quindi Invia una risposta.

  9. Nell'editor di risposta, copia e incolla quanto segue:

    ${user.name} - thanks for starting a ${user.weeks} week trial with us! Your meals will be delivered to this address: ${user.address}.
    
  10. Nell'area del contenuto, seleziona Aggiungi (+), quindi Inizia un argomento Microsoft Copilot Studio.

  11. Nel riquadro delle proprietà, per Nome finestra di dialogo, seleziona Fine conversazione.

Prova il tuo bot

  1. Pubblica il contenuto del tuo Composer per renderlo disponibile nel tuo copilota in Copilot Studio.

    Importante

    La selezione di Pubblica in Composer rende disponibili le modifiche per il test, ma non pubblica automaticamente il bot.

    Pubblica il tuo bot in Microsoft Copilot Studio per aggiornarlo su tutti i canali a cui è connesso.

  2. Vai alla pagina Argomenti di Copilot Studio per vedere il nuovo argomento StartTrial.

  3. Apri il riquadro Test del bot e assicurati che Tieni traccia tra argomenti sia abilitata. Inserisci il messaggio How do I sign up for a trial? per iniziare la conversazione.