Condividi tramite

Implementare una competenza da usare in Copilot Studio

  • Articolo

SI APPLICA A: SDK v4

Una competenza è un bot che può essere usato da un altro bot. In questo modo, è possibile creare un singolo bot rivolto all'utente ed estenderlo con una o più competenze. Per altre informazioni sulle competenze in generale, vedere Panoramica delle competenze e la procedura per compilarle in Implementare una competenza. In alternativa, i modelli di Assistente virtuale contengono un set di competenze predefinite che è possibile personalizzare e distribuire anziché crearne uno da zero.

Se prevedi che la tua competenza verrà usata da un copilota di Copilot Studio , ci sono altre restrizioni che devi tenere conto della tua competenza.

Restrizioni per il manifesto

Copilot Studio pone restrizioni su ciò che è possibile dichiarare nel manifesto della competenza.

  • È possibile dichiarare solo 100 o meno azioni.
  • Ogni azione ha un limite massimo di 25 input o output.
  • Non è possibile usare il tipo di matrice per input o output.

Restrizione per lo stesso tenant

Per garantire la conformità e una governance adeguata delle competenze personalizzate registrate per l'uso in Copilot Studio, il bot di competenza deve essere un'applicazione registrata in Microsoft Entra ID. Dopo aver aggiunto una competenza, viene convalidato se l'ID applicazione della competenza si trova nel tenant dell'utente connesso e l'endpoint di competenze corrisponde a quello dell'applicazione Home Page URLregistrata.

Prima di poter registrare il bot come competenza all'interno di Copilot Studio, è necessario assicurarsi che per il bot la home page nel portale di Azure sia impostata sull'URL del manifesto della competenza del bot.

Convalida eseguita durante la registrazione di una competenza

Quando un utente finale tenta di connettersi alla competenza dal copilota, dovrà prima importare la competenza in Copilot Studio. La competenza esegue una serie di controlli di convalida. Un errore di uno di questi controlli potrebbe generare un messaggio di errore come descritto in questa tabella.

Controllo di convalida Codice di errore Error message Descrizione o mitigazione
URL manifesto valido URL_MALFORMED, URL_NOT_HTTPS The link isn't valid; The link must begin with https:// (Collegamento non valido; il collegamento deve iniziare con https://) Immettere nuovamente il collegamento come URL sicuro.
Il manifesto è recuperabile MANIFEST_FETCH_FAILED We ran into problems getting the skill manifest (Si sono verificati problemi durante il recupero del manifesto della competenza). Verificare che l'URL del manifesto sia un collegamento al manifesto; provare ad aprire l'URL del manifesto in un Web browser. Se l'URL visualizza la pagina entro 10 secondi, registra nuovamente la tua competenza.
Il manifesto è leggibile MANIFEST_TOO_LARGE Il manifesto è troppo grande. Il manifesto deve essere di almeno 500 KB.
Il manifesto è leggibile MANIFEST_MALFORMED Il manifest è incompatibile. Controllare se il manifesto è un file JSON valido. Controllare se il manifesto contiene proprietà obbligatorie, ad esempio name, msaAppIde così via. Per altre informazioni, vedere Restrizioni del manifesto.
La competenza non è ancora registrata MANIFEST_ALREADY_IMPORTED Questa competenza è già stata aggiunta al tuo bot. Eliminare la competenza e registrarla di nuovo.
Corrispondenza tra endpoint manifesto e domini della home page MANIFEST_ENDPOINT_ORIGIN_MISMATCH There's a mismatch in your skill endpoints. (Gli endpoint della competenza non corrispondono). È necessario che il dominio URL e il dominio URL del manifesto dell'app Microsoft Entra ID corrispondano. Vedere Restrizione per lo stesso tenant
La competenza è ospitata nel tenant dell'utente connesso APPID_NOT_IN_TENANT To add a skill, it must first be registered (Per aggiungere una competenza, è necessario prima registrarla). Un amministratore globale deve registrare la competenza nell'organizzazione dell'utente che ha eseguito l'accesso.
Le azioni sono limitate LIMITS_TOO_MANY_ACTIONS La competenza è limitata a 100 azioni. Esistono troppe azioni di competenza definite nel manifest della competenza. Rimuovi le azioni e riprova.
I parametri di input dell'azione sono limitati LIMITS_TOO_MANY_INPUTS Le azioni sono limitate a 25 input. Esistono troppi parametri di input dell'azione di competenza. Rimuovi i parametri e riprova.
I parametri di output delle azioni sono limitati LIMITS_TOO_MANY_OUTPUTS Le azioni sono limitate a 25 output. Esistono troppi parametri di output dell'azione di competenza. Rimuovere i parametri e riprovare.
Il numero di competenze è limitato LIMITS_TOO_MANY_SKILLS Your bot can have a maximum of 25 skills (Il bot può contenere un massimo di 25 competenze). Ci sono troppe competenze aggiunte in un bot. Rimuovi una competenza esistente e riprova.
Token di sicurezza valido AADERROR_OTHER It looks like something went wrong (Si è verificato un errore). Potrebbe verificarsi un errore temporaneo per acquisire un token di sicurezza per attivare la competenza. Riprovare a importare la competenza.
La competenza è integra ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Si è verificato un errore durante il controllo della competenza. Copilot Studio ha ricevuto una risposta sconosciuta quando si invia un'attività EndOfConversation alla competenza. Assicurarsi che la competenza sia in esecuzione e risponda correttamente.
La competenza è autorizzata ENDPOINT_HEALTHCHECK_UNAUTHORIZED Questa competenza non ha consentito il bot. Controllare se il bot si trova nell'elenco di elementi consentiti della competenza. Per altre informazioni, vedere Copilot Studio come configurare una competenza.