Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit Microsoft Copilot Studio können Sie Ihren Agent mithilfe von Fertigkeiten (Skills) erweitern. Wenn Sie bereits Agents für bestimmte Szenarien in Ihrem Unternehmen erstellt und bereitgestellt haben (mithilfe des Microsoft 365 Agents SDK oder anderer Pro-Code-Tools), können Sie diese Bots in eine Fertigkeit umwandeln und diese Fertigkeit in einem Copilot Studio-Agent registrieren.
Anmerkung
Zum Hinzufügen einer Fertigkeit ü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 -Fähigkeiten vertraut sind.
Sobald Sie sich bei einem Copilot Studio-Agent registrieren, können Sie in der Unterhaltung nahtlos Fertigkeitsaktionen auslösen.
Anforderungen
Wichtig
Copilot Studio-Agents unterstützen nur Skills, die mit Legacy Bot Framework SDK Version 4.12.0+ und Microsoft 365 Agents SDK v1.0.0+ erstellt wurden. Neue Fertigkeiten sollten mit dem Microsoft 365 Agents SDK erstellt werden.
Um eine Fertigkeit zu konfigurieren, legen Sie die zugeordnete App-Registrierung in Microsoft Entra ID für Ihre Fertigkeit auf die Konfiguration mit einem einzelnen Mandanten fest.
Verwendung von Agent-Flows im Vergleich zu Fertigkeiten
Die folgende Tabelle hilft Ihnen herauszufinden, wann für eine Unterhaltung Agent-Flows oder Fertigkeiten eingesetzt werden sollten.
| Faktor | Wann Sie Agent-Flows verwenden sollten | Wann Sie Fertigkeiten verwenden sollten |
|---|---|---|
| Persona | Agent-Autoren können wiederverwendbare Flows erstellen, um sie in jede Agent-Unterhaltung einzubetten | Entwickler können benutzerdefinierte Skills in ihrer eigenen Umgebung erstellen, bereitstellen und hosten |
| Unterhaltungstyp | Verwenden Sie Flows für einfache Vorgänge mit einer Runde. Geben Sie beispielsweise eine Bestellung auf oder erhalten Sie den Bestellstatus. | Nutzen Sie Fertigkeiten 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 implementieren Sie eine Fertigkeit mithilfe von Pro-Code-Tools in Ihrem Unternehmen. Sehen Sie sich diese Beispiele an:
Bevor Sie den Fertigkeit registrieren, geben Sie Ihrem Fertigkeiten-Entwickler die Agent-ID an, damit der Agent Aktionen in der Fertigkeit aufrufen kann. Erfahren Sie mehr über die Liste der erlaubten Fertigkeiten. Sie können die ID Ihres Agents vom Fenster Fertigkeit hinzufügen aus abrufen.
Fügen Sie Ihrem Agent eine Fertigkeit hinzu:
Gehen Sie zu Ihrem Agent.
Wählen Sie Einstellungen>Fertigkeiten aus, um zur Seite „Fertigkeiten“ zu wechseln.
Wählen Sie Eine Fertigkeit hinzufügen aus.
Kopieren Sie Ihre Ihre-ID. Sie müssen die Agent-ID für Ihre Fertigkeitsentwickler bereitstellen.
Geben Sie die URL zum Skillmanifest 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 Ihre Fertigkeit Ihrem Agent hinzugefügt. Sie können diesen Fertigkeit nun in Ihren Themen verwenden.
Überlegungen zur Compliance
Um die Privatsphäre der Benutzer zu schützen, müssen die Fertigkeiten 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 Fertigkeit registrieren.
| Fehlernachricht | Fehlerbehebung/Risikominderung |
|---|---|
| Wir haben Probleme beim Abrufen des Fertigkeitsmanifests 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 Fertigkeit 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, einzel 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 Fertigkeit mit Ihrer Microsoft Entra ID-Anmeldungsregistrierung Publisher domain (bevorzugt) oder Home page URL Feld ü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) |
Überarbeiten Sie den Link, um eine sichere URL hinzuzufügen. |
| 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 Ihrer Fertigkeit 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. Überprüfen Sie auch, ob die App-Registrierung der einzelnen Mandantenfertigkeit für denselben Mandanten bereitgestellt wurde. |
| 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. |