Conectar e configurar um agente para o Teams e o Microsoft 365

Com seu agente publicado, você pode disponibilizá-lo para usuários no Teams e no Microsoft 365. Dessa forma, você, seus colegas de equipe e sua organização mais ampla 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.

É possível:

• Personalize a aparência do seu agente no Teams e no Microsoft 365 Copilot
• Instale o agente por si mesmo no Teams e no Microsoft 365 Copilot
• Compartilhar o link de instalação do agente com outros usuários
• Mostre o agente na loja de aplicativos do Teams.
  • Mostrar o agente para usuários compartilhados adicionando-o à seção Construído com Power Platform da loja de aplicativos do Teams.
  • Compartilhe o agente com a organização, enviando-o para aprovação do administrador a fim de ser apresentado na seção Criado para sua organização da loja de aplicações do Teams.
• Adicione o agente a um canal de equipa.
• Faça o download do manifesto da aplicação para que o seu agente o distribua no seu espaço do Teams.

Quando você adiciona um agente ao Teams, alguns de seus dados, como o conteúdo do agente e o conteúdo do bate-papo do usuário, são compartilhados com o Teams. Seus dados podem fluir fora dos limites de conformidade e geográficos ou regionais da sua organização. Para obter mais informações, consulte Compreender 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 o Microsoft 365 Copilot.
• Os criadores de agentes devem ter permissões para criar e acessar um ambiente do Copilot Studio.
• Compartilhe seu agente com outros usuários para que eles possam instalar e conversar com o agente no Teams e no Microsoft 365 Copilot.
• Sua organização deve permitir que os aplicativos do Microsoft Power Platform sejam adicionados ao Teams antes que você ou outros usuários possam instalar diretamente um agente no Teams ou encontrá-lo na seção Criado com o Power Platform na loja de aplicativos do Teams. Trabalhe com o seu administrador para Gerir aplicações da Microsoft Power Platform no centro de administração do Microsoft Teams se estiver desativado para a sua organização.
• Os agentes que aparecem na seção Criado para sua organização (aprovados por um administrador) são gerenciados separadamente pelos administradores na página Gerenciar aplicativos do Centro de administração do Teams.
• Antes de instalar um agente para si mesmo ou compartilhá-lo com outras pessoas, você deve publicar 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 permitir que os usuários conversem com ele no Teams e no Microsoft 365 Copilot.

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

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

   Observação

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

3. Selecione Adicionar canal.

   

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

Fornecer a descrição e a aparência corretas para um agente antes de disponibilizá-lo a outros usuários é importante, pois informa-os sobre o propósito e a marca do agente, quando aplicável.

1. Abra o painel de configuração para os canais Teams e 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 do aplicativo depois que o usuário instala o agente. Analise as diretrizes de formato de ícone do aplicativo para o Teams.

   Importante

   As alterações nos detalhes de um agente não estão disponíveis para usuários que já instalaram o agente a partir de um link compartilhado ou da seção Built with Power Platform da app store do Teams. Os usuários devem reinstalar o agente para obter as atualizações.

   Para agentes que foram aprovados por um administrador, você deve reenviar o agente para aprovação.

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

   • Nome do programador
   • Sítio Web
   • Declaração de privacidade
   • Termos de utilização

   Você deve fornecer essas informações para informar os usuários sobre seu agente. Para obter mais informações, consulte Criar uma declaração de privacidade e termos de uso no Microsoft Teams.

4. Selecione Guardar. Suas alterações na cor, ícone e breve descrição agora estão visíveis no painel de configuração.

Instalar um agente no Teams e no Microsoft 365 Copilot

Com seu agente publicado, você pode adicioná-lo ao seu próprio perfil do Teams diretamente do Copilot Studio.

Recomendamos adicionar seu agente ao seu próprio perfil no Teams primeiro, antes de compartilhá-lo com outras pessoas.

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Ver agente no Teams.

   Se você configurou seu agente para estar disponível no Microsoft 365 Copilot quando adicionou o canal pela primeira vez, selecionar Ver agente no Teams instalará seu agente no Teams e no Microsoft 365 Copilot. Se você não configurou seu agente para o Microsoft 365 Copilot, seu agente será instalado somente no Teams.

3. Selecione Adicionar.

   

   O agente aparece na lista de agentes à esquerda.

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

Compartilhar um link para que outras pessoas possam instalar um agente

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Copiar ligação.

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

Depois de publicar seu agente, você pode mostrá-lo na loja de aplicativos do Teams para que os usuários possam encontrá-lo e instalá-lo.

Mostrar a utilizadores partilhados

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

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Mostrar aos meus colegas de equipa e utilizadores partilhados e analise quem tem acesso ao agente.

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

   Seu agente fica disponível na secção Built with Power Platform da loja de aplicações do Teams, e um rótulo verde Adicionado ao Teams aparece na página de opções de disponibilidade.

   

Remover um agente da secção Built with Power Platform

Você pode remover um agente da seção Construída com Power Platform. Remover o agente de lá não afeta os usuários com o agente instalado.

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Mostrar aos meus colegas de equipa e utilizadores partilhados e despeje a caixa Mostrar em Construído pelos Seus Colegas .

4. Selecione Partilhar. O agente não está mais presente na seção Built with Power Platform da loja de aplicativos do Teams.

Mostrar a 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. Apresentar seu aplicativo no Built for your org é uma ótima maneira de distribuir amplamente seu agente, fazendo parceria com seu administrador para implementá-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 para instalar e fixar automaticamente um agente para usuários na 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 liberação e em conformidade com os padrões, regras e políticas da empresa.
• Você coordena com outros gerentes de agentes. Depois de enviar um agente, um usuário diferente não poderá reenviá-lo até que um administrador aprove ou rejeite o envio anterior.
• Remova o agente, se aplicável, da secção Compilação com o Power Platform da loja de aplicações do Teams. Caso contrário, se submeter o seu agente para aprovação pelo administrador, pode acabar por aparecer em dois lugares.

Submeter um agente para a secção Criado para a sua organização

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Certifique-se de que o agente não é mostrado aos membros da equipa ou aos utilizadores partilhados. Remova-o se disser Adicionado ao Teams.

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

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

   Observação

   Assegure-se de que o conteúdo está revisado e pronto para ser revisado 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 é aprovado, todos os usuários novos e existentes do agente no Teams recebem a atualização.

   Uma nova aprovação só é 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 quiser. Você não precisa enviar seu agente para aprovação novamente depois de publicar essas alterações de conteúdo.

   Um prompt de confirmação final é exibido.

6. Selecione 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 enviar o agente para aprovação do administrador, você não deve alterar a configuração de acesso do agente para ser menor do que todos na sua organização.

   A definição para menos do que todos resulta na impossibilidade de os utilizadores da organização conversarem com o agente depois de o instalar a partir da seção Criado para a sua organização da loja de aplicações do Teams.

   Trabalhe com seu administrador na política do aplicativo Microsoft Teams para determinar quem pode localizar 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 outras pessoas na página Publicar .

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

9. Opcionalmente, peça ao administrador para usar as políticas de configuração do aplicativo para instalar e fixar automaticamente um agente para os usuários na 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. Quando um agente está disponível para uma equipa, os membros da equipa podem mencioná-lo em qualquer canal da equipa, e todos os colegas de equipa veem as respostas do agente. Esse recurso é útil para situações como os seguintes exemplos:

• Seu agente oferece suporte à colaboração, como compartilhar as informações mais recentes do relatório de vendas com o resto da equipe de vendas.
• Você deseja permitir que todos os membros da equipe se envolvam com o agente em um canal de equipe ou via chat privado sem a necessidade de 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. Com essas opções selecionadas, o agente tem acesso ao histórico de conversas do canal da equipe, do bate-papo em grupo ou do bate-papo da reunião, o que ajuda o agente a fornecer respostas mais adequadas ao contexto da conversa.

Quando os usuários instalam um agente da 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:

• Adicionar o agente a um canal de equipa
• Adicionar o agente aos chats de grupo e de reunião no Teams

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

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

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Editar detalhes.

3. Selecione Permitir que seus usuários adicionem esse agente a uma equipe.

4. Selecione Guardar.

O Teams armazena informações em cache, portanto, pode levar um tempo até que os usuários vejam a opção de adicionar o agente a um bate-papo de equipe ou grupo. Os usuários podem atualizar o navegador (ou sair do cliente de desktop do Teams e entrar novamente) para obter as alterações mais recentes.

Se você enviou anteriormente o agente para aprovação do administrador, deverá enviá-lo novamente depois de ativar essa opção. O administrador deve aprovar suas alterações antes que os usuários possam adicionar o agente às suas equipes na seção Criado para sua organização da loja de aplicativos do Teams.

Impedir que os utilizadores adicionem um agente a uma equipa ou a chats de grupo e de reunião

A desativação dessa opção impede que os usuários adicionem um agente a uma nova equipe, grupo ou bate-papo de reunião. Se você já adicionou um agente a uma conversa, desativar essa opção não a remove. Tem de remover manualmente o agente.

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

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Editar detalhes.

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

4. Selecione Guardar.

Configurar o comportamento de saudação privada

As saudações privadas de um agente são úteis para quando você deseja que os membros da equipe tenham conversas individuais com o agente sem a necessidade de instalar manualmente o agente.

Quando ativado, seu agente inicia automaticamente uma conversa com os membros da equipe. Para personalizar a mensagem de saudação do agente, modifique o tópico Sistema de saudação.

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

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

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Configurações.

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

4. Selecione Guardar.

Descarregar o manifesto da aplicação Teams para um agente (avançado)

Pode transferir o manifesto da aplicação Teams do agente para efetuar alterações detalhadas no manifesto diretamente e partilhar com o seu administrador ou com utilizadores no inquilino. Você também pode carregar diretamente um manifesto de aplicativo no Teams se a política da sua organização permitir que você carregue aplicativos personalizados.

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Opções de disponibilidade.

3. Selecione Download .zip.

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

4. No Teams, selecione Apps>Gerir as suas apps>Carregar uma app.

5. Selecione Carregar uma aplicação personalizada.

6. Procure ficheiro .zip transferido.

Desconectar um agente do Teams

Você pode colocar seu agente offline para que os usuários não possam mais conversar com o agente no Teams. Quando seu agente está offline, ele não responde a ninguém que tente conversar com ele. Você deve considerar cuidadosamente a necessidade de desconectar seu agente antes de fazê-lo.

Os agentes desconectados não são exibidos na secção Built with Power Platform da loja de aplicativos do Teams e não podem ser instalados a partir de um link partilhado. Se um usuário já tiver esse agente instalado no Teams, ele permanecerá disponível até que o usuário o desinstale.

Depois de desconectar um agente que foi aprovado por um administrador, ele continuará a aparecer na seção Criado para sua organização da loja de aplicativos do Teams. Você deve pedir ao administrador para removê-lo.

1. Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot.

2. Selecione Remover canal.

3. Revise 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 para os canais Teams e Microsoft 365 Copilot, republicando e reinstalando o agente no Teams.

Abra o painel de configuração para os canais Teams e Microsoft 365 Copilot

1. Abra o seu agente no Copilot Studio.

2. Na barra de menu superior, selecione Canais.

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

Limitações conhecidas

As limitações conhecidas diferem consoante esteja a utilizar o Teams ou o Microsoft 365 Copilot.

Limitações conhecidas no Microsoft Teams

• A configuração de saudação privada não é suportada para agentes que usam a tela de criação unificada atualizada.
• A configuração do ícone do avatar do agente na página de detalhes não aparece para agentes aprovados por um administrador. Os agentes aprovados por um administrador usam o ícone do aplicativo como avatar do agente.
• O Teams tem uma limitação de taxa nos agentes. Dependendo das necessidades do seu negócio, talvez queira manter o seu conteúdo de agente conciso para os agentes adicionados ao Teams.
• Atualmente, se o seu agente suportar a autenticação de utilizador final, o utilizador não poderá terminar a sessão explicitamente. Este comportamento gera uma falha a certificação do Teams AppSource se estiver a publicar o seu agente no Dashboard de Vendedores. Esta limitação não se aplica ao uso pessoal ou ao uso por inquilinos do agente. Saiba mais sobre como publicar seu aplicativo no Teams Store e sobre a política de certificação do AppSource.
• Depois de desconectar seu agente do canal do Teams, pode levar alguns minutos até que o agente se torne inacessível pelos usuários no Teams.
• Os chats de grupo e os chats de reunião não suportam agentes configurados para autenticação manual com logon único (SSO) para o Teams. Dependendo das suas necessidades comerciais, você pode autenticar com a Microsoft ou remover o SSO for Teams da sua autenticação manual.

Limitações conhecidas no Microsoft 365 Copilot

• Tópico Início da Conversa não suportado: O canal Copilot do Microsoft 365 não suporta o tópico Início da Conversação , pelo que não é possível saudações gerais. Em vez disso, são usadas sugestões sugeridas. As variáveis podem ser definidas através de tópicos acionados por Eventos de Atividade, mas estes não são ideais para saudações devido aos efeitos secundários.

• Tipos de mídia não suportados: mídias como GIFs não são renderizadas

• URLs incorporadas: O Microsoft 365 Copilot pode remover URLs incorporadas por razões de segurança. As citações de respostas generativas devem incluir URLs na seção de citações.

• Tipos de nós não suportados:

  • Operações de voz
  • Entrega ao representante de atendimento ao cliente
  • Cartões Adaptáveis com Action.Execute

• Tipos de mensagem não suportados:

  Observação

  Você pode usar Adaptive Cards para mostrar imagens.

  • Cartões básicos (erro ContentFiltered)
  • Vídeo (erro ContentFiltered)
  • Image (erro ContentFiltered )
  • Ficheiro
  • Voz (não enviado)

• O acionador de inatividade é acionado, mas não envia mensagens de volta para o Microsoft 365 Copilot.

• Os agentes publicados no Microsoft 365 Copilot não suportam comentários (reações) dos utilizadores.