Bot Framework-Skill zur Nutzung in Copilot Studio konfigurieren

Artikel
08/12/2024

Mithilfe von Copilot Studio können Sie Ihren Copiloten über die Bot Framework-Skills erweitern. Wenn Sie bereits Bots in Ihrer Organisation für bestimmte Szenarien erstellt und bereitgestellt haben (mithilfe der Bot Framework SDK- und Pro-Code-Tools), können Sie diese Bots in einen Skill umwandeln und diese in einem Copilot Studio-Copiloten 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. Sobald ein Skill bei einem Copilot Studio-Copilot registriert wurde, können Autoren nahtlos Skillaktionen in der Unterhaltung auslösen.

Anforderungen

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

Wichtig

Copilot Studio-Copiloten unterstützen nur Skills, die über die 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-Copiloten 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-Registrierungs in Microsoft Entra ID für Ihren Skill auf Multi-Tenant-Konfiguration eingestellt sein.

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	Copilot-Autoren können wiederverwendbare Flows erstellen, um sie in jeder Copilot-Unterhaltung 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.
Response	Verwenden Sie Flows, um eine Copilot-Antwort auszugeben. Zeigen Sie beispielsweise eine personalisierte Nachricht oder Inline-Bilder an.	Nutzen Sie die Skills, um jede unterstützte Copilot-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 Copilot-Antwort zu einer Seite.

Einen Skill konfigurieren

Verwenden Sie zunächst Copilot Studio, um einen Copiloten zu erstellen, und erstellen Sie einen Skill mithilfe der Pro-Code Tools, den Sie in Ihrem Unternehmen bereitstellen.

Bevor Sie den Skill registrieren, geben Sie Ihrem Skill-Entwicklungsmitarbeitenden die Copilot-ID an, damit der Copilot Aktionen im Skill aufrufen kann. Mehr über die Fertigkeit allowlist erfahren. Sie können die ID Ihres Copiloten über das Fenster Einen Skill hinzufügen abrufen.

So fügen Sie Ihrem Copiloten einen Skill 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 Copiloten und teilen Sie diese Ihrem Skill-Entwickler mit.
Geben Sie die URL zum Skill-Manifest ein. Das Manifest eines Skills enthält die Informationen, die Ihr Copilot benötigt, um Aktionen innerhalb eines Skills auszulösen.
Wählen Sie Weiter aus, um den Überprüfungsprozess zu starten. Sobald die Prüfung erfolgreich ist, wird Ihr Skill Ihrem Copiloten 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 des Skills, der Ihrem Copiloten 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 Skill wurde Ihrem Copiloten 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 Copilot kann maximal 100 Skills haben. (`LIMITS_TOO_MANY_SKILLS`)	Es wurden zu viele Skills zu einem Copiloten 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 Copiloten (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`) nicht zugelassen	Prüfen Sie, ob Ihr Copilot der Skill-Positivliste hinzugefügt wurde.

Freigeben über