Exportando para Comunicadores

Guia

Dica

O Prodgy permite levar os agentes do Playground para além da plataforma, conectando-os diretamente a comunicadores empresariais. Seus usuários interagem com a Knowledge Base sem sair do Teams, Slack ou Google Chat.

Visão Geral

O módulo Comunicador permite exportar produtos do Prodgy para plataformas de comunicação. Os usuários conversam com o assistente IA diretamente no seu comunicador do dia a dia — o Prodgy processa a mensagem via Agentic Executor e retorna a resposta usando a Knowledge Base do workspace.

Plataformas Suportadas

Plataforma	Protocolo	Status
MS Teams	Bot Framework SDK	Produção
Slack	Event API + Web API	Produção
Google Chat	Webhook + REST API	Produção

Como Funciona

Usuário envia mensagem no comunicador
        ↓
  Prodgy recebe via webhook/Bot Framework
        ↓
  Identifica produto (canal ou seleção do usuário)
        ↓
  Envia "_Pensando..._" como indicador
        ↓
  Processa via Agentic Executor (Knowledge Base + Tools)
        ↓
  Atualiza mensagem com a resposta final

---

Exportando para Comunicadores

Para conectar um workspace do Prodgy a um comunicador:

1. Crie a integração — Na página de Integrações, adicione o comunicador desejado (Teams, Slack ou Google Chat) e configure as credenciais
2. Exporte o workspace — No Playground, clique em Exportar e selecione o comunicador configurado
3. Configure o comunicador — Siga o guia específico da plataforma para apontar o webhook/endpoint

MS Teams Configuração via Azure Bot Service

Slack Configuração via Slack App e Event API

Google Chat Configuração via Google Cloud

---

Comandos do Bot

Após exportar, os usuários interagem com o bot nos comunicadores usando comandos:

Comando	Descrição
/prodgy login	Gera link para autenticar a conta Prodgy (expira em 15 min)
/prodgy logoff	Desvincula a conta Prodgy (para trocar de usuário)
/prodgy list	Lista os workspaces acessíveis ao usuário
/prodgy link <slug>	Seleciona ou troca o workspace ativo
/prodgy clear	Limpa a conversa e inicia uma sessão nova
/prodgy help	Exibe a lista de comandos disponíveis

Fluxo de Primeiro Uso

1. O usuário digita /prodgy login no comunicador
2. O bot retorna um link de autenticação (expira em 15 minutos)
3. O usuário clica no link e faz login no Prodgy pelo navegador
4. A conta do comunicador fica vinculada à conta Prodgy
5. O usuário usa /prodgy list para ver os workspaces disponíveis
6. Usa /prodgy link <slug> para selecionar um workspace
7. A partir daí, basta enviar perguntas normalmente

Cuidado

O usuário precisa ter acesso ao workspace via Gerenciamento de Usuários do Prodgy. Caso contrário, o workspace não aparecerá na lista.

---

Multi-Produto

O mesmo bot pode atender múltiplos workspaces simultaneamente:

• Cada usuário seleciona seu workspace ativo via /prodgy link <slug>
• Canais específicos podem ser mapeados a produtos (ex: canal #suporte → produto “Suporte”, canal #vendas → produto “Vendas”)
• O roteamento segue a prioridade: seleção do usuário > mapeamento de canal > primeiro workspace acessível

---

Configuração Avançada

Os parâmetros de execução do Agentic para comunicadores são configuráveis no banco de dados. Isso permite ajustar o comportamento sem redeployar.

Parâmetros

Parâmetro	Default	Descrição
maxTokens	8192	Máximo de tokens de saída da LLM. Comunicadores enviam a resposta inteira de uma vez (sem streaming), então este valor evita respostas excessivamente longas.
maxIterations	3	Máximo de iterações do loop de tool-calling. Menor que o Playground (10) para manter respostas rápidas.
timeoutMs	30000	Timeout de execução em milissegundos. 30 segundos é um limite seguro para as janelas de resposta do Bot Framework e webhooks do Slack.
maxChatHistory	20	Máximo de mensagens anteriores enviadas ao Agentic. Limita uso de context window e custo.
systemPromptSuffix	(ver abaixo)	Instrução extra adicionada ao prompt do agente quando a requisição vem de um comunicador.

Valor default do systemPromptSuffix:

“You are responding via a chat communicator (Teams/Slack). Keep answers concise and well-formatted for chat. Avoid extremely long responses.”

Nota

Esses parâmetros ficam armazenados em Configurações > Knowledge Base > playground.communicator. Após alterá-los, reinicie o serviço da API para aplicar (configuração é cacheada em memória).

---

Tradução Automática

O bot detecta automaticamente o idioma do usuário e traduz as respostas de comandos para o mesmo idioma. Se o usuário escreve em português, as respostas do bot vêm em português. Em inglês, vêm em inglês.

• A tradução é feita pelo LLM core do Prodgy
• Resultados são cacheados para evitar chamadas repetidas
• Markdown, URLs, comandos /prodgy e nomes de workspace são preservados
• Se a tradução falhar, o texto original em inglês é retornado

---

Histórico de Conversa

Cada sessão de comunicador mantém um histórico de conversa vinculado ao workspace:

• As mensagens são salvas no mesmo formato do Playground
• O comando /prodgy clear arquiva a sessão atual — a próxima mensagem inicia uma nova conversa
• O histórico é enviado ao Agentic respeitando o limite maxChatHistory

---

Resumo dos Comunicadores

Plataforma	Protocolo	Guia
MS Teams	Azure Bot Service (Bot Framework SDK)	Configuração
Slack	Slack App (Event API + Web API)	Configuração
Google Chat	Google Chat API (HTTP endpoint)	Configuração