Visão geral do modo multi-inquilino no Copilot Studio (prévia)

[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]

Copilot Studio agora oferece suporte ao modo multilocatário. Esse novo suporte permite que um agente seja usado em um locatário Microsoft Entra diferente do locatário que o hospeda. O modo multitenant muda o comportamento de um agente do Copilot Studio quando usa opções específicas de autenticação. Este artigo descreve a autenticação no Copilot Studio e o papel que a autenticação desempenha no modo multilocatário.

Importante

O recurso multilocatário no Copilot Studio está em versão prévia pública e está claramente marcado no Copilot Studio para criadores. Tem termos referenciados no produto. Recursos de pré-visualização pública não são suportados para uso em uma capacidade geralmente disponível. No entanto, você pode testar agentes públicos de pré-visualização no Teams/Agent Store sob diretrizes específicas. Os parceiros devem destacar para seus usuários finais que seus agentes usam a funcionalidade de pré-visualização, incluindo um banner de Pré-visualização no ícone.

Copilot Studio Makers pode selecionar entre três opções de autenticação para agentes:

Método de autenticação	Descrição
Sem autenticação	Quando você seleciona a configuração No Authenticaton na área Authentication e Settings do agente, o Copilot Studio permite que usuários externos usem agentes que você compila e hospeda na plataforma. Quando você ativa essa configuração, o cliente onde o usuário acessa o agente não passa um token de acesso para o agente. Você é comum encontrar esse tipo de situação em sites em casos de uso do tipo FAQ de autoatendimento. Essa configuração permite que qualquer usuário acesse o agente.
Autenticar com a Microsoft	Essa opção utiliza uma opção de autenticação integrada. O agente espera que o cliente forneça uma identidade Microsoft Entra ID. O Teams e outros clientes da Microsoft enviam essa identidade quando autenticam usuários com contas do Microsoft Entra corporativas ou escolares. O agente usa essa identidade para permitir que o usuário acesse sua funcionalidade. Essa opção no Copilot Studio executa uma experiência de SSO (logon único) entre o cliente, o agente e o usuário. O usuário não precisa primeiro fazer login para acessar o cliente e depois uma segunda vez para acessar o agente.
Autenticar manualmente	Quando selecionada, essa opção indica explicitamente para o Copilot Studio para não manipular ou esperar a identidade. O criador configura a autenticação para a opção de autenticação selecionada. A autenticação manual é tipicamente usada quando não se utiliza uma identidade ou cliente baseado na Microsoft. Por exemplo, você está incorporando o agente em um site ou aplicativo nativo e quer autenticar usuários externos. Ao usar autenticação manual, você pode selecionar o tipo de autenticação: OAuth: Quando o OAuth é selecionado, o usuário que acessa o agente no cliente é solicitado a fazer login com o OAuth. Isso abre um fluxo de login baseado nos provedores de identidade OAuth configurados pelo fabricante. Uma vez que o usuário faz login com sucesso, o agente recebe um token de acesso e pode usar o token em serviços posteriores e para personalização. Opções de identidade baseadas no Microsoft Entra: Há opções para identidades baseadas em serviços e identidades baseadas no usuário (por exemplo, certificados e autenticação de usuário do Microsoft Entra). A autenticação de serviço é tipicamente para quando o agente precisa de sua própria identidade. A entidade baseada no usuário é usada para acessar serviços posteriores que exigem autenticação. Os criadores do Copilot Studio podem optar por configurar manualmente a autenticação do usuário com o Microsoft Entra.

Importante

Para usar Microsoft Teams como canal no Copilot Studio, selecione Authenticate com Microsoft ou Authenticate Manualmente. Esse requisito é intencional e alinha modelos de identidade. O Teams exige que o usuário esteja sempre logado, então, como resultado, os agentes do Teams não podem ser anônimos. O mesmo vale para todos os canais da Microsoft (por exemplo, SharePoint).

Modo multilocatário

No modo de tenant único, os usuários do Microsoft Teams precisam estar conectados e acessar o agente do Copilot Studio usando o mesmo tenant onde o agente está hospedado no Copilot Studio. Se um usuário de outro locatário (por exemplo, example@zavainsurance.com tentar acessar um agente hospedado em example@contoso.com), o usuário recebe uma mensagem do agente: "Você não tem acesso para falar com este bot. Entre em contato com o dono."

Quando você habilita o modo multilocatário no Copilot Studio para um agente, os usuários podem acessar o agente hospedado em um tenant a partir de outro tenant do Microsoft Entra ID diferente.

Esse recurso está em versão prévia pública. O modo multitenant suporta agentes do Copilot Studio no Microsoft Teams e Microsoft Copilot. O modo multilocatário permite que os agentes sejam descobertos na Microsoft Teams Store global, onde os agentes podem ser utilizados por clientes que estão em dois locatários diferentes.

Terminologia

Quando você trabalha com agentes e entende autenticação, é importante separar os seguintes comportamentos:

• Autenticação de usuário para cliente: Por exemplo, quando um usuário faz login em um cliente do Teams ou faz login em um site usando sua conta Microsoft. Essa autenticação não está estritamente relacionada ao agente do Copilot Studio e ocorre fora do agente.
• Autenticação de cliente para agente: O cliente envia informações ao agente, e o agente espera informações do cliente. Se você configurar o agente para single log-on (SSO), a autenticação fica invisível para o usuário final do cliente. Se não, o usuário é solicitado a fazer login com o agente separadamente.
• Autenticação de agentes para outros serviços autenticados: O agente precisa se comunicar com outros serviços e, em alguns casos, precisa repassar identidade. Essa identidade pode ser a identidade do agente (principal de serviço) se o agente tiver uma identidade. Caso contrário, o agente pode usar a identidade do usuário se ele tiver permissões para isso, acessando recursos e realizando ações (usando permissões delegadas pelo usuário cliente logado).

Há também uma experiência de opção de autenticação integrada, onde um fluxo de autenticação de agente pode ser controlado por meio de tópicos no Copilot Studio, usando o nó Autenticar, que solicita que o usuário entre. A autenticação combinada só estará disponível quando Autenticar Manualmente estiver selecionado no Copilot Studio e quando Exigir que os usuários façam login estiver desativado.

Quando você usa o modo multiinquilino, utilize a seguinte terminologia:

• O host é o ambiente onde o Copilot Studio é hospedado, funciona e é cobrado. O host é onde você cria o agente do Copilot Studio. O host também é onde o agente passa pelo ciclo de vida padrão do desenvolvimento de software enquanto ele é desenvolvido, testado e transferido para um ambiente de produção para uso ao vivo. Esse processo não é diferente do caso dos agentes no modo de inquilino único.

• O cliente é onde você acessa o agente. Esse aplicativo cliente é como o Microsoft Teams ou o Microsoft Copilot. Desses clientes, o usuário acessa e usa o agente, entrando usando Microsoft Entra ID. O cliente requer ou não usa nenhuma infraestrutura do Power Platform, incluindo Copilot Studio.

A documentação a seguir aborda as funcionalidades que são atualmente suportadas na versão prévia pública quando o modo multi-inquilino é ativado no Copilot Studio.

Funcionalidade suportada

A prévia pública para multitenant está sendo lançada dentro de um escopo específico.

Quando o agente está em modo multitenant, ele se comporta de forma diferente. Nem todos os recursos do Copilot Studio têm suporte. As diferenças podem ser devidas à natureza da funcionalidade (por exemplo, o conhecimento do SharePoint não funciona entre inquilinos) ou devido ao escopo da versão prévia pública. As seções a seguir contêm mais detalhes.

Destaques importantes:

• O modo multitenant ainda não suporta autenticação do usuário final. Essa limitação significa que você não pode delegar acesso para usar a identidade do usuário em comportamentos posteriores. O valor desse recurso é passar informações autenticadas ao agente a partir da autenticação delegada, utilizando outros serviços. Essa funcionalidade ainda não está disponível.
• As transcrições das conversas são desativadas quando o modo multitenant está ativado. Essa restrição protege a privacidade dos inquilinos posteriores que utilizam o agente.
• Os hospedeiros são responsáveis pelo faturamento do agente do Copilot Studio da mesma forma que no modo de locatário único. Parceiros da Microsoft que se implantam na loja global do Teams e do agente, que buscam diferentes padrões de trabalho com seus clientes finais, como cobrar por agentes na loja global do Teams, devem consultar o Centro de Parceiros para saber quais programas estão disponíveis.

A seção a seguir resume a funcionalidade conhecida por funcionar ou não ao usar o agente no modo multitenant. Se algo não estiver listado aqui como funcionando, é provável que não funcione no modo de multiinquilinos. A funcionalidade no Copilot Studio não é modificada para funcionar de forma diferente quando o modo multitenancy estiver ativado. Por exemplo, políticas de dados ainda rodam no locatário host, e recursos e funcionalidades, se suportados, têm o mesmo conjunto de recursos que no modo de locatário único.

Conhecimento

• Upload do Dataverse: Suportado em versão prévia pública entre os locatários.
• Sites públicos: Suportados em versão pública de pré-visualização entre locatários.

Ferramentas

• Prompts: Suportados na pré-visualização pública entre os locatários.
• Conectores padrão limitados: Para mais informações, veja Autenticação.
• Conectores REST API: Suportados em visualização pública entre os tenants.

Note

Conectores personalizados, uso de computador, fluxos de agentes e ferramentas MCP não são suportados no modo multiinquilino.

Tópicos

• Variáveis de usuário: Não disponíveis nem suportadas em pré-visualização pública.
• Nó de autenticação: Disponível apenas para autenticação manual.
• Nó HTTP: Funciona para endpoints públicos em pré-visualização pública para modo multi-inquilino.

Canais

Canais suportados para pré-visualização pública incluem:

• Equipes da Microsoft
• Microsoft Copilot

Autenticação

• Autenticação do usuário final: Não suportada. O cliente solicita que os usuários abram o gerenciador de conexões, mas não podem concluir a solicitação, pois ele envia o usuário para seu próprio gerenciador de conexões do Copilot Studio em um local diferente de onde o agente está localizado.
• OAuth: Não suportado para autenticar manualmente.
• Graph/Microsoft 365 conectores padrão: sem suporte.
• Conectores personalizados: Não são suportados.
• Autenticação de maker (principal de serviço) em ferramentas padrão: Suportada na versão prévia pública.
• A autenticação manual com o ID de usuário do Microsoft Entra e principal de serviço: não é suportado na visualização pública.
• Usuários convidados: Não suportado.

Outros detalhes

• Apenas conversas individuais são suportadas. Conversas em grupo não são suportadas.
• Multi-geo não é suportado. No prévia pública, os agentes são hospedados em uma única região do Dataverse, e a conformidade com a residência de dados permanece sob responsabilidade do parceiro.
• O Government Community Cloud (GCC) e o GCC High não são suportados.
• A autenticação manual ainda não é suportada (em breve).

Note

Tenha cautela ao usar autenticação do fabricante nos conectores. A autenticação do maker em conectores pode expor detalhes do seu inquilino para terceiros por meio de URLs e assim por diante.

Análises

• Análises agregadas: Não disponíveis na prévia pública.
• Dados da transcrição: Não disponível em prévia pública.
• Baixar dados da sessão: Não disponível na prévia pública.
• Satisfação, eficácia, visão geral e reações: Não disponível na prévia pública.

Note

As métricas do canal se baseiam no que o Teams oferece por meio das capacidades e disponibilidade do canal.

Controles de administrador

Controles de administrador para o host do agente

O centro de administração do Power Platform (PPAC) controla o modo multilocatário. Administradores de hosts podem impedir que os criadores ativem o modo multitenant para agentes. Administradores do locatário host podem acessar a área de isolamento do locatário no PPAC, que está desativada por padrão. Quando você ativa o isolamento do inquilino, o inquilino fica isolado e você não pode usar o modo multiinquilino. Se os administradores quiserem permitir que apenas um conjunto seleto de inquilinos estabeleça conexões com ou de seu locatário, eles podem ativar o isolamento de inquilinos e usar o recurso de lista de permissão para especificar esses inquilinos para entrada e saída. Para mais informações, veja Restrições de entrada e saída entre inquilinos.

Se o isolamento do inquilino estiver ativado, o modo multitenant não estará disponível no Copilot Studio.

Outros cenários:

• Se o isolamento do inquilino estiver ativado depois que um agente for habilitado e publicado, o Copilot Studio exibirá uma notificação explicando que o agente não funcionará mais no modo multitenant. O agente então se comporta da mesma forma que um agente de inquilino único quando outro inquilino tenta acessá-lo.
• Se o controle de administrador estiver ativado (para bloquear multiinquilino), mas houver uma entrada na lista de permitidos, apenas os inquilinos na lista de permitir podem acessar o agente. Todos os outros inquilinos são bloqueados, igual ao modo de inquilino único.
• Os controles de prevenção de perda de dados esperam as políticas de dados do agente anfitrião.
• Copilot Studio permite a desabilitação do canal do Teams para um agente. Essa ação impede o agente de responder no cliente do Teams.
• Se o canal Teams e Microsoft Copilot estiver desativado, essa ação interrompe o serviço para seu agente. Você pode ativar seu agente novamente, já que seu ID de agente não foi alterado. Pode ser necessário completar novamente o processo de publicação.
• Atualizar um agente é o mesmo procedimento usado para o Copilot Studio. Criadores devem usar Publish para implementar alterações no agente ativo. Novas atualizações não precisam ser publicadas pela loja do Teams. As políticas da Teams Store têm suas próprias expectativas sobre atualizar um agente caso metadados relacionados ao agente, por exemplo, propósito, termos, links e assim por diante, sejam alterados.

Controles de administrador do Copilot Studio no cliente

No tenant cliente onde o agente está sendo usado, não há alterações para os administradores do Microsoft Admin Center (MAC). Os administradores MAC têm o controle de um CEA usando o Copilot Studio da mesma forma que os agentes de mecanismo personalizado pro-code.

Cobrança e licenciamento

Você é responsável pela cobrança como inquilino anfitrião. Essa responsabilidade é a mesma dos agentes pró-código na loja e dos clientes que implantam agentes para seus próprios usuários. Para mais informações sobre faturamento, veja Gerenciar sessões e capacidade.

Os locatários de host devem gerenciar seu faturamento como parte do produto e garantir que as configurações de faturamento e os créditos adequados estejam disponíveis para apoiar os usuários aos quais estão permitindo acesso.

O modo multilocatário tem suporte na versão preliminar pública somente por locatários de host com uma licença completa do Copilot Studio.

Se o parceiro não tiver faturamento suficiente e ficar sem créditos, o usuário final é afetado e recebe um erro com o agente. Antes disso acontecer, os administradores são notificados e solicitados a resolver o problema por meio de uma notificação automática. O número máximo de créditos e sessões do Copilot Studio que você pode alocar a um ambiente é o mais alto que você pode atribuir.

Se parceiros ou clientes publicarem seu agente na Teams Store, a adoção do agente pode causar faturamento inesperado se ocorrer em alta velocidade (por exemplo, via Teams Store ou outros métodos de descoberta). Você é responsável, como inquilino anfitrião, por esse processo e pelo agente, da mesma forma que hoje publica agentes anônimos em canais não autenticados (por exemplo, na web).

Práticas de desenvolvimento de software

Como parte do processo de gerenciamento do ciclo de vida da aplicação (ALM) do seu agente, submeta os agentes multitenant a níveis mais altos de teste. Agentes multitenant têm mais áreas de funcionalidade para testar, já que algumas áreas se comportam de forma diferente do modo de inquilino único.

Considere essas áreas ao trabalhar com agentes multilocatários no Copilot Studio:

• Configure seus ambientes de desenvolvimento e configure o processo ALM recomendado, que inclui um ambiente de desenvolvimento, um ambiente de teste, um ambiente de teste em um segundo tenant e um ambiente de produção.
• Planeje e configure sua capacidade para os ambientes. Além disso, planeje uma forma proativa de revisar e monitorar esses agentes.
• Se você planeja criar um agente multiinquilino, certifique-se de ter um tenant separado para testes, assim você pode testar a configuração específica no modo multitenant acessando o agente a partir de um inquilino diferente daquele em que o agente está hospedado.
  • Você pode carregar seu agente manualmente no seu tenant de teste e configurar a política de isolamento do tenant na administração do Power Platform no seu ambiente host para funcionar especificamente com a configuração do seu ambiente de teste.
  • Um cliente ou parceiro pode instalar manualmente o pacote .ZIP que faz referência a um agente que está sendo executado no Copilot Studio. O pacote .ZIP pode ser carregado por meio do Teams ou do Microsoft Admin Center e gerenciado da mesma maneira que para agentes single-tenant no Copilot Studio.

Atualize seu agente

Agentes publicados na Teams Store só precisam de republicação pelo processo de validação da Teams Store se houver alterações nos metadados (por exemplo, propósito, termos, links e assim por diante). Esse requisito significa que, quando um agente não Microsoft é publicado e disponibilizado, ele fica disponível para todos os usuários atuais. Esse requisito é o mesmo para Copilot Studio atualmente como para outros canais e métodos de autenticação.

Exportar o manifesto do Copilot Studio

Quando estiver pronto para testar o agente no cliente Microsoft Teams ou Microsoft Copilot em outro tenant, você precisa disponibilizar o agente no segundo tenant. Para testes, um administrador MAC ou um usuário com permissões para instalar o agente em seu cliente (concedidas por um administrador MAC no segundo tenant) deve instalar o agente manualmente no outro tenant.

Você pode restringir o acesso ao locatário host por meio da política de isolamento de locatário do centro de administração do Power Platform. Adicione as informações do cliente de teste quando estiver testando seus próprios inquilinos específicos e avançando pelo processo de gerenciamento do ciclo de vida da aplicação.

Para exportar o arquivo .ZIP manifesto, vá em Canais em Copilot Studio, selecione o canal Teams e Microsoft Copilot, e depois selecione Editar Detalhes.

Você pode editar o nome, descrição e outros detalhes no arquivo manifesto exigido pelo Microsoft Teams e Microsoft Copilot. O arquivo manifesto contém metadados importantes sobre seu agente, que o locatário cliente vê ao revisar o agente para uso no locatário deles.

Depois de editar os detalhes, selecione Opções de Disponibilidade para exportar o arquivo .ZIP.

Essa ação baixa um arquivo local de .ZIP para sua máquina. O arquivo .ZIP tem ícones coloridos e arquivos de manifesto. Você também pode editar o manifesto manualmente. Enquanto o recurso está em visualização pública, os criadores precisam editar o manifesto, especificamente o nó Valid Domains. Para mais informações, veja Torne seu agente disponível no Teams ou no Microsoft Copilot.

Conteúdo relacionado

• Disponibilize seu agente no Teams ou Microsoft Copilot: Este artigo inclui documentação sobre como instalar e publicar na Teams Store global.
• Melhores práticas, solução de problemas e informações adicionais: Este artigo inclui orientações sobre o ciclo de vida do desenvolvimento de software na construção de agentes, considerações, solução de problemas e informações sobre o roadmap.