Pular para conteúdo

Open WebUI — padrão Betão (casca de chat dos agentes)

Como os agentes conversacionais da Bepex (Betão, Kowalski, e o futuro "Sobe Obras") ficam disponíveis num chat para a equipe. O Open WebUI é só a casca; toda a inteligência mora no n8n.

Instância

Parâmetro Valor
URL https://n8n-openwebui.fetrtm.easypanel.host/
Hospedagem EasyPanel (self-hosted)
Versão v0.10.1
Admin de funções /admin/functions

Como a ponte funciona

  • Cada agente é uma função tipo Pipe ("N8N Pipe" da comunidade, customizada pela Bepex). Cada pipe vira um "modelo" no seletor do Open WebUI.
  • O pipe encaminha para um webhook n8n (host n8n-hook.bepex.com.br).
  • Contrato pipe ↔ n8n: o pipe envia body.chatInput + body.sessionId; o n8n responde com o campo output (via nó Respond to Webhook).
  • Bearer compartilhado nas valves do pipe: ${OPENWEBUI_N8N_BEARER} (mesmo token em todos os pipes — ver credenciais.md; Tier 1 → rotacionar).

Pipes existentes

Pipe (modelo) Webhook n8n Agente
n8n_betao /webhook/3dc7d59a-… Betão — Coach de Vendas
n8n_betao_v2 /webhook/betao2 Betão — Análise de Negócio (timeout 360s)
n8n_para_tudo /webhook/v2/kowalski Kowalski (Procedimento Para Tudo)

Anatomia do workflow n8n típico (Betão)

chatTrigger + Webhook (cred `openwebUI`)
   │  Switch: mensagens "Query:" (geração de título do Open WebUI) desviam — não gastam o agente
   ▼
AI Agent (OpenRouter, ex. google/gemini-2.5-pro, cred "Betão Openrouter Agente" SESgn3rDg6E6qtJG)
   │
   ▼
Memória (Postgres n8n v2 / 7F3gxDoPsQGjAbOW)
   │
   ▼
Respond to Webhook  (campo `output`)

Credencial OpenRouter do Betão: Betão Openrouter Agente (SESgn3rDg6E6qtJG) — ver openrouter.md.

Regras ao criar/estender agentes (padrão validado)

  • Reaproveitar o padrão dos pipes Betão: criar uma nova pipe + novo webhook, nunca mexer nos pipes/webhooks existentes.
  • Usar credencial OpenRouter própria do agente — não emprestar chave de outro sistema (custo por sistema; ver openrouter.md).
  • Switch para Query: desvia as chamadas internas de geração de título do Open WebUI, para não disparar (e cobrar) o agente à toa.
  • Timeout do pipe alto para agentes que processam muito (o betao2 usa 360s).
  • Operação da API do Open WebUI: /api/v1/functions (pipes) e /api/v1/models (modelos).

Projeto que usa este backbone

O Agente "Sobe Obras" (canais-digitais/agente-sobe-obras/) foi desenhado sobre exatamente este padrão: um novo pipe Open WebUI → um novo WF-Sobe-Obra no n8n → sub-flow determinístico que publica obra no WordPress. Está em status: planejamento. Este doc é a fundação técnica que aquele projeto reaproveita.