Usare un chatbot classico come funzionalità in un bot di servizio Bot

Quando si usa un chatbot classico come skill con un bot servizio Bot, il bot servizio Bot determina se ciò che l'utente dice corrisponde alle frasi di attivazione del chatbot classico. Se c'è una corrispondenza, il servizio Bot può passare la conversazione al chatbot classico. Il chatbot classico estrae qualsiasi entità e attiva l'argomento corrispondente.

Per configurare il chatbot classico come funzione:

1. Aggiungere il bot servizio Bot all'elenco elementi consentiti per il chatbot classico.

2. Scarica il manifesto della competenza per il chatbot classico.

3. Connetti a un'abilità di Copilot Studio nel tuo bot.

4. Verificare che il bot funzioni come abilità.

Prerequisiti

• Informazioni sul funzionamento delle competenze del servizio Bot.
• Ottieni l'ID dell'app del bot di servizio Bot.

Aggiungere il bot servizio Bot all'elenco elementi consentiti per il chatbot classico

Aggiungere l'ID app del servizio Bot nell'elenco degli elementi consentiti del chatbot classico che vuoi usare come competenza. I bot devono essere nello stesso tenant.

1. Ottenere l'ID app Microsoft per il bot di Bot Services. Queste informazioni sono disponibili nel portale di Azure o nelle configurazioni del bot.

2. In Copilot Studio aprire il chatbot classico che si vuole usare come competenza.

3. Vai su Impostazioni, seleziona Sicurezza e poi seleziona Lista consentita.

4. Seleziona Aggiungi chiamante autorizzato.

5. Incollare l'ID app del bot servizio Bot e selezionare Next.

   Attenzione

   Un chatbot classico non può fungere da competenza per altri chatbot classici. Se provi ad aggiungere un ID app che appartiene a un chatbot classico alla lista dei permessi, ricevi un errore. È possibile aggiungere un ID app solo per un bot servizio Bot.

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

6. (Opzionale) Aggiungi un nome visualizzato per il bot che hai aggiunto alla lista dei permessi.

7. Seleziona Salva.

Il bot del servizio Bot viene mostrato con il suo nome visualizzato se ne hai inserito uno, o con l'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.

Scarica il manifesto delle competenze per il tuo chatbot classico

servizio Bot bot possono usare un manifesto della competenza di Copilot Studio per configurare una connessione al chatbot classico che ha prodotto il manifesto.

Tutti i chatbot classici hanno manifesti delle abilità. Un manifesto delle competenze è un file JSON che include il nome, l'interfaccia e le frasi trigger di una competenza.

Un bot servizio Bot usa un manifesto della competenza per sapere quando attivare il chatbot classico (ad esempio, in risposta a un messaggio che un utente dice).

I manifesti delle competenze di Copilot Studio seguono version 2.2 dello schema del manifesto della competenza servizio Bot e sono costituiti da file intents.lu e manifest.json.

In base ai dati del manifesto, un bot servizio Bot potrebbe decidere che un chatbot classico deve gestire la richiesta dell'utente. Il bot trasmette tutto ciò che l'utente ha detto al chatbot. Poi, il chatbot abbina ciò che l'utente ha detto a un argomento, estrae tutte le entità necessarie per il riempimento degli slot e attiva l'argomento.

Copilot Studio genera e aggiorna automaticamente i manifesti delle competenze. Un chatbot classico ha due manifesti della competenza:

• Test manifest: consente al bot servizio Bot di connettersi alla versione di test del chatbot classico. Usa il manifesto di test per convalidare le modifiche alla tua competenza prima di pubblicarla.

  • Il manifesto di test è immediatamente disponibile per ogni nuovo chatbot classico.
  • Viene aggiornato automaticamente per riflettere i cambiamenti ogni volta che salvi il tuo chatbot classico.

• Manifesto pubblicato: consente al bot del servizio Bot di connettersi 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 i cambiamenti ogni volta che pubblichi il tuo chatbot classico.

Entrambi i manifesti di abilità appaiono nel pannello Gestione della lista dei permessi .

I manifesti delle abilità appaiono anche nella pagina Dettagli del chatbot. Vai su Impostazioni, poi seleziona Dettagli. La pagina Dettagli mostra altri metadati, inclusi Environment ID, Tenant ID e ID Bot app.

Per scaricare un manifesto, selezionalo. Viene scaricato come file .zip etichettato _<bot name>manifest per il manifesto pubblicato o <bot name>test__manifest per il manifesto di test.

Connetti a un'abilità di Copilot Studio nel tuo bot.

Usare le informazioni dal manifest della competenza di Copilot Studio per creare una connessione di competenza nel bot di servizio Bot.

Per ulteriori informazioni sulla struttura del manifesto delle abilità, vedi Manifesto delle competenze.

La sezione delle attività del manifesto della competenza contiene gli argomenti disponibili nel chatbot classico.

È possibile implementare un consumatore di competenze nel bot del servizio Bot per chiamare un chatbot classico come competenza.

Testare il chatbot classico come competenza con un bot del servizio Bot

Usa l'Emulatore del servizio Bot per testare che il tuo bot servizio Bot chiami correttamente un chatbot classico come competenza.

Aggiornare un bot multi-tenant di servizio Bot a un bot a tenant singolo

La figura seguente illustra lo scenario in cui un bot di servizio Bot chiama un chatbot classico per usarlo come abilità.

Sia il bot servizio Bot che il chatbot classico hanno una registrazione dell'app Microsoft Entra ID, a cui fanno riferimento le istanze del bot Azure. Crei queste registrazioni di app Microsoft Entra ID come multitenant. Il bot servizio Bot richiede un token dal tenant servizio Bot e usa questo token per eseguire l'autenticazione a Copilot Studio usando Azure servizio Bot. Copilot Studio usa lo stesso meccanismo per contattare il bot servizio Bot.

Poiché la registrazione dell'applicazione del chatbot di Copilot Studio è ora a tenant singolo, questa comunicazione non funziona più. Microsoft Entra ID rifiuta di creare token per le registrazioni di applicazioni a tenant singolo che non si trovano nello stesso tenant.

Inoltre, Copilot Studio convalida il token in ingresso e rifiuta le richieste dai tenant non previsti, come l'ID del tenant in cui è stata creata la registrazione dell'applicazione del chatbot classico.

Per risolvere questo problema, segui le indicazioni che si applicano alla tua situazione:

• Chatbot classici nello stesso tenant del bot servizio Bot: negli scenari in cui il chatbot di Copilot Studio è già distribuito nello stesso tenant del bot servizio Bot e viene usato solo da questo bot, aggiornare il bot a una configurazione a tenant singolo, quindi ridistribuire il bot servizio Bot. Per altre informazioni su come configurare un bot di servizio Bot per un tenant singolo, vedere Provision e pubblicare un bot.

• Copilot Studio chatbot che non può essere aggiornato per supportare un tenant singolo: negli scenari in cui il Copilot Studio chatbot è già distribuito nello stesso tenant del bot di servizio Bot, ma il bot non può essere aggiornato per supportare un tenant singolo, aggiornare il codice nel bot di servizio Bot per creare un token necessario per comunicare con il Copilot Studio chatbot. Il token deve essere creato per il tenant in cui è stato creato anche il chatbot di Copilot Studio. Inoltre, la risposta deve essere accettata, il che probabilmente richiede di seguire i passaggi descritti in Convertire un skill esistente da multitenant a single-tenant.

Informazioni correlate

• Panoramica delle competenze
• Manifesto della competenza
• Testare una competenza nell'emulatore