Implementare una competenza da usare in Power Virtual Agents

  • 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 dell'assistente virtuale includono un set di competenze predefinite che è possibile personalizzare e distribuire invece di crearne una da zero.

Se si prevede che la competenza venga usata da un bot di Power Virtual Agents , è necessario tenere conto di alcune restrizioni aggiuntive per la competenza.

Restrizioni per il manifesto

Power Virtual Agents impone restrizioni sugli elementi che possono essere dichiarati nel manifesto delle competenze.

  • È 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 Power Virtual Agents, il bot di competenza deve essere un'applicazione registrata in Microsoft Entra ID. Quando si aggiunge una competenza, viene verificato se l'ID dell'applicazione relativo è presente nel tenant dell'utente connesso e se l'endpoint della competenza corrisponde all'oggetto Home Page URL dell'applicazione registrata.

Prima di poter registrare il bot come competenza all'interno di Power Virtual Agents, è 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 prova a connettersi alla competenza dal bot di Power Virtual Agents, dovrà prima di tutto importare la competenza in Power Virtual Agents. La competenza verrà sottoposta a una serie di controlli di convalida. Un errore in uno di questi controlli può generare un messaggio come descritto in questa tabella.

Controllo di convalida Codice di errore Messaggio di errore 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://) Immetti 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 essersi verificato un errore temporaneo nell'acquisizione di 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. Power Virtual Agents 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 è stato aggiunto all'elenco di elementi consentiti della competenza. Per altre informazioni, vedere Power Virtual Agents how to Configure a Skill .For more information, see the Power Virtual Agents how to Configure a Skill.