Oversigt over multitenanttilstand i Copilot Studio (prøveversion)

[Denne artikel er dokumentation til en foreløbig version og er med forbehold for ændringer.]

Copilot Studio understøtter nu multitenanttilstand. Denne nye support gør det muligt for en agent at blive brugt i en anden Microsoft Entra lejer end den lejer, der er vært for den. Multitenanttilstand ændrer funktionsmåden for en Copilot Studio-agent, når der bruges specifikke godkendelsesindstillinger. I denne artikel beskrives godkendelse i Copilot Studio, og rollegodkendelsen afspilles i multitenanttilstand.

Vigtig

Multitenantfunktionen i Copilot Studio er en offentlig prøveversion og er tydeligt markeret i Copilot Studio for udviklere. Den har termer, der refereres til i produktet. Offentlige forhåndsvisningsfunktioner understøttes ikke til brug i en generelt tilgængelig kapacitet. Du kan dog prøve offentlige preview-agenter på Teams/Agent Store under specifikke retningslinjer. Partnere bør fremhæve over for deres slutbrugere, at deres agenter bruger forhåndsvisningsfunktionalitet, ved at inkludere et Forhåndsvisningsbanner i ikonet.

Copilot Studio Makers kan vælge mellem tre godkendelsesindstillinger for agenter:

Godkendelsesmetode Beskrivende tekst
Ingen autentificering Denne mulighed tillader eksterne brugere at bruge agenter, som du bygger og hoster på platformen. Når du vælger denne mulighed for din agent, sender klienten, hvor brugeren tilgår agenten, ikke en adgangstoken til agenten. Dette scenarie er almindeligt for hjemmesider med selvbetjenings-FAQs, for eksempel. Denne indstilling giver enhver bruger adgang til agenten.
Godkend med Microsoft Denne mulighed bruger en integreret autentificeringsfunktion. Agenten forventer en Microsoft Entra ID identitet fra klienten. Teams og andre Microsoft-klienter sender denne identitet, når de godkender brugere med arbejds- eller skole Microsoft Entra-konti. Agenten bruger denne identitet til at lade brugeren få adgang til dens funktionalitet. Denne indstilling i Copilot Studio udfører en enkeltlogonoplevelse (SSO) mellem klienten, agenten og brugeren. Brugeren behøver ikke først logge ind for at få adgang til klienten og derefter en anden gang for at få adgang til agenten.
Autentificer manuelt Når indstillingen er valgt, signalerer den eksplicit, at Copilot Studio skal ikke håndtere eller forvente identiteten. Producenten konfigurerer autentificering for den valgte autentificeringsmulighed. Manuel autentificering bruges typisk, når man ikke bruger en Microsoft-baseret identitet eller klient. For eksempel indlejrer du agenten i en hjemmeside eller en native applikation og vil autentificere eksterne brugere. Når du bruger manuel autentificering, kan du vælge typen af autentificering:
  • OAuth: Når OAuth vælges, bliver brugeren, der tilgår agenten på klienten, bedt om at logge ind med OAuth. Dette åbner et loginflow baseret på de maker-konfigurerede OAuth-identitetsudbydere. Når brugeren logger ind med succes, modtager agenten en adgangstoken og kan bruge tokenet i nedstrømstjenester og til personalisering.
  • Microsoft Entra-baserede identitetsindstillinger: Der er indstillinger for tjenestebaseret identitet og brugerbaseret identitet (f.eks. certifikater og Microsoft Entra brugergodkendelse). Serviceautentificering er typisk for, når agenten har brug for sin egen identitet. Brugerbaseret enhed bruges til at få adgang til downstream-tjenester, der kræver autentificering. Copilot Studio-udviklere kan vælge at konfigurere brugergodkendelse manuelt med Microsoft Entra.

Vigtig

Hvis du vil bruge Microsoft Teams som kanal i Copilot Studio, skal du vælge Authenticate med Microsoft eller Authenticate manuelt. Dette krav er designet og tilpasser identitetsmodeller. Teams kræver, at en bruger altid er logget ind, så som følge heraf kan Teams-agenter ikke være anonyme. Det samme gælder for alle Microsoft-kanaler (f.eks. SharePoint).

Multitenant-tilstand

I tilstanden med en enkelt lejer skal Microsoft Teams brugere være logget på og få adgang til Copilot Studio-agenten ved hjælp af den samme lejer, som hvor agenten hostes i Copilot Studio. Hvis en bruger fra en anden lejer (for eksempel example@zavainsurance.com forsøger at få adgang til en agent, der hostes i example@contoso.com), modtager brugeren en besked fra agenten: "Du har ikke adgang til at tale med denne bot. Kontakt ejeren."

Skærmbillede af testpanelet, der viser agentens svar, når multitenant-tilstand ikke er aktiveret.

Når du aktiverer multitenanttilstand i Copilot Studio for en agent, kan brugerne få adgang til den agent, der hostes i én lejer fra en anden Microsoft Entra ID lejer.

Denne funktion er i offentlig forhåndsvisning. Multitenant-tilstand understøtter Copilot Studio-agenter i Microsoft Teams og Microsoft Copilot. Multitenanttilstand gør det muligt at finde agenter i den globale Microsoft Teams Store, hvor agenter kan bruges fra klienter, når de er i to forskellige lejere.

Terminologi

Når du arbejder med agenter og forstår autentificering, er det vigtigt at adskille følgende adfærd:

  • Bruger-til-klient-autentificering: For eksempel når en bruger logger ind på en Teams-klient eller logger ind på en hjemmeside ved at bruge deres Microsoft-konto. Denne godkendelse er ikke udelukkende relateret til Copilot Studio-agenten og sker uden for agenten.
  • Klient-til-agent-autentificering: Klienten sender information til agenten, og agenten forventer information fra klienten. Hvis du konfigurerer agenten til single sign-on (SSO), er autentificeringen usynlig for klientens slutbruger. Hvis ikke, bliver brugeren bedt om at logge ind hos agenten separat.
  • Agentautentificering til andre autentificerede tjenester: Agenten skal kommunikere med andre tjenester, og i nogle tilfælde skal identiteten viderebringes. Den identitet kan være agentens identitet (serviceprincipal), hvis agenten har en identitet. Ellers kan agenten bruge brugerens identitet, hvis agenten har tilladelser til det, tilgå ressourcer og udføre handlinger (ved at bruge delegerede tilladelser fra den indloggede klientbruger).

Der er også en blended godkendelsesindstilling, hvor et agentgodkendelsesflow kan åbnes via emner i Copilot Studio ved hjælp af Authenticate node, som beder brugeren om at logge på. Blandet godkendelse er kun tilgængelig, når Authenticate manuelt er valgt i Copilot Studio, og når Krævs brugere at logge på er slået fra.

Når du bruger multitenant-tilstand, skal du bruge følgende terminologi:

  • host er det miljø, hvor Copilot Studio hostes, kører fra og faktureres fra. Værten er stedet, hvor du bygger Copilot Studio-agenten. Værten er også stedet, hvor agenten bevæger sig gennem den standard softwareudviklingscyklus, efterhånden som agenten udvikles, testes og flyttes til et produktionsmiljø til live-brug. Denne proces adskiller sig ikke fra tilfældet for agenter i single-tenant mode.

  • Det er klienten, du får adgang til agenten. Denne klientapplikation er som Microsoft Teams eller Microsoft Copilot. Fra disse klienter får brugeren adgang til og bruger agenten ved at logge på ved hjælp af Microsoft Entra ID. Klienten kræver eller bruger ingen Power Platform-infrastruktur, herunder Copilot Studio.

I følgende dokumentation beskrives, hvilke funktioner der i øjeblikket understøttes i offentlig prøveversion, når multitenanttilstand er slået til i Copilot Studio.

Understøttet funktionalitet

Offentlig forhåndsvisning til multitenant-support lanceres i begrænset omfang.

Når agenten er i multitenant-tilstand, opfører den sig anderledes. Ikke alle funktioner i Copilot Studio understøttes. Forskellene kan enten skyldes funktionalitetens art (f.eks. SharePoint viden ikke fungerer på tværs af lejere) eller på grund af omfanget af den offentlige prøveversion. De følgende afsnit indeholder flere detaljer.

Vigtige højdepunkter:

  • Multitenant-tilstand understøtter endnu ikke slutbruger-autentificering. Denne begrænsning betyder, at du ikke kan delegere adgang til at bruge brugerens identitet i nedstrøms adfærd. Værdien af denne funktion er at overføre autentificeret information til agenten fra delegeret autentificering ved brug af andre tjenester. Denne funktionalitet er endnu ikke tilgængelig.
  • Samtaletransskriptioner slås fra, når multitenant-tilstand er slået til. Denne begrænsning beskytter privatlivet for de downstream-lejere, der bruger agenten.
  • Værtslejere er ansvarlige for faktureringen af Copilot Studio-agenten på samme måde som for tilstand med en enkelt lejer. Microsoft-partnere, der implementerer til den globale Teams og agent store og søger forskellige arbejdsmønstre med deres slutkunder, såsom opkrævning for agenter i den globale Teams Store, bør konsultere Partner Center for at se, hvilke programmer der er tilgængelige.

Det følgende afsnit opsummerer den funktionalitet, der vides at virke eller ikke virker, når agenten bruges i multitenant-tilstand. Hvis noget ikke er angivet her som virkende, kan du forvente, at det ikke virker i multitenant-tilstand. Funktionaliteten i Copilot Studio ændres ikke til at fungere anderledes, når multitenanttilstand er slået til. For eksempel kører datapolitikker stadig på værtslejeren, og funktioner og funktionalitet, hvis de understøttes, har samme funktionssæt som i enkelt-lejer tilstand.

Viden

  • Dataverse Upload: Understøttes i offentlig forhåndsvisning på tværs af lejere.
  • Offentlige hjemmesider: Understøttet i offentlig forhåndsvisning på tværs af lejere.

Værktøjer

  • Prompts: Understøttet i offentlig forhåndsvisning på tværs af lejere.
  • Begrænsede standardforbindelser: For yderligere information, se Autentificering.
  • REST API-connectorer: Understøttes i offentlig forhåndsvisning på tværs af lejere.

Note

Brugerdefinerede connectors, computerbrug, agentflows og MCP-værktøjer understøttes ikke i multitenant-tilstand.

emner

  • Brugervariabler: Ikke tilgængelige eller understøttede i offentlig forhåndsvisning.
  • Autentificeringsnode: Kun tilgængelig til manuel autentificering.
  • HTTP-node: Virker for offentlige endepunkter i offentlig forhåndsvisning i multitenant-tilstand.

Kanaler

Understøttede kanaler til offentlig forhåndsvisning inkluderer:

  • Microsoft Teams
  • Microsoft Copilot

Godkendelse

Note

Eksterne B2B-brugere behandles ikke som brugere af værtslejer, selvom deres mappebrugertype er sat til Member. For at få adgang til agenten skal brugere autentificere sig fra deres hjemmetenant via en understøttet multitenant-kanal.

  • Slutbrugerautentificering: Ikke understøttet. Klienten beder brugerne om at åbne forbindelsesstyringen, men kan ikke fuldføre anmodningen, da den sender brugeren til deres egen Copilot Studio-forbindelsesstyring på en anden placering end den, hvor agenten er placeret.
  • OAuth: Understøttes ikke manuel autentificering.
  • Graph/Microsoft 365 standardconnectors: Understøttes ikke.
  • Specialanskaffede stik: Ikke understøttet.
  • Maker-autentificering (serviceprincipal) på standardværktøjer: Understøttes i offentlig forhåndsvisning.
  • Manuel godkendelse med Microsoft Entra bruger-id og tjenesteprincipal: Understøttes ikke i offentlig prøveversion.
  • Gæstebrugere: Ikke understøttet.

Andre detaljer

  • Kun en-til-en samtaler understøttes. Gruppesamtaler understøttes ikke.
  • Multi-geo understøttes ikke. I offentlig forhåndsvisning hostes agenterne i en enkelt Dataverse-region, og overholdelse af data-residency forbliver partnerens ansvar.
  • Government Community Cloud (GCC) og GCC High understøttes ikke.
  • Manuel autentificering understøttes endnu ikke (kommer snart).

Note

Vær forsigtig, når du bruger maker-autentificering på stik. Maker-autentificering på connectors kan eksponere detaljer om din lejer til tredjepart via URL'er og lignende.

Analyse

  • Aggregerede analyser: Ikke tilgængelig i offentlig forhåndsvisning.
  • Transskriptionsdata: Ikke tilgængelig i offentlig forhåndsvisning.
  • Download sessionsdata: Ikke tilgængelig i offentlig forhåndsvisning.
  • Tilfredshed, effektivitet, overblik og reaktioner: Ikke tilgængelig i offentlig forhåndsvisning.

Note

Kanalmetrikker er baseret på, hvad Teams tilbyder gennem kanalens kapaciteter og tilgængelighed.

Administratorindstillinger

Administrationskontroller for agentværtlejerenhed

Power Platform-administrationscenteret (PPAC) styrer multitenant-tilstand. Værts-lejeradministratorer kan forhindre producenter i at aktivere multitenant-tilstand for agenter. Administratorer for værtslejeren kan navigere til lejerens isolationsområde i PPAC, som er slået fra som standard. Når du slår lejerisolering til, er lejeren isoleret, og du kan ikke bruge multitenant-tilstand. Hvis administratorer kun vil tillade et udvalgt sæt lejere at etablere forbindelser til eller fra deres lejer, kan de slå lejerisolering til og bruge tilladelseslisten til at specificere disse lejere for indgående og udgående lejere. For yderligere information, se Cross-tenant inbound and outbound restriktioner.

Skærmbillede af panelet Security: Identity and Access Management, der viser, hvor man aktiverer lejerisolering.

Hvis lejerisolation er slået til, er multitenanttilstand ikke tilgængelig i Copilot Studio.

Andre scenarier:

  • Hvis lejerisolation er slået til, når en agent er aktiveret og publiceret, viser Copilot Studio en meddelelse, der forklarer, at agenten ikke længere fungerer som multitenant. Agenten opfører sig derefter som en enkeltlejer-agent, når en anden lejer forsøger at få adgang til den.
  • Hvis admin-kontrollen er slået til (for at blokere multitenant), men der er en tilladelsesliste, kan kun lejere i tilladelseslisten få adgang til agenten. Alle andre lejere er blokeret, ligesom i enkelt-lejer tilstand.
  • Kontroller for datatabsforebyggelse forventer værtsagentens datapolitikker.
  • Copilot Studio tillader deaktivering af Teams-kanalen for en agent. Denne handling forhindrer agenten i at svare på Teams-klienten.
  • Hvis Microsoft 365- og Microsoft Teams-kanalen er slået fra, afbryder denne handling tjenesten for din agent. Du kan slå din agent til igen, da dit agent-ID ikke er ændret. Du kan blive pålagt at gennemføre publiceringsprocessen igen.
  • Opdatering af en agent er den samme som for Copilot Studio. Skabere bør bruge Publish til at sende ændringer til den aktive agent, der er i brug. Nye opdateringer behøver ikke at blive offentliggjort via Teams Store. Teams Store-politikkerne har deres egne forventninger til at opdatere en agent, hvis der er metadata relateret til agenten, for eksempel formål, termer, links osv., der ændres.

Administratorkontrolelementer for Copilot Studio i klienten

I klientlejeren, hvor agenten bruges, er der ingen ændringer for Microsoft Admin Center (MAC)-administratorer. MAC-administratorer har kontrol over en CEA ved hjælp af Copilot Studio på samme måde som brugerdefinerede programagenter med prokode.

Fakturering og licensering

Du er ansvarlig for at fakturere som værtslejer. Dette ansvar er det samme som for pro-code-agenter i butikken og for kunder, der deployerer agenter til deres egne brugere. For mere information om fakturering, se Administrer sessioner og kapacitet.

Værtslejere skal administrere deres fakturering som en del af produktet og sikre, at det har tilstrækkelige kreditter og faktureringskonfiguration til at understøtte det publikum, de giver adgang til.

Multitenanttilstand understøttes kun i offentlig prøveversion af værtslejere med en fuld Copilot Studio-licens.

Hvis partneren ikke har tilstrækkelig fakturering og løber tør for kreditter, bliver slutbrugeren påvirket og modtager en fejl hos agenten. Før dette sker, bliver administratorerne underrettet og bedt om at tage hånd om problemet via en automatisk notifikation. Det maksimale antal Copilot Studio-kreditter og -sessioner, som du kan tildele til et miljø, er det højeste, du kan tildele.

Hvis partnere eller kunder offentliggør deres agent i Teams Store, kan agentadoption forårsage uventet fakturering, hvis det går hurtigt (for eksempel via Teams Store eller andre discovery-metoder). Du er ansvarlig som værtslejer for denne proces og for agenten på samme måde som ved at offentliggøre anonyme agenter i dag på ikke-autentificerede kanaler (for eksempel på nettet).

Softwareudviklingspraksis

Som en del af din agents applikationslivscyklusstyringsproces (ALM) kan du udsætte multitenant-agenter for højere testniveauer. Multitenant-agenter har flere funktionalitetsområder at teste, da nogle områder opfører sig anderledes end i single-tenant-tilstand.

Overvej disse områder, når du arbejder med multitenantagenter i Copilot Studio:

  • Konfigurér dine udviklingsmiljøer og opsæt den anbefalede ALM-proces, som inkluderer et udviklingsmiljø, et testmiljø, et testmiljø i en anden lejer og et produktionsmiljø.
  • Planlæg og konfigurer din kapacitet til miljøerne. Planlæg også en proaktiv måde at gennemgå og overvåge disse agenter på.
  • Hvis du planlægger at oprette en multitenant-agent, skal du sikre dig, at du har en separat lejer til test, så du kan teste den specifikke konfiguration i multitenant-tilstand ved at tilgå agenten fra en anden tenant end den, agenten hoster i.
    • Du kan sideloade din agent i din testklient-tenant og konfigurere tenant isolation-politikken i din host Power Platform Admin, så den fungerer specifikt med din testmiljøkonfiguration.
    • En kunde eller partner kan sideloade den .ZIP pakke, der refererer til en agent, der kører i Copilot Studio. Pakken .ZIP kan uploades via Teams eller Microsoft Administration og administreres på samme måde som for agenter med en enkelt lejer i Copilot Studio.

Opdater din agent

Agenter, der er udgivet i Teams Store, kræver kun en genudgivelse via valideringsprocessen i Teams Store , hvis der sker ændringer i metadata (for eksempel formål, termer, links osv.). Dette krav betyder, at når en ikke-Microsoft-agent bliver offentliggjort og gjort live, er den tilgængelig for alle nuværende brugere. Dette krav er det samme for Copilot Studio i dag som for andre kanaler og godkendelsesmetoder.

Eksportér manifestet fra Copilot Studio

Når du er klar til at teste agenten i Microsoft Teams eller Microsoft Copilot-klienten i en anden lejer, skal du gøre agenten tilgængelig i den anden lejer. Til test skal en MAC-administrator eller en bruger med tilladelser til at sideloade agenten i deres klient (givet af en MAC-administrator i den anden lejer) sideloade agenten ind i den anden lejer.

Du kan begrænse værtslejers adgang ved at bruge lejerisolationspolitikken i Power Platform Administration. Tilføj dine testklient-lejeroplysninger, når du tester på tværs af dine egne specifikke lejere og bevæger dig gennem applikationslivscyklusstyringsprocessen.

For at eksportere manifestet .ZIP filen, gå til Kanaler i Copilot Studio, vælg Microsoft 365 og Microsoft Teams kanal, og vælg derefter Rediger Detaljer.

Skærmbillede af Teams- og Microsoft Copilot-kanalens panelet Rediger Detaljer.

Du kan redigere navn, beskrivelse og andre detaljer i manifestfilen, som kræves af Microsoft Teams og Microsoft Copilot. Manifestfilen indeholder vigtige metadata om din agent, som klientlejeren ser, når den gennemgår din agent til brug på deres lejer.

Efter du har redigeret detaljerne, vælg Tilgængelighedsindstillinger for at eksportere .ZIP-filen.

Skærmbillede af kanalpanelet Teams og Microsoft Copilot, der viser knappen Tilgængelighedsmuligheder.

Denne handling downloader en lokal .ZIP-fil til din maskine. Den .ZIP fil har ikonfarven og manifestfilerne. Du kan også redigere manifestet manuelt. Mens funktionen er i offentlig forhåndsvisning, skal skaberne redigere manifestet, specifikt Valid Domains noden. For mere information, se Gør din agent tilgængelig i Teams eller Microsoft Copilot.

  • Sidst opdateret den