Usare un chatbot classico come abilità nel bot di Bot Service

Quando si usa un chatbot classico come skill con un bot Bot Service, il bot Bot Service 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 Bot Service 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 dal servizio Bot Service.

Aggiungere il bot Bot Service 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 Bot Service 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 Bot Service.

   Copilot Studio convalida l'ID app del bot Bot Service 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

Bot Service 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 Bot Service 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 Bot Service e sono costituiti da file intents.lu e manifest.json.

In base ai dati del manifesto, un bot Bot Service 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 Bot Service 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 Bot Service 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 Bot Service chiama un chatbot classico per usarlo come abilità.

Sia il bot Bot Service 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 Bot Service richiede un token dal tenant Bot Service e usa questo token per eseguire l'autenticazione a Copilot Studio usando Azure Bot Service. Copilot Studio usa lo stesso meccanismo per contattare il bot Bot Service.

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 Bot Service: negli scenari in cui il chatbot di Copilot Studio è già distribuito nello stesso tenant del bot Bot Service e viene usato solo da questo bot, aggiornare il bot a una configurazione a tenant singolo, quindi ridistribuire il bot Bot Service. Per altre informazioni su come configurare un bot di Bot Service per un tenant singolo, vedere Provision e pubblicare un bot.

• Chatbot di Copilot Studio non aggiornabile a tenant singolo: negli scenari in cui il chatbot di Copilot Studio è già distribuito nello stesso tenant del bot di Bot Service, ma non può essere aggiornato a tenant singolo, aggiornare il codice del bot del servizio Bot per creare il token necessario a comunicare con il chatbot di Copilot Studio. 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 pertinenti

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