Pular para o conteúdo principal

Integre o Chatbot do EKB ao MS Teams

Integrar o EKB ao Microsoft Teams permite trazer um chat inteligente e context-aware diretamente para o ambiente de colaboração da sua equipe. Este guia orienta você sobre os passos para configurar o chatbot do EKB no Microsoft Teams, permitindo comunicação contínua com seu agente de IA sem sair da interface do Teams.

Pré-requisitos​

  • Acesso de administrador ao Azure para criar o bot
  • Acesso de administrador ao Portal de Desenvolvimento do Teams

Passos de Configuração​

1. Criar o Bot do Azure​

  1. Vá para o painel do Azure.
  2. Clique em Criar Recurso.
  3. Digite Bot na barra de pesquisa e selecione Azure Bot.
  4. Crie um novo Azure Bot e defina o Nome de Exibição desejado.

2. Configurar o Bot​

  1. Vá para a aba Configuração e atualize o Endpoint de Mensagens para apontar para a URL do seu servidor.
    Informação
    Clientes de Nuvem, por favor insira https://api.getodin.ai/teams/events
    Clientes On-Premise, por favor insira <sua URL raiz do backend>/teams/events

    Configuração do Endpoint de Mensagens
  2. Na aba Configuração, copie o App ID e o Tenant ID, e em seguida navegue até Gerenciar Senhas.
  3. Crie uma nova senha para o bot e a salve para uso posterior.
  4. Habilite um endpoint de streaming para o bot no Azure e aponte para a URL desse endpoint.

3. Habilitar o Canal do Teams​

  1. Clique em Canais no lado esquerdo do portal do Azure e habilite o canal de interação Teams para o bot.

4. Registrar o Bot no EKB​

Informação
Clientes de Nuvem, por favor abram um ticket de suporte com o suporte da AA fornecendo seu App ID, Tenant ID e App Password para ter o bot registrado para você.
  1. No EKB, navegue até a página Super Admin e selecione **Bots do Teams` no lado esquerdo.
  2. Clique em Registrar Bot.
  3. Insira o App ID, o Tenant ID e a Senha coletados nos passos 6–7. Clique em Registrar Bot.

5. Criar o Aplicativo no Portal de Desenvolvimento do Teams​

  1. Vá para o Portal de Desenvolvimento do Teams.
  2. Clique em Novo Aplicativo.
  3. Preencha as informações do aplicativo:
    • Descrição Curta — obrigatória, não pode estar vazia.
    • Descrição Longa — obrigatória, não pode estar vazia.
  4. Preencha o campo App ID com o App ID do bot do Azure.

6. Configurar Recursos do Bot​

  1. Vá para Recursos do Aplicativo e adicione o bot, fornecendo o App ID do Azure.
  2. Configure os recursos do bot da seguinte forma:
    Recursos do Bot do Teams

7. Implantar​

  1. Implante o pacote seguindo a política padrão da sua organização para implantação de novos aplicativos do Teams.
  2. Para conectar o bot a um projeto, envie !setupme (só para você) ou !setup (para todos na conversa) como primeira mensagem. Consulte Conectar o bot a um projeto.

Método de Implantação Recomendado​

  1. Publicar para a Organização

    Na página do aplicativo no Painel de Desenvolvimento do Microsoft Teams, role até o final da barra lateral esquerda. Em Publicar, selecione Publicar para a organização.
    Publicar para a Organização

  2. Conceder Consentimento do Administrador

    O aplicativo será publicado na sua instância do Teams e pode exigir o consentimento do Administrador. O consentimento pode ser concedido no Centro de Administração do Microsoft Teams.

  3. Aguardar a Propagação

    Após o consentimento ser concedido, aguarde algumas horas para que as permissões se propaguem antes que o bot se torne utilizável. Este atraso é causado pelo processo de revisão interno da Microsoft para aplicativos personalizados, mesmo quando restrito a uma única organização.

Conectar o bot a um projeto​

O bot responde a partir de um projeto do Odin e usa uma chave de API e um segredo para agir nele. Há duas formas de conectar um, e ambas abrem um formulário curto no Teams. Em canais e chats em grupo, mencione o bot com @ ao enviar um comando, por exemplo @Odin !setup.

Conexão compartilhada (!setup)​

!setup conecta um projeto para todos na conversa, usando o ID do projeto e uma chave de API e um segredo que tenham acesso a ele.

Por padrão, uma conexão compartilhada tem granularidade por bot e por instância do Teams: ela se aplica a toda a instância do Teams, incluindo todos os canais, grupos e mensagens diretas.

Conexão pessoal (!setupme)​

!setupme conecta sua própria conta do Odin. Informe uma chave de API e um segredo das configurações da sua própria conta (uma chave de nível de projeto não é aceita) e, opcionalmente, o ID de um projeto ao qual você tenha acesso. Deixe o ID do projeto em branco para usar seu projeto pessoal Autopilot.

Uma conexão pessoal responde apenas a você e sempre tem prioridade sobre uma compartilhada. !resetme a remove; depois disso, o bot volta a responder a você pela conexão compartilhada.

Configurações por canal (somente on-premise)​

Para mais granularidade — por exemplo, usar um bot com vários projetos dependendo do canal, do grupo ou do usuário — defina a seguinte variável de ambiente do backend:

TEAMS_USE_PER_CHANNEL_SETTINGS=TRUE

Com ela definida, !setup conecta um projeto por canal (e por pessoa nas mensagens diretas), e uma conexão pessoal criada com !setupme em um canal vale apenas para esse canal. Uma conexão pessoal criada em uma mensagem direta vale para suas mensagens diretas com o bot.

Informação

Esta configuração está disponível apenas para clientes on-premise. Ela não é compatível com implantações hospedadas na nuvem.

Seleção do agente​

O bot responde com o agente padrão definido atualmente no projeto. Uma conexão pessoal sem Project ID usa o seu projeto Autopilot, que responde como o agente Autopilot do Odin.

Se o projeto ativar Permitir escolha de agente nas configurações do Teams App, qualquer pessoa com uma conexão pessoal (!setupme) pode escolher outro agente para si: digite !agent, ou pressione Change agent no cartão inicial, e escolha entre os agentes que a sua função pode usar no chat web do Odin, incluindo o Autopilot. Project default acompanha o agente definido no projeto, mesmo que ele mude depois.

A sua escolha afeta apenas a sua própria conexão. Ela é mantida se você executar !setupme de novo com o mesmo projeto, é apagada se você conectar outro, e o histórico da conversa permanece quando você troca de agente. Conexões compartilhadas (!setup) sempre respondem com o agente padrão do projeto. Se o agente escolhido for excluído, ou a sua função perder o acesso a ele, o bot avisa uma vez e volta ao agente padrão do projeto. Desativar a configuração faz todos voltarem ao padrão.

Usar o bot​

Cartão inicial​

Digite !home para ver a qual projeto o bot está conectado, o que ele pode fazer e algumas perguntas sugeridas para experimentar. O cartão tem botões para trocar de projeto e ver as integrações do projeto. O bot também o mostra quando é instalado pela primeira vez em um chat pessoal. Quando a sua conexão pode escolher o agente, o cartão também mostra qual agente está respondendo, com um botão Change agent.

Status ao vivo​

Enquanto o agente trabalha, o bot mostra o que ele está fazendo — Thinking... ou a ferramenta que está usando — antes de a resposta chegar. Em chats pessoais, isso aparece como uma linha de status ao vivo; em canais e chats em grupo, a mensagem do bot é atualizada no lugar. Apenas a resposta final permanece na conversa. Isso pode ser desativado com a opção Status ao vivo nas configurações do aplicativo do Teams.

Conectar integrações​

Quando o agente precisa de uma integração que ainda não está conectada, o bot publica um cartão:

  • Para serviços que fazem login com OAuth (por exemplo, Gmail ou Notion), selecione Connect, conclua o login no navegador e depois selecione Continue.
  • Para serviços que usam uma chave de API ou um token, selecione Connect e informe as credenciais no formulário que se abre.

!integrations lista as integrações que o projeto tem conectadas e as que ele poderia conectar. A conexão e a desconexão de integrações são feitas no Odin.

Aprovações e perguntas​

Se o agente quiser executar uma ação que precisa da sua aprovação, o bot mostra os detalhes da ação com os botões Allow e Deny. Se precisar de mais informações, ele pergunta com um formulário curto que você pode responder diretamente no Teams.

Consulte Comandos disponíveis para ver todos os comandos aceitos pelo bot.