Implementieren eines Skills für die Verwendung in Power Virtual Agents

  • Artikel

GILT FÜR: SDK v4

Ein Skill ist ein Bot, der von einem anderen Bot verwendet werden kann. Auf diese Weise können Sie einen einzelnen Bot für die Benutzerinteraktion erstellen und mit Skills erweitern. Weitere allgemeine Informationen zu Skills finden Sie in der Übersicht über Skills. Informationen zu ihrer Erstellung finden Sie unter Implementieren eines Skills. Alternativ enthalten die Vorlagen des virtuellen Assistenten einen Satz vordefinierter Skills, die Sie anpassen und bereitstellen können, anstatt Skills von Grund auf neu zu erstellen.

Wenn Sie davon ausgehen, dass Ihr Skill von einem Power Virtual Agents-Bot verwendet wird, gelten einige zusätzliche Einschränkungen für Ihren Skill, die Sie berücksichtigen sollten.

Einschränkungen beim Manifest

Bei Power Virtual Agents gelten Einschränkungen für Deklarationen in Ihrem Skillmanifest.

  • Sie dürfen maximal 100 Aktionen deklarieren.
  • Jede Aktion ist auf maximal 25 Ein- oder Ausgänge beschränkt.
  • Für Ein- oder Ausgaben darf nicht der Arraytyp verwendet werden.

Einschränkung auf einen Mandanten

Um Compliance und eine angemessene Governance von benutzerdefinierten Skills zu gewährleisten, die für die Verwendung innerhalb von Power Virtual Agents registriert sind, muss Ihr Skillbot eine registrierte Microsoft-Entra-ID-Anwendung sein. Nach dem Hinzufügen eines Skills wird überprüft, ob die Anwendungs-ID des Skills im Mandanten des angemeldeten Benutzers enthalten ist und ob der Skillendpunkt mit der Home Page URL der registrierten Anwendung übereinstimmt.

Bevor Sie Ihren Bot als Skill in Power Virtual Agents registrieren können, müssen Sie sicherstellen, dass die Startseite für den Bot im Azure-Portal auf die URL des Skillmanifests für den Bot festgelegt ist.

Beim Registrieren eines Skills ausgeführte Validierung

Wenn ein Endbenutzer versucht, eine Verbindung mit Ihrem Skill aus dem Power Virtual Agents-Bot herzustellen, muss er zunächst den Skill in Power Virtual Agents importieren. Ihr Skill durchläuft dann eine Reihe von Validierungen. Wenn eine dieser Validierungen zu einem Fehler führt, kann eine der Fehlermeldungen ausgegeben werden, die in dieser Tabelle beschrieben sind.

Validierungsschritt Fehlercode Fehlermeldung Beschreibung oder Entschärfung
Manifest-URL ist gültig URL_MALFORMED, URL_NOT_HTTPS Der Link ist ungültig. Der Link muss mit „https://“ beginnen. Geben Sie den Link erneut als sichere URL ein.
Manifest kann abgerufen werden MANIFEST_FETCH_FAILED Das Skillmanifest konnte nicht abgerufen werden. Überprüfen Sie, ob ihre Manifest-URL ein Link zu Ihrem Manifest ist; versuchen Sie, Ihre Manifest-URL in einem Webbrowser zu öffnen. Wenn die URL die Seite innerhalb von 10 Sekunden rendert, registrieren Sie Ihren Fertigkeit erneut.
Manifest ist lesbar MANIFEST_TOO_LARGE Das Manifest ist zu groß. Ihr Manifest darf höchstens 500 KB groß sein.
Manifest ist lesbar MANIFEST_MALFORMED Das Manifest ist nicht kompatibel. Überprüfen Sie, ob das Manifest eine gültige JSON-Datei ist. Überprüfen Sie, ob das Manifest erforderliche Eigenschaften enthält, z. B. name, msaAppIdusw. Weitere Informationen finden Sie unter Manifest-Einschränkungen.
Skill ist noch nicht registriert MANIFEST_ALREADY_IMPORTED Dieser Fertigkeit wurde Ihrem Bot bereits hinzugefügt. Löschen Sie den Skill und registrieren Sie ihn erneut.
Manifest-Endpunkt und Homepage-Domänen stimmen überein MANIFEST_ENDPOINT_ORIGIN_MISMATCH Die Endpunkte Ihres Skills stimmen nicht überein. Die URL-Domäne der Startseite Ihrer Microsoft-Entra-ID-App und die URL-Domäne für das Manifest müssen identisch sein. Weitere Informationen finden Sie unter Einschränkung auf einen Mandanten.
Der Skill wird im Mandanten des angemeldeten Benutzers gehostet APPID_NOT_IN_TENANT Damit ein Skill hinzugefügt werden kann, muss er zunächst registriert werden. Ein globaler Administrator muss den Skill bei der Organisation des angemeldeten Benutzers registrieren.
Aktionen sind eingeschränkt LIMITS_TOO_MANY_ACTIONS Der Fertigkeit ist auf 100 Aktionen begrenzt. Es sind zu viele Fertigkeit-Aktionen im Fertigkeit-Manifest definiert. Entfernen Sie Aktionen, und versuchen Sie es erneut.
Aktionseingabeparameter sind eingeschränkt LIMITS_TOO_MANY_INPUTS Aktionen sind auf 25 Eingaben begrenzt. Es gibt zu viele Eingabeparameter für Fertigkeit-Aktionen. Entfernen Sie Parameter, und versuchen Sie es erneut.
Aktionsausgabeparameter sind eingeschränkt LIMITS_TOO_MANY_OUTPUTS Aktionen sind auf 25 Ausgaben begrenzt. Es gibt zu viele Fertigkeit-Aktions-Ausgabeparameter. Entfernen Sie Parameter, und wiederholen Sie den Vorgang.
Die Anzahl der Skills ist eingeschränkt LIMITS_TOO_MANY_SKILLS Ihr Bot darf maximal 25 Skills umfassen. Es wurden zu viele Fertigkeiten zu einem Bot hinzugefügt. Entfernen Sie einen vorhandenen Fertigkeit und versuchen Sie es erneut.
Sicherheitstoken ist gültig AADERROR_OTHER Offenbar ist ein Fehler aufgetreten. Möglicherweise ist dies ein vorübergehender Fehler, da zunächst ein Sicherheitstoken zum Auslösen des Skills abgerufen werden muss. Versuchen Sie erneut, den Skill zu importieren.
Skill ist fehlerfrei ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Bei der Überprüfung Ihrer Fertigkeit ging etwas schief. Power Virtual Agents hat beim Senden einer EndOfConversation-Aktivität an Ihren Skill eine unbekannte Antwort erhalten. Stellen Sie sicher, dass Ihr Skill ausgeführt wird und ordnungsgemäß reagiert.
Skill ist autorisiert ENDPOINT_HEALTHCHECK_UNAUTHORIZED Diese Fertigkeit erlaubt es nicht, ihren Bot aufzulisten. Prüfen Sie, ob Ihr Bot in die Liste der zugelassenen Skills aufgenommen wurde. Weitere Informationen finden Sie unter Power Virtual Agents – Konfigurieren eines Skills.