Conecte e configure um agente para Microsoft Teams
Com seu agente publicado, você pode disponibilizá-lo para usuários no Teams. 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.
Você pode:
- Personalize a aparência do seu agente no Teams
- Instale o agente para você no Teams
- Compartilhe a instalação do agente vincular com outros usuários
- Exiba agente na loja de aplicativos do Teams.
- Mostre o agente para usuários compartilhados adicionando-o à seção extensões agente da loja de aplicativos do Teams.
- Compartilhe a hashtag agente com a organização enviando-a para aprovação do administrador para ser apresentada na seção Criado para sua organização da loja de aplicativos do Teams.
- Adicione agente a um canal de equipe.
- Baixe o manifesto do aplicativo para seu agente para distribuí-lo no seu locatário do Teams.
Quando você adiciona um agente ao Teams, alguns dos seus dados, como o conteúdo do agente e o conteúdo do bate-papo 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
- Compartilhe seu agente com outros usuários para que eles possam instalar e conversar com o agente no Teams.
- Sua organização deve permitir que Microsoft Power Platform aplicativos sejam adicionados ao Teams antes que você ou outros usuários possam instalar diretamente um agente no Teams ou encontrá-lo na seção extensões do agente 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 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 você ou compartilhá-lo com outras pessoas, você deve publicar o agente pelo menos uma vez.
Conecte um agente ao canal Microsoft Teams
Depois de publicar seu agente pelo menos uma vez, você pode conectá-lo ao Microsoft Teams canal para permitir que os usuários conversem com ele no Teams.
Observação
Recomendamos que você ative as configurações de segurança para agentes criados para o Teams ou para uso interno de funcionários, para impedir que pessoas de fora da sua organização usem esses agentes.
Selecione Ativar Teams.
Observação
Se você não vir essa opção, o canal do Microsoft Teams já foi ativado.
Personalize a aparência de um agente para equipes
Fornecer a descrição e a aparência corretas para um agente antes de disponibilizá-lo para outros usuários é importante, pois os informa sobre o propósito e a marca do agente, quando aplicável.
Select Edite 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. Revise as diretrizes de formato de ícone do aplicativo para o Teams.
Importante
Alterações nos detalhes de um agente não estão disponíveis para usuários que já instalaram o agente de um vincular compartilhado ou da seção extensões do agente da loja de aplicativos 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.
Selecione Mais para adicionar as seguintes informações:
- Nome do desenvolvedor
- Site da Web
- Declaração de privacidade
- Termos de Uso
Você deve fornecer essas informações para informar os usuários sobre seu agente. Para obter mais informações, consulte Criar uma política de privacidade e termos de uso no Microsoft Teams.
Selecione Salvar. Suas alterações na cor, no ícone e na descrição resumida agora estão visíveis no painel de configuração.
Observação
A personalização de ícones nesta seção se aplica somente ao avatar agente para agentes que são aprovados pelo administrador e não se aplica a usuários que instalam o agente com uma instalação direta vincular ou da seção de extensões agente da loja de aplicativos do Teams. Você pode personalizar o avatar agente em Personalizar a aparência do agente.
Instalar um agente como um aplicativo no Teams
Com seu agente publicado, você pode adicioná-lo ao seu próprio perfil do Teams diretamente de Copilot Studio.
Importante
Novos conteúdos em um agente recém-publicado não aparecerão em conversas que estejam em andamento.
Você pode digitar "Recomeçar" em uma conversa existente para iniciar uma nova conversa imediatamente e ver as últimas atualizações do agente.
Recomendamos adicionar agente ao seu perfil no Teams primeiro, antes de compartilhá-lo com outras pessoas.
Select Open agente para que o prompt de instalação seja iniciado no Teams. Selecione Adicionar para adicioná-lo como um aplicativo no Teams. Esta operação apenas instala o agente para você.
Compartilhe um vincular para que outros possam instalar um agente
Selecione Opções de disponibilidade.
Selecione Copiar link.
Compartilhe o vincular com os usuários para que eles possam instalar o agente no Teams.
Importante
Somente usuários que podem acessar o agente podem usar a instalação vincular para instalar o agente. Você pode compartilhar o agente para dar aos usuários acesso ao agente.
Não é possível usar um link de instalação no aplicativo móvel do Teams. Para garantir que seu agente esteja disponível para usuários móveis do Teams, configure-o para exibir na loja de aplicativos do Teams.
Exibir um agente na loja de aplicativos do Teams
Depois de publicar seu agente, você pode exibi-lo na loja de aplicativos do Teams para que os usuários possam encontrá-lo e instalá-lo.
Mostrar aos usuários compartilhados
Você pode compartilhar seu agente adicionando-o ao Extensões agente seção da loja de aplicativos do Teams. Apenas usuários compartilhados pode encontrar o agente There.
Importante
Somente usuários compartilhados podem encontrar e instalar o agente na seção extensões agente da loja de aplicativos do Teams. O agente não é exibido para todos na organização, mesmo que esteja configurado para permitir que todos usem o agente. Para mostrar o agente para a organização, envie o agente para aprovação de um administrador para mostrá-lo na seção Criado para sua organização da loja de aplicativos do Teams.
Um agente só pode aparecer na seção extensões agente da loja de aplicativos do Teams se o número total de usuários compartilhados não exceder os limites impostos pela política de descoberta da loja de aplicativos do Teams para seu locatário. Para tornar seu agente disponível para um número maior de usuários, faça uma parceria com seu administrador para mostrar o agente para a organização.
Selecione Opções de disponibilidade.
Select Mostrar aos meus colegas de equipe e verificar quem tem acesso ao agente.
Confirme se a caixa de seleção Visível em extensões agente está marcada e Select Compartilhar.
Seu agente fica disponível na seção extensões agente da loja de aplicativos do Teams, e um rótulo verde Adicionado ao Teams aparece na página de opções de disponibilidade.
Observação
Se seu aplicativo não aparecer na seção extensões agente , seu aplicativo Teams pode estar armazenando informações em cache.
Tente sair e entrar novamente (se estiver usando o aplicativo de desktop do Teams) ou atualizando o navegador (se estiver usando o aplicativo Web do Teams).
Remover um agente da seção de extensões agente
Você pode remover um agente da seção extensões agente . Remover o agente do There não afeta usuários com o agente instalado.
Selecione Opções de disponibilidade.
Select Mostrar para meus colegas de equipe e desmarcar a caixa de seleção Visível em extensões agente .
Selecione Compartilhar. O agente não aparece mais na seção extensões agente 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. Apresentar seu aplicativo no Desenvolvido para sua organização é uma ótima maneira de distribuir amplamente seu agente por meio de parceria com seu administrador para distribuí-lo a todos na organização ou a 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 ser lançado e em conformidade com os padrões, regras e políticas da empresa.
- Você coordena com outros gerentes do 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 agente, se aplicável, da seção extensões agente da loja de aplicativos do Teams. Caso contrário, se você enviar seu agente para aprovação do administrador, ele poderá acabar aparecendo em dois lugares.
Observação
Depois que um agente é aprovado por um administrador, a disponibilidade de agente na seção Construído para sua organização é gerenciada por seu administrador. Somente um administrador pode remover o agente da seção Construído para sua organização .
Envie um agente para a seção Construído para sua organização
Selecione Opções de disponibilidade.
Confirme se agente não está sendo exibido para colegas de equipe ou usuários compartilhados. Remova-o se estiver escrito Adicionado às equipes.
Selecione Mostrar a todos na minha organização.
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ê deve enviar uma nova solicitação de aprovação para atualizar o ícone e as descrições dos agentes que foram aprovados anteriormente.
Após a aprovação, todos os usuários novos e existentes do agente no Teams recebem a atualização.
Isso se aplica somente aos detalhes do agente. Você ainda pode fazer atualizações de conteúdo no seu agente e publicá-lo sempre que desejar. Você não precisa enviar seu agente para aprovação novamente após publicar tais alterações de conteúdo.
Uma solicitação de confirmação final aparece.
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 que ele seja menor que o de todos na sua organização.
Definir como menos que todos faz com que os usuários na organização não consigam bater papo com agente após instalá-lo na seção Desenvolvido para sua organização da loja de aplicativos do Teams.
Trabalhe com seu administrador na Microsoft Teams política do aplicativo para determinar quem pode encontrar e instalar o agente.
Aguarde a aprovação do administrador. Você pode verificar o status mais recente selecionando Atualizar, ou abrindo o Disponibilize o agente para outros janela do Publicar página.
Depois que seu administrador aprovar o agente, o status será atualizado para Aprovado. Você pode abrir diretamente o agente e compartilhar o vincular da versão aprovada com outros usuários.
Opcionalmente, peça ao seu administrador para usar políticas de configuração de aplicativo 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.
Observação
Se seu aplicativo não aparecer na seção Criado para 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).
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 estiver disponível para uma equipe, os membros da equipe poderão "@mencioná-lo" em qualquer canal da equipe, e todos os colegas de equipe verão as respostas do agente. Esse recurso é útil para situações como os seguintes exemplos:
- Seu agente oferece suporte à colaboração, como compartilhar as últimas informações do relatório de vendas com o restante da equipe de vendas.
- Você quer permitir que todos os membros da equipe interajam com o agente em um canal da equipe ou via chat privado sem precisar instalar manualmente o agente.
Duas opções determinam se os usuários podem adicionar agente a qualquer equipe da qual façam parte ou a bate-papos 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 a instalação vincular , eles podem ver uma das seguintes opções, dependendo do escopo colaborativo definido para o agente:
- Adicione agente a um canal de equipe
- Adicione agente aos chats de grupo e reunião no Teams
Os membros da equipe também podem remover um agente de uma equipe.
Importante
O agente deve ser 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 agente. Recomendamos não alterar a configuração de segurança do agente depois de habilitar esse recurso. Caso contrário, os usuários poderão ver erros de permissão ao tentar interagir com agente em canais do Teams ou bate-papos em grupo.
Para permitir que os usuários adicionem um agente a uma equipe:
Selecione Editar detalhes.
Select Permita que seus usuários adicionem este agente a uma equipe.
Selecione Salvar.
O Teams armazena informações em cache, então pode demorar um pouco até que os usuários vejam a opção de adicionar agente a um bate-papo de equipe ou 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ê enviou o agente para aprovação do administrador anteriormente, deverá enviá-lo novamente após habilitar esta opção. O administrador deve aprovar suas alterações antes que os usuários possam adicionar agente às suas equipes na seção Criado para sua organização da loja de aplicativos do Teams.
Impedir que os usuários adicionem um agente a uma equipe, grupo ou bate-papos de reunião
Desabilitar esta 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 agente a uma conversa, desabilitar esta opção não o removerá. Você deve remover manualmente o agente.
Para impedir que usuários adicionem um agente a uma equipe:
Selecione Editar detalhes.
Desmarque a caixa de seleção Permitir que seus usuários adicionem este agente a uma equipe .
Selecione Salvar.
Configurar o comportamento de saudação privada
Saudações privadas de um agente são úteis quando você deseja que os membros da equipe tenham conversas individuais com o agente sem precisar instalar manualmente o agente.
Observação
A configuração de saudação privada está disponível apenas para chatbots clássicos.
Quando ativado, seu agente inicia automaticamente uma conversa com os membros da equipe. Para personalizar a mensagem de saudação do agente, modifique a Saudação agente.
Considere o quão relevante o agente é para os membros da equipe. Certifique-se de que a saudação do agente os ajude a entender o que fazer com ele, descreva suas limitações e, mais importante, deixe-os confortáveis ao interagir com ele.
Para configurar quando um agente envia uma saudação privada:
Selecione Configurações.
Configure as opções de saudação privada.
Selecione Salvar.
Baixe o manifesto do aplicativo Teams para um agente (avançado)
Você pode baixar o manifesto do aplicativo Teams do agente para fazer alterações detalhadas no manifesto diretamente 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.
Selecione Opções de disponibilidade.
Selecione Baixar .zip.
O manifesto é gerado como um arquivo .zip e é salvo de acordo com as configurações de salvamento do seu navegador.
Desconectar um agente do Teams
Você pode colocar seu agente offline 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 tenta conversar com ele. Você deve considerar cuidadosamente a necessidade de desconectar seu agente antes de fazer isso.
Agentes desconectados não aparecem na seção extensões agente da loja de aplicativos do Teams e não podem ser instalados de um vincular compartilhado. Se um usuário já tiver um 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 continua a aparecer no Construído para sua organização seção da loja de aplicativos do Teams. Você deve pedir ao administrador para removê-lo.
Selecione Desconectar do Teams.
Revise as informações sobre como desconectar seu agente e Select Desconectar para continuar.
Você sempre pode reconectar seu agente selecionando Ativar equipes no Disponibilize o agente para outros janela no Publicar página.
Abrir o painel de configuração do canal do Microsoft Teams
Abra seu agente em Copilot Studio.
Na barra de menus superior, selecione Canais.
Selecione o bloco do Microsoft Teams. O painel de configuração será exibido.
Limitações conhecidas
- Configuração de saudação privada não é suportado por agentes que usam o tela de autoria unificada atualizada.
- Configurando o ícone do avatar agente na página de detalhes não aparece para agentes aprovados por um administrador. Agentes aprovados por um administrador usam o ícone do aplicativo como o avatar agente.
- As equipes têm limitação de taxa em agentes. Dependendo das necessidades do seu negócio, talvez você queira manter o conteúdo agente conciso para agentes adicionados ao Teams.
- Atualmente, se seu agente suporta autenticação de usuário final, o usuário não consegue sair explicitamente. Esse comportamento falha na Microsoft Teams AppSource certificação se você estiver publicando seu agente no Painel do Vendedor. Esta limitação não se aplica ao uso pessoal ou de locatários do agente. Saiba mais sobre como Publicar seu aplicativo na Loja do Teams e sobre a política de certificação do AppSource.
- Depois de desconectar seu agente do Microsoft Teams canal, pode levar alguns minutos até que o agente fique inacessível para usuários no Teams.
- Os bate-papos em grupo e 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.