Condividi tramite

Usare un chatbot classico come competenza in un bot Bot Framework

  • Articolo

Nota

Questo articolo include informazioni applicabili solo ai chatbot classici. Copilot Studio Questa funzionalità non è disponibile nella nuova Copilot Studio esperienza.

Quando si utilizza un chatbot classico come competenza con un Bot Framework bot, Bot Framework bot determina se qualcosa di ciò che dice l'utente corrisponde alle frasi grilletto del chatbot classico. Se c'è una corrispondenza, Bot Framework bot passa la conversazione al chatbot classico. Il chatbot classico estrae qualsiasi entità e attiva il corrispondente argomento.

È anche possibile passare una variabile a a Copilot Studio competenza argomento come input da Bot Framework Composer e utilizzare gli output che restituisce.

Importante

Per utilizzare i chatbot classici come capacità è necessario disporre di una licenza di prova o completa. Copilot Studio Questa funzionalità non è disponibile con la licenza Teams Copilot Studio .

Per impostare il tuo chatbot classico come competenza:

  1. Aggiungere Bot Framework bot alla lista consentita per il chatbot classico.

  2. Scarica il manifest competenza per il chatbot classico.

  3. Utilizzare il manifesto competenza scaricato in Bot Framework Composer per creare una connessione tra i bot.

  4. Utilizzare l' Bot Framework emulatore per confermare che bot funziona come competenza.

Prerequisiti

Aggiungi il tuo Bot Framework bot alla lista consentita per il tuo chatbot classico

Aggiungi l'ID app di Bot Framework bot alla lista consentita per il chatbot classico che vuoi usare come competenza. I bot devono essere nello stesso tenant.

  1. In Bot Framework Composer, apri il bot che utilizzerà la competenza. Seleziona Configura, quindi seleziona Risorse di sviluppo. Copia l'ID in ID app Microsoft.

  2. In Copilot Studio, apri il chatbot classico che vuoi usare come competenza.

  3. Nel menu di navigazione, vai a Impostazioni e seleziona Sicurezza. Seleziona Elenco elementi consentiti.

  4. Seleziona Aggiungi chiamante consentito.

  5. Incolla l'ID app del Bot Framework e seleziona Avanti.

    Attenzione

    Un chatbot classico non può fungere da competenza per altri chatbot classici. Se provi ad aggiungere un ID app che appartiene a un bot Power Virtual Agent all'elenco elementi consentiti, riceverai un errore. Puoi aggiungere un ID app solo per un Bot Framework.

    Copilot Studio convalida l'ID app di Bot Framework bot e conferma che appartiene a un bot nello stesso tenant.

  6. (facoltativo) Puoi aggiungere un nome visualizzato per il bot che hai aggiunto all'elenco elementi consentiti.

  7. Seleziona Salva.

Il Bot Framework viene mostrato con il suo nome visualizzato se ne hai inserito uno, o conl'ID app se non hai inserito un nome visualizzato. Per eliminarlo o modificarlo in qualsiasi momento, seleziona l'icona a destra dell'ID app o del nome visualizzato del bot.

Nota

I Bot Framework aggiunti all'elenco elementi consentiti non sono esportati come parte del contenuto del bot.

Scarica il manifesto del chatbot classico competenza per il tuo chatbot classico

Bot Framework i bot possono utilizzare un manifesto competenza per configurare una connessione al chatbot classico che ha prodotto il manifesto. Copilot Studio

Tutti i chatbot classici hanno manifesti competenza. Si tratta di file JSON che includono il nome, l'interfaccia e le frasi trigger di una competenza.

A Bot Framework bot può usare un manifesto competenza per sapere quando grilletto al chatbot classico (ad esempio, in risposta per qualcosa che un utente gli dice).

Copilot Studio competenza manifesta seguire versione 2.2 dello Bot Framework schema del manifesto competenza e consiste nei file intents.lu e manifest.json .

A Bot Framework bot può decidere se un chatbot classico debba gestire la richiesta dell'utente, in base ai dati del manifest. Trasmette al chatbot classico tutto ciò che l'utente ha detto. Quindi, il chatbot classico confronta ciò che l'utente ha detto a un Copilot Studio argomento, estrae tutte le entità necessarie per il riempimento degli slot e attiva Copilot Studio argomento.

Copilot Studio I manifesti competenza vengono generati e aggiornati automaticamente. Un chatbot classico ha due manifesti competenza:

  • Manifest di prova: consente di Bot Framework bot per passare a Connetti la versione di prova del tuo chatbot classico. Usa il manifesto di test per convalidare le modifiche alla tua competenza prima di pubblicarla.

    • Il manifesto di prova è immediatamente disponibile per ogni chatbot classico appena creato.
    • Viene aggiornato automaticamente per riflettere le modifiche ogni volta che salvi il tuo chatbot classico.

  • Manifesto pubblicato: consente di Bot Framework bot in Connetti alla versione pubblicata del tuo chatbot classico.

    • Il manifesto pubblicato è disponibile solo per i chatbot classici che sono stati pubblicati almeno una volta.
    • Viene aggiornato automaticamente per riflettere le modifiche ogni volta che pubblichi il tuo agente.

Nota

Il manifesto pubblicato non è disponibile per i chatbot classici che non sono mai stati pubblicati.

Per generare il manifesto pubblicato del tuo bot, pubblica il tuo chatbot classico.

Entrambi i manifesti della competenza sono visualizzati nel pannello Gestisci elenco elementi consentiti.

I manifesti della competenza vengono visualizzati anche nella pagina Dettagli del copilota. Nel menu di spostamento, seleziona Impostazioni, quindi Dettagli. La pagina Dettagli mostra altri metadati come ID ambiente, ID tenant, e ID app bot.

Per scaricare un manifesto, selezionalo. Viene scaricato come file .zip etichettato _<bot nome>manifesto per il manifesto pubblicato, oppure <bot nome>test__manifesto per il manifesto di prova.

Nota

Il manifesto competenza non include gli argomenti di sistema e le finestre di dialogo del compositore che vengono aggiunti a un chatbot classico. Sono inclusi solo gli argomenti creati dagli autori del copilota e dai trigger di intenti di Composer che gli autori aggiungono al bot.

Connetti a Copilot Studio competenza in Composer

Utilizza i manifesti competenza per creare una connessione competenza nel tuo bot in Composer. Copilot Studio Bot Framework

  1. In un progetto Bot Framework Composer, seleziona + Aggiungi e poi seleziona Connetti una competenza.

  2. Sfoglia e Seleziona un Copilot Studio archivio manifest .zip, quindi Seleziona Avanti.

  3. Seleziona gli argomenti, o intenti, nel tuo chatbot classico che vuoi aggiungere a Bot Framework bot, quindi Seleziona Avanti.

  4. Rivedi e modifica le frasi grilletto per il tuo chatbot classico, quindi Seleziona Avanti.

  5. Assicurati che Usa orchestrazione per progetti con più bot sia selezionato, quindi scegli Continua.

  6. Verifica che Copilot Studio competenza sia stato aggiunto correttamente al tuo Bot Framework bot e che un nuovo grilletto con il nome del tuo chatbot classico appaia nel progetto in Composer.

Individuare l'argomento nel manifest della competenza

Utilizzare un evento per grilletto a Copilot Studio argomento in competenza. Per chiamare uno specifico argomento da Composer, fai riferimento all'argomento con il suo nome dell'evento associato nel manifesto della competenza.

  1. Seleziona l'azione Connetti una competenza.

  2. Sotto Nome finestra di dialogo competenza, seleziona Mostra manifesto competenza.

  3. Trova activities nel manifesto. Questa proprietà contiene proprietà nidificate che rappresentano gli argomenti disponibili nel tuo chatbot classico.

  4. Trova l'argomento che vuoi chiamare e cerca la proprietà name. Quando competenza riceve un evento con questo nome, attiva argomento. Copilot Studio

    In questo esempio, il nome dell'attività evento è dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Chiama un Copilot Studio competenza argomento

Invece di affidarti a ciò che un utente dice per grilletto a Copilot Studio competenza argomento, puoi chiamarlo direttamente. È possibile chiamare direttamente solo gli argomenti elencati nel manifesto competenza. Copilot Studio

  1. Nell'area del contenuto di Composer seleziona Aggiungi, quindi seleziona Accedi a risorse esterne, quindi seleziona Connetti una competenza.

  2. Nell'elenco competenza Nome dialogo , Seleziona il tuo chatbot classico.

  3. Trova il nome dell'attività evento per il chatbot classico argomento che vuoi chiamare. Copia il valore, omettendo le virgolette, e salvalo per utilizzarlo nei passaggi successivi.

  4. Seleziona Chiudi.

  5. Nella sezione Attività seleziona Mostra codice.

  6. Digita o incolla il codice seguente. Sostituisci TOPIC_ACTIVITY_NAME con il nome dell'attività dell'evento dell'argomento. Assicurati che non ci siano virgolette nella proprietà name.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

Passa una variabile di input a a Copilot Studio competenza argomento

Bot Framework Il compositore può passare una variabile a a Copilot Studio competenza argomento come input. Per informazioni su come creare argomenti che accettano variabili di input, vedere Lavorare con le variabili Copilot Studio . ...

Se nel manifesto argomento è elencato un elemento che può ricevere una variabile di input, è possibile passargli una variabile Composer. Copilot Studio

  1. Nell'area del contenuto di Composer seleziona Aggiungi, quindi seleziona Accedi a risorse esterne, quindi seleziona Connetti una competenza.

  2. Nell'elenco competenza Nome dialogo , Seleziona il tuo chatbot classico.

  3. Trova il nome dell'attività evento per il chatbot classico argomento che vuoi chiamare. Copia il valore, omettendo le virgolette, e salvalo per utilizzarlo nei passaggi successivi.

  4. Trova la proprietà value dell'argomento. La proprietà value contiene la proprietà $ref. Copia il valore e salvalo per utilizzarlo nel passaggio successivo.

    Avviso

    Se a Copilot Studio argomento non ha input, non avrà una proprietà value .

  5. Trova la proprietà definitions quindi cerca una proprietà nidificata che corrisponda al valore $ref trovato nel passaggio precedente. Notare i nomi e i tipi degli input di Copilot Studio argomento. Li userai nei prossimi passaggi.

  6. Seleziona Chiudi.

  7. Nella sezione Attività seleziona Mostra codice.

  8. Digita o incolla il codice seguente. Sostituisci questi valori:

    1. Sostituisci TOPIC_ACTIVITY_NAME con il nome dell'attività dell'evento dell'argomento.
    2. Sostituisci PVA_INPUT_VARIABLE con una variabile di input dal tuo argomento.
    3. Sostituisci COMPOSER_INPUT_VARIABLE con una variabile Composer che fornirà un valore.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    In questo esempio, la variabile Composer dialog.storeLocation fornisce un valore alla variabile di input pva_StoreLocation nel chatbot classico argomento dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Ricevi una variabile di output da a Copilot Studio competenza argomento

È possibile ricevere output da a Copilot Studio competenza argomento in Composer. Per informazioni su come creare argomenti che restituiscono output, vedere Lavorare con le variabili. Copilot Studio

  1. Nell'area del contenuto di Composer seleziona Aggiungi, quindi seleziona Accedi a risorse esterne, quindi seleziona Connetti una competenza.

  2. Nell'elenco competenza Nome dialogo , Seleziona il tuo chatbot classico.

  3. Trova il nome dell'attività evento per il tuo chatbot classico argomento che vuoi chiamare. Copia il valore, omettendo le virgolette, e salvalo per utilizzarlo nei passaggi successivi.

  4. Trova la proprietà resultValue dell'argomento. La proprietà resultValue contiene la proprietà $ref. Copia il valore e salvalo per utilizzarlo nel passaggio successivo.

    Avviso

    Se a Copilot Studio argomento non ha output, non avrà una proprietà resultValue .

  5. Trova la proprietà definitions quindi cerca una proprietà nidificata che corrisponda al valore $ref trovato nel passaggio precedente. Notare i nomi e i tipi delle variabili di output di Copilot Studio argomento. Li userai nei prossimi passaggi.

    In questo esempio, Copilot Studio argomento restituisce due output di tipo String, pva_State e pva_Item.

  6. Seleziona Chiudi.

  7. Nella sezione Attività seleziona Mostra codice.

  8. Digita o incolla il codice seguente. Sostituisci TOPIC_ACTIVITY_NAME con il nome dell'attività dell'evento dell'argomento. Assicurati che non ci siano virgolette nella proprietà name.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

  9. Nell'area del codice, imposta Proprietà su una variabile Composer per ricevere e memorizzare i valori di output da Copilot Studio competenza argomento.

  10. Nel canvas di creazione di Composer seleziona Aggiungi, quindi seleziona Gestisci proprietà, quindi seleziona Imposta proprietà.

  11. Imposta Proprietà sul valore Composer che archivia il valore estratto. Quindi imposta Valore sulla variabile Composer in cui hai memorizzato gli output dell'argomento.

    In questo esempio, i valori di output da dialog.skillResult.pvaState e dialog.skillResult.pvaItem vengono estratti nelle nuove variabili Composer dialog.State e dialog.Item.

Prova il tuo chatbot classico come competenza con un Bot Framework bot

Utilizza l' Bot Framework Emulatore per verificare che il tuo Bot Framework bot chiami correttamente un chatbot classico come competenza.

Importante

Affinché la connessione competenza funzioni, il tuo Bot Framework bot deve essere aggiunto alla lista consentita del chatbot classico.

Altre informazioni