Was ist ein Connector-Namespace? (Vorschau)

Important

Diese Vorschaufunktion unterliegt den Supplemental-Nutzungsbedingungen für Microsoft Azure Previews. Während der Vorschau ist diese Funktion nur in Azure öffentlichen Regionen verfügbar.

Wenn Sie Lösungen erstellen, die in SaaS-Apps (Software-as-a-Service)-Apps, Geschäftssysteme und Datenplattformen integriert werden, müssen Sie in der Regel benutzerdefinierten API-Clientcode für jede Verbindung oder Integration schreiben. Sie müssen außerdem Authentifizierungsflüsse, Credential-Rotation, Retry-Logik, Paginierung und Webhook-Abonnements über mehrere Systeme hinweg verwalten. Diese Aufgaben bringen erhebliche Entwicklungskosten und operative Risiken mit sich.

Connector Namespace ist ein vollständig verwalteter Integrationsdienst, der diese Komplexität beseitigt. Der Dienst bietet einen Katalog von vorgefertigten, wiederverwendbaren Connectors, die Ihre Lösungen nutzen können, um sich über ein konsistentes Programmiermodell mit Diensten wie SharePoint, Salesforce, SAP und Outlook zu verbinden. Jeder Konnektor stellt Funktionen wie Ereignisauslöser, Aktionen zum Ausführen von Aufgaben und KI-Agent-Tools über ein gemeinsames Verbindungsmodell bereit. Ihre Lösung kann Trigger und Aktionen mithilfe sprachspezifischer Softwareentwicklungskits (SDKs) für C#, Node.jsund Python oder über direkte HTTP-Aufrufe aufrufen.

Ein Connectornamespace verwaltet die zugrunde liegende Integrationsinfrastruktur, indem die folgenden Aufgaben behandelt werden:

Aufgabe Description
Authentifizierung und Verwaltung von Anmeldeinformationen Speichern und rotieren Sie Anmeldeinformationen oder Secrets für OAuth-, API-Schlüssel- und Token-basierte Verbindungen.
Polling und Webhook-Zustellung Erstellen und Verwalten von Ereignisabonnements, die Daten an Ihre App übertragen, wenn sich Quellsysteme ändern.
Wiederholen, Drosselung und Fehlerbehandlung Richten Sie integrierte Resilienzrichtlinien ohne benutzerdefinierte Implementierung ein.
MCP-Serverhosting für KI-Agents Veröffentlichen Sie Connectors als MCP-Server (Model Context Protocol), damit KI-Agents und Copilot externe Dienste als Tools aufrufen können.

Diese Übersicht beschreibt, was Sie mit Connector-Namespaces tun können, wichtige Konzepte, wie Connector-Namespaces funktionieren, Sicherheitsaspekte und Überlegungen zur Bereitstellung in der Vorschauphase.

Note

Connector Namespace ist ein Integrationspfad für Compute-Services, die nicht auf einer Workflow-Engine laufen. Connector-Namespaces erfordern nichts in Azure Logic Apps, verwenden dort nichts und ändern dort auch nichts. Der Verbinderkatalog in Azure Logic Apps funktioniert unabhängig und separat für Workflows in Azure Logic Apps.

Was Sie mit Connectornamespaces tun können

Integrieren Sie Ihre Apps mit Hunderten externer Dienste, indem Sie ein konsistentes Programmiermodell verwenden. Die folgende Tabelle beschreibt gängige Szenarien, in denen Ihre App Connector Namespace nutzen kann, um ohne zusätzlichen Code mit anderen Diensten zu integrieren:

Szenario Beispielintegration
Verarbeiten von Dokumenten und Inhalten Eine Azure-Funktion verwendet SharePoint Connectorvorgänge, um neue oder aktualisierte Dateien auf einem SharePoint-Server zu erkennen, die Dateien zu lesen und zu verarbeiten und die Ergebnisse zurück in SharePoint zu schreiben.
Ereignisse aus externen Diensten überwachen Eine Azure-Container-App verwendet einen Salesforce-Connectortrigger, um Ereignisse zu neuen Leads von Salesforce zu empfangen.
Automatisieren der Produktivität Eine Node.js-App verwendet Outlook Connectorvorgänge zum Lesen und Senden von E-Mails durch erneutes Verwenden einer Verbindung, die bereits eine andere App besitzt.
Erstellen und Ausführen von KI- oder agentischen Workloads Ein Python-Dienst ruft Connector-Aktionen auf, um die Modellausgabe mit Daten aus Geschäftssystemen zu stützen oder anzureichern.
Vorhandenen App-Code wiederverwenden ASP.NET, Node.jsund Python Dienste können verwaltete Integrationen ohne ein Workflowmodul im Anrufpfad verwenden.
Konnektoren als verwaltete MCP-Server veröffentlichen Konvertieren Sie einen beliebigen Connector aus Ihrem Namespace in einen MCP-Server (Model Context Protocol) mit einem einzigen Schritt. Ihr Namespace verarbeitet Hosting, Tooldefinitionen und Authentifizierung, sodass Copilot und andere KI-Agents Connectoraktionen als Tools aufrufen können.
Bereitstellen von MCP-Servern aus einem kuratierten Katalog Wählen Sie vorkonfigurierte MCP-Server aus und stellen Sie sie in Ihrem Connector-Namespace bereit. Sie steuern die Serverkonfiguration, während der Namespace bereitstellungs-, skalierungs- und anmeldeinformationen verarbeitet – keine Infrastruktur, die Sie verwalten können.

Zentrale Konzepte

In der folgenden Tabelle werden die Kernkonzepte beschrieben, die Sie verstehen sollten, wenn Sie mit Connectornamespaces arbeiten:

Konzept Description
Connector-Namensraum Die Azure-Ressource, die die Connector-Laufzeit hostet und die folgenden Aufgaben übernimmt:

– Laden und Ausführen von Verbindervorgängen.
– Verbindungsstatus und Anmeldeinformationen beibehalten.
- Abfrage von Diensten und Systemen. Webhook-Ereignisse senden.
– Wenden Sie Wiederholungs-, Drosselungs- und Diagnoserichtlinien an.

Sie können einen Connectornamespace erstellen, indem Sie das Azure Portal, Azure Resource Manager (ARM) und Bicep Vorlagen oder Azure CLI verwenden. Anschließend binden Sie Verbindungen und nutzen Konnektoren aus Ihren Apps.
Konnektor Eine vorgefertigte Komponente für die Integration eines bestimmten Diensts wie SharePoint, Salesforce, SAP und Outlook. Ein Connector abstrahiert die API, das Authentifizierungsprotokoll, die Paginierung und das Wiederholungsverhalten des zugrunde liegenden Diensts, sodass ihr Code auf die Geschäftslogik konzentriert bleibt.

Jeder Verbinder macht eine typierte Oberfläche für die folgenden Vorgänge verfügbar:

- Trigger: Ein Vorgang zum Abonnieren von Ereignissen, den Ihre App bei einem Connector registriert. Wenn beispielsweise eine neue E-Mail eingeht, wenn ein Datensatz aktualisiert wird oder eine Datei einem Ordner hinzugefügt wird. Wenn der Quelldienst oder das System ein Ereignis auslöst, sendet Ihr Connectornamespace die Nutzlast an Ihre App.

--- Jeder Connector definiert seine Trigger unabhängig von einer bestimmten App.

--- Mehrere Apps können dasselbe Triggerereignis mithilfe derselben Verbindung abonnieren.

--- Ihr Konnektor-Namespace verwaltet in Ihrem Namen die Abrufpläne und die Registrierung von Webhooks, je nachdem, was der zugrunde liegende Dienst unterstützt.

- Aktion: Ein Vorgang, den Ihre App aufruft. Senden Sie beispielsweise eine Nachricht, lesen Sie eine Zeile, oder laden Sie eine Datei hoch.
Connection Eine authentifizierte, konfigurierte Bindung an ein externes Konto oder Mandanten. Sie können Verbindungen wiederverwenden, was bedeutet, dass mehrere Apps und Connectors dieselbe Verbindung gemeinsam nutzen können. Unterstützte Verbindungsauthentifizierungstypen:

-Oauth
- API-Schlüssel
- Grundlegend
MCP-Server Eine erstklassige Ressource, die Tools verfügbar macht, die KI-Agents über das Model Context Protocol (MCP) verwenden können. Connector-Namensräume unterstützen folgende Arten von MCP-Servern, die vom Connector-Namensraum gehostet werden:

- Verwaltet: Die Server und Konnektoren, die Ihr Konnektor-Namespace erstellt und konfiguriert. Sie können einen verwalteten Server oder Connector als MCP-Server bereitstellen. Sie müssen nur die zugrunde liegende Verbindung authentifizieren. Ihr Connectornamespace behandelt die Serverkonfiguration, Tooldefinitionen, den Lebenszyklus und die Laufzeit.

- Gehostet: Vorgefertigte MCP-Server aus einem kuratierten Katalog, die Sie auswählen, konfigurieren und in Ihrem Connector-Namespace bereitstellen. Sie behalten die Kontrolle über die Servereinstellungen, die Umgebung und die Parameter. Ihr Connectornamespace verarbeitet Hosting, Skalierung und Anmeldeinformationen.

In beiden Fällen können KI-Agents wie Copilot, benutzerdefinierte Agents oder alle MCP-fähigen Clients Tools mithilfe des Verbindungsmodells des Namespace erkennen und aufrufen. Sie können MCP-Server unabhängig von der zugrunde liegenden Verbindung aktivieren, deaktivieren oder drehen.
Konnektor-SDKs Stark typisierte SDKs, die mit Connector-Namespaces mitgeliefert werden, damit Sie Connectoren mithilfe der Standardidiome Ihrer Sprache aufrufen können:

- C#: Azure.Connectors.Sdk auf NuGet, mit dem Visual Studio Code-Sprachdienst für IntelliSense, Vervollständigungen und CodeLens.

- Node.js: @azure/connectors, ein TypeScript-orientierter Client mit Aktionsaufrufen über async/await.

- Python: azure-connectors, das an den Konventionen des Azure SDK für Python ausgerichtet ist.

Jedes SDK macht denselben Katalog, das Verbindungsmodell, die konsistente Telemetrie und die Wiederholungssemantik verfügbar.

Hinweis: Wenn ein typiertes SDK nicht geeignet ist, können Sie Connectors über HTTP aufrufen.

So arbeiten Sie mit Connector-Namensräumen

In den folgenden Abschnitten wird der allgemeine Ablauf für den Einstieg in die Integration von Connectors oder MCP-Servern in Ihre App beschrieben.

Typische Schritte zum Integrieren von Connectors in Ihre App

In den folgenden allgemeinen Schritten wird beschrieben, wie Sie mit der Verwendung von Connectors mit Ihrer App beginnen können:

  1. Erstellen Sie in Ihrem Azure-Abonnement eine Connector-Namespace-Ressource.

  2. Erstellen Sie eine oder mehrere Verbindungen zu den Diensten, die Sie integrieren möchten.

    Angenommen, Sie erstellen eine OAuth-Verbindung zu Microsoft 365 oder eine API-Schlüsselverbindung mit einem externen Dienst. In den folgenden Schritten wird beschrieben, was zwischen Ihrer App und Ihrem Connectornamespace passiert.

    1. Ihre App, die in Functions, Container Apps, App Service oder einem anderen Compute-Service ausgeführt wird, referenziert den Namespace und die Verbindung über ein Connector SDK.

    2. Ihre App abonniert Trigger für den Konnektor oder ruft Konnektor-Aktionen auf.

      Aufrufe von Konnektoraktionen werden synchron ausgeführt. Die Zustellung von Triggern erfolgt über Webhooks oder pullbasierte Abonnements, abhängig vom Connector und dem Quelldienst.

    3. Ihr Namespace kümmert sich um Authentifizierung, Signierung von Anfragen, Polling, Webhook-Abonnement und Wiederholungen.

    4. Ihre App empfängt typierte Antworten und Ereignisnutzlasten.

Typische Schritte zum Integrieren von MCP-Servern in Ihre App

Die folgenden übergeordneten Schritte beschreiben eine typische Methode, um MCP-Server mit Ihrer App zu nutzen:

  1. Erstellen Sie in Ihrem Azure-Abonnement eine Connector-Namespace-Ressource.

  2. Fügen Sie aus dem Katalog einen MCP-Server zu Ihrem Connectornamespace hinzu.

    Sie können einen verwalteten MCP-Server oder einen gehosteten MCP-Server hinzufügen.

  3. Authentifizieren Sie die zugrunde liegende Verbindung. Richten Sie alle serverspezifischen Konfigurationsanforderungen ein.

    • Dein Connector-Namensraum veröffentlicht den Endpunkt für den MCP-Server und betreibt den Server. Der Namensraum übernimmt Authentifizierung, Skalierung und Rotation der Zugangsdaten.
    • KI-Agenten wie Copilot, benutzerdefinierte Agenten oder jeder MCP-fähige Client können den MCP-Server finden, seinen Werkzeugkatalog lesen und Tools über die konfigurierte Verbindung aufrufen.

Wo Sie Connectornamespaces verwenden können

In diesem Abschnitt wird beschrieben, wie Ihre App Connectornamespaces und Connectorvorgänge für die Integration verwenden kann.

  • Connectornamespaces unterstützen die folgenden Azure Computedienste, bei denen Ihre App verfügbare Connectorvorgänge verwenden kann:

    • Azure App Service
    • Azure Container Apps – ein Dienst für containerbasierte Anwendungen
    • Azure Functions

  • Jeder selbst gehostete Computingdienst kann über einen Konnektor-Namespace Konnektoren verwenden.

    Diese selbst gehosteten Dienste umfassen beispielsweise ASP.NET, Node.jsoder Python auf Azure Kubernetes oder Azure Virtual Machines.

  • KI-Agents, Copilot Erweiterungen und MCP-serverfähige Clients können Tools für MCP-Server finden und aufrufen, die in Ihrem Connector-Namespace gehostet werden – alles, ohne eine separate Computeebene zu durchlaufen.

    Ihre Apps können diese KI- und agentischen Tools verwenden, die mit verbundenen Systemen und externen Diensten interagieren, indem sie die Endpunkte für MCP-Server verwenden, die in Ihrem Connectornamespace bereitgestellt werden. Sie benötigen keinen benutzerdefinierten API-Clientcode oder Toolwrapper. Ihr Connectornamespace stellt die zugrunde liegende Berechnung für ausgeführte Server bereit und verwaltet sie, sodass Sie keine eigene Infrastruktur mitbringen müssen.

Sicherheit und Governance

  • Überlassen Sie die Verwaltung von Anmeldeinformationen Ihrem Connector-Namespace, der Ihre Verbindungsanmeldeinformationen für Sie speichert, verwaltet und regelmäßig erneuert. Ihre App verarbeitet niemals unformatierte Anmeldeinformationen.

  • Beschränken Sie den Netzwerkzugriff mithilfe der Integration des virtuellen Netzwerks und privater Endpunkte mit Ihrem Connectornamespace.

  • Steuern Sie, wer Verbindungen erstellen, Trigger registrieren und Aktionen aufrufen kann, indem Sie rollenbasierte Zugriffssteuerung (RBAC) in Ihrem Connectornamespace verwenden.

  • Um die End-to-End-Ablaufverfolgung über Ihren Connector-Namespace und Ihre Compute-Dienste hinweg zu unterstützen, werden Diagnoseprotokolle und Korrelations-IDs an Azure Monitor übermittelt.

Überlegungen und Einschränkungen

Während Connector Namespace in der Vorschau ist, prüfen Sie die folgenden Überlegungen, wenn Sie während der Vorschau eine Bereitstellung planen:

Consideration Description
Kein Service Level Agreement (SLA) für die Vorschau Connector Namespace (Vorschau) wird derzeit nicht für Produktionsworkloads empfohlen.
Verfügbarkeit der Region Die Unterstützung für Regionen ist derzeit begrenzt, wird aber im Laufe der Zeit erweitert.
Verbinderabdeckung Konnektoren mit hoher Auslastung und Standardkonnektoren sind zuerst verfügbar, während Konnektoren für Unternehmen, wie z. B. SAP, IBM MQ und Oracle Database, in späteren Wellen folgen.
Identität API-Schlüssel und OAuth-Verbindungen werden derzeit unterstützt. Die Unterstützung der verwalteten Identität für Verbindungen erfolgt später, ist jedoch für ausgewählte MCP-Server früher geplant.
Versioning SDK- und Namespacelaufzeitversionen werden während der Vorschau gekoppelt. Erwarten Sie fehlerhafte Änderungen zwischen den Meilensteinen der Vorschau.
Pricing Das Preismodell ist noch nicht abgeschlossen. Die Form der Messung kann sich vor der allgemeinen Verfügbarkeit ändern.

Verwandte Inhalte

  • Last updated on