Connector-Einwilligungskarten mit dem Agents SDK verarbeiten

Read this in English

Consent Adaptive Cards erkennen, Sicherheitsinformationen anzeigen und die Auswahl Allow oder Cancel über das Agents SDK zurücksenden.

28/10/2026 28/10/2026

Power Platform Governance

Eine Abfolge in 3 Schritten zeigt das Erkennen einer Copilot Studio Einwilligungskarte, das Anzeigen der Sicherheitsdetails mit Allow oder Cancel und das Zuruecksenden der Auswahl als Message Activity mit postBack true. — Schematische Darstellung der beschriebenen Schritte nach The Custom Engine, kein Screenshot.

TL;DR

Copilot Studio benötigt die Einwilligung des Endbenutzers, bevor Connectoren mit Endbenutzerauthentifizierung aufgerufen werden. In eigenen Agents SDK-Oberflächen werden Karten über Connect to continue sowie die Schaltflächen Allow und Cancel erkannt und die Auswahl als Message Activity mit postBack true zurückgesendet.

Original von Adi Leibowitz, auf The Custom Engine. Artikel lesen

Dies ist unsere eigene Kurzfassung, keine Wiederveröffentlichung oder vollständige Übersetzung.

Bedeutung für Governance

Makers: Rendert die Consent Adaptive Card in eigenen Oberflächen und erfasst Allow oder Cancel, weil Connectoren mit Endbenutzerauthentifizierung ohne Einwilligung nicht aufgerufen werden.
Admins/CoE: Trennt die Einwilligung für native Entra ID-Connectoren vom Verbindungsmanager, weil Custom Connectoren und andere nicht unterstützte Connectoren die aufwendigere Verbindungsverwaltung verwenden.
Security/Compliance: Erhaltet die Fähigkeitszeilen und den Datenschutzwarnhinweis, weil die Karte über Credential-Nutzung und mögliche Risiken für die Datenexposition informiert.

Häufige Fragen

Wie erkennt ein Agents SDK Client eine Connector-Einwilligungskarte in Copilot Studio?

Prüfe einen TextBlock mit Connect to continue sowie Action.Submit-Schaltflächen mit Allow und Cancel. Diese Heuristik erkennt die Einwilligungskarte ohne speziellen Ereignistyp.

Welche Activity muss nach Allow oder Cancel an Copilot Studio gesendet werden?

Sende eine Message Activity mit channelData.postBack true sowie value mit der Auswahl, id submit und shouldAwaitUserInput true.

Welche Connectoren verwenden in Copilot Studio die Einwilligungskarte statt des Verbindungsmanagers?

Native Connectoren mit Entra ID-Authentifizierung können die Karte anzeigen. Custom Connectoren und andere Connectoren verwenden stattdessen den aufwendigeren Verbindungsmanager.