Torne seu agente multilocatário disponível no Teams ou no Microsoft 365 Copilot (versão prévia)

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

Disponibilize seu agente multilocatário no Teams ou Microsoft 365 Copilot atualizando seu arquivo de manifesto e enviando-o para o Teams Store.

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.

Note

Ao publicar seu agente do Copilot Studio e selecionar o modo multilocatário, você será responsável pelos termos e privacidade do agente multilocatário publicado. Essa responsabilidade inclui onde esses termos e quaisquer avisos de privacidade relacionados são mostrados aos administradores e usuários finais, como as lojas do Teams e do Agente. Além disso, as lojas do Microsoft Teams e do Agent têm requisitos de Termos e Contrato de Publicação no Partner Center, que você deve examinar totalmente.

Enviar para Microsoft 365 Store

As seções a seguir descrevem como disponibilizar seu agente no cliente Microsoft Teams e Microsoft 365 Copilot. As seções abrangem exportar o manifesto do Copilot Studio, atualizar o arquivo de manifesto e enviá-lo para o Teams Store por meio do Partner Center.

Exportar o manifesto do Copilot Studio

Quando estiver pronto para testar o agente no Microsoft Teams ou Microsoft 365 Copilot cliente em outro locatário, você precisará disponibilizar o agente no segundo locatário. 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.

A política de isolamento de locatários do Power Platform Admin Center pode restringir o acesso ao host. Você pode adicionar as informações do seu cliente de teste ao testar entre seus próprios locatários específicos conforme avança pelo processo de gerenciamento do ciclo de vida da aplicação.

Para exportar o arquivo de .ZIP de manifesto, acesse Channels no Copilot Studio, selecione o canal Teams e Microsoft 365 Copilot e selecione Edit Details.

Captura de tela do painel Editar detalhes do canal do Teams e do Microsoft 365 Copilot.

Você pode editar o nome, a descrição e outros detalhes no arquivo de manifesto exigido por Microsoft Teams e Microsoft 365 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.

Screenshot do painel do Canal do Teams e Microsoft 365 Copilot, mostrando o botão Opções de Disponibilidade.

Essa ação baixa um arquivo local de .ZIP para sua máquina. O arquivo .ZIP contém os arquivos de cor de ícones e manifestos. Você também pode editar o manifesto manualmente. Enquanto o recurso está em pré-visualização pública, os criadores precisam editar o manifesto, especificamente no nó Valid Domains. Para mais informações, veja Atualizar domínios válidos.

Atualizar domínios válidos

No arquivo manifest, há um nó chamado ValidDomains. Esta seção do manifesto especifica quais domínios o agente pode acessar.

  • Adicione a geografia correta para seu agente host com base na geografia do ambiente do Dataverse:

    • unitedstates.token.botframework.com // incluir somente se a área geográfica do host estiver Estados Unidos
    • europe.token.botframework.com incluir somente se o host geo estiver na Europa
    • india.token.botframework.com incluir apenas se o geô hospedeiro for a Índia
    • token.botframework.com inclua caso a localização do host seja qualquer outra localidade
  • Sempre inclua o seguinte domínio:

    • api.botframework.com deve ser incluído
  • Evite usar domínios coringa (como *example.com) a menos que você os possua, pois seu uso representa riscos de segurança.

  • Evite usar domínios de propriedade da Microsoft (incluindo domínios associados a Microsoft Copilot Studio) na configuração de domínio.

Envie para a Loja do Teams através do Centro de Parceiros

Para enviar seu agente para a Teams Store, revise e siga o processo descrito em Publique seu aplicativo na Teams Store. O sócio precisa revisar e concordar com os termos e condições esperados com base no programa sob o qual o agente está sendo submetido.

O mesmo processo de exportação e importação se aplica. O pacote .zip exportado do Copilot Studio deve conter os seguintes itens para ajudar o usuário final a entender o que o agente faz, incluindo o fornecimento de documentação e informações de solução de problemas:

  • Termos e condições da organização anfitriã
  • Política de privacidade
  • Outros documentos obrigatórios

Selecione as regiões no Centro de Parceiros para corresponder à geografia do ambiente do Dataverse host (Opcional)

Ao tratar das necessidades de residência de dados, lembre-se de que tanto o host quanto o cliente podem estar localizados em regiões diferentes. Se a residência de dados for um objetivo, escolha apenas aqueles países e regiões no Centro de Parceiros que correspondam à geografia do Dataverse onde o agente está hospedado (consulte a tabela abaixo). Além disso, certifique-se de considerar qualquer comunicação entre o agente e ferramentas ou serviços que não sejam da Microsoft. A responsabilidade de cumprir os requisitos de residência de dados recai sobre o hospedeiro ou a organização hospedeira, não cabe à Microsoft.

Note

As regiões disponíveis no Dataverse baseiam-se na localização principal do tenant do Microsoft Entra. A partir desse local, você pode criar regiões do Dataverse em várias outras regiões ao redor do mundo. Você pode criar um banco de dados para um ambiente em uma região (por exemplo, Estados Unidos) mesmo que o locatário Microsoft Entra esteja em outra região, conforme explicado na visão geral das regiões Power Platform. Ambientes são criados em diferentes regiões e estão ligados àquela localização geográfica. Quando você cria um app em um ambiente, implanta esse app em datacenters naquela localização geográfica.

Host Dataverse Geo Domínio Válido Países/Regiões do Centro Parceiro
Estados Unidos unitedstates.token.botframework.com Estados Unidos
Europa europe.token.botframework.com 47 países/regiões: Ilhas Åland, Albânia, Andorra, Áustria, Bielorrússia, Bélgica, Bósnia e Herzegovina, Bulgária, Croácia, Chipre, Tchéquia, Dinamarca, Estônia, Ilhas Faroe, Finlândia, Gibraltar, Grécia, Guernsey, Hungria, Islândia, Irlanda, Ilha de Man, Itália, Jersey, Letônia, Liechtenstein, Lituânia, Luxemburgo, Malta, Moldávia, Mônaco, Montenegro, Holanda, Macedônia do Norte, Polônia, Portugal, Romênia, Rússia, San Marino, Sérvia, Eslováquia, Eslovênia, Espanha, Svalbard, Turquia, Ucrânia, Cidade do Vaticano
Ásia Genérico: token.botframework.com 45 países/regiões (excluindo Índia, Japão e Coreia; veja suas linhas dedicadas): Afeganistão, Armênia, Azerbaijão, Bahrein, Bangladesh, Butão, Brunei, Camboja, China, Chipre, Geórgia, RAE de Hong Kong, Indonésia, Iraque, Israel, Jordânia, Cazaquistão, Kuwait, Quirguistão, Laos, Líbano, RAE de Macau, Malásia, Maldivas, Mongólia, Mianmar, Nepal, Omã, Paquistão, Autoridade Palestina, Filipinas, Catar, Rússia, Arábia Saudita, Singapura, Sri Lanka, Taiwan, Tajiquistão, Tailândia, Timor-Leste, Turquia, Turcomenistão, Uzbequistão, Vietnã, Iêmen
Australia Genérico: token.botframework.com Australia
Índia india.token.botframework.com Índia
Japan Genérico: token.botframework.com Japan
Canada Genérico: token.botframework.com Canada
Reino Unido europe.token.botframework.com Reino Unido
América do Sul Genérico: token.botframework.com 12 países/regiões: Argentina, Bolívia, Brasil, Chile, Colômbia, Equador, Guiana, Paraguai, Peru, Suriname, Uruguai, Venezuela
França europe.token.botframework.com França
Emirados Árabes Unidos (UAE) Genérico: token.botframework.com Emirados Árabes Unidos
Alemanha europe.token.botframework.com Alemanha
Suíça europe.token.botframework.com Suíça
Noruega europe.token.botframework.com Noruega
Coreia Genérico: token.botframework.com Coreia
África do Sul Genérico: token.botframework.com África do Sul
Suécia europe.token.botframework.com Suécia

Os usuários devem selecionar os países e regiões relacionados relevantes para o mapeamento geográfico e de esquema do Dataverse. Os Estados Unidos e a Índia são diretos. A Europa pode conter mais de 40 países e regiões, e o ambiente do Dataverse pode ser Europa, Alemanha, França, Suécia, Noruega, Suíça ou Reino Unido.