Microsoft Teams

Põe um agente do Pepe no Microsoft Teams para a tua equipa conversar com ele por lá.

Microsoft Teams

Ligar o Teams permite que a tua equipa converse com o agente onde já trabalha. O Teams fala com bots através do Bot Framework da Microsoft; configura a ligação pela configuração guiada (ou pelo painel):

pepe setup

O config de uma ligação contém:

• app_id: o id da aplicação (cliente) Microsoft do bot.
• app_password: o segredo de cliente. Guarda-o como ${ENV_VAR}.
• tenant_id: o tenant ID do Azure (ou botframework.com).

As atividades de entrada chegam como POSTs. As respostas voltam para o URL de serviço da atividade com um token de acesso de aplicação gerado a partir das credenciais de cliente. A menção ao bot é retirada do texto de entrada antes de o agente o ver. Formato do URL de retorno:

https://YOUR_HOST/webhooks/default/msteams/<slug>

Autenticação de entrada

O Pepe confirma que cada pedido recebido vem mesmo da Microsoft antes de o agente ver seja o que for: cada pedido transporta um token do Bot Framework em Authorization: Bearer, e o Pepe valida-o (assinatura contra as chaves públicas da Microsoft, emissor e uma audiência igual ao app_id do bot). Assim o endpoint aceita POSTs diretamente da Microsoft, sem necessidade de um proxy que valide. Se o teu proxy já faz essa verificação, define trust_proxy: true na ligação para saltar a do Pepe.

Vê Webhooks para os campos partilhados por toda a ligação (agent, mode, trainers, session_ttl_min, ephemeral, commands) e como funciona a rota genérica por dentro.

Mudar de modelo

Os comandos /model e /models permitem ver ou mudar o modelo de IA que responde. Só funcionam numa ligação em modo admin com commands ativado; no support, são tratados como texto normal. /models lista os modelos disponíveis para o projeto desta ligação; /model mostra o atual, ou muda-o:

/model openrouter               # pergunta se muda só este chat ou todos
/model openrouter session       # muda só para esta conversa
/model openrouter global        # muda para todos com quem esta ligação fala

Qualquer pessoa numa conversa permitida pode mudar o modelo da sua própria conversa. Mudá-lo globalmente, para todos com quem esta ligação fala, está reservado aos formadores, a mesma lista de confiança que rege a memória. Define model_switch_locked: true na ligação para desativar por completo a mudança de modelo para quem não é formador.