Conectar e configurar um agente para o Teams e Microsoft 365

Depois de publicar seu agente, disponibilize-o aos usuários no Teams e Microsoft 365. Dessa forma, você, seus colegas de equipe e sua organização em geral podem interagir com ele. Você deve publicar o agente pelo menos uma vez antes que os usuários possam interagir com o agente no Teams e no Microsoft 365.

Você pode:

• Personalize a aparência do agente no Teams e Microsoft 365 Copilot.
• Instale o agente por conta própria no Teams e Microsoft 365 Copilot.
• Compartilhe o link de instalação do agente com outros usuários.
• Mostrar o agente na loja de aplicativos do Teams.
  • Mostre o agente aos usuários compartilhados adicionando-o à seção Criado com o Power Platform da loja de aplicativos do Teams.
  • Compartilhe o agente com a organização enviando o agente para aprovação do administrador a fim de ser apresentado na seção Criado para sua organização na loja de aplicativos do Teams.
• Adicione o agente a um canal de equipe.
• Baixe o manifesto do aplicativo de seu agente para distribuí-lo em seu locatário do Teams.

Quando você adiciona um agente ao Teams, alguns de seus dados, como o conteúdo do agente e o conteúdo do chat do usuário final, são compartilhados com o Teams. Seus dados podem ser enviados para fora da conformidade da sua conformidade da organização e limites geográficos ou regionais. Para obter mais informações, consulte Noções básicas sobre as permissões e as informações acessadas pelos aplicativos do Teams.

Pré-requisitos

• Todos os usuários do agente em sua organização podem usar Microsoft 365 Copilot.

• Os criadores de agente têm permissões para criar e acessar um ambiente do Copilot Studio.

• Compartilhar seu agente com outros usuários para que eles possam instalar e conversar com o agente no Teams e Microsoft 365 Copilot.

• Sua organização deve permitir que aplicativos do Power Platform sejam adicionados ao Teams antes que você ou outros usuários possam:

  • Instale diretamente um agente no Teams, ou
  • Encontre um agente na seção Desenvolvido com Power Platform na loja de aplicativos do Teams.

  Trabalhe com o administrador para Gerenciar os aplicativos do Microsoft Power Platform no centro de administração do Microsoft Teams se ele estiver desabilitado para sua organização.

• Administradores gerenciam agentes que aparecem na seção Construído para sua organização (aprovados por um administrador) separadamente na página Gerenciar aplicativos do centro de administração do Teams.

• Antes de instalar um agente para você ou compartilhá-lo com outras pessoas, publique o agente pelo menos uma vez.

Conectar um agente aos canais do Teams e do Microsoft 365 Copilot

Depois de publicar seu agente pelo menos uma vez, você pode conectá-lo aos canais Teams e Microsoft 365 Copilot para que os usuários possam conversar com ele no Teams e no Microsoft 365 Copilot.

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Se você quiser que seu agente esteja disponível no Microsoft 365 Copilot e no Teams, em Ativar Microsoft 365, certifique-se de que Tornar o agente disponível no Microsoft 365 Copilot esteja selecionado.

   Observação

   Se você não selecionar Disponibilizar agente no Microsoft 365 Copilot, o agente ficará disponível apenas no Teams.

3. Selecione Adicionar canal.

   

Personalizar a aparência de um agente para o Teams e Microsoft 365 Copilot

Antes de disponibilizar um agente para outros usuários, forneça a descrição e aparência corretas. Essas informações ajudam os usuários a entender o propósito e a marca do agente.

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Editar detalhes para alterar o ícone, a cor e as descrições do agente. Esses atributos ficam visíveis na loja de aplicativos do Teams e na guia Sobre depois que o usuário instala o agente. Revise as diretrizes de formato de ícone do aplicativo para o Teams.

   Importante

   Usuários que já instalaram o agente a partir de um link compartilhado ou da seção Built with Power Platform da loja de aplicativos do Teams não veem alterações nos dados do agente. Os usuários precisam reinstalar o agente para obter as atualizações.

   Para agentes já aprovados por um administrador, você deve submeter o agente novamente para aprovação.

3. Selecione Mais para adicionar as seguintes informações:

   • Nome do desenvolvedor
   • Site da Web
   • Declaração de privacidade
   • Termos de uso

   Forneça essas informações para informar os usuários sobre seu corretor. Para obter mais informações, consulte Criar uma política de privacidade e termos de uso em Microsoft Teams.

4. Clique em Salvar. Suas alterações na cor, no ícone e na descrição resumida agora estão visíveis no painel de configuração.

Instalar um agente no Teams e Microsoft 365 Copilot

Depois de publicar seu agente, você pode adicioná-lo ao seu perfil do Teams diretamente do Copilot Studio.

Adicione seu agente ao seu próprio perfil no Teams primeiro, antes de compartilhar com outras pessoas.

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Ver agente no Teams.

   Se você configurou seu agente para estar disponível no Microsoft 365 Copilot ao adicionar o canal pela primeira vez, selecionar Ver agente no Teams instalará seu agente tanto no Teams quanto no Microsoft 365 Copilot. Se você não configurou seu agente para Microsoft 365 Copilot, seu agente será instalado apenas no Teams.

3. Selecione Adicionar.

   

   O agente aparece na lista de agentes à esquerda.

4. Para fazer uma pergunta ao novo agente em Microsoft 365 Copilot, insira @, selecione seu agente na lista exibida, insira sua pergunta e selecione Enter.

Compartilhar um link para que outras pessoas possam instalar o agente

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Copiar link.

4. Compartilhe o link com os usuários para que eles possam instalar o agente no Teams.

Mostrar um agente na loja de aplicativos do Teams ou na Microsoft 365 Agent Store

Depois de publicar seu agente, você poderá mostrá-lo na loja de aplicativos do Teams ou na Loja de Agentes do Microsoft 365 para que os usuários possam encontrá-lo e instalá-lo.

Mostrar para usuários compartilhados no Teams

Você pode compartilhar seu agente adicionando-o à seção Criado com o Power Platform da loja de aplicativos do Teams. Apenas os usuários compartilhados podem encontrar o agente lá.

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Mostrar aos meus colegas de equipe e usuários compartilhados e analise quem tem acesso ao agente.

4. Confirme que a caixa de seleção Mostrar em Construído pelos Seus Colegas está selecionada e selecione Atualizar.

   Seu agente fica disponível na seção Criado com o Power Platform da loja de aplicativos do Teams e um rótulo verde Adicionado ao Teams aparece na página de opções de disponibilidade.

   

Remover um agente da seção Criado com o Power Platform

Você pode remover um agente da seção Criado com o Power Platform. Remover o agente desta seção não afeta os usuários com o agente instalado.

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Mostrar para meus colegas e usuários compartilhados e desmarque a caixa de seleção Mostrar em Construído pelos Seus Colegas.

4. Selecione Compartilhar. O agente não aparece mais na seção Criado com o Power Platform da loja de aplicativos do Teams.

Mostrar à organização

Você pode compartilhar um agente com sua organização enviando-o para aprovação do administrador para ser apresentado na seção Criado para sua organização da loja de aplicativos do Teams. Se você também publicar seu agente no Microsoft 365, enviá-lo para aprovação do administrador também o aplicará ao Microsoft 365 Agent Store. A apresentação de seu aplicativo na loja de aplicativos do Teams e na Microsoft 365 Agent Store é uma ótima maneira de distribuir amplamente seu agente fazendo parceria com seu administrador para distribuí-lo para todos na organização ou para um subconjunto de usuários.

Os administradores também podem usar políticas de configuração de aplicativos aplicativos para instalar e fixar automaticamente um agente para os usuários da organização para que eles possam acessá-lo diretamente da barra de aplicativos no Teams.

Antes de enviar um agente para sua organização, certifique-se de que:

• Seu agente está pronto para lançamento e em conformidade com os padrões, as regras e as políticas da empresa.
• Você coordena com outros gerenciadores de agente. Depois de enviar um agente, um usuário diferente não poderá reenviá-lo até que um administrador aprove ou rejeite o envio anterior.
• Você remove o agente, se aplicável, da seção Criado com o Power Platform da loja de aplicativos do Teams. Caso contrário, se você enviar seu agente para aprovação do administrador, ele pode acabar aparecendo em dois lugares.

Envie um agente para aprovação administrativa

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Confirme se o agente não é mostrado para colegas de equipe ou usuários compartilhados. Remova-o se for informado Adicionado ao Teams.

4. Selecione Mostrar a todos na minha organização.

5. Analise os requisitos para envio e selecione Enviar para aprovação do administrador.

   Observação

   Analise o conteúdo e ele estará pronto para ser analisado por um administrador. Você deve enviar uma nova solicitação de aprovação para atualizar o ícone e as descrições dos agentes que foram aprovados anteriormente.

   Depois que um agente for aprovado, todos os usuários novos e existentes do agente no Teams e Microsoft 365 Copilot receberão a atualização.

   Uma nova aprovação só será necessária se você modificar os detalhes do agente. Você pode fazer atualizações de conteúdo para seu agente e publicá-lo quantas vezes desejar. Você não precisa enviar seu agente para aprovação novamente depois de publicar essas alterações de conteúdo.

   Uma solicitação de confirmação final aparece.

6. Clique em Sim para continuar. O agente é enviado ao seu administrador para aprovação e você pode ver uma nota indicando o status do seu envio.

   Observação

   Depois de submeter o agente para aprovação administrativa, não mude a configuração de acesso do agente para ser inferior à de todos na sua organização.

   Definir o acesso como inferior a todos faz com que os usuários da organização não consigam conversar com o agente após instalá-lo pela loja de aplicativos do Teams ou do Microsoft 365 Agent Store.

   Trabalhe com o administrador na política de aplicativo Microsoft Teams para determinar quem pode encontrar e instalar o agente.

7. Aguarde a aprovação do administrador. Você pode verificar o status mais recente selecionando Atualizar ou abrindo a janela Disponibilizar o agente para outros usuários da página Publicar.

8. Depois que seu administrador aprovar o agente, o status é atualizado para Aprovado. Você pode abrir o agente diretamente e compartilhar o link da versão aprovada com outros usuários.

9. Como opção, peça ao administrador para usar políticas de configuração de aplicativos para instalar e fixar automaticamente um agente para os usuários da organização para que eles possam acessá-lo diretamente da barra de aplicativos no Teams.

Permitir que os usuários adicionem um agente a uma equipe no Teams

No Teams, os usuários podem adicionar um agente a uma equipe específica. Depois que um agente estiver disponível para uma equipe, os membros da equipe poderão "@mencioná-lo" em qualquer canal da equipe e todos os colegas verão as respostas do agente. Esse recurso é útil para situações como os seguintes exemplos:

• Seu agente oferece suporte à colaboração, como o compartilhamento das informações mais recentes do relatório de vendas com o restante da equipe de vendas.
• Você deseja permitir que todos os membros da equipe interajam com o agente em um canal de equipe ou por meio de chat privado sem precisar instalar manualmente o agente.

Duas opções determinam se os usuários podem adicionar um agente a qualquer equipe da qual façam parte ou a chats de grupo e reunião no Teams. Ao selecionar essas opções, o agente tem acesso ao histórico de conversas no canal da equipe, no grupo ou no chat da reunião, o que ajuda o agente a fornecer respostas mais adequadas ao contexto da conversa.

Quando os usuários instalam um agente na loja de aplicativos do Teams ou usando o link de instalação, eles podem ver uma das seguintes opções, dependendo do escopo colaborativo definido para o agente:

• Adicione o agente a um canal de equipe
• Adicionar o agente a chats de grupo e de reunião no Teams

Os membros da equipe também podem remover um agente de uma equipe.

Para permitir que os usuários adicionem um agente a uma equipe:

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Editar detalhes.

3. Selecione Permitir que os usuários adicionem este agente a uma equipe.

4. Clique em Salvar.

O Teams armazena informações em cache para que possa demorar um pouco até que os usuários vejam a opção de adicionar o agente a uma equipe ou chat em grupo. Os usuários podem atualizar o navegador (ou e sair do cliente de desktop do Teams e entrar novamente) para obter as alterações mais recentes.

Se você já enviou o agente para aprovação do administrador, precisará enviá-la novamente depois da ativação dessa opção. O administrador precisa aprovar suas alterações antes que os usuários possam adicionar o agente às suas equipes da loja de aplicativos do Teams na seção Criado para sua organização.

Impedir que os usuários adicionem um agente a uma equipe ou chats em grupo e de reunião

Quando você desativa essa opção, os usuários não podem adicionar um agente a uma nova equipe, grupo ou chat de reunião. Não remove o agente para usuários que já o possuem. Você precisa remover o agente manualmente.

Para impedir que os usuários adicionem um agente a uma equipe:

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Editar detalhes.

3. Desmarque a caixa de seleção "Os usuários podem adicionar este agente a uma equipe".

4. Clique em Salvar.

Configurar o comportamento de saudação privada

Mensagens privadas de um agente são úteis para que os membros da equipe possam conversar individualmente com o agente sem precisar instalar o agente por conta própria.

Quando você configura esse comportamento, seu agente inicia automaticamente uma conversa com os membros da equipe. Para personalizar a mensagem de saudação do agente, modifique o tópico do sistema de saudação.

Considere a relevância do agente para os membros da equipe. Certifique-se de que a saudação do agente ajude os usuários a entender o que fazer com ele, descreva suas limitações e, mais importante, que os deixe confortáveis ao interagir com ele.

Para configurar quando um agente envia uma saudação privada:

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Configurações.

3. Configure as opções de saudação privada.

4. Clique em Salvar.

Baixe o manifesto do aplicativo do Teams para um agente (avançado)

Você pode baixar o manifesto do aplicativo do Teams do agente para fazer alterações detalhadas diretamente no manifesto e compartilhar com seu administrador ou usuários no locatário. Você também pode carregar diretamente o manifesto do aplicativo no Teams, se a política da sua organização permitir que você carregue os aplicativos personalizados.

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Baixar .zip. O manifesto é gerado como um arquivo .zip e salvo de acordo com as configurações do seu navegador.

4. No Teams, selecione Aplicativos>Gerenciar seus aplicativos>Carregar um aplicativo.

5. Selecione Carregar uma aplicação personalizada.

6. Procure o arquivo .zip baixado.

Desconectar um agente do Teams

Você pode desligar seu agente para que os usuários não possam mais conversar com ele no Teams. Quando seu agente está offline, ele não responde a ninguém que tente conversar com ele. Considere a necessidade de desconectar seu agente antes de fazer isso.

Os agentes desconectados não aparecem na seção Criado com o Power Platform da loja de aplicativos do Teams e não podem ser instalados a partir de um link compartilhado. Se um usuário já tiver um agente instalado no Teams, ele permanecerá disponível até que o usuário o desinstale.

Se você desconectar um agente aprovado por um administrador, ele continua aparecendo na seção Construído para sua organização na loja de aplicativos do Teams. Você deve pedir ao administrador para removê-lo.

1. Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot.

2. Selecione Remover canal.

3. Analise as informações sobre como desconectar seu agente e selecione Desconectar para continuar.

Você sempre pode reconectar seu agente selecionando Adicionar canal no painel de configuração nos canais do Teams e do Microsoft 365 Copilot, republicando e reinstalando o agente no Teams.

Abra o painel de configuração dos canais do Teams e do Microsoft 365 Copilot

1. Abra seu agente no Copilot Studio.

2. Na barra de menus superior, selecione Canais.

3. Selecione o painel o Teams e o Microsoft 365 Copilot. O painel de configuração será exibido.

Limitações conhecidas

As limitações conhecidas diferem dependendo se você está usando o Teams ou Microsoft 365 Copilot.

Limitações conhecidas no Teams

• Agentes que usam o canvas unificado de autoria atualizado não suportam a configuração de saudação privada.

• Agentes aprovados por um administrador não têm a opção de definir o ícone do avatar na página de detalhes. Esses agentes usam o ícone do app como avatar.

• O Teams aplica os limite de taxa aos agentes. Dependendo das suas necessidades de negócios, convém manter o conteúdo do agente conciso para os agentes que você publicar no Teams.

• Se seu agente suporta autenticação de usuário, o usuário não pode sair explicitamente. Esse comportamento não cumpre a certificação do Teams Marketplace se você estiver publicando seu agente no Painel do Vendedor. Essa limitação não se aplica ao uso pessoal ou no locatário do agente. Saiba como publicar seu aplicativo na Teams Store e sobre a política de certificação do Marketplace.

• Depois que você desconecta seu agente do canal do Teams, pode levar alguns minutos até que os usuários no Teams não consigam mais contato com o agente.

• Em chats e canais de grupo do Teams, os agentes do Copilot Studio não podem usar fontes de conhecimento que exijam autenticação do usuário final, como o SharePoint. Essa limitação é por design e ajuda a evitar a exposição de dados não intencional. Esses agentes têm suporte apenas em chats 1:1.

• Os chats em grupo e os chats de reunião não oferecem suporte a agentes configurados para autenticação manual com logon único (SSO) para o Teams. Dependendo das suas necessidades de negócios, você pode autenticar com a Microsoft ou remover o SSO para Teams de sua autenticação manual.

SystemError após publicar ou republicar um agente

Quando os usuários interagem com um agente Copilot no Teams, eles podem ver a seguinte mensagem:

Desculpa, aconteceu algo inesperado. Estamos investigando.
Código de erro: SystemError

Esse problema acontece quando o Teams continua usando uma versão previamente publicada do agente depois que você publica ou republica o agente. Em alguns casos, o Teams não atualiza imediatamente a configuração atualizada do agente. Esse problema causa um SystemError genérico durante a execução do agente.

Workaround

Para atualizar a configuração do agente, tente os seguintes passos:

1. No Microsoft Teams centro de administração, localize o aplicativo do agente, desabilite-o, aguarde alguns segundos e habilite-o novamente.
2. No Copilot Studio, desative o canal Teams para o agente, salve as alterações e, em seguida, ative o canal novamente.
3. Republique o agente para garantir que a versão mais recente esteja disponível para o Teams.

Se o problema persistir, entre em contato com o Suporte da Microsoft e forneça a ID da conversação, ID do agente e a hora em que o erro ocorreu.

Limitações conhecidas no Microsoft 365 Copilot

• Tópico Início da Conversa não compatível: o canal do Microsoft 365 Copilot não é compatível com o tópico Início da Conversa, portanto, saudações gerais não são possíveis. Em vez disso, o agente oferece prompts de comandos. Você pode definir variáveis através de tópicos acionados por eventos de atividade, mas esse método não é ideal para cumprimentos devido aos efeitos colaterais.

• Tipos de mídia não suportados: Mídias como imagens GIF não são renderizadas.

• Embedded URLs: Microsoft 365 Copilot pode remover URLs inseridas para segurança. Citações de respostas generativas devem incluir URLs na seção citação.

• Tipos de nó incompatíveis:

  • Operações de fala
  • Entrega ao representante de atendimento ao cliente
  • Adaptive Cards com Action.Execute

• Tipos de mensagem sem suporte:

  • Cartões básicos (erro em ContentFiltered)
  • Vídeo (erro em ContentFiltered)
  • Imagem (erro em ContentFiltered)
  • Arquivo
  • Fala (não enviada)

  Observação

  Você pode usar Adaptive Cards para mostrar imagens.

• O gatilho de inatividade é disparado, mas não republica mensagens no Microsoft 365 Copilot.

• Os agentes publicados no Microsoft 365 Copilot não dão suporte a comentários do usuário (reações).

Informações relacionadas

• Implantar agentes no Microsoft Teams