Adicionar um copiloto ao Microsoft Teams

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

Com o copiloto publicado, você pode disponibilizá-lo para os usuários no Microsoft Teams. Dessa forma, você, seus colegas de equipe e sua organização em geral podem interagir com ele. Você precisa publicar o copiloto pelo menos uma vez antes que os usuários possam interagir com o copiloto no Microsoft Teams.

Você pode:

• Personalizar a aparência do copiloto no Microsoft Teams
• Instalar o copiloto para você no Microsoft Teams
• Compartilhar o link de instalação do copiloto com outros usuários
• Mostrar o copiloto na loja de aplicativos do Microsoft Teams.
  • Mostre o copiloto aos usuários compartilhados, adicionando-o à seção Criado por seus colegas da loja de aplicativos do Microsoft Teams.
  • Compartilhe o copiloto com a organização enviando o copiloto para aprovação do administrador a fim de ser apresentado na seção Criado pela sua organização da loja de aplicativos do Microsoft Teams.
• Adicione o copiloto a um canal de equipe.
• Baixe o manifesto do aplicativo Teams pré-gerado para distribuí-lo em seu locatário do Microsoft Teams.

Quando você adiciona o copiloto ao Microsoft Teams, alguns de seus dados, como o conteúdo do copiloto e o conteúdo do chat do usuário final, são compartilhados com o Microsoft 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 a política de privacidade do aplicativo do Microsoft Teams.

Pré-requisitos

• Compartilhe com os usuários para que possam instalar e conversar com o copiloto no Microsoft Teams.
• Sua organização precisa permitir que os aplicativos do Microsoft Power Platform sejam adicionados ao Microsoft Teams antes que você ou outros usuários possam instalar o copiloto diretamente no Teams ou encontrá-lo na seção Criado por seus colegas na loja de aplicativos do Teams. Trabalhe com seu administrador para Gerenciar os aplicativos do Microsoft Power Platform no Microsoft Teams se ele está desabilitado para sua organização.
• Os copilotos aprovados para a seção Criado pela sua organização (após o envio a um administrador) são gerenciados separadamente por administradores na Página de gerenciamento de aplicativos do centro de administração do Microsoft Teams.
• Antes de instalar o copiloto para você mesmo ou compartilhar o copiloto com outras pessoas, você deverá publicar o copiloto pelo menos uma vez.

Conectar seu copiloto ao canal do Microsoft Teams

Depois de publicar seu copiloto pelo menos uma vez, você poderá conectá-lo ao canal do Microsoft Teams para permitir que os usuários conversem com o copiloto no Microsoft Teams.

Observação

Recomendamos que você ative as configurações de segurança para copilotos criados para o Microsoft Teams ou uso interno por funcionários para que você possa garantir que o copiloto não seja acessível a pessoas de fora da sua organização.

Conecte-se ao Microsoft Teams:

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Ativar Teams.

   

   Nota

   Se você não vir essa opção, então talvez o canal do Microsoft Teams já esteja ativado.

Personalizar a aparência do copiloto no Microsoft Teams

Fornecer a descrição e a aparência corretas para o copiloto antes de disponibilizá-lo para outros usuários é importante, pois os instrui sobre a finalidade do copiloto e sua marca, quando aplicável.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Editar detalhes para alterar o ícone, a cor e as descrições do copiloto. Estas opções são mostradas na loja de aplicativos do Microsoft Teams e na guia Sobre do aplicativo depois que o usuário instalar o copiloto. Analisar as recomendações em formatos de ícone do Microsoft Teams.

   

   Importante

   As atualizações dos detalhes do copiloto não se aplicam a usuários que já instalaram o copiloto a partir de um link compartilhado ou da seção Criado por seus colegas. Elas precisarão ser reinstaladas no copiloto para receber as atualizações.

   Atualizações nos detalhes do copiloto não se aplicam a copilotos que foram aprovados por um administrador. Você precisará reenviar o copiloto para aprovação para que os detalhes mais recentes sejam atualizados para os usuários.

4. Selecione Mais para adicionar outras informações:

   • Nome do desenvolvedor

   • Site

   • Declaração de Privacidade

   • Termos de uso

     Você deve fornecer essas informações para manter seu usuário informado sobre o copiloto. Consulte o artigo Política de privacidade e termos de uso para obter mais detalhes e exemplos.

5. Selecione Salvar para voltar à tela onde você pode disponibilizar seu copiloto no Teams. Suas atualizações de cor, ícone e descrição agora estão visíveis.

Observação

A personalização do ícone nesta seção só se aplica ao avatar do copiloto para copilotos que são aprovados pelo administrador e não se aplica a usuários que instalam o copiloto com um link de instalação direto ou na seção Criado por seus colegas da loja de aplicativos do Microsoft Teams. Você pode personalizar o avatar do copiloto em Personalizar a aparência do copiloto.

Instalar um copiloto como um aplicativo no Microsoft Teams

Com seu copiloto publicado, você pode adicioná-lo à sua própria versão do Microsoft Teams diretamente do aplicativo do Microsoft Copilot Studio.

Importante

O novo conteúdo em um copiloto recém-publicado não aparecerá nas conversas em andamento. Após 30 minutos de tempo ocioso, o copiloto será atualizado.

Você pode digitar Start over em uma conversa existente para iniciar uma nova conversa imediatamente e ver as atualizações mais recentes do copiloto.

É necessário adicionar o copiloto à sua própria versão do Teams antes de compartilhá-lo com outras pessoas.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Abrir o copiloto para que o prompt de instalação seja iniciado no Microsoft Teams. Selecione Adicionar para adicioná-lo como um aplicativo no Teams. Isso só instala o copiloto para você.

   

Compartilhar um link para que outras pessoas possam instalar o copiloto

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecionar Opções de disponibilidade e selecione Link de cópia

   Importante

   Apenas os usuários que podem acessar o copiloto podem usar o link de instalação para instalar o copiloto. Você pode compartilhar o copiloto para dar aos usuários acesso ao chat com o copiloto.

   

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

Mostrar o copiloto na loja de aplicativos do Microsoft Teams

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

Mostrar aos usuários compartilhados

Você pode compartilhar o copiloto, adicionando-o à seção Criado para sua organização>Criado por seus colegas da loja de aplicativos do Microsoft Teams. Apenas os usuários compartilhados podem encontrar o copiloto lá.

Importante

Apenas usuários compartilhados podem localizar e instalar o copiloto na seção Criado por seus colegas na loja de aplicativos do Microsoft Teams. O copiloto não será mostrado para todos na organização, mesmo se estiver configurado para permitir que todos usem o copiloto. Para mostrar o copiloto para a organização, envie o copiloto para a aprovação de um administrador para mostrá-lo na seção Criado pela sua organização da loja de aplicativos do Microsoft Teams.

O copiloto só poderá ser mostrado na seção Criado por seus colegas da loja de aplicativos do Microsoft Teams quando o número total de usuários compartilhados não exceder a política de descoberta da loja de aplicativo do Teams do locatário. Para mostrar o copiloto além do limite da política de sua organização, faça parceria com seu administrador para mostrar o copiloto à organização.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

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

   

5. Confirme se a caixa de seleção Visível em Desenvolvido pelos seus colegas está marcada e selecione Compartilhar.

   

6. Isso adiciona automaticamente o copiloto à seção Criado por seus colegas e mostra um rótulo verde Adicionado ao Teams na página de opções de disponibilidade.

   

Observação

Se seu aplicativo não aparecer na seção Criado por seus colegas, seu aplicativo do Teams pode estar armazenando informações em cache.

Tente sair e entrar novamente (se estiver usando o aplicativo da área de trabalho) ou atualizar seu navegador (se estiver usando o aplicativo Web do Teams).

Remover o copiloto da seção Criado por seus colegas

Você pode remover o copiloto da seção Criado por seus colegas. A remoção do copiloto aqui não afeta os usuários com o copiloto instalado.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

4. Selecione Mostrar aos meus colegas de equipe e usuários compartilhados e remova a seleção da caixa de seleção Visível em Desenvolvido pelos seus colegas.

   

5. Selecione Compartilhar. Agora, o copiloto não aparece mais na seção Criado por seus colegas da loja de aplicativos do Microsoft Teams.

Mostrar à organização

Você pode compartilhar o copiloto com a organização enviando o copiloto para aprovação do administrador a fim de ser apresentado na seção Criado para sua organização>Criado por seus colegas. Destacar seu aplicativo em Criado por seus colegas é uma ótima maneira de distribuir amplamente o copiloto, fazendo parceria com o administrador para distribuir o copiloto a todos na organização ou a um subconjunto de usuários.

Os administradores também podem pré-instalar e fixar o copiloto para usuários na organização, para que possam acessá-lo diretamente da barra de aplicativos à esquerda no Microsoft Teams.

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

• Seu copiloto 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 copiloto. Depois de enviar o copiloto, um usuário diferente não poderá reenviá-lo até que um administrador aprove ou rejeite o envio anterior.
• Você remove o copiloto, se aplicável, da seção Criado por seus colegas. Caso contrário, se você enviar seu copiloto para aprovação do administrador, o copiloto poderá aparecer em dois lugares. Veja as instruções em como remover seu copiloto para obter detalhes.

Observação

Depois que um copiloto é aprovado por um administrador, a disponibilidade do copiloto na seção Criado pela sua organização será totalmente gerenciada pelo seu administrador. Apenas um administrador pode remover o copiloto da seção Criado pela sua organização.

Enviar para a seção Criado pela sua organização

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

4. Confirme se o copiloto não é mostrado para colegas de equipe ou usuários compartilhados. Remova se informa Adicionado ao Teams.

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

   

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

   Nota

   Analise o conteúdo e ele estará pronto para ser analisado por um administrador. Você precisará enviar novas solicitações ao administrador para atualizar o ícone e as descrições dos copilotos que foram aprovados anteriormente.

   Depois de aprovado, todos os usuários novos e existentes do copilotos no Teams receberão a atualização.

   Isso se aplica apenas aos detalhes do copiloto. Você pode continuar a fazer atualizações de conteúdo para o seu copiloto publicando o conteúdo mais recente. Você não precisa reenviar para um administrador.

7. Um prompt de confirmação final aparece. Selecione Sim para continuar. O copiloto é enviado ao seu administrador para que ele o aprove e você pode ver uma nota indicando o status do seu envio.

   

   Observação

   Depois de enviar o copiloto para aprovação do administrador, você não deverá alterar a configuração de acesso do copiloto para que ele não seja disponibilizado para todos em sua organização.

   Definir como menos que todos faz com que os usuários da organização não consigam conversar com o copiloto depois de instalá-lo na seção Criado pela sua organização da loja de aplicativos do Microsoft Teams.

   Trabalhe com o administrador na política de aplicativos do Microsoft Teams sobre quem pode encontrar e instalar o copiloto.

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

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

10. Opcionalmente, faça parceria com o administrador para pré-fixar ou instalar o aplicativo para usuários na política de aplicativo do Microsoft Teams para que eles possam encontrar o copiloto diretamente na barra de aplicativos esquerda do Microsoft Teams.

Observação

Se seu aplicativo não aparecer na seção Criado pela sua organização, mesmo se estiver marcado como Aprovado, seu aplicativo do Teams pode estar armazenando informações em cache.

Tente sair e entrar novamente (se estiver usando o aplicativo de desktop) ou atualizando o navegador (se estiver usando o aplicativo Web do Teams).

Adicionar um copiloto a uma equipe

No Microsoft Teams, você pode adicionar copiloto a equipes. Quando você adiciona os copilotos, os membros da equipe podem @mention o copiloto em qualquer canal da equipe e todos os colegas de equipe verão a resposta do copiloto. Esse recurso é útil para cenários em que:

• Seu copiloto 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 copiloto em um canal de equipe ou por meio de chat privado sem precisar instalar manualmente o copiloto.

Permitir que os usuários adicionem o copiloto a uma equipe e Habilitar para chats em grupo e de reunião do Teams

Essas duas opções controlam se os usuários podem adicionar o copiloto a qualquer equipe da qual façam parte ou a chats em grupo e da reunião ao adicionar o copiloto no Microsoft Teams.

Quando você seleciona essas duas opções, o copiloto obtém o histórico da conversa no canal da equipe, no chat em grupo ou no chat da reunião para fornecer a melhor resposta no contexto da conversa.

Depois de habilitar pelo menos uma opção, qualquer usuário que instale o copiloto na loja de aplicativos do Teams ou no link de instalação poderá ver um dos seguintes itens:

• a opção para adicionar o copiloto a um canal de equipe
• a opção de adicionar o copiloto a chats em grupo e da reunião no Microsoft Teams

Os membros da equipe também podem remover o copiloto de uma equipe.

Importante

O copiloto é configurado para permitir que todos na organização conversem com ele. Isso garante que todos os membros da equipe tenham permissão para conversar com o copiloto nos canais da equipe. É altamente recomendável não alterar a configuração de segurança do copiloto depois de habilitar esse recurso. Caso contrário, os usuários verão erros de permissão ao interagir com o copiloto nos canais da equipe.

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

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Editar detalhes.

4. Selecione Permitir que os usuários adicionem este copiloto a uma equipe e/ou Habilitar para chats em grupo e de reunião do Teams.

   

5. Selecione Salvar.

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

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

Não permitir que usuários adicionem copiloto a chats de equipe ou em grupo e de reunião

Desabilitar essa opção impede que os usuários adicionem um copiloto a uma nova equipe, a um grupo ou a um chat de reunião. Se você já adicionou um copiloto a uma conversa, desabilitar essa opção não o removerá. Você precisa remover o copiloto manualmente.

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

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Editar detalhes.

4. Desmarque a caixa de seleção Permitir que os usuários adicionem este copiloto a uma equipe e/ou Habilitar para chats em grupo e de reunião do Teams.

   

5. Selecione Salvar.

Configurar o comportamento de saudação privada

As saudações privadas de um copiloto são úteis quando você deseja que os membros da equipe tenham conversas individuais com o copiloto sem precisar instalá-lo manualmente.

Observação

A configuração de saudação privada não é compatível com copilotos que usam a tela de criação unificada atualizada.

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

Considere a relevância do copiloto para os membros da equipe. Certifique-se de que a saudação do copiloto os ajude a entender o que fazer com ele, descreva suas limitações e, o mais importante, os deixe à vontade para interagir com ele.

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

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Configurações.

   

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

   

5. Selecione Salvar.

Baixe o manifesto do aplicativo do Teams do copiloto (avançado)

Você pode baixar o manifesto do aplicativo do Teams do copiloto 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 Microsoft Teams se a política da sua organização permitir que você carregue aplicativos personalizados.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Opções de disponibilidade.

4. Selecione Baixar .zip.

   

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

Desconectar seu copiloto do Teams

Você pode colocar seu copiloto offline para que os usuários não possam mais conversar com o copiloto no Teams. Quando o copiloto está offline, ele não responde a ninguém que tenta conversar com ele e interrompe qualquer pessoa que possa estar usando-o. Você deverá considerar cuidadosamente a necessidade de desconectar seu copiloto antes de fazer isso.

Os copilotos não aparecem mais na seção Criado por seus colegas da loja de aplicativos do Microsoft Teams e não podem ser instalados a partir do link compartilhado. Os copilotos adicionados por usuários no Microsoft Teams continuarão a existir até que o usuário desinstale o copiloto.

Para copilotos que são aprovados por um administrador, os copilotos continuarão a ser exibidos na seção Criado pela sua organização da loja de aplicativos do Microsoft Teams. Você precisará entrar em contato com seu administrador para remover o copiloto.

1. No menu de navegação, em Configurações, selecione Canais.

2. Selecione Microsoft Teams.

3. Selecione Desconectar do Teams.

   

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

Você sempre pode reconectar seu copiloto após desconectá-lo, selecionando Ativar o Teams na janela Disponibilizar o copiloto para outros usuários na página Publicar.

Limitações conhecidas

• A Configuração de saudação privada não é compatível com copilotos que usam a tela de criação unificada atualizada.
• Atualmente, apenas os escopos Pessoal e Equipe são compatíveis com o Microsoft Teams. O Chat em grupo não é compatível.
• Configurar o ícone do avatar do copiloto na página de detalhes não aparece para copilotos aprovados por um administrador. Os copilotos aprovados por um administrador usarão o ícone do aplicativo como avatar do copiloto.
• O Teams tem limitação de taxa para copilotos. Dependendo das suas necessidades de negócios, convém manter o conteúdo do copiloto conciso para os copilotos adicionados ao Microsoft Teams.
• Atualmente, se seu copiloto for compatível com autenticação de usuário final, o usuário não poderá sair explicitamente. Ocorrerá uma falha na certificação do Microsoft Teams AppSource, se você publicar seu copiloto no Painel do Vendedor. Isso não se aplica ao uso pessoal ou no locatário do copiloto. Saiba mais em Publicar seu aplicativo do Microsoft Teams e Política de validação do AppSource.
• Desconectar seu copiloto do Teams pode demorar alguns minutos antes que o copiloto se torne inacessível para usuários no Microsoft Teams.