Usare un chatbot classico come competenza in un bot Bot Framework

Quando usi un copilota Microsoft Copilot Studio come competenza con un Bot Framework, il Bot Framework determina se qualcosa che l'utente dice corrisponde a una frase trigger del copilota Microsoft Copilot Studio. Se c'è una corrispondenza, il Bot Framework passa la conversazione al bot Microsoft Copilot Studio. Il copilota Microsoft Copilot Studio estrae qualsiasi entità e attiva l'argomento corrispondente.

Puoi anche passare una variabile a un argomento di competenza Microsoft Copilot Studio come input da Bot Framework Composer e utilizzare gli output che restituisce.

Per configurare il tuo copilota Microsoft Copilot Studio come competenza:

1. Aggiungi il Bot Framework all'elenco degli elementi consentiti del copilota Microsoft Copilot Studio.
2. Scarica il manifesto della competenza per il copilota Microsoft Copilot Studio.
3. Usa il manifesto della competenza scaricato in Bot Framework Composer per creare una connessione tra i bot.
4. Usa l'emulatore Bot Framework per confermare che il bot funziona come competenza.

Prerequisiti

• Capire funzionano come le competenze Bot Framework.
• Comprendere l'utilizzo di Bot Framework Composer.
• Comprendere l'utilizzo delle competenze in Bot Framework Composer.
• Ottenere l'ID app del Bot Framework.

Aggiungere il Bot Framework all'elenco degli elementi consentiti del copilota Microsoft Copilot Studio

Aggiungere l'ID app del Bot Framework nell'elenco degli elementi consentiti del copilota Microsoft Copilot Studio 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 Microsoft Copilot Studio, apri il copilota che desideri utilizzare 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 copilota Microsoft Copilot Studio non può fungere da competenza per altri copiloti Microsoft Copilot Studio. 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.

   Microsoft Copilot Studio convalida l'ID app del Bot Framework e conferma che appartiene a un bot distribuito 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.

Scaricare il manifesto della competenza per il copilota Microsoft Copilot Studio

I bot Bot Framework possono usare un manifesto delle competenze Microsoft Copilot Studio per configurare una connessione al copilota che ha prodotto il manifesto.

Tutti i copiloti Microsoft Copilot Studio hanno i manifesti della competenza. Si tratta di file JSON che includono il nome, l'interfaccia e le frasi trigger di una competenza.

Il Bot Framework può usare il manifesto della competenza per sapere quando attivare il bot Microsoft Copilot Studio (ad esempio, in risposta a qualcosa che un utente dice al bot).

I manifesti della competenza Microsoft Copilot Studio seguono la versione 2.2 dello schema del manifesto della competenza Bot Framework e consistono nei file intents.lu e manifest.json.

Un Bot Framework può decidere che un copilota Microsoft Copilot Studio deve gestire la richiesta dell'utente, in base ai dati del manifesto. Passa al copilota tutto ciò che l'utente ha detto. Il copilota Microsoft Copilot Studio corrisponde le frasi dell'utente ad un argomento Microsoft Copilot Studio, estrae qualsiasi entità necessaria per il riempimento degli slot, e attiva l'argomento Microsoft Copilot Studio.

I manifesti della competenza Microsoft Copilot Studio vengono generati e aggiornati automaticamente. Un copilota Microsoft Copilot Studio ha due manifesti della competenza:

• Manifesto di test: consente al bot Bot Framework di connettersi alla versione di prova del copilota Microsoft Copilot Studio. Usa il manifesto di test per convalidare le modifiche alla tua competenza prima di pubblicarla.

  • Il manifesto di test è immediatamente disponibile per ogni nuovo bot Microsoft Copilot Studio creato.
  • Viene aggiornato automaticamente per riflettere le modifiche ogni volta che salvi il copilota.

• Manifesto pubblicato: consente al bot Bot Framework di connettersi alla versione pubblicata del copilota Microsoft Copilot Studio.

  • Il manifesto pubblicato è disponibile solo per i copiloti Microsoft Copilot Studio che sono stati pubblicati almeno una volta.
  • Viene aggiornato automaticamente per riflettere le modifiche ogni volta che pubblichi il copilota.

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 name>_manifesto per il manifesto pubblicato o <bot name>_manifesto_test per il manifesto di test.

Connessione a una competenza Microsoft Copilot Studio in Composer

Usa i manifesti della competenza Microsoft Copilot Studio per creare una connessione di competenza nel bot Bot Framework in Composer.

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

   

2. Sfoglia e seleziona un file .zip del manifesto Microsoft Copilot Studio quindi seleziona Avanti.

   

3. Seleziona gli argomenti o gli intenti nel copilota Microsoft Copilot Studio che vuoi aggiungere al tuo Bot Framework e seleziona Avanti.

   

4. Rivedi e modifica le frasi trigger del copilota Microsoft Copilot Studio e seleziona Avanti.

   

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

   

6. Verifica che la competenza Microsoft Copilot Studio sia aggiunta al bot Bot Framework correttamente e un nuovo trigger con il nome del tuo copilota Microsoft Copilot Studio sia aggiunto al progetto in Composer.

   

Individuare l'argomento nel manifest della competenza

Usa un evento per attivare un argomento Microsoft Copilot Studio nella 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 dal copilota Microsoft Copilot Studio.

   

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

   Nell'esempio seguente, il nome dell'attività dell'evento è dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

   

Chiamare un argomento della competenza di Microsoft Copilot Studio

Invece di fare affidamento su ciò che dice un utente per attivare un argomento di competenza Microsoft Copilot Studio, puoi chiamarlo direttamente. Gli argomenti Microsoft Copilot Studio elencati nel manifesto della competenza possono essere richiamati direttamente.

1. Nel canvas di creazione di Composer seleziona Aggiungi, quindi seleziona Accedi a risorse esterne, quindi seleziona Connetti una competenza.

   

2. Nell'elenco Nome finestra di dialogo competenza, seleziona il tuo copilota Microsoft Copilot Studio.

   

3. Individua il nome dell'attività dell'evento per l'argomento del bot Microsoft Copilot Studio che vuoi chiamare. Copia il valore, omettendo le virgolette, e salvalo per utilizzarlo nei passaggi successivi.

4. Selezionare 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
   ]
   

   

Passare una variabile di input a un argomento della competenza Microsoft Copilot Studio

Bot Framework Composer può passare una variabile a un argomento della competenza Microsoft Copilot Studio come input. Per imparare a creare argomenti di Microsoft Copilot Studio che accettano variabili di input, vedi Utilizzo di variabili.

Se un argomento Microsoft Copilot Studio che può ricevere una variabile di input è elencato nel tuo manifesto della competenza, puoi passargli una variabile Composer.

1. Nel canvas di creazione di Composer seleziona Aggiungi, quindi seleziona Accedi a risorse esterne, quindi seleziona Connetti una competenza.

   

2. Nell'elenco Nome finestra di dialogo competenza, seleziona il tuo copilota Microsoft Copilot Studio.

   

3. Individua il nome dell'attività dell'evento per l'argomento del copiota Microsoft Copilot Studio 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 un argomento Microsoft Copilot Studio non ha input, non contiene una proprietà value.

   

5. Trova la proprietà definitions quindi cerca una proprietà nidificata che corrisponda al valore $ref trovato nel passaggio precedente. Annota i nomi e i tipi di input dell'argomento Microsoft Copilot Studio. 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)}
   ]
   

   Nell'esempio seguente, la variabile Composer dialog.storeLocation fornisce un valore alla variabile di input pva_StoreLocation nell'argomento del copilota Microsoft Copilot Studio dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

   

Ricevere una variabile di output da un argomento della competenza Microsoft Copilot Studio

È possibile ricevere output da un argomento della competenza Microsoft Copilot Studio in Composer. Per imparare a creare argomenti Microsoft Copilot Studio che restituiscono output, vedi Utilizzo di variabili.

1. Nel canvas di creazione di Composer seleziona Aggiungi, quindi seleziona Accedi a risorse esterne, quindi seleziona Connetti una competenza.

   

2. Nell'elenco Nome finestra di dialogo competenza, seleziona il tuo copilota Microsoft Copilot Studio.

   

3. Trova il nome dell'attività dell'evento per l'argomento del bot Microsoft Copilot Studio 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 un argomento Microsoft Copilot Studio non ha output, non contiene una proprietà resultValue.

   

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

   Nell'esempio seguente, l'argomento Microsoft Copilot Studio restituisce due output di tipo Stringa, pva_State e pva_Item.

   

6. Selezionare 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 un argomento della competenza Microsoft Copilot Studio.

   

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.

    Nell'esempio seguente, i valori di output di dialog.skillResult.pvaState e dialog.skillResult.pvaItem vengono estratti nelle nuove variabili Composer dialog.State e dialog.Item.

    

Testare il copilota Microsoft Copilot Studio come competenza con un bot Bot Framework

Usa l'emulatore Bot Framework per testare che il Bot Framework chiami correttamente un copilota Microsoft Copilot Studio come competenza.

Altre informazioni

• Panoramica delle competenze
• Manifesto della competenza
• Documentazione di Bot Framework Composer
• Competenze in Composer
• Connessione a una competenza remota in Composer
• Testare una competenza nell'emulatore