Wat is een Connector Namespace? (voorbeeld)

Important

Deze preview-functie is onderhevig aan de Aanvullende gebruiksvoorwaarden voor Microsoft Azure previews. Tijdens de preview is deze mogelijkheid alleen beschikbaar in Azure openbare regio's.

Wanneer u oplossingen bouwt die kunnen worden geïntegreerd met SaaS-apps (Software-as-a-Service), bedrijfssystemen en gegevensplatforms, moet u doorgaans aangepaste API-clientcode schrijven voor elke verbinding of integratie. Je moet ook authenticatieflows, credentialrotatie, retry-logica, paginering en webhook-abonnementen beheren over meerdere systemen. Deze taken brengen aanzienlijke ontwikkelingskosten en operationele risico's met zich mee.

Connector Namespace is een volledig beheerde integratiedienst die deze complexiteit elimineert. De dienst bevat een catalogus van vooraf gebouwde, herbruikbare connectoren die je oplossingen kunnen gebruiken om verbinding te maken met diensten zoals SharePoint, Salesforce, SAP en Outlook via een consistent programmeermodel. Elke connector maakt bewerkingen beschikbaar, zoals gebeurtenistriggers, acties die taken voltooien en AI-agenthulpprogramma's via een gedeeld verbindingsmodel. Uw oplossing kan triggers en acties aanroepen met behulp van taalspecifieke SDK's (Software Development Kits) voor C#, Node.jsen Python, of via directe HTTP-aanroepen.

Een connectornaamruimte beheert de onderliggende integratie-infrastructuur door de volgende taken af te handelen:

Opdracht Description
Verificatie- en referentiebeheer Inloggegevens of geheimen opslaan en roteren voor OAuth-, API-sleutel- en verbindingen op basis van tokens.
Opvragen via polling en webhookbezorging Gebeurtenisabonnementen maken en beheren die gegevens naar uw app pushen wanneer bronsystemen veranderen.
Nieuwe pogingen, snelheidsbeperking en foutafhandeling Ingebouwde beleidsregels voor tolerantie instellen zonder aangepaste implementatie.
MCP-serverhosting voor AI-agents Publiceer connectors als MCP-servers (Model Context Protocol), zodat AI-agents en Copilot externe services als hulpprogramma's kunnen aanroepen.

In dit overzicht wordt beschreven wat u kunt doen met connectornaamruimten, belangrijke concepten, hoe connectornaamruimten werken, beveiligingsaspecten en overwegingen voor implementatie tijdens de preview-versie.

Note

Connector Namespace is een integratiepad voor computeservices die niet op een workflow-engine draaien. Naamruimten voor connectors vereisen, gebruiken of wijzigen niets in Azure Logic Apps. De connectorgalerie in Azure Logic Apps werkt onafhankelijk van en los van werkstromen in Azure Logic Apps.

Wat u kunt doen met connectornaamruimten

Integreer uw apps met honderden externe services met behulp van een consistent programmeermodel. De volgende tabel beschrijft veelvoorkomende scenario's waarin uw app Connector Namespace kan gebruiken om te integreren met andere services zonder extra code:

Scenario Voorbeeldintegratie
Documenten en inhoud verwerken Een Azure-functie maakt gebruik van SharePoint connectorbewerkingen voor het detecteren van nieuwe of bijgewerkte bestanden op een SharePoint-server, het lezen en verwerken van de bestanden en het terugschrijven van de resultaten naar SharePoint.
Gebeurtenissen van externe services bewaken Een Azure container-app maakt gebruik van een Salesforce-connectortrigger om gebeurtenissen over nieuwe leads van Salesforce te ontvangen.
Productiviteit automatiseren Een Node.js-app maakt gebruik van Outlook connectorbewerkingen om e-mail te lezen en te verzenden door een verbinding te hergebruiken die al eigendom is van een andere app.
AI- of agentische workloads creëren en uitvoeren Een Python service roept connectoracties aan om modeluitvoer te gronden of te verrijken met gegevens van bedrijfssystemen.
Bestaande app-code opnieuw gebruiken ASP.NET, Node.jsen Python-services kunnen beheerde integraties gebruiken zonder een werkstroomengine in het aanroeppad.
Connectors publiceren als beheerde MCP-servers Converteer elke connector van uw naamruimte naar een MCP-server (Model Context Protocol) met één stap. Uw naamruimte verwerkt hosting, hulpprogrammadefinities en verificatie, zodat Copilot en andere AI-agents connectoracties kunnen aanroepen als hulpprogramma's.
MCP-servers implementeren vanuit een gecureerde catalogus Selecteer en implementeer off-the-shelf MCP-servers in uw connectornaamruimte. U beheert de serverconfiguratie, terwijl de naamruimte de implementatie, schaal en referenties afhandelt. Er is geen infrastructuur die u kunt beheren.

belangrijke concepten

In de volgende tabel worden de belangrijkste concepten beschreven die u moet begrijpen wanneer u werkt met connectornaamruimten:

Concept Description
Connector-naamruimte De Azure resource die als host fungeert voor de runtime van de connector en de volgende taken verwerkt:

- Connectorbewerkingen laden en uitvoeren.
- Verbindingsstatus en referenties behouden.
- Poll-bronservices en -systemen. Webhook-gebeurtenissen verzenden.
- Pas beleid voor opnieuw proberen, beperking en diagnostiek toe.

U kunt een connectornaamruimte maken met behulp van de Azure-portal, Azure Resource Manager (ARM) en Bicep-sjablonen of Azure CLI. Vervolgens verbindt u verbindingen en gebruikt u connectors uit uw apps.
Connector Een vooraf samengesteld onderdeel voor het integreren van een specifieke service, zoals SharePoint, Salesforce, SAP en Outlook. Een connector abstraheert de API, het verificatieprotocol, de paginering en het gedrag van de onderliggende service, zodat uw code zich op de bedrijfslogica blijft concentreren.

Elke verbindingslijn maakt een getypt oppervlak beschikbaar voor de volgende bewerkingen:

- Trigger: Een gebeurtenisabonnementsbewerking die door uw app wordt geregistreerd op een connector. Bijvoorbeeld wanneer een nieuwe e-mail binnenkomt, wanneer een record wordt bijgewerkt of wanneer een bestand wordt toegevoegd aan een map. Wanneer de bronservice of het bronsysteem een gebeurtenis genereert, verzendt de naamruimte van uw connector de payload naar uw app.

--- Elke connector definieert de triggers onafhankelijk van elke specifieke app.

--- Meerdere apps kunnen zich abonneren op dezelfde trigger gebeurtenis met behulp van dezelfde verbinding.

--- Uw connectornaamruimte beheert pollingschema's en webhookregistratie namens u, op basis van wat de onderliggende service ondersteunt.

- Actie: Een bewerking die uw app aanroept. Verzend bijvoorbeeld een bericht, lees een rij of upload een bestand.
Verbinding Een geverifieerde, geconfigureerde binding met een extern account of tenant. U kunt verbindingen hergebruiken, wat betekent dat meerdere apps en connectors dezelfde verbinding kunnen delen. Ondersteunde verbindingsverificatietypen:

-Oauth
- API-sleutel
- Basis
MCP-server Een eersteklas resource die hulpprogramma's beschikbaar maakt die AI-agents kunnen gebruiken via het Model Context Protocol (MCP). Connector-naamruimtes ondersteunen de volgende soorten MCP-servers, die worden gehost door de Connector Namespace:

- Beheerd: Servers en connectors die uw connectornaamruimte maakt en configureert. U kunt een beheerde server of connector implementeren als een MCP-server. U hoeft alleen de onderliggende verbinding te verifiëren. De naamruimte van de connector verwerkt de serverconfiguratie, hulpprogrammadefinities, levenscyclus en runtime.

- Gehost: vooraf samengestelde MCP-servers uit een gecureerde catalogus die u kiest, configureert en implementeert in uw connectornaamruimte. U houdt de controle over de serverinstellingen, omgeving en parameters. De naamruimte van uw connector beheert hosting, schaling en toegangsgegevens.

In beide gevallen kunnen AI-agents, zoals Copilot, aangepaste agents of MCP-compatibele clients, tools detecteren en aanroepen via het verbindingsmodel van de naamruimte. U kunt MCP-servers onafhankelijk van de onderliggende verbinding inschakelen, uitschakelen of draaien.
Connector SDK's Sterk getypte SDK's die worden verzonden met connectornaamruimten, zodat u connectors kunt aanroepen met behulp van de standaard-idiomen van uw taal:

- C#: Azure. Connectors.Sdk op NuGet, met de Visual Studio Code taalservice voor IntelliSense, voltooiingen en CodeLens.

- Node.js: @azure/connectors, een client die in de eerste plaats op TypeScript is gericht en waarin acties met async-await kunnen worden aangeroepen.

- Python: azure-connectors, die is afgestemd op Azure SDK voor Python conventies.

Elke SDK biedt dezelfde catalogus, hetzelfde verbindingsmodel, consistente telemetrie en hetzelfde gedrag bij nieuwe pogingen.

Opmerking: als een getypte SDK niet geschikt is, kunt u connectors aanroepen via HTTP.

Werken met naamruimten van connectoren

In de volgende secties wordt het proces op hoog niveau beschreven voor het integreren van connectors of MCP-servers met uw app.

Typische stappen voor het integreren van connectors met uw app

In de volgende stappen op hoog niveau wordt een typische manier beschreven waarop u connectors met uw app kunt gaan gebruiken:

  1. Maak in uw Azure-abonnement een resource voor connectornaamruimte.

  2. Maak een of meer verbindingen met de services die u wilt integreren.

    Stel dat u een OAuth-verbinding maakt met Microsoft 365 of een API-sleutelverbinding met een externe service. In de volgende stappen wordt beschreven wat er gebeurt tussen uw app en uw connectornaamruimte.

    1. Uw app, die wordt uitgevoerd in Functions, Container Apps, App Service of een andere rekenservice, verwijst naar de naamruimte en de verbinding via een Connector SDK.

    2. Uw app abonneert zich op connectortriggers of roept connectoracties aan.

      Aanroepen naar connectoracties worden synchroon uitgevoerd. De levering van triggers maakt gebruik van webhooks of pull-gebaseerde abonnementen, afhankelijk van de connector en de bronservice.

    3. Uw naamruimte verwerkt verificatie, aanvraagondertekening, polling, webhookabonnement en nieuwe pogingen.

    4. Uw app ontvangt getypeerde antwoorden en payloads van gebeurtenissen.

Typische stappen voor het integreren van MCP-servers met uw app

De volgende overzichtelijke stappen beschrijven een typische manier om MCP-servers met je app te gebruiken:

  1. Maak in uw Azure-abonnement een resource voor connectornaamruimte.

  2. Voeg vanuit de catalogus een MCP-server toe aan uw connectornaamruimte.

    U kunt een beheerde MCP-server of een gehoste MCP-server toevoegen.

  3. Verifieer de onderliggende verbinding. Stel eventuele serverspecifieke configuratievereisten in.

    • Je connector-naamruimte publiceert het eindpunt voor de MCP-server en draait de server. De naamruimte verzorgt authenticatie, schaalverdeling en credentialrotatie.
    • AI-agenten, zoals Copilot, custom agents of elke MCP-bewuste client, kunnen de MCP-server vinden, de toolcatalogus lezen en tools aanroepen via de geconfigureerde verbinding.

Waar u connectornaamruimten kunt gebruiken

In deze sectie worden de manieren beschreven waarop uw app connectornaamruimten en connectorbewerkingen voor integratie kan gebruiken.

  • Connectornaamruimten ondersteunen de volgende Azure compute-services waar uw app beschikbare connectorbewerkingen kan gebruiken:

    • Azure App Service
    • Azure Container Apps - een dienst van Microsoft waarmee je containers kunt uitvoeren en beheren in de cloud.
    • Azure Functions

  • Elke zelf-hostende rekenservice kan connectors gebruiken via een connectornaamruimte.

    Deze zelf-hostende services omvatten bijvoorbeeld ASP.NET, Node.jsof Python op Azure Kubernetes of Azure Virtuele Machines.

  • AI-agents, Copilot-extensies en MCP-serverbewuste clients kunnen hulpprogramma's vinden en aanroepen voor MCP-servers die worden gehost in uw connectornaamruimte, allemaal zonder een afzonderlijke rekenlaag te doorlopen.

    Uw apps kunnen gebruikmaken van deze AI- en agentische hulpprogramma's die communiceren met verbonden systemen en externe services met behulp van de eindpunten voor MCP-servers die zijn geïmplementeerd in uw connectornaamruimte. U hebt geen aangepaste API-clientcode of tool-wrappers nodig. Uw connectornaamruimte biedt en beheert de onderliggende berekening voor actieve servers, zodat u uw eigen infrastructuur niet hoeft te gebruiken.

Beveiliging en governance

  • Laat het beheer van inloggegevens over aan de naamruimte van uw connector, waarin verbindingsgegevens voor u worden opgeslagen, beheerd en geroteerd. Uw app verwerkt nooit ruwe inloggegevens.

  • Beperk netwerktoegang met behulp van integratie van virtuele netwerken en privé-eindpunten met uw connectornaamruimte.

  • Bepalen wie verbindingen kan maken, triggers kan registreren en acties kan aanroepen met behulp van op rollen gebaseerd toegangsbeheer (RBAC) in uw connectornaamruimte.

  • Ter ondersteuning van end-to-end tracering in uw connectornaamruimte en rekenservices, stromen diagnostische logboeken en correlatie-id's naar Azure Monitor.

Pricing

Connector-naamruimteprijzen gebruiken een consumptiemodel. De kosten voor de uitvoering van connectoracties verschillen per type connector. De volgende tabel legt uit hoe elke component in een connectornaamruimte wordt gemeten:

Capability Meten
Connectoren Per connectoractie
Triggers Per triggeractie
Beheerde MCP-connectoren Per aanroep van hulpprogramma
Configureerbare MCP-connectoren Per toolaanroep
Gegevensretentie Per GB maandelijks

Connector-per-eenheidstarianties worden gepubliceerd onder Connector-prijzen op de prijspagina van Azure Logic Apps.

Aanroepen van MCP-connectortools worden gemeten op basis van de aanroepen van de onderliggende connectoracties.

Note

Facturering voor gehoste MCP-servers is niet ingeschakeld tijdens de preview. Microsoft geeft een kennisgeving voordat de facturering begint voor deze mogelijkheid.

Overwegingen en beperkingen

Terwijl Connector Namespace in preview is, bekijk dan de volgende overwegingen als je een deployment plant tijdens de preview:

Consideratie Description
Geen service level agreement (SLA) voor previewversies Connector Namespace (preview) wordt momenteel niet aanbevolen voor productieworkloads.
Beschikbaarheid van de regio Ondersteuning voor regio's is momenteel beperkt, maar wordt in de loop van de tijd uitgebreid.
Connectordekking Connectors met hoog gebruik en standaard zijn eerst beschikbaar, terwijl bedrijfsconnectors, zoals SAP, IBM MQ en Oracle Database, later volgen.
Identiteit API-sleutel en OAuth-verbindingen worden momenteel ondersteund. Ondersteuning voor beheerde identiteiten voor verbindingen komt later binnen, maar is eerder gepland voor bepaalde MCP-servers.
Versioning SDK-versies en runtimeversies van naamruimten worden tijdens de previewperiode gekoppeld. Verwacht belangrijke wijzigingen tussen preview-mijlpalen.

Verwante onderwerpen

  • Last updated on