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 Copilot Studio können Sie Ihren Agenten mithilfe von skills erweitern. Wenn Sie bereits Agents in Ihrer Organisation (mithilfe der Microsoft 365 Agents SDK oder anderer Pro-Code-Tools) für bestimmte Szenarien erstellt und bereitgestellt haben, können Sie diese Bots in eine Fähigkeit konvertieren und diese Fähigkeiten in einem Copilot Studio-Agent registrieren.
Anmerkung
Um eine Fähigkeit aus der Copilot Studio-App in Microsoft Teams hinzuzufügen, müssen Sie über ein Microsoft Copilot Studio eigenständiges Abonnement verfügen.
Dieser Artikel richtet sich an Systemadministratoren oder IT-Experten, die mit Fähigkeiten vertraut sind.
Nachdem Sie sich bei einem Copilot Studio-Agenten registriert haben, können Sie nahtlos Skill-Aktionen im Gespräch auslösen.
Anforderungen
Einschränkungen und Überprüfungen für Fähigkeiten, die in Copilot Studio
Wichtig
Copilot Studio-Agents unterstützen nur Fähigkeiten, die mit Legacy Bot Framework SDK Version 4.12.0+ und Microsoft 365 Agents SDK v1.0.0+ erstellt wurden. Neue Fähigkeiten sollten mit Microsoft 365 Agents SDK aufgebaut werden.
Um einen Skill zu konfigurieren, legen Sie die zugeordnete App-Registrierung in Microsoft Entra ID für Ihren Skill auf Einzelmandantenkonfiguration fest.
Wann Agenten-Flows statt Fertigkeiten verwendet werden sollten
Die folgende Tabelle hilft Ihnen herauszufinden, wann für eine Unterhaltung Agent-Flows oder Skills eingesetzt werden sollten.
| Faktor | Wann man Agentenflüsse verwenden sollte | Wann man Fähigkeiten einsetzen sollte |
|---|---|---|
| Persona | Agenten-Autoren können wiederverwendbare Flows erstellen, um sie in jedes Agentengespräch einzubetten. | Entwickler können benutzerdefinierte Skills in ihrer eigenen Umgebung erstellen, bereitstellen und hosten |
| Unterhaltungstyp | Verwenden Sie Flows für einfache, einmalige Vorgänge. Geben Sie beispielsweise eine Bestellung auf oder erhalten Sie den Bestellstatus. | Nutzen Sie Fähigkeiten für komplexe mehrstufige 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 Fähigkeiten, um jede unterstützte Antwort eines Agenten zu übermitteln. Zeigen Sie beispielsweise eine adaptive Karte oder senden Sie zufällige Antworten. |
| Aktionen | Verwenden Sie Flows, um serverseitige Einzelinteraktionsaktionen 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 nach einer Agentenantwort auf eine Seite. |
Einen Skill konfigurieren
Verwenden Sie zunächst Copilot Studio, um einen Agent zu erstellen und mithilfe von Pro-Codierung-Tools in Ihrer Organisation eine Fähigkeit zu erstellen und bereitzustellen. Sehen Sie sich diese Beispiele an:
Bevor Sie die Fertigkeit registrieren, geben Sie Ihrem Skill-Entwickler die Agenten-ID an, damit der Agent Aktionen in der Fertigkeit aufrufen kann. Erfahren Sie mehr über die Erlaubnisliste für eine Fähigkeit. 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 Agent-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 diese Fertigkeiten nun in Ihren Themen verwenden.
Überlegungen zur Compliance
Um die Privatsphäre des Benutzers zu schützen, müssen Skills als App im Mandanten des angemeldeten Benutzers innerhalb von Microsoft Entra ID 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, die Ihrem Agenten hinzugefügt wird. Sie müssen diese Fehler beheben, bevor Sie eine Fertigkeit registrieren.
| Fehlernachricht | Fehlerbehebung/Risikominderung |
|---|---|
| Wir hatten Probleme, das Fertigkeitsmanifest zu bekommen. ( 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 Ihre Fähigkeit erneut. |
| Das Manifest ist nicht kompatibel. ( MANIFEST_MALFORMED) |
(a) Überprüfen Sie, ob das Manifest eine gültige JSON-Datei ist. (b) Überprüfen, ob das Manifest die erforderlichen Eigenschaften enthält Zum Beispiel ( name, msaAppId, einzelnendpoint,activities/id , , activities/descriptionactivities/type(nur event oder message unterstützt)). |
| Es gibt eine Diskrepanz bei deinen Endpunkten ( MANIFEST_ENDPOINT_ORIGIN_MISMATCH) |
Überprüfen Sie, ob Ihr Skill-Endpoint mit der Microsoft Entra ID Ihrer Anwendungsregistrierung im Feld Publisher domain (bevorzugt) oder im Feld Home page URL übereinstimmt.
Weitere Informationen zum Festlegen der Startseite für Endpunkte. |
| Um eine Fertigkeit hinzuzufügen, muss sie zuerst registriert werden ( APPID_NOT_IN_TENANT) |
Überprüfen Sie, ob die Anwendungs-ID Ihrer Fähigkeiten im Microsoft Entra ID Mandanten Ihrer Organisation registriert ist. |
| Der Link ist ungültig; Der Link muss mit https:// beginnen ( 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. |
| Diese Fertigkeit wurde Ihrem Agenten 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 Ergebnisse begrenzt. ( LIMITS_TOO_MANY_OUTPUTS) |
Es gibt zu viele Ausgabeparameter für Skill-Aktionen. 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. |
| Es sieht so aus, als wäre etwas schiefgelaufen. ( 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 Funktion hat deinen Agenten nicht erlaubnislistet. ( ENDPOINT_HEALTHCHECK_UNAUTHORIZED) |
Prüfen Sie, ob Ihr Agent zur Liste der erlaubten Fertigkeiten hinzugefügt wurde. |