Você criou um agente personalizado no Copilot Studio e agora quer disponibilizá-lo para sua equipe diretamente no Microsoft Teams. Publicar o agente em um canal do Teams permite que os membros interajam com ele sem sair da interface de chat. Este artigo explica os pré-requisitos, o processo de publicação passo a passo e os problemas comuns que podem impedir uma implantação bem-sucedida.
Os agentes do Copilot Studio podem ser publicados como aplicativos do Teams que aparecem na barra de aplicativos do Teams ou como guias dentro de um canal específico. O método de publicação em canal coloca o agente como uma guia no topo do canal, dando acesso a todos os membros daquele canal. Essa abordagem funciona melhor para ferramentas de equipe, como assistentes de helpdesk de TI, verificadores de status de projetos ou bots de pesquisa em bases de conhecimento.
Você aprenderá como configurar o agente para o Teams, submetê-lo para aprovação do administrador, se necessário, e adicioná-lo a um canal. O artigo também aborda o que fazer se o agente não aparecer após a publicação ou se os usuários virem um erro de permissão.
Principais Conclusões: Publicar um Agente do Copilot Studio em um Canal do Teams
- Copilot Studio > Publicar > Seleção de canal > Teams: Abre o editor de manifesto do aplicativo Teams, onde você configura o nome, ícone e descrição do agente para o Teams.
- Centro de administração do Microsoft Teams > Gerenciar aplicativos > Permitir ou carregar: Necessário quando sua organização bloqueia o sideload de aplicativos personalizados; o agente deve ser aprovado por um administrador antes de aparecer.
- Canal do Teams > Adicionar uma guia > Agente do Copilot Studio: A sequência exata para colocar o agente publicado como uma guia, para que todos os membros do canal possam usá-lo.
O Que Significa Publicar um Agente do Copilot Studio em um Canal do Teams
Quando você publica um agente do Copilot Studio em um canal do Teams, está convertendo o agente em um aplicativo do Teams que aparece como uma guia dentro desse canal. Cada membro do canal pode abrir a guia e iniciar uma conversa com o agente. O agente herda o contexto do canal do Teams, o que significa que pode responder a perguntas com base no tópico do canal ou executar ações definidas nos fluxos de tópicos do agente.
Antes de publicar, você precisa dos seguintes pré-requisitos:
- Uma licença do Copilot Studio atribuída ao autor do agente.
- Um agente ativo do Copilot Studio com pelo menos um tópico e uma versão de teste publicada.
- Permissão para criar aplicativos personalizados do Teams no seu locatário do Microsoft 365. Se o seu locatário bloquear sideload, você precisará de um administrador do Teams para aprovar o aplicativo.
- Função de proprietário ou colaborador no agente no Copilot Studio.
O processo de publicação tem duas fases. A primeira fase gera o pacote do aplicativo Teams dentro do Copilot Studio. A segunda fase adiciona esse aplicativo como uma guia no canal do Teams de destino. Ambas as fases são descritas na próxima seção.
Passos para Publicar um Agente do Copilot Studio em um Canal do Teams
Siga estes passos em ordem. Pular a etapa de registro do aplicativo no Copilot Studio fará com que o agente falhe ao tentar adicioná-lo ao canal.
- Abra o agente no Copilot Studio
Acesse copilotstudio.microsoft.com e faça login com sua conta corporativa ou de estudante. Selecione o agente que deseja publicar na lista de agentes na barra lateral esquerda. - Navegue até a seção Publicar
No menu de navegação esquerdo, clique em Publicar. Em seguida, clique na guia Canais. Você verá uma lista de canais disponíveis, incluindo Teams, Power Apps e chat web. - Configure o canal do Teams
Clique no bloco do canal Teams. Um painel é aberto onde você pode definir o nome do aplicativo, descrição curta, descrição completa e ícone. O nome do aplicativo deve ser único em todo o locatário. Carregue um ícone de 192×192 pixels para o bloco do aplicativo e um ícone de 32×32 pixels para a barra de guias. Clique em Salvar após preencher todos os campos. - Gere o pacote do aplicativo Teams
De volta à página Canais, clique em Publicar no topo da página. O Copilot Studio gera um arquivo .zip contendo o manifesto do aplicativo Teams e a configuração do agente. Uma caixa de diálogo aparece com a opção de baixar o pacote. Clique em Baixar e salve o arquivo .zip no seu computador. - Carregue o aplicativo no Microsoft Teams
Abra o Microsoft Teams. Na barra lateral esquerda, clique em Aplicativos. Na parte inferior da página Aplicativos, clique em Gerenciar seus aplicativos e depois selecione Carregar um aplicativo. Escolha Carregar um aplicativo personalizado e selecione o arquivo .zip que você baixou. O Teams instala o aplicativo para sua organização. Se o seu locatário bloquear uploads personalizados, você verá um erro de permissão. Nesse caso, envie o arquivo .zip para um administrador do Teams e peça para ele carregá-lo através do centro de administração do Teams. - Adicione o agente como uma guia no canal de destino
Navegue até o canal do Teams onde deseja que o agente apareça. No topo do canal, clique no ícone + para adicionar uma nova guia. Na galeria de guias, pesquise pelo nome do seu agente. Selecione o agente na lista. No pop-up que aparece, clique em Adicionar. A guia do agente agora está visível para todos os membros do canal. - Teste o agente no canal
Clique na guia para abrir a interface do agente. Digite uma mensagem de teste como Olá ou uma pergunta relacionada aos tópicos do seu agente. Verifique se o agente responde corretamente. Se o agente não responder, verifique se ele tem pelo menos um tópico publicado e se as frases de gatilho do tópico correspondem à sua entrada de teste.
O Que Fazer se o Agente Não Aparecer ou Falhar ao Carregar
A guia do agente está faltando na galeria de guias
Se você não vir seu agente na galeria de guias após carregar o aplicativo, pode ser que o aplicativo não tenha sido instalado completamente. Volte para Teams > Aplicativos > Gerenciar seus aplicativos e confirme se o aplicativo está listado. Se estiver listado, mas mostrar um status de Bloqueado, um administrador do Teams deve aprová-lo no centro de administração do Teams em Gerenciar aplicativos, selecionando o aplicativo e clicando em Permitir.
Usuários veem um prompt de login ao abrir a guia
Isso acontece quando o agente requer autenticação para certos tópicos. No Copilot Studio, vá para as configurações do agente e habilite Autenticação para Microsoft Entra ID. Publique o agente novamente, baixe o arquivo .zip atualizado e recarregue-o no Teams. Os usuários devem fazer login uma vez para autenticar o agente para sua sessão.
O agente responde com erros genéricos ou não responde
O agente pode não ter um tópico que corresponda à entrada do usuário. No Copilot Studio, abra a seção Tópicos e verifique se as frases de gatilho dos seus tópicos cobrem as perguntas que os usuários farão. Republicue o agente após fazer alterações. Verifique também se o agente não está em estado de rascunho. Apenas agentes publicados funcionam em canais do Teams.
Agente do Copilot Studio em Canal do Teams vs Barra de Aplicativos do Teams
| Item | Guia do Canal do Teams | Barra de Aplicativos do Teams |
|---|---|---|
| Local de acesso | Dentro de um canal específico como uma guia | Barra lateral esquerda do Teams, seção Aplicativos |
| Público | Apenas membros do canal | Todos os usuários que instalarem o aplicativo |
| Consciência de contexto | Pode ler o nome e o tópico do canal | Sem contexto de canal |
| Visibilidade | Visível para todos no canal | Visível apenas para o usuário que instalou |
| Aprovação do administrador | Necessária se o locatário bloquear uploads personalizados | Necessária se o locatário bloquear uploads personalizados |
Depois que o agente for publicado como uma guia de canal, você pode atualizar o agente no Copilot Studio e republicar. A guia reflete automaticamente a versão publicada mais recente após alguns minutos. Não é necessário recarregar o aplicativo, a menos que você altere o nome, ícone ou descrição do aplicativo.