Configura le skill di Azure servizio Bot da usare negli agenti di Copilot Studio

Note

Questo articolo descrive le caratteristiche utilizzate negli agenti o nei flussi di agenti alimentati dall'imbracatura standard.

Important

Questo articolo include informazioni sulle competenze di Azure servizio Bot, un modo basato su codice per estendere le capacità di un agente nell'infrastruttura standard. Queste abilità non vanno confuse con le abilità agentiche nell’harness di GitHub Copilot. Scopri di più su come utilizzare le abilità agentiche nella panoramica delle Competenze per agenti.

Copilot Studio ti permette di estendere il tuo agente usando le Azure servizio Bot competenze. Se hai già agenti creati e distribuiti nella tua organizzazione (usando il Managed Disks o altri strumenti pro-code) per scenari specifici, puoi convertire quei bot in skill di Azure servizio Bot e registrarle in un agente Copilot Studio.

Note

Per aggiungere una Azure servizio Bot skill dall'app Copilot Studio in Microsoft Teams, devi avere un abbonamento Microsoft Copilot Studio standalone.

Questo articolo è rivolto agli amministratori di sistema o ai professionisti IT che conoscono Azure servizio Bot skills.

Una volta registrata una competenza Azure Bot Framework con un agente Copilot Studio, puoi attivare senza problemi le azioni di competenza di Azure servizio Bot nella conversazione.

Prerequisites

Important

Gli agenti di Copilot Studio supportano solo skills di Azure servizio Bot create utilizzando Legacy Bot Framework SDK versione 4.12.0+ e Managed Disks v1.0.0+. Le nuove abilità Azure servizio Bot dovrebbero essere costruite usando Managed Disks.

Per configurare una competenza di Azure servizio Bot, imposta la registrazione dell'app associata in Microsoft Entra ID per la tua competenza su una configurazione a tenant singolo.

Quando utilizzare i flussi di agenti o le competenze di Azure servizio Bot

La tabella seguente ti aiuta a determinare quando utilizzare i flussi agente o le abilità di Azure servizio Bot per una conversazione.

Fattore Quando utilizzare i flussi di agenti Quando usare le abilità di Azure servizio Bot
Persona Gli autori di agenti possono creare flussi riutilizzabili da incorporare in qualsiasi conversazione di agenti. Gli sviluppatori possono creare, distribuire e ospitare competenze personalizzate nel proprio ambiente.
Tipo di conversazione Utilizza flussi per operazioni semplici a turno singolo. Ad esempio, effettua un ordine o ottieni lo stato dell'ordine. Usa le abilità di Azure servizio Bot per operazioni complesse e multi-turno. Ad esempio, pianifica una riunione o prenota un volo.
Risposta Utilizza i flussi per emettere una risposta dell'agente. Ad esempio, mostra un messaggio personalizzato o immagini inline. Usa le competenze di Azure servizio Bot per generare qualsiasi risposta dell'agente supportata. Ad esempio, mostra una scheda adattiva o invia risposte casuali.
Actions Utilizza i flussi per attivare le azioni a turno singolo lato server. Ad esempio, chiama un'API HTTP o attiva un connettore personalizzato. Usa le abilità di Azure servizio Bot per attivare eventi e azioni sia sul server che sul lato client. Ad esempio, passa a una pagina dopo la risposta dell'agente.

Configura un'abilità di Azure servizio Bot

Per prima cosa, usa Copilot Studio per creare un agente e creare e distribuire una skill di Azure servizio Bot usando strumenti pro-code nella tua organizzazione. Fai riferimento a questi esempi:

Prima di registrare l'abilità Azure servizio Bot, fornisci l'ID dell'agente al tuo sviluppatore così che possa autorizzare l'agente a chiamare azioni nell'abilità. Scopri di più sulla allow list per un'abilità di Azure servizio Bot. Puoi ottenere l'ID dell'agente dalla finestra Aggiungi un'abilità.

Per aggiungere una Azure servizio Bot competenza al tuo agente:

  1. Vai al tuo agente.

  2. Seleziona Impostazioni>Competenze.

  3. Seleziona Aggiungi una competenza.

  4. Copia l'ID agente. Devi fornire l'ID dell'agente al tuo sviluppatore di competenze.

  5. Inserisci l'URL del manifest della competenza di Azure servizio Bot. Il manifest di un'abilità contiene le informazioni di cui il tuo agente ha bisogno per attivare azioni all'interno dell'abilità.

  6. Seleziona Avanti per iniziare il processo di convalida. Quando la convalida ha successo, la tua skill viene aggiunta al tuo agent. Puoi ora usare questa competenza nei tuoi argomenti.

Considerazioni sulla conformità

Per proteggere la privacy dell'utente, devi registrare un'abilità di Azure servizio Bot come app nel tenant Microsoft Entra ID dell'utente connesso.

Risolvere gli errori durante la registrazione delle skill di Azure servizio Bot

Il sistema esegue una serie di controlli di convalida sull'URL. Questi controlli garantiscono la conformità, la governance e l'usabilità della skill che aggiungi al tuo agente. Devi correggere questi errori prima di registrare una competenza di Azure servizio Bot.

Messaggio di errore Risoluzione dei problemi / Mitigazione
Abbiamo avuto problemi a ottenere il manifesto delle abilità.
(MANIFEST_FETCH_FAILED)		 Prova ad aprire l'URL del manifest in un browser Web. Se l'URL visualizza la pagina entro 10 secondi, registra nuovamente la tua competenza.
Il manifesto è incompatibile.
(MANIFEST_MALFORMED)		 (a) Controlla se il manifest è un file JSON valido.
(b) Verificare se il manifesto contiene le proprietà richieste
Ad esempio, (name, msaAppId, singola endpoint, activities/id,activities/description ,activities/type (solo event o message supportata)).
C'è una discrepanza nei tuoi endpoint
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Controlla se l'endpoint della competenza corrisponde al campo della registrazione dell'applicazione Publisher domain (scelta preferita) o Home page URL di Microsoft Entra ID. Ulteriori informazioni sull'impostazione della home page per gli endpoint.
Per aggiungere un'abilità, deve prima essere registrata
(APPID_NOT_IN_TENANT)		 Controllare se l'ID applicazione dell'abilità è registrato nel tenant Microsoft Entra ID dell'organizzazione.
Il link non è valido; Il collegamento deve iniziare con https://
(URL_MALFORMED, URL_NOT_HTTPS)		 Rivedi il collegamento per aggiungere un URL sicuro.
Il manifesto è troppo grande;
(MANIFEST_TOO_LARGE)		 Controlla la dimensione del manifest. Deve essere uguale o minore a 500 KB.
Questa competenza è già stata aggiunta al tuo agente.
(MANIFEST_ALREADY_IMPORTED)		 Elimina l'abilità e prova a ribregistrarla.
La competenza è limitata a 100 azioni.
(LIMITS_TOO_MANY_ACTIONS)		 Esistono troppe azioni di competenza definite nel manifest della competenza. Rimuovi le azioni e riprova.
Le azioni sono limitate a 25 input.
(LIMITS_TOO_MANY_INPUTS)		 Ci sono troppi parametri di input dell'azione di abilità. Rimuovi i parametri e riprova.
Le azioni sono limitate a 25 risultati.
(LIMITS_TOO_MANY_OUTPUTS)		 Esistono troppi parametri di output dell'azione di competenza. Rimuovi i parametri e riprova.
L'agente può avere un massimo di 100 competenze.
(LIMITS_TOO_MANY_SKILLS)		 Ci sono troppe competenze aggiunte in un agente. Rimuovi uno skill esistente e riprova.
Sembra che qualcosa sia andato storto.
(AADERROR_OTHER)		 Si è verificato un errore temporaneo durante la convalida della tua competenza. Riprovare.
Si è verificato un errore durante il controllo della competenza.
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)		 Controlla se l'endpoint della skill è online e sta rispondendo ai messaggi. Verifica anche che la registrazione dell'app della competenza per singolo tenant sia stata distribuita nello stesso tenant.
Questa abilità non ha inserito il tuo agente nell’elenco consentiti
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Controlla se il tuo agente è stato aggiunto all'allow list della skill.
  • Ultimo aggiornamento: