Microsoft Teams

Implante um agente de conversa no Microsoft Teams para que os usuários possam acessar a assistência de IA por meio do plug-in do UiPath Autopilot, no chat ou na aba Chat do Agente.

Visão geral

Implante seu agente de conversa no Microsoft Teams para trazer assistência de IA diretamente para o espaço de trabalho de colaboração da sua equipe.

Há duas maneiras de interagir com um agente no Teams:

• Chat — envie uma mensagem ao agente diretamente em um chat do Teams, por meio do plug-in do UiPath Autopilot. Ideal para perguntas rápidas sem sair de uma conversa.
• Guia Chat do agente — Abra a guia Chat do agente (Visualização) no mesmo aplicativo para obter a experiência completa do agente, incluindo solicitações iniciais, entradas de conversa, confirmações de chamadas de ferramentas e visualizações de citações no aplicativo.

Ambas as experiências usam os mesmos agentes, e você pode alternar entre eles a qualquer momento.

Usuários pretendidos: usuários finais que usam principalmente o Microsoft Teams e precisam acessar o agente de conversa sem sair do espaço de trabalho de colaboração.

Disponibilidade de funcionalidades

Recurso	Chat	Aba Chat do agente
Iniciar novo chat	✅	✅
Histórico do chat	✅	✅
Excluir sessão de chat	❌	✅
Configurações do perfil do usuário	❌	✅
Iniciando prompts	❌	✅
Carregamentos de arquivo	✅	✅
Entradas de conversas	❌	✅
Confirmações de chamadas de ferramentas	❌	✅
Citações	✅	✅
Visualização do HTML	❌	✅
Copiar resposta	❌	✅
Feedback (polegares)	❌	✅

Pré-requisitos

Para tornar um agente de conversa disponível no Microsoft Teams:

Configuração do administrador

1. Entre no Microsoft Teams.
2. Selecione Apps e pesquise UiPath Autopilot.
3. Selecione o aplicativo de resultados da pesquisa e selecione Adicionar.
4. Publique o agente de conversa na pasta do Orchestrator desejada.
5. Certifique-se de que os usuários tenham permissões apropriadas para acessar o agente.

Requisitos do usuário

• Conta do Microsoft Teams com acesso ao aplicativo UiPath Autopilot.
• Permissões para usar o agente publicado.

Acesso ao agente

1. Na barra lateral do Teams, selecione UiPath Autopilot para abrir o chat.
2. Envie qualquer mensagem para iniciar a autenticação se for sua primeira vez.
3. Siga as instruções para acessar sua Organização do Automation Cloud e o tenant desejados para concluir a autenticação.
4. Selecione seu agente na lista de Agentes de conversa.
5. Envie mensagens diretamente para o agente.

Observação:

Os agentes de conversa no Teams só funcionam com chats diretos com um usuário por meio do plug-in do UiPath Autopilot. Discussões do canal e @menções não são compatíveis.

Funcionalidades do chat

A experiência de chat no Teams segue os padrões de UX do Teams. Esta seção descreve como cada funcionalidade trabalha ao enviar mensagens ao agente diretamente em um chat do Teams. Para a experiência de guias, consulte Guia Chat do agente.

Observação:

As funcionalidades de chat são orientadas principalmente por solicitações no Microsoft Teams.

Iniciando um novo chat

O Microsoft Teams é compatível apenas com a limpeza do contexto da conversa. Você pode limpar o contexto do chat enviando a solicitação "Novo chat". Embora você possa ver as trocas de chat anteriores, o contexto anterior será apagado e o agente continuará como se você tivesse iniciado uma nova sessão de chat.

Histórico do chat

O Microsoft Teams é compatível apenas com uma única thread de chat de cada vez e as mensagens anteriores são visíveis dentro da mesma thread de conversa do Teams.Role para cima para visualizar mensagens anteriores na sessão e sessões anteriores.

Citações

Quando um agente usa fontes de conhecimento para gerar uma resposta, as citações aparecem para mostrar a origem das informações.Os marcadores de citação aparecem em linha na resposta do agente.

Observação:

A visualização de citação abre o documento no navegador web padrão.

Aba Chat do agente

A guia Chat do agente (Prévia) fornece a experiência completa do agente de conversação dentro do Teams, sem os limites de formatação e interação de um chat do Teams. Ela está disponível no aplicativo UiPath Autopilot e em cada aplicativo dedicado do Teams.

Observação:

A guia Chat do agente está em Visualização.

Como abrir a guia

1. Na barra lateral do Teams, selecione UiPath Autopilot (ou seu aplicativo de agente dedicado).
2. Selecione a aba Chat do agente (Prévia) na parte superior do aplicativo.
3. Selecione Fazer login e conclua a autenticação com sua conta da UiPath na janela pop-up.
4. Selecione seu tenant. Se você tiver acesso a apenas um tenant, ele será selecionado automaticamente.
5. Selecione um agente da lista e, em seguida, envie sua mensagem.

Em um app dedicado do Teams, a guia é aberta diretamente no agente desse app, e a lista de agentes é ignorada.

Observação:

A guia mantém você conectado enquanto estiver aberta. Fecho-la encerra a sessão, e você faz login novamente na próxima vez que abrir a guia.

Funcionalidades de guia

Além de tudo disponível no chat, a aba Chat do Agente é compatível com:

Recurso	Description
Iniciando prompts	A mensagem de boas-vindas do agente e as solicitações sugeridas aparecem quando você abre uma nova conversa. Selecione uma sugestão para enviá-la.
Entradas de conversas	Se o agente exigir entradas, você será solicitado a fornecê-las antes que a conversa comece. As entradas opcionais podem ser definidas ou alteradas a qualquer momento no ícone de configurações (Engrenagem) e aplicar para o resto da conversa.
Configurações do perfil	Defina seu nome, e-mail, função, departamento, empresa, país e fuso horário no ícone de configurações ( engrenagem). Os agentes podem usar esses detalhes para personalizar suas respostas.
Confirmações de chamadas de ferramentas	Quando o agente precisa de aprovação antes de executar uma ferramenta, uma solicitação de aprovação aparece em linha mostrando a ferramenta e suas entradas. Você pode ajustar as entradas antes da aprovação ou rejeitar a chamada.
Várias conversas	Mantenha várias conversas com o mesmo agente e alterne entre elas no painel de histórico. Pesquise conversas anteriores ou exclua uma conversa que não é mais necessária.
Visualização de citações	Selecione uma citação para abrir o documento de origem em um painel de visualização dentro da guia, em vez de em uma janela de navegador separada.
Visualização do HTML	Quando um agente retorna um bloco de código HTML, a aba o renderiza como uma visualização em tempo real assim que a resposta é concluída. Você pode alternar entre a visualização e a origem ou abri-la em uma exibição maior.
Texto e feedback	Copie qualquer resposta com uma seleção e avalie as respostas com polegar para cima ou para baixo. O feedback é anexado aos traces do agente.
Carregamentos de arquivo	Anexe arquivos à sua mensagem para que o agente trabalhe.

Localizar e trocar de agente

A lista de agentes mostra todos os agentes aos quais você tem acesso no tenant selecionado.

• Pesquisar — Use a caixa de pesquisa para filtrar agentes por nome ou descrição.
• Favoritos — marque os agentes que você mais usa para que eles apareçam em uma seção Favoritos na parte superior da lista.
• Alternar agente — Selecione Voltar acima da conversa para retornar à lista e escolher um agente diferente. Cada agente mantém seu próprio histórico de conversas, portanto, a mudança não limpa suas conversas anteriores.

Comandos do Teams

Use o menu suspenso Visualizar solicitações no lado inferior direito do chat para acessar comandos disponíveis:

Command	Description
Ajuda	Exibe a mensagem de ajuda para entender os recursos
Fazer logout	Desconecta você da organização e do tenant atuais
Alterar tenant	Solicita que você selecione um novo tenant
Alternar agente	Escolha entre agentes de conversa disponíveis
Configuração da máquina	Not applicable for Conversational Agents
Listar minhas automações acessíveis	Not applicable for Conversational Agents

Limitações

As funcionalidades a seguir não estão disponíveis ao enviar mensagens ao agente em um chat do Teams. Salvo indicação em contrário, eles estão disponíveis na aba Chat do agente.

Recurso	Observações
Excluir sessão de chat	Não é possível excluir sessões de chat
Configurações do perfil do usuário	A configuração de informações do perfil não é compatível
Iniciando prompts	Não propagado para a interface do Teams
Entradas de conversas	As entradas configuradas para o agente conversacional não são propagadas para a interface do Teams
Confirmações de chamadas de ferramentas	As chamadas de ferramentas não podem exigir confirmação
Visualização do HTML	O conteúdo HTML é exibido como texto bruto
Copiar resposta	As respostas devem ser destacadas e copiadas manualmente
Feedback	O feedback enviado ainda não está anexado aos traces

Discussões do canal e @menções não são compatíveis com nenhuma das experiências.

Solução de problemas

Agente não aparece no Teams

• Verifique se o agente foi publicado para Orchestrator.
• Confira se o aplicativo UiPath Autopilot para Teams está instalado.
• Use o comando Alternar agente para ver os agentes disponíveis.
• Certifique-se de estar conectado ao tenant correto.

Problemas da guia Chat do agente

• Se o pop-up de login não aparecer, verifique se os pop-ups são permitidos para o Microsoft Teams no seu navegador e, em seguida, selecione Entrar novamente.
• Se a guia relatar que está configurada para uma organização UiPath diferente, selecione Sair e faça login novamente com a organização à qual o agente pertence.
• Se sua sessão expirar, um banner aparecerá acima da conversa. Selecione Entrar novamente para continuar sem perder sua conversa.
• Se nenhum agente aparecer na lista, confirme se você selecionou o tenant correto e se o agente está publicado em uma pasta à qual você tem acesso.

Problemas de conversa

Se as conversas não começarem nem responderem:

• Verifique o status da conexão do agente no Gerenciamento de instâncias.
• Verifique as atribuições de robô na pasta da solução.
• Use o comando Fazer logout e reconecte-se para atualizar sua sessão.

Próximas Etapas

• Gerenciamento de instâncias: referência de funcionalidade completa e depuração
• Autopilot para Microsoft Teams: guia de integração completo do Teams