Overzicht van de multitenantmodus in Copilot Studio (preview)

[Dit artikel is voorlopige documentatie en kan worden gewijzigd.]

Copilot Studio ondersteunt nu de modus voor meerdere tenants. Met deze nieuwe ondersteuning kan een agent worden gebruikt in een andere Microsoft Entra tenant dan de tenant die deze host. De modus Multitenant wijzigt het gedrag van een Copilot Studio-agent bij het gebruik van specifieke verificatieopties. In dit artikel wordt de verificatie in Copilot Studio beschreven en wordt de rol van verificatie in de multitenant-modus besproken.

Important

De functie voor meerdere tenants in Copilot Studio bevindt zich in de openbare preview en is duidelijk gemarkeerd in Copilot Studio voor makers. Er zijn termen die in het product worden genoemd. Publieke previewfuncties worden niet ondersteund voor gebruik in een algemeen beschikbare uitvoering. Je kunt echter wel publieke preview-agenten testen in de Teams/Agent Store onder specifieke richtlijnen. Partners moeten hun eindgebruikers laten zien dat hun agenten de previewfunctionaliteit gebruiken door een Preview-banner in het pictogram op te nemen.

Copilot Studio Makers kunnen kiezen uit drie verificatieopties voor agents:

Verificatiemethode	Description
Geen authenticatie	Wanneer u de configuratie-instelling No Authenticaton selecteert in het gebied Authentication en Settings van de agent, kunnen externe gebruikers Copilot Studio agents gebruiken die u in het platform bouwt en host. Wanneer je deze instelling inschakelt, geeft de client waar de gebruiker toegang krijgt geen toegangstoken door aan de agent. Je vindt dit soort situaties vaak op websites in zelfbedienings-FAQ-stijl toepassingen. Deze instelling stelt elke gebruiker in staat toegang te krijgen tot de agent.
Verifiëren met Microsoft	Deze optie gebruikt een geïntegreerde authenticatie-optie. De agent verwacht een Microsoft Entra ID identiteit van de client. Teams en andere Microsoft-clients verzenden deze identiteit wanneer ze gebruikers verifiëren met werk- of schoolaccounts Microsoft Entra. De agent gebruikt deze identiteit om de gebruiker toegang te geven tot de functionaliteit. Met deze optie in Copilot Studio wordt een ervaring met eenmalige aanmelding (SSO) uitgevoerd tussen de client, de agent en de gebruiker. De gebruiker hoeft niet eerst in te loggen om toegang te krijgen tot de client, en daarna een tweede keer om de agent te bereiken.
Authenticatie handmatig	Wanneer deze optie is geselecteerd, geeft dit expliciet aan dat Copilot Studio de identiteit niet afhandelt of verwacht. De maker stelt authenticatie in voor de geselecteerde authenticatie-optie. Handmatige authenticatie wordt doorgaans gebruikt wanneer geen Microsoft-gebaseerde identiteit of client wordt gebruikt. Bijvoorbeeld, je embedt de agent in een website of native applicatie en wilt externe gebruikers authenticeren. Bij handmatige authenticatie kun je het type authenticatie selecteren: OAuth: Wanneer OAuth is geselecteerd, wordt de gebruiker die de agent op de client benadert, gevraagd in te loggen met OAuth. Dit opent een aanmeldingsstroom gebaseerd op de door maker geconfigureerde OAuth identiteitsproviders. Zodra de gebruiker succesvol is ingelogd, ontvangt de agent een toegangstoken en kan deze token gebruiken in downstream-diensten en voor personalisatie. Microsoft Entra gebaseerde identiteitsopties: Er zijn opties voor identiteiten op basis van services en gebruikersidentiteiten (bijvoorbeeld certificaten en Microsoft Entra gebruikersverificatie). Service-authenticatie is meestal bedoeld wanneer de agent een eigen identiteit nodig heeft. Gebruikersgerichte entiteit wordt gebruikt voor toegang tot downstream-diensten die authenticatie vereisen. Copilot Studio-makers kunnen ervoor kiezen om gebruikersverificatie handmatig te configureren met Microsoft Entra.

Important

Als u Microsoft Teams wilt gebruiken als een kanaal in Copilot Studio, moet u Authenticate met Microsoft of Authenticate Handmatig selecteren. Deze eis is bewust ontworpen en sluit identiteitsmodellen aan. Bij Teams moet een gebruiker altijd ingelogd zijn, dus daardoor kunnen Teams-agenten niet anoniem zijn. Hetzelfde geldt voor alle Microsoft-kanalen (bijvoorbeeld SharePoint).

Multitenant-modus

In de modus met één tenant moeten Microsoft Teams gebruikers zijn aangemeld en toegang hebben tot de Copilot Studio-agent met behulp van dezelfde tenant als waar de agent wordt gehost in Copilot Studio. Als een gebruiker van een andere tenant (bijvoorbeeld probeert example@zavainsurance.com toegang te krijgen tot een agent die in example@contoso.comwordt gehost), ontvangt de gebruiker een bericht van de agent: "Je hebt geen toegang om met deze bot te praten. Neem contact op met de eigenaar."

Wanneer u de modus voor meerdere tenants inschakelt in Copilot Studio voor een agent, hebben gebruikers toegang tot de agent die in één tenant wordt gehost vanuit een andere Microsoft Entra ID tenant.

Deze functie is beschikbaar voor openbare preview. Multitenant-modus ondersteunt Copilot Studio-agenten in Microsoft Teams en Microsoft Copilot. In de multitenancy-modus kunnen agents worden ontdekt in de wereldwijde Microsoft Teams Store, waar agents door clients kunnen worden gebruikt wanneer ze zich in twee verschillende tenants bevinden.

Terminologie

Wanneer je met agenten werkt en authenticatie begrijpt, is het belangrijk om de volgende gedragingen te scheiden:

• Gebruikers-naar-client authenticatie: Bijvoorbeeld wanneer een gebruiker inlogt bij een Teams-client, of inlogt op een website met zijn Microsoft-account. Deze verificatie is niet strikt gerelateerd aan de Copilot Studio-agent en vindt plaats buiten de agent.
• Authenticatie van client naar agent: De client stuurt informatie naar de agent, en de agent verwacht informatie van de client. Als je de agent configureert voor single sign-on (SSO), is de authenticatie onzichtbaar voor de eindgebruiker van de client. Zo niet, dan wordt de gebruiker gevraagd om zich apart aan te melden bij de agent.
• Agentauthenticatie naar andere geauthenticeerde diensten: De agent moet communiceren met andere diensten en in sommige gevallen identiteit doorgeven. Die identiteit kan de identiteit van de agent (dienstprincipal) zijn als de agent een identiteit heeft. Anders kan de agent de identiteit van de gebruiker gebruiken als de agent daartoe rechten heeft, toegang krijgen tot bronnen en acties uitvoeren (met gedelegeerde rechten van de ingelogde clientgebruiker).

Er is ook een blended authenticatieoptie waarbij een agent-authenticatiestroom kan worden gecontroleerd via onderwerpen binnen Copilot Studio door gebruik te maken van de Authenticate node, die de gebruiker vraagt om in te loggen. Gemengde verificatie is alleen beschikbaar wanneer Handmatig verifiëren is geselecteerd in Copilot Studio en wanneer Vereis dat gebruikers zich aanmelden is uitgeschakeld.

Wanneer je multitenant-modus gebruikt, gebruik dan de volgende terminologie:

• De host is de omgeving waarin Copilot Studio gehost wordt, waarvan het wordt uitgevoerd, en vanuit waar het wordt gefactureerd. De host is waar u de Copilot Studio-agent bouwt. De host is ook de plek waar de agent door de standaard softwareontwikkelingscyclus beweegt terwijl de agent wordt ontwikkeld, getest en naar een productieomgeving wordt gebracht voor live gebruik. Dit proces verschilt niet van het geval voor agenten in single-tenant modus.

• De client is waar je toegang krijgt tot de agent. Deze clientapplicatie lijkt op Microsoft Teams of Microsoft Copilot. Vanaf deze clients heeft de gebruiker toegang tot en gebruikt de agent en meldt zich aan met behulp van Microsoft Entra ID. De client vereist of gebruikt geen Power Platform-infrastructuur, waaronder Copilot Studio.

In de volgende documentatie wordt beschreven welke functionaliteit momenteel wordt ondersteund in openbare preview wanneer de modus voor meerdere tenants is ingeschakeld in Copilot Studio.

Ondersteunde functionaliteit

Openbare preview voor multitenant wordt gelanceerd binnen een specifiek bereik.

Wanneer de agent in multitenant-modus is, gedraagt hij zich anders. Niet alle functies van Copilot Studio worden ondersteund. De verschillen kunnen worden veroorzaakt door de aard van de functionaliteit (bijvoorbeeld dat SharePoint-kennis niet tussen tenants werkt) of vanwege het publieke preview-bereik. De volgende secties bevatten meer details.

Belangrijke hoogtepunten:

• Multitenant-modus ondersteunt nog geen eindgebruikersauthenticatie. Deze beperking betekent dat je geen toegang kunt delegeren om de identiteit van de gebruiker te gebruiken in downstream-gedrag. De waarde van deze functie is het doorgeven van geauthenticeerde informatie aan de agent vanuit gedelegeerde authenticatie via andere diensten. Deze functionaliteit is nog niet beschikbaar.
• Gesprekstranscripties worden uitgeschakeld wanneer multitenant-modus is ingeschakeld. Deze beperking beschermt de privacy van de downstream-huurders die de agent gebruiken.
• Host-tenants zijn verantwoordelijk voor de facturering van de Copilot Studio-agent op dezelfde wijze als in de eentenantmodus. Microsoft-partners die uitrollen naar de wereldwijde Teams en agent store en op zoek zijn naar verschillende werkpatronen met hun eindklanten, zoals het factureren van agenten in de wereldwijde Teams Store, dienen contact op te nemen met het Partner Center om te informeren welke programma's beschikbaar zijn.

De volgende sectie vat de functionaliteit samen waarvan bekend is dat die wel of niet werkt bij gebruik van de agent in multitenant-modus. Als hier iets niet als werkend wordt vermeld, kun je verwachten dat het niet werkt voor multitenant-modus. Functionaliteit in Copilot Studio wordt niet gewijzigd om anders te werken wanneer de modus voor meerdere tenants is ingeschakeld. Gegevensbeleid draait bijvoorbeeld nog steeds op de hosttenant, en kenmerken en functionaliteit, als ze worden ondersteund, hebben dezelfde set kenmerken als in de single-tenant modus.

Kennis

• Dataverse-upload: ondersteund in openbare preview tussen tenants.
• Openbare websites: ondersteund in openbare preview tussen tenants.

Tools

• Prompts: ondersteund in openbare preview tussen tenants.
• Beperkte standaardconnectoren: Voor meer informatie, zie Authenticatie.
• REST API-connectors: ondersteund in openbare preview tussen tenants.

Note

Aangepaste connectors, computergebruik, agentstromen en MCP-tools worden niet ondersteund in multitenant-modus.

Onderwerpen

• Gebruikersvariabelen: Niet beschikbaar of ondersteund in de openbare preview.
• Authenticatieknoop: Alleen beschikbaar voor handmatige authenticatie.
• HTTP-knooppunt: werkt voor openbare eindpunten in openbare preview voor multitenant-modus.

Kanalen

Ondersteunde kanalen voor publieke preview zijn onder andere:

• Microsoft Teams
• Microsoft Copilot

Authentication

• Eindgebruikersauthenticatie: Niet ondersteund. De client vraagt gebruikers om de verbindingsbeheerder te openen, maar kan de aanvraag niet voltooien omdat deze de gebruiker naar hun eigen Copilot Studio-verbindingsbeheer verzendt op een andere locatie dan waar de agent zich bevindt.
• OAuth: Niet ondersteund voor handmatig authenticeren.
• Graph/Microsoft 365 standaardconnectors: niet ondersteund.
• Aangepaste connectoren: Niet ondersteund.
• Makerauthenticatie (service principal) op standaardtools: Ondersteund in publieke preview.
• Manuele authenticatie met Microsoft Entra-gebruikers-ID en service-principal: Niet ondersteund in openbare preview.
• Gastgebruikers: Niet ondersteund.

Overige details

• Alleen één-op-één gesprekken worden ondersteund. Groepsgesprekken worden niet ondersteund.
• Multi-geo wordt niet ondersteund. In de publieke preview worden agenten gehost in één Dataverse-regio, en blijft de naleving van dataresidentie de verantwoordelijkheid van de partner.
• Government Community Cloud (GCC) en GCC High worden niet ondersteund.
• Handmatige authenticatie wordt nog niet ondersteund (binnenkort beschikbaar).

Note

Wees voorzichtig bij het gebruik van makerauthenticatie op connectoren. Makerauthenticatie op connectors kan details van je huurder aan derden blootstellen via URL's, enzovoort.

Analytics

• Geaggregeerde analyses: Niet beschikbaar in de publieke preview.
• Transcriptgegevens: Niet beschikbaar in publieke voorbeeldweergave.
• Download sessiegegevens: Niet beschikbaar in de openbare preview.
• Tevredenheid, effectiviteit, overzicht en reacties: Niet beschikbaar in de publieke preview.

Note

Kanaalstatistieken zijn gebaseerd op wat Teams biedt via de kanaalmogelijkheden en beschikbaarheid.

Beheerdersinstellingen

Beheerderscontroles voor de tenant van de agent host

Het Power Platform-beheercentrum (PPAC) beheert de multitenant-modus. Hosttenant-beheerders kunnen makers verhinderen om multitenant-modus voor agenten in te schakelen. Beheerders van de host-tenant kunnen naar het tenant-isolatiegebied in PPAC navigeren, dat standaard uitgeschakeld is. Wanneer je tenant-isolatie inschakelt, is de tenant geïsoleerd en kun je de multitenant-modus niet gebruiken. Als beheerders slechts een select aantal huurders willen toestaan om verbindingen met of van hun huurder te leggen, kunnen ze huurderisolatie inschakelen en de toestaanlijstfunctie gebruiken om die huurders voor inkomende en uitgaande huurders te specificeren. Zie Binnenkomende en uitgaande cross-tenant beperkingen voor meer informatie.

Als tenantisolatie is ingeschakeld, is de modus voor meerdere tenants niet beschikbaar in Copilot Studio.

Andere scenario's:

• Als tenantisolatie is ingeschakeld nadat een agent is ingeschakeld en gepubliceerd, geeft Copilot Studio een melding weer waarin wordt uitgelegd dat de agent niet meer werkt als multitenant. De agent gedraagt zich vervolgens hetzelfde als een agent met één huurder wanneer een andere huurder probeert toegang te krijgen.
• Als de beheerderscontrole is ingeschakeld (om multitenant te blokkeren) maar er een toestemmingslijst is, kunnen alleen huurders in de toestemmingslijst toegang krijgen tot de agent. Alle andere tenants zijn geblokkeerd, net als in de single-tenant modus.
• Beheersmaatregelen voor gegevensverliespreventie vereisen het gegevensbeheerbeleid van de hostagent.
• Copilot Studio staat het uitschakelen van het Teams-kanaal voor een agent toe. Deze actie verhindert dat de agent reageert in de Teams-client.
• Als het kanaal Teams en Microsoft Copilot is uitgeschakeld, verstoort deze actie de service voor je agent. Je kunt je agent weer inschakelen, aangezien je agent-ID niet veranderd is. Je moet mogelijk het publicatieproces opnieuw doorlopen.
• Het bijwerken van een agent is hetzelfde als voor Copilot Studio. Makers zouden Publish moeten gebruiken om wijzigingen te pushen naar de live agent die wordt gebruikt. Nieuwe updates hoeven niet via de Teams-winkel gepubliceerd te worden. Het beleid van de Teams Store heeft eigen verwachtingen over het bijwerken van een agent als metadata met betrekking tot de agent, zoals doel, termen, links, enzovoort, wordt gewijzigd.

Beheerbesturingselementen voor Copilot Studio in de client

In de clienttenant waar de agent wordt gebruikt, zijn er geen wijzigingen voor Microsoft Admin Center (MAC)-beheerders. MAC-beheerders hebben controle over een CEA door Copilot Studio op dezelfde manier te gebruiken als agents met aangepaste engine.

Facturering en licenties

Jij bent verantwoordelijk voor de facturering als gasthuurder. Deze verantwoordelijkheid is dezelfde als voor pro-code agents in de store en voor klanten die agents voor hun eigen gebruikers implementeren. Voor meer informatie over facturering, zie Sessies beheren en capaciteit.

Gasthuurders moeten hun facturering beheren als onderdeel van het product en ervoor zorgen dat deze voldoende credits en facturatieconfiguraties heeft om de doelgroep te ondersteunen waartoe ze toegang krijgen.

Multitenant-modus wordt alleen ondersteund in openbare preview door hosttenants met een volledige Copilot Studio-licentie.

Als de partner niet voldoende factureert en zonder tegoeden komt te zitten, wordt de eindgebruiker getroffen en ontvangt hij een foutmelding bij de agent. Voordat dit gebeurt, worden de beheerders op de hoogte gebracht en gevraagd het probleem via een automatische melding aan te pakken. Het maximum aantal Copilot Studio-tegoeden en -sessies dat u aan een omgeving kunt toewijzen, is het hoogste dat u kunt toewijzen.

Als partners of klanten hun agent publiceren in de Teams Store, kan agentadoptie onverwachte facturering veroorzaken als het snel verloopt (bijvoorbeeld via de Teams Store of andere ontdekkingsmethoden). Je bent verantwoordelijk als hosttenant voor dit proces en voor de agent, op dezelfde manier als het publiceren van anonieme agenten vandaag op niet-geauthenticeerde kanalen (bijvoorbeeld op het web).

Softwareontwikkelingspraktijken

Als onderdeel van het Application Lifecycle Management (ALM)-proces van je agent, onderwerp multitenant-agenten aan hogere testniveaus. Multitenant-agenten hebben meer functionaliteitsgebieden om te testen, omdat sommige gebieden zich anders gedragen dan in single-tenant-modus.

Houd rekening met deze gebieden bij het werken met multitenant-agents in Copilot Studio:

• Configureer je ontwikkelomgevingen en stel het aanbevolen ANIM-proces in, dat bestaat uit een ontwikkelomgeving, een testomgeving, een testomgeving in een tweede tenant en een productieomgeving.
• Plan en configureer je capaciteit voor de omgeving. Plan ook een proactieve manier om die agenten te beoordelen en te monitoren.
• Als je van plan bent een multitenant-agent te maken, zorg dan dat je een aparte tenant hebt om te testen, zodat je de specifieke configuratie in multitenant-modus kunt testen door toegang te krijgen tot de agent vanuit een andere tenant dan de tenant waarin de agent wordt gehost.
  • Je kunt je agent sideloaden in je testclienttenant en het tenant isolation-beleid configureren in je host Power Platform Admin zodat het specifiek werkt met je testomgevingsconfiguratie.
  • Een klant of partner kan het zippakket installeren dat verwijst naar een agent die in Copilot Studio wordt uitgevoerd. Het .ZIP-pakket kan worden geüpload via het Teams- of Microsoft-beheercentrum en hetzelfde beheren als voor agents met één tenant in Copilot Studio.

Werk uw agent bij

Agents die in de Teams Store zijn gepubliceerd, hoeven alleen opnieuw te worden gepubliceerd via het valideringsproces van de Teams Store als er wijzigingen in metadata zijn (bijvoorbeeld doel, termen, links, enzovoort). Deze eis betekent dat wanneer een niet-Microsoft-agent wordt gepubliceerd en live wordt gemaakt, deze beschikbaar is voor alle huidige gebruikers. Deze vereiste is hetzelfde voor Copilot Studio als voor andere kanalen en verificatiemethoden.

Het manifest exporteren vanuit Copilot Studio

Wanneer je klaar bent om de agent te testen in de Microsoft Teams- of Microsoft Copilot-client in een andere tenant, moet je de agent beschikbaar maken in de tweede tenant. Voor testen moet een MAC-beheerder of een gebruiker met rechten om de agent in hun client te sideloaden (verleend door een MAC-beheerder in de tweede tenant) de agent sideloaden naar de andere tenant.

U kunt de toegang van de hosttenant beperken met behulp van het isolatiebeleid voor tenants in het Power Platform-beheercentrum. Voeg de tenantinformatie van uw testclient toe wanneer u test op uw eigen specifieke tenants en het proces van levenscyclusbeheer voor toepassingen doorloopt.

Om het manifest .ZIP-bestand te exporteren, ga je naar Kanalen in Copilot Studio, selecteer je Teams en Microsoft Copilot kanaal, en selecteer je vervolgens Details bewerken.

Je kunt de naam, beschrijving en andere details in het manifestbestand aanpassen dat vereist is door Microsoft Teams en Microsoft Copilot. Het manifestbestand bevat belangrijke metadata over uw agent, die de cliënthuurder ziet wanneer zij uw agent beoordelen voor gebruik op hun huurder.

Nadat je de details hebt bewerkt, selecteer je Beschikbaarheidsopties om het .ZIP bestand te exporteren.

Deze actie downloadt een lokaal .ZIP bestand naar je machine. Het .ZIP-bestand heeft de pictogramkleur en manifestbestanden. Je kunt het manifest ook handmatig bewerken. Terwijl de functie in de publieke preview is, moeten makers het manifest bewerken, specifiek de Valid Domains node. Voor meer informatie, zie Maak je agent beschikbaar in Teams of Microsoft Copilot.

Verwante onderwerpen

• Maak je agent beschikbaar in Teams of Microsoft Copilot: Dit artikel bevat documentatie over sideloading en publiceren naar de wereldwijde Teams Store.
• Best practices, probleemoplossing en aanvullende informatie: Dit artikel bevat richtlijnen over de softwareontwikkelingscyclus bij het bouwen van agents, overwegingen, probleemoplossing en roadmap-informatie.