Usando no MS Teams

Guia

Dica

O Prodgy se integra ao Microsoft Teams via Azure Bot Service. Os usuários conversam diretamente com o bot no Teams e recebem respostas da Knowledge Base do workspace.

Pré-requisitos

• Conta no Azure Portal com permissão para criar recursos
• Produto cadastrado no Prodgy com Knowledge Base configurada
• Organização com modelo de IA (LLM) configurado
• API do Prodgy acessível publicamente via HTTPS

---

Configuração

1. Criar o Azure Bot

1. Acesse o Azure Portal

2. Crie um novo recurso do tipo Azure Bot

3. Preencha os campos:

   Campo	Valor
   Bot handle	Nome único (ex: prodgy-bot-org)
   Pricing tier	Free (F0) para testes
   Type of App	Multi Tenant
   Creation type	Create new Microsoft App ID

4. Após a criação, anote o Microsoft App ID

5. Vá em Certificates & Secrets no App Registration e gere um Client Secret — anote o valor

2. Habilitar o Canal Teams

1. Na página do Azure Bot, vá em Channels
2. Clique em Microsoft Teams
3. Aceite os termos e salve

3. Criar a Integração no Prodgy

1. No Prodgy, acesse Integrações

2. Adicione uma nova integração do tipo MS Teams (classificação: comunicador)

3. Preencha as credenciais:

   Campo	Valor
   App ID	Microsoft App ID do Azure Bot
   App Password	Client Secret gerado no passo 1
   Tenant ID	(opcional) — deixe vazio para Multi Tenant

Nota

Se o Tenant ID não for informado, o sistema usa common automaticamente, permitindo que usuários de qualquer tenant Azure AD usem o bot.

4. Exportar o Produto

1. Acesse o Playground do workspace desejado
2. Clique em Exportar no cabeçalho
3. Selecione a integração MS Teams criada
4. O sistema gera a URL do endpoint (Messaging Endpoint)

5. Configurar o Messaging Endpoint

1. Volte ao Azure Portal > Azure Bot > Configuration

2. Cole a URL gerada no campo Messaging endpoint:

   https://<sua-api>/api/communicator/botframework/<integration_base_id>/messages

3. Salve a configuração

---

Testando

No Azure Portal

No Azure Bot > Test in Web Chat, envie uma mensagem para verificar se o bot responde.

No Teams

1. Na página do Azure Bot > Channels > Microsoft Teams, clique Open in Teams
2. Ou busque o bot pelo nome na barra de pesquisa do Teams
3. Inicie uma conversa direta com o bot

Primeiro uso

1. Envie /prodgy login para vincular sua conta Prodgy
2. Clique no link de autenticação e faça login
3. Envie /prodgy list para ver os workspaces disponíveis
4. Envie /prodgy link <slug> para selecionar um workspace
5. Comece a conversar normalmente — o bot responde usando a Knowledge Base

---

Comportamento

Indicador de Processamento

Quando o usuário envia uma mensagem:

1. O bot envia “Pensando…” imediatamente
2. O Agentic processa a mensagem (consulta Knowledge Base, executa tools se necessário)
3. A mensagem “Pensando…” é substituída pela resposta final

Formatação

O Teams suporta Markdown nativamente. As respostas da LLM são exibidas com formatação correta:

• Negrito, itálico, código
• Listas com marcadores (•)
• Blocos de código
• Links clicáveis

Multi-Produto

Se a organização tem múltiplos workspaces exportados para o mesmo bot:

• Cada usuário seleciona seu workspace ativo via /prodgy link <slug>
• Canais do Teams podem ser mapeados a produtos específicos pelo administrador

---

Troubleshooting

Bot não responde no Teams

• Verifique se o Messaging Endpoint no Azure Bot está correto e acessível via HTTPS
• Verifique se a integração está com status ativo no Prodgy
• Verifique se as credenciais (App ID e App Password) estão corretas

Erro 401 (Unauthorized)

• O App Password pode estar incorreto ou expirado
• Regenere o Client Secret no Azure Portal > App Registration > Certificates & Secrets
• Atualize a credencial no Prodgy

Mensagens cortadas ou com texto embaralhado

• Verifique o parâmetro maxTokens nas configurações do comunicador
• Valores muito altos podem degradar a qualidade da resposta da LLM
• Recomendado: entre 4096 e 8192 tokens

Resposta demora muito

• O timeout padrão é 30 segundos (timeoutMs: 30000)
• Reduza maxIterations para limitar o loop de tool-calling
• Verifique a latência do serviço Agentic

Cuidado

O pacote botbuilder é necessário no backend. Se houver erro “Cannot find module ‘botbuilder’”, execute pnpm install na raiz do projeto.