Glossário Operacional Triadeflow

Termos que aparecem com frequência. Útil para onboarding de devs novos e referência rápida.

A

A2P 10DLC Application-to-Person 10-Digit Long Code. Compliance obrigatório para envio de SMS comercial nos EUA. Aplicável a clientes Triadeflow americanos (ex: USA Salus).

Agente Instância de um tipo (sdr, vendas, suporte, etc) servindo N tenants. Implementado como aplicação Python rodando em Docker.

Annotation Queue Fila do Langfuse com traces marcados para revisão manual. Usada na rotina semanal de qualidade.

Asana Plataforma de gestão de projetos da Triadeflow. MCP integrado permite Claude Code criar/atualizar tasks.

B

BANT Budget, Authority, Need, Timeline. Framework de qualificação de leads. Usado em agent-sdr e agent-vendas.

BullMQ Sistema de filas sobre Redis. Usado para processar mensagens assíncronas, tasks de longo prazo, retries.

C

Caddy Reverse proxy com TLS automático. Substitui Nginx. Usado em todos os deploys Hetzner.

ClickHouse DB OLAP usado pelo Langfuse para armazenar traces. Não acessamos diretamente, apenas via Langfuse.

CPX21 / CPX31 Tipos de servidor Hetzner. CPX21 (3 vCPU, 4GB RAM, €5.83/mês) para agentes pequenos. CPX31 (4 vCPU, 8GB, €15.39/mês) para agentes maiores ou infra core.

D

DataSync Produto Triadeflow para limpeza e enriquecimento de contatos antes de importar para GHL.

E

Eval Conjunto de casos de teste com resultado esperado. Cada agente tem eval/datasets/golden.json que valida qualquer mudança.

Evolution API Provider WhatsApp self-hosted via Baileys. Usado para clientes Kommo. Hospedado em evolution.triadeflow.com.

F

Fragment (de prompt) Pedaço reutilizável de system prompt em prompts/fragments/. Compartilhado entre tenants do mesmo tipo de agente. Ex: tom.md, lgpd.md, handoff.md.

G

GHL (GoHighLevel) CRM americano com features avançadas (calendar nativo, snapshots, marketplace). Usado para clientes maiores ou agências.

GraphRAG Variante de RAG que usa grafo de conhecimento. Considerado e descartado para Triadeflow (ver ADR-003).

H

Handoff Transição agente → humano. Sempre via tool específica (handoff_humano). Triggers: keywords, sentiment negativo, número de tentativas.

Hetzner Cloud provider principal da Triadeflow. Hospeda toda infra de produção em Falkenstein (Alemanha).

Hub A Triadeflow inteira como entidade. Não somos agência. Nos posicionamos como hub de tecnologia.

K

Kommo CRM padrão da Triadeflow para clientes brasileiros. Sucessor da amoCRM.

L

Langfuse Plataforma de observabilidade para LLMs. Self-hosted no Hetzner. Hospeda traces, datasets, scores, annotation queue.

LangChain / LangGraph Frameworks para construir agentes LLM. LangChain para chamadas básicas, LangGraph para workflows com state.

LGPD Lei Geral de Proteção de Dados. Compliance obrigatório no Brasil. Toda operação Triadeflow respeita.

LLM-as-judge Técnica de usar LLM para avaliar qualidade de outputs de outros LLMs. Roda automaticamente no Langfuse.

M

MCP (Model Context Protocol) Protocolo para conectar Claude Code a serviços externos. Triadeflow tem MCPs configurados para Asana, Notion, Drive, GitHub, etc.

Memory summarizer Componente que comprime histórico de conversa após N turnos. Reduz custo em conversas longas.

Model router Componente que escolhe modelo (Sonnet vs Haiku) baseado no tipo de tarefa. Reduz custo sem comprometer qualidade.

N

Nicho Setor do cliente final (saúde, beleza, educação, e-commerce, etc). Cada nicho tem playbook em .claude/playbooks/.

n8n Plataforma de automação visual. Triadeflow usa em transição para arquitetura nova baseada em código Python + BullMQ.

O

OpenClaw VPS Triadeflow conectado via Telegram bot (@open_claw_triadeflow_bot). Útil para alertas e operações ad-hoc.

P

Parceira Agência que revende agentes para seus próprios clientes finais. Triadeflow tem ~18 ativas.

Pipeline (CRM) Funil de vendas no Kommo ou GHL. Cada stage representa um momento da jornada.

Playbook (de nicho) Configuração base para um setor. Define tom, qualificação, compliance, integrações típicas. Ver .claude/playbooks/.

Prompt caching Feature da Anthropic para cachear partes fixas do prompt e reduzir custo. Padrão Triadeflow para system prompts > 1024 tokens.

Q

Qdrant Vector database self-hosted. Usado para RAG. Cada tenant tem collection isolada.

R

RAG (Retrieval Augmented Generation) Técnica de buscar contexto relevante e fornecer ao LLM. Triadeflow usa RAG vetorial simples (Qdrant + embeddings OpenAI).

Redis Cache, memória curta de conversas, filas BullMQ. Self-hosted.

Retention Tempo que dados sensíveis ficam armazenados. Padrão Triadeflow: 90 dias para PII, 1 ano para traces. Ajustável por tenant conforme LGPD.

S

SLA (Service Level Agreement) Acordo de nível de serviço com cliente. Triadeflow oferece tiers: Standard, Plus, Enterprise.

Stevo Provider WhatsApp para GHL. Integração oficial via WhatsApp Business API. Mais estável que Evolution mas com custo.

System prompt Instrução base do agente. Compilada de template Jinja2 + fragments + variáveis do tenant.

T

TDI (Triadeflow Implementation) Metodologia de implantação Triadeflow. Fases: Triagem, Discovery, Implementação, Homologação, Go-live, Acompanhamento.

Tenant Cliente final. Identificado por tenant_id (slug kebab-case). Cada um tem config.yaml, KB, integrações específicas.

Tier (de agente) Classificação por maturidade e ticket:

Tier 1: SDR, vendas, suporte, agendamento (ticket R$ 1k-2k/mês)
Tier 2: recuperação, cobrança, pós-venda (ticket R$ 1.5k-2.5k)
Tier 3: prospecção ativa, NPS (ticket R$ 2.5k-4.5k)
Tier 4: confirmação, RH, vendedor catálogo (backlog)

Tool Função que o agente pode invocar via LangChain. Tipada com Pydantic. Ex: consultar_kb, agendar_reuniao, handoff_humano.

top_k (RAG) Quantidade de chunks retornados na busca vetorial. Padrão Triadeflow: 5. Maior = mais contexto + mais custo.

Trace Registro completo de uma execução do agente no Langfuse. Inclui inputs, outputs, tools, latência, custo.

Triadeflow Core Biblioteca Python compartilhada entre todos os agentes. Contém: providers, CRM clients, observability, model router, memory.

U

UTM Parâmetros de tracking em URLs (utm_source, utm_medium, utm_campaign). Capturados pelo agente para attribution.

V

Vector store Banco que armazena embeddings vetoriais. Triadeflow usa Qdrant.

W

Webhook URL HTTP que recebe eventos de plataformas externas (Evolution, Stevo, Kommo, GHL, gateway, etc).

White-label Quando cliente recebe dashboard/produto sem branding Triadeflow visível. Cobrado como upsell.

Z

Z-API Provider WhatsApp brasileiro alternativo a Evolution. Considerado em casos específicos.

Mantenedor: este glossário é vivo. Adicione termos novos quando aparecerem com frequência.