Agent SDK (Vorschau)

Leitet Bot Framework/Microsoft Agents SDK Activity Payloads an einen vom Benutzer bereitgestellten Agentendpunkt weiter. Die Agentendpunkt-URL wird pro Aufruf als Eingabeparameter bereitgestellt. Die Authentifizierung wird beim Erstellen der Verbindung ausgewählt: keine Authentifizierung, kein statischer API-Schlüssel oder Microsoft Entra ID OAuth (client_credentials). Wenn OAuth ausgewählt ist, muss die Bearertokengruppe (Ressourcen-URL, die für die Verbindung konfiguriert ist) mit der vom Ziel-Agent erwarteten Zielgruppe übereinstimmen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Der Agent SDK-Connector leitet Bot Framework/Microsoft Agents SDK-Aktivitätsnutzlasten an einen vom Benutzer bereitgestellten Agentendpunkt weiter. Die Agentendpunkt-URL wird pro Aufruf als Eingabeparameter bereitgestellt. OAuth-Token werden von der Plattform von den vom Benutzer bereitgestellten Microsoft Entra ID Anwendungsanmeldeinformationen verwendet, die für die Verbindung konfiguriert und als Bearertoken für jede ausgehende Anforderung eingefügt werden. Die Bearertokengruppe (Ressourcen-URL, die für die Verbindung konfiguriert ist) muss mit der vom Ziel-Agent erwarteten Zielgruppe übereinstimmen.

Voraussetzungen

• Ein bereitgestellter Microsoft Agents SDK / Bot Framework-Agent erreichbar über HTTPS.
• Eine Microsoft Entra ID Anwendung, die im Mandanten registriert ist, der den Agent hostt, konfiguriert mit der client_credentials Erteilung und Berechtigung zum Aufrufen des Ziel-Agents.
• Die erwartete Tokengruppe des Agents (zapi://<appId>. B. die Microsoft App-ID des Agents).

Holen Sie Ihre Anmeldeinformationen ab

Um Ihre API-Anforderungen zu authentifizieren, benötigen Sie Folgendes:

1. Die Mandanten-ID der Microsoft Entra ID Anwendung.
2. Die Client-ID (Anwendungs-ID) der Microsoft Entra ID Anwendung.
3. Der geheime Clientschlüssel für diese Anwendung.
4. Die Ressourcen-URL , die der Zielgruppe entspricht, die vom Ziel-Agent erwartet wird (Bot Framework-Fähigkeits-Authentifizierungsmuster).

Geben Sie diese Werte an, wenn Sie eine Verbindung erstellen. Erstellen Sie eine Verbindung pro Agent, wenn benutzergruppen unterschiedlich sind.

Bekannte Probleme und Einschränkungen

• Die agentEndpoint Eingabe muss eine vollständige HTTPS-URL (z. B https://my-agent.azurewebsites.net. ) sein. Der Connector fügt die Aktivitätsnutzlast /api/messages an und leitet sie weiter.
• Der Connector leitet die Aktivitätsnutzlast as-is weiter und legt nicht fest deliveryMode. Der Agent antwortet asynchron (normale Zustellung) durch POSTing-Antwortaktivitäten zurück auf die serviceUrl bereitgestellten eingehenden Aktivitäten (der Anrufer, z. B. Microsoft Copilot Studio, stellt einen SAS-Schlüssel-Rückruf serviceUrlbereit).
• Dieser Connector befindet sich in der Vorschau. Verfügbarkeit und Funktionen können geändert werden.

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

API-Schlüssel

Auth-ID: apiKey

Anwendbar: Alle Regionen

Authentifizieren mit einem statischen API-Schlüssel, den der Ziel-Agent in einem benutzerdefinierten HTTP-Header erwartet. Geben Sie sowohl den Headernamen (z. B. x-api-key) als auch den zugehörigen Wert an.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Microsoft Entra ID (Clientanmeldeinformationen)

Auth-ID: oauthClientCredentials

Anwendbar: Alle Regionen

OAuth-Bearertoken aus einer Microsoft Entra ID Anwendung mithilfe des client_credentials-Flusses. Die Bearertokengruppe (Ressourcen-URL) muss der vom Ziel-Agent erwarteten Zielgruppe entsprechen.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Keine Authentifizierung

Authentifizierungs-ID: anonym

Anwendbar: Alle Regionen

Rufen Sie den Ziel-Agent-Endpunkt ohne Authentifizierungsheader auf. Verwenden Sie dies nur für Agents, die anonyme Anrufe explizit akzeptieren.

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumentation

Standard [VERALTET]

Anwendbar: Alle Regionen

Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Aktionen

Aktivität an Agent senden

Definitionen

Objekt