Bot Framework-Skill zur Nutzung in Copilot Studio konfigurieren

Artikel
02/18/2025

Copilot Studio ermöglicht es Ihnen, Ihren Agent mit Bot Framework-Fähigkeiten zu erweitern. Wenn Sie bereits Bots in Ihrer Organisation für bestimmte Szenarien erstellt und bereitgestellt haben (mithilfe von Bot Framework SDK- und Pro-Code-Tools), können Sie diese Bots in eine Fähigkeit umwandeln und diese Fähigkeit in einem Copilot Studio-Agent registrieren.

Anmerkung

Zum Hinzufügen eines Skills über die Copilot Studio-App in Microsoft Teams, brauchen Sie ein Microsoft Copilot Studio Standalone-Abonnement.

Dieser Artikel richtet sich an Systemadministratoren oder IT-Experten, die mit diesen Bot Framework-Fähigkeiten vertraut sind. Nachdem eine Fertigkeit bei einem Copilot Studio-Agent registriert wurde, können Autoren nahtlos Fertigkeitsaktionen im Gespräch auslösen.

Anforderungen

Überprüfen Sie die Einschränkungen und die Prüfung der Fertigkeiten, die in Copilot Studio verwendet werden

Wichtig

Copilot Studio-Agent unterstützen nur Fähigkeiten, die mit Bot Framework SDK-Version 4.12.0+ erstellt wurden.

Klassische Chatbots unterstützen nur Fertigkeiten, die über die Bot Framework SDK-Version 4.7+ erstellt wurden.

Wenn Sie Bot Framework Composer verwenden, wird dringend empfohlen, Composer 2.x zu verwenden. Wenn Sie einen vorhandenen Composer 1.x-Agent verwenden möchten, migrieren Sie es zuerst auf Composer 2.x, bevor Sie es als Skill verwenden.

Um einen Skill zu konfigurieren, sollte die zugehörige App-Registrierung in Microsoft Entra ID für Ihren Skill auf die mehrinstanzenfähige Konfiguration festgelegt werden.

Flow-Aktionen und Skill-Aktionen

Die folgende Tabelle hilft bei der Bestimmung, wann Skills für ein Gespräch eingesetzt werden sollten.

	Flow-Aktionen	Fertigkeitsaktionen
Persona	Agent-Autoren können wiederverwendbare Flows erstellen, um sie in jede Agent-Konversation einzubetten	Entwickler können benutzerdefinierte Skills in ihrer eigenen Umgebung erstellen, bereitstellen und hosten
Unterhaltung	Verwenden Sie Flows für einfache Vorgänge mit einer Runde. Geben Sie beispielsweise eine Bestellung auf oder erhalten Sie den Bestellstatus.	Nutzen Sie Skills für komplexe Multiturn-Operationen. Planen Sie beispielsweise ein Meeting oder buchen Sie einen Flug.
Antwort	Verwenden Sie Flows, um eine Agent-Antwort auszugeben. Zeigen Sie beispielsweise eine personalisierte Nachricht oder Inline-Bilder an.	Nutzen Sie die Fertigkeiten, um jede unterstützte Agent-Antwort auszusenden. Zeigen Sie beispielsweise eine adaptive Karte oder senden Sie zufällige Antworten.
Aktionen	Verwenden Sie Flows, um serverseitige Aktionen mit einer Runde auszulösen. Rufen Sie beispielsweise eine HTTP-API auf oder lösen Sie einen benutzerdefinierten Connector aus.	Einsatz von Skills zum Auslösen server- und clientseitiger Ereignisse und Aktionen. Navigieren Sie beispielsweise bei einer Agent-Antwort zu einer Seite.

Einen Skill konfigurieren

Verwenden Sie zunächst Copilot Studio, um einen Agent zu erstellen und erstellen und stellen Sie die Skills mit den Pro-Code Tools in Ihrem Unternehmen bereit.

Bevor Sie den Fertigkeit registrieren, geben Sie Ihrem Fertigkeiten-Entwickler die Agent-ID an, damit der Agent Aktionen in der Fertigkeit aufrufen kann. Mehr über die Fertigkeit allowlist erfahren. Sie können die ID Ihres Agents vom Fenster Fertigkeit hinzufügen aus abrufen.

Fügen Sie Ihrem Agent eine Fertigkeit hinzu:

Erweitern Sie im Navigationsbereich die Option Einstellungen, und wählen Sie Skills aus.
Wählen Sie oben auf der Skills-Seite die Option Skill hinzufügen aus.
Kopieren Sie die ID Ihres Agents und teilen Sie diese Ihrem Fertigkeit-Entwickler mit.
Geben Sie die URL zum Skill-Manifest ein. Das Manifest einer Fertigkeit enthält die Informationen, die Ihr Agent benötigt, um Aktionen innerhalb einer Fertigkeit auszulösen.
Wählen Sie Weiter aus, um den Überprüfungsprozess zu starten. Sobald die Validierung erfolgreich war, wird Ihr Skill Ihrem Agent hinzugefügt. Sie können diesen Skill nun in Ihren Themen verwenden.

Überlegungen zur Compliance

Um die Privatsphäre der Benutzer zu schützen, müssen die Skills als Apps im Microsoft Entra ID-Mandant des angemeldeten Benutzers registriert werden.

Fehlerbehebung bei der Registrierung von Skills

Eine Reihe von Validierungsprüfungen wird anhand der URL durchgeführt. Diese Überprüfungen gewährleisten die Compliance, Governance und Benutzerfreundlichkeit der Fertigkeit, der Ihrem Agent hinzugefügt wird. Sie müssen diese Fehler beheben, bevor Sie eine Fähigkeit registrieren können.

Fehlermeldung	Fehlerbehebung/Risikominderung
Wir haben Probleme beim Abrufen des Skillmanifests festgestellt. (`MANIFEST_FETCH_FAILED`)	Versuchen Sie, Ihre Manifest-URL in einem Webbrowser zu öffnen. Wenn die URL die Seite innerhalb von 10 Sekunden rendert, registrieren Sie Ihren Skill erneut.
Das Manifest ist nicht kompatibel. (`MANIFEST_MALFORMED`)	(a) Überprüfen Sie, ob das Manifest eine gültige JSON-Datei ist. (b) Überprüfen Sie, ob das Manifest erforderliche Eigenschaften enthält Zum Beispiel, (`name`, `msaAppId`, Single `endpoint`, `activities`/`id`, `activities`/`description`, `activities`/`type` (nur `event` oder `message` unterstützt)).
Ihre Endpunkte weisen eine Nichtübereinstimmung auf (`MANIFEST_ENDPOINT_ORIGIN_MISMATCH`)	Prüfen Sie, ob der Endpunkt Ihres Skills mit dem Feld `Publisher domain` (bevorzugt) oder `Home page URL` Ihrer Microsoft Entra ID-Anwendungsregistrierung übereinstimmt. Weitere Informationen zum Festlegen der Startseite für Endpunkte.
Zum Hinzufügen eines Skills muss dieser zuerst registriert werden. (`APPID_NOT_IN_TENANT`)	Überprüfen Sie, ob die Anwendungs-ID Ihrer Fähigkeit im Microsoft Entra ID-Mandanten Ihrer Organisation registriert ist.
Der Link ist ungültig. Der Link muss beginnen mit https:// (`URL_MALFORMED`, `URL_NOT_HTTPS`)	Geben Sie den Link erneut als sichere URL ein.
Das Manifest ist zu groß. (`MANIFEST_TOO_LARGE`)	Überprüfen Sie die Größe des Manifests. Es muss kleiner oder gleich 500 KB sein.
Dieser Fertigkeit wurde Ihrem Agent bereits hinzugefügt. (`MANIFEST_ALREADY_IMPORTED`)	Löschen Sie den Skill, und versuchen Sie die Registrierung erneut.
Der Skill ist auf 100 Aktionen begrenzt. (`LIMITS_TOO_MANY_ACTIONS`)	Es sind zu viele Skill-Aktionen im Skill-Manifest definiert. Entfernen Sie Aktionen, und versuchen Sie es erneut.
Aktionen sind auf 25 Eingaben begrenzt. (`LIMITS_TOO_MANY_INPUTS`)	Es gibt zu viele Eingabeparameter für Skill-Aktionen. Entfernen Sie Parameter, und versuchen Sie es erneut.
Aktionen sind auf 25 Ausgaben begrenzt. (`LIMITS_TOO_MANY_OUTPUTS`)	Es gibt zu viele Skill-Aktions-Ausgabeparameter. Entfernen Sie Parameter, und versuchen Sie es erneut.
Ihr Agent kann maximal 100 Fertigkeiten haben. (`LIMITS_TOO_MANY_SKILLS`)	Es wurden zu viele Fertigkeiten zu einem Agent hinzugefügt. Entfernen Sie einen vorhandenen Skill und versuchen Sie es erneut.
Anscheinend ist ein Fehler aufgetreten. (`AADERROR_OTHER`)	Bei der Validierung Ihres Skills ist ein vorübergehender Fehler aufgetreten. Wiederholen.
Bei der Überprüfung Ihres Skills ging etwas schief. (`ENDPOINT_HEALTHCHECK_FAILED`, `HEALTH_PING_FAILED`)	Prüfen Sie, ob der Endpunkt Ihres Skills online ist und auf Nachrichten reagiert.
Diese Fähigkeit hat Ihren Agent nicht zugelassen (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`)	Prüfen Sie, ob Ihr Agent zur Liste der erlaubten Fertigkeiten hinzugefügt wurde.

Freigeben über