Konfigurieren Sie Azure Bot Service Fähigkeiten für den Einsatz in Copilot Studio Agenten

Note

Dieser Artikel beschreibt Funktionen, die in Agenten oder Agent-Flows verwendet werden, die auf dem standard harness basieren.

Important

Dieser Artikel enthält Informationen über Azure Bot Service Skills, eine codebasierte Methode, um die Skills eines Agenten im Standard-Harness zu erweitern. Diese Fähigkeiten sollten nicht mit agentischen Fähigkeiten im GitHub Copilot-Harness verwechselt werden. Erfahren Sie mehr darüber, wie Sie agentische Fähigkeiten im Skills-Überblick für Agenten einsetzen.

Mit Copilot Studio können Sie Ihren Agent durch Azure Bot Service Skills erweitern. Wenn Sie bereits Agenten in Ihrer Organisation erstellt und eingesetzt haben (mit dem Microsoft 365 Agents SDK oder anderen Pro-Code-Tools) für bestimmte Szenarien, können Sie diese Bots in Azure Bot Service Skills umwandeln und diese in einem Copilot Studio Agent registrieren.

Note

Um einen Azure Bot Service Skill innerhalb der Copilot Studio-App in Microsoft Teams hinzuzufügen, musst du ein eigenständiges Microsoft Copilot Studio-Abonnement haben.

Dieser Artikel richtet sich an Systemadministratoren oder IT-Fachkräfte, die mit Azure Bot Service skills vertraut sind.

Sobald du eine Azure Bot Framework-Fähigkeit bei einem Copilot Studio-Agenten registriert hast, kannst du nahtlos Azure Bot Service Skill-Aktionen im Gespräch auslösen.

Prerequisites

Important

Copilot Studio Agenten unterstützen nur Azure Bot Service Skills, die mit dem Legacy Bot Framework SDK Version 4.12.0+ und Microsoft 365 Agents SDK v1.0.0+ entwickelt wurden. Neue Azure Bot Service Skills sollten mit Microsoft 365 Agents SDK entwickelt werden.

Um eine Azure Bot Service Skill zu konfigurieren, setze die zugehörige App-Registrierung in Microsoft Entra ID für deinen Skill auf eine Einzel-Tenant-Konfiguration.

Wann man Agentenflüsse oder Azure Bot Service Skills verwenden sollte

Die folgende Tabelle hilft Ihnen zu bestimmen, wann Sie Agent Flows oder Azure Bot Service Skills für ein Gespräch verwenden sollten.

Faktor Wann man Agentenflüsse verwenden sollte Wann man Azure Bot Service 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. Nutze Azure Bot Service Skills 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. Nutze Azure Bot Service Skills, um jede unterstützte Agentenantwort auszugeben. 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. Nutze Azure Bot Service Skills, um serverseitige und clientseitige Ereignisse und Aktionen auszulösen. Navigieren Sie beispielsweise nach einer Agentenantwort auf eine Seite.

Konfigurieren Sie einen Azure Bot Service Skill

Zuerst nutzen Sie Copilot Studio, um einen Agenten zu erstellen und eine Azure Bot Service Fähigkeit mit Pro-Code-Tools in Ihre Organisation zu erstellen und einzusetzen. Sehen Sie sich diese Beispiele an:

Gib vor der Registrierung der Azure Bot Service-Fähigkeit die Agenten-ID an deinen Skill-Entwickler weiter, damit dieser den Agenten autorisieren kann, Aktionen im Skill aufzurufen. Erfahren Sie mehr über die Zulassungsliste für einen Azure Bot Service Skill. Du kannst deine Agenten-ID im Fenster "Skill hinzufügen" bekommen.

So fügen Sie Ihrem Agenten einen Azure Bot Service Skill hinzu:

  1. Gehen Sie zu Ihrem Agent.

  2. Wähle Einstellungen>Skills.

  3. Wählen Sie Eine Fertigkeit hinzufügen aus.

  4. Kopieren Sie Ihre Agent-ID. Du musst deinem Skill-Entwickler die Agenten-ID geben.

  5. Gib die URL zum Azure Bot Service Fertigkeitsmanifest ein. Das Manifest einer Fähigkeit enthält die Informationen, die dein Agent benötigt, um Aktionen innerhalb der Fähigkeit auszulösen.

  6. Wählen Sie Weiter aus, um den Überprüfungsprozess zu starten. Wenn die Validierung erfolgreich ist, wird dein Skill deinem Agent hinzugefügt. Sie können diese Fertigkeiten nun in Ihren Themen verwenden.

Überlegungen zur Compliance

Um die Privatsphäre der Nutzer zu schützen, müssen Sie eine Azure Bot Service Skill als App im Microsoft Entra ID Tenant des angemeldeten Nutzers registrieren.

Fehler während der Azure Bot Service Skill-Registrierung beheben

Das System führt eine Reihe von Überprüfungsprüfungen für die URL aus. Diese Prüfungen stellen die Einhaltung der Vorschriften, Governance und die Benutzerfreundlichkeit des Skills sicher, den Sie Ihrem Agenten hinzufügen. Sie müssen diese Fehler beheben, bevor Sie einen Azure Bot Service Skill 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-Endpunkt mit der Anwendungsregistrierung Ihrer Microsoft Entra ID im Feld Publisher domain (bevorzugt) oder 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 Ihres Skills im Microsoft Entra ID Tenant 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 Fähigkeit hat deinen Agenten nicht auf die Zulassungsliste gesetzt.
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Überprüfe, ob dein Agent zur Zulassungsliste des Skills hinzugefügt wurde.
  • Zuletzt aktualisiert um