Usa un chatbot classico come skill di Azure servizio Bot in un bot di Azure servizio Bot

Quando usi un chatbot classico come abilità Azure servizio Bot con un bot servizio Bot, il bot servizio Bot verifica se qualcosa che l'utente dice corrisponde alle frasi trigger del chatbot classico. Se c'è una corrispondenza, il bot di servizio Bot passa la conversazione al chatbot classico. Il chatbot classico estrae qualsiasi entità e attiva l'argomento corrispondente.

Per impostare il tuo chatbot classico come skill di Azure servizio Bot:

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

2. Scarica il manifest del set di competenze di Azure servizio Bot per il chatbot classico.

3. Connettersi a un chatbot classico come skill di Azure servizio Bot dal bot servizio Bot.

4. Conferma che il chatbot classico funzioni come una competenza di Azure servizio Bot.

Prerequisites

• Capire come funzionano le competenze di Azure Bot Service.
• 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 dell'app del bot di servizio Bot all'elenco di elementi consentiti per il chatbot classico che si vuole usare come funzione. I bot devono essere all'interno dello 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, apri il chatbot classico che vuoi usare come abilità Azure servizio Bot.

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.

   Caution

   Un chatbot classico non può essere una skill di Azure servizio Bot 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. Selezionare 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 di Azure servizio Bot per il tuo chatbot classico

Tutti i chatbot classici hanno i manifest dei componenti di Azure servizio Bot. Un manifesto delle competenze è un file JSON che include il nome, l'interfaccia e le frasi trigger di una competenza. servizio Bot bot possono utilizzare il manifesto di abilità Azure servizio Bot di un chatbot classico Copilot Studio per configurare una connessione con il chatbot classico che ha prodotto il manifesto.

Un bot servizio Bot utilizza un manifesto delle abilità di Azure servizio Bot per sapere quando attivare il chatbot classico (ad esempio, in risposta a qualcosa che un utente dice).

I manifesti di abilità di Azure servizio Bot per chatbot classici seguono la versione 2.2 dello schema dei manifesti di abilità di servizio Bot e consistono nei 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 Azure servizio Bot manifesti di abilità. Un chatbot classico ha due manifest:

• 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.

Connettiti a un chatbot classico come skill di Azure servizio Bot dal tuo bot

Usa le informazioni del tuo manifest delle competenze di Azure servizio Bot per creare una connessione competenza nel tuo bot servizio Bot.

Scopri di più sulla struttura del manifest delle competenze di Azure servizio Bot in manifest delle competenze di Azure servizio Bot.

La sezione attività del manifesto della skill di Azure servizio Bot contiene gli argomenti disponibili nel tuo chatbot classico.

Puoi implementare un Azure servizio Bot skill consumer nel tuo bot di servizio Bot per chiamare un chatbot classico come Azure servizio Bot skill.

Testa il tuo chatbot classico come skill di Azure servizio Bot con un bot di servizio Bot

Usa il servizio Bot Emulator per testare che il tuo bot servizio Bot stia chiamando correttamente un chatbot classico come skill di Azure servizio Bot.

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

L'illustrazione seguente mostra lo scenario in cui un bot di Azure servizio Bot chiama un chatbot classico per usarlo come skill di Azure servizio Bot.

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 Azure servizio Bot: Negli scenari in cui il chatbot Copilot Studio è già distribuito nello stesso tenant del bot servizio Bot ed è usato solo da questo bot, aggiornare il bot Azure servizio Bot a una configurazione a un solo tenant e poi ridistribuire. Scopri di più in Effettua il provisioning e pubblica un bot.

• Chatbot Copilot Studio che non può essere aggiornato a single-tenant: Negli scenari in cui il chatbot di Copilot Studio è già distribuito nello stesso tenant del bot servizio Bot, ma il bot non può essere aggiornato a single-tenant, aggiorna il codice nel bot servizio Bot per creare il token per 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 approvata, il che probabilmente richiede di seguire i passaggi in Converti una competenza di Azure servizio Bot esistente da multitenant a single-tenant.

Informazioni correlate

• Azure servizio Bot panoramica delle competenze
• Azure servizio Bot manifest delle competenze
• Testare un'abilità di Azure servizio Bot nell'Emulator