Freigeben über

Implementieren einer Fähigkeit zur Verwendung in Copilot Studio

  • 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 benutzerorientierten Bot erstellen und mit einem oder mehreren Fähigkeiten 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 für den virtuellen Assistenten eine Reihe vordefinierter Fähigkeiten , die Sie anpassen und bereitstellen können, anstatt von Grund auf neu zu erstellen.

Wenn Sie davon ausgehen, dass Ihre Fähigkeiten von einem Copilot Studio Copilot genutzt werden, gibt es einige andere Einschränkungen, die Sie berücksichtigen müssen.

Einschränkungen beim Manifest

Copilot Studio legt Einschränkungen für das, was Sie in Ihrem Qualifikationsmanifest deklarieren können.

  • Sie können nur 100 oder weniger 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 sicherzustellen, dass Compliance und angemessene Governance von benutzerdefinierten Fähigkeiten für die Verwendung in Copilot Studio registriert werden, muss Ihr Qualifikations-Bot eine registrierte Anwendung in Microsoft Entra ID sein. Beim Hinzufügen einer Fähigkeit überprüfen wir, ob sich die Anwendungs-ID der Qualifikation im Mandanten des angemeldeten Benutzers befindet und der Kompetenzendpunkt mit dem registrierten Anwendungsendpunkt Home Page URLübereinstimmt.

Bevor Sie Ihren Bot als Fähigkeit in Copilot Studio registrieren können, müssen Sie sicherstellen, dass für den Bot die Startseite im Azure-Portal auf die Url des Bot-Qualifikationsmanifests festgelegt ist.

Beim Registrieren eines Skills ausgeführte Validierung

Wenn ein Endbenutzer versucht, von ihrem Copilot eine Verbindung mit Ihren Fähigkeiten herzustellen, muss er zuerst die Fähigkeit in Copilot Studio importieren. Ihre Fähigkeit durchläuft eine Reihe von Validierungsprüfungen. Ein Fehler einer dieser Prüfungen kann zu einer Fehlermeldung führen, wie in dieser Tabelle beschrieben.

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 als sichere URL erneut 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 tritt ein vorübergehender Fehler auf, um ein Sicherheitstoken zu erhalten, um die Fähigkeit auszulösen. 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. Copilot Studio hat beim Senden einer EndOfConversation Aktivität an Ihre Fähigkeiten eine unbekannte Antwort erhalten. Stellen Sie sicher, dass Ihr Skill ausgeführt wird und ordnungsgemäß reagiert.
Skill ist autorisiert ENDPOINT_HEALTHCHECK_UNAUTHORIZED Diese Fähigkeit hat Ihren Bot nicht zugelassen. Überprüfen Sie, ob Ihr Bot der Zulassungsliste der Fähigkeiten entspricht. Weitere Informationen finden Sie im Copilot Studio zum Konfigurieren einer Fähigkeit.