SafeHarn
HARN — Catálogo de Automações Inteligentes.
Plataforma de agentes composáveis para mercado financeiro, RH e operações. Orquestre no HarnFlow, gere com MagicWork e execute na web, API ou Telegram.
Financeiro · RH · Operações
Problema
Chatbots genéricos não resolvem crédito, KYC ou RH — faltam integrações, controle de custo e resultado verificável.
Solução
Cada automação é uma receita: prompt, skills, rules e tools. Orquestre no HarnFlow ou deixe o LLM planejar; rode na web, API ou Telegram com JSON validado e trilha completa.
Catálogo de automações inteligentes
Cada automação é uma receita reutilizável de Prompt + SKILLs + RULEs + Tools + LLM — para financeiro, RH e operações.
20
Oportunidades mapeadas
3
Verticais de mercado
18
Capacidades da plataforma
Entregas recentes
Evolução de segurança, deploy, qualidade e produto na plataforma.
Segurança
Fail-fast de secrets e gates de deploy
JWT/AMQP/PYTHON_RUNNER_API_KEY obrigatórios no boot; seed admin bloqueado em production; Telegram exige credenciais no startup.
Deploy
Contrato Dev/Docker alinhado à produção
DNS interno harn-api / harn-python-runner; portas 3210/3211/3212/3280 preservadas; .env.example só para pnpm local.
Qualidade
Testes de alto valor + CI
ACL (resource-access), BFF (backend-proxy), messaging (processResponse), sql-params; pnpm test na raiz e GitHub Actions (Node + unittest do runner).
Arquitetura
Docs de sistema e ADRs
C4 containers, auth E2E, mapa de filas, rede Docker e contratos Telegram em docs/architecture; ADRs de BFF cookie→Bearer e dual auth.
Código
Field-encryption unificado
AES-256-GCM centralizado em @harn/shared; API e worker consomem a mesma implementação.
Produto
Telegram + MagicWork em produção
Canal operacional completo e geração de agentes a partir de linguagem natural (já documentados nas seções abaixo).
Indicadores e oportunidades
Distribuição por vertical, maturidade das integrações e impacto estimado.
Oportunidades por vertical
8 financeiro · 5 RH · 7 outros
Maturidade das integrações
Status real da plataforma
Impacto estimado (%)
Valores ilustrativos para apresentação
Capacidades da plataforma
Tools, canais e capabilities — com status de implementação.
SERPRO, Serasa, bureaus com bloqueio inteligente
Integrações REST configuráveis
Regras de negócio no sidecar FastAPI autenticado
Busca pública via SearXNG/Tavily
Vínculo, dual auth, execução e push de resultado no chat
Query Builders + db-runtime (SQL parametrizado)
Envio via ApiConfig (ex.: gateway SMTP/HTTP) com schema e domínio email no worker
Stub hoje; Qdrant já usado para tools — RAG de docs é o próximo passo
Atendimento e coleta de documentos
Base de conhecimento / RAG de verdade — Qdrant já existe; docs por agente, citações
Agendamento e gatilhos — cron, webhook de entrada e eventos internos
Human-in-the-loop — pausar tools críticas; aprovar no Web + Telegram
Observabilidade de custo e qualidade — tokens, replay, evals
Memória / conversa contínua — thread por chave composta de inputs
Completar catálogo de tools — RAG, webhooks Slack/Teams
Versionamento e promoção — draft → staging → prod
Multi-tenant / workspaces — org, quotas e isolamento
Designer visual de orquestração multi-agente. Monta fluxos (DAG) conectando agentes do catálogo a LLM, prompts, skills e rules; valida o grafo, persiste e executa no worker (FlowRunner) com paralelismo por waves — útil para automações compostas sem depender só do orquestrador LLM.
HarnFlow
ProntoPara que serve: orquestrar vários agentes em um fluxo visual (DAG), compondo LLM, prompts, skills e rules no canvas; validar, salvar e executar a automação composta no worker — sem depender apenas do plano gerado pelo orquestrador LLM.
Arquitetura e diferenciais
Fluxo executivo da plataforma — da entrada ao resultado auditável.
API / UI / Telegram
Entrada da solicitação
RabbitMQ
Fila de tarefas
Worker
Motor de execução
LLM + Tools
Planejamento e integração
Resultado auditável
JSON validado + logs
Integração Telegram
Canal operacional pronto: vincule sua conta, liste e execute agentes pelo bot e receba o resultado no chat.
Como vincular
- 1.Abra Conta → Telegram na plataforma web
- 2.Gere o link de vinculação
- 3.Abra o deep link no Telegram e inicie a conversa com o bot
- 4.Confirme o vínculo — a web detecta automaticamente
Comandos
/agentesListar agentes e executar/funcoesListar funções disponíveis/status <ticket>Status da execução/resultado <ticket>Resultado final/cancelarCancelar coleta de parâmetros/helpAjuda e status do vínculo
Vínculo
Conta web ↔ chat Telegram
/agentes
Lista paginada com ACL do usuário
Inputs
Coleta dos parâmetros do agente
Ticket
Execução assíncrona no worker
Resultado
Push automático no chat
MagicWork
Gere um agente completo a partir de uma tarefa em linguagem natural: Prompt + SKILL + RULE + Agente (e Python/tool se o plano pedir).
Como gerar
- 1.Descreva a tarefa (obrigatório); nome e grupo do agente são opcionais
- 2.Opcional: dite a tarefa por voz com a assistente Luna
- 3.Clique em “Gerar agente automaticamente”
- 4.Acompanhe o progresso: análise → Python → SKILL → RULE → Prompt → Agente
- 5.Abra os recursos criados ou execute o agente
A geração acontece na página MagicWork — aqui só explicamos o fluxo.
Agent
Orquestrador com inputs, template e playbooks
Skill
Playbook procedural (SKILL)
Rule
Playbook de regras e formato de saída
Prompt
Instruções e schema do agente
Python + Tool
Opcional — função e tool PYTHON quando o plano exigir
Tools do catálogo
Sugestões; aviso se ainda não existirem na plataforma
Tarefa
Descrição em linguagem natural
Plano LLM
Monta a receita dos artefatos
Criação
Recursos em sequência
Resultado
Links e execução; rollback se falhar
Execução do Worker
Diagramas do motor: bootstrap, fluxo principal, orquestrador e agent loop.
Bootstrap do Worker
Sequência de inicialização ao subir o processo worker.
- Health HTTP na porta 3202
- Carrega tools do PostgreSQL e indexa no Qdrant
- Registra playbooks e inicia consumers RabbitMQ
Empacotamento da receita
Camadas que compostam cada automação na SafeHarn.
Prompt
Instruções + task + outputSchema
SKILLs
Procedimentos por domínio
RULEs
Restrições e formato de saída
Tools
PROVIDER, API, PYTHON, canais
Inputs
CPF, telefone, valores...
Canal
UI, API, Telegram, WhatsApp
Catálogo de oportunidades
20 automações mapeadas — filtre por vertical.
Financeiro
KYC / Onboarding completo
Valida identidade, documento, telefone, PEP e listas restritivas.
Abertura de conta em minutos com rastreio auditável
Financeiro
Análise de crédito pré-aprovada
Cruza bureau, renda, histórico interno e política de crédito.
Pré-análise antes do analista humano
Financeiro
Antifraude PIX/TED
Analisa titularidade, padrão de comportamento e listas negras.
Bloqueio preventivo com explicação estruturada
Financeiro
Conciliação bancária
Compara extratos, boletos e lançamentos internos.
Menos trabalho manual no back-office
Financeiro
Validação de NF-e
Valida chave, CNPJ emitente, duplicidade e inconsistências.
Contas a pagar com menos fraude
Financeiro
Compliance PLD-FT
Monitora PEP, OFAC, operações atípicas e mídia adversa.
Relatórios de compliance com evidências
Financeiro
Cobrança inteligente
Prioriza devedores e valida contato antes de acionar.
Recuperação mais eficiente
Financeiro
Análise de contratos
Extrai cláusulas e compara com política interna.
Revisão jurídica em minutos
RH
Triagem de currículos
Ranqueia candidatos contra requisitos da vaga.
Recrutamento mais rápido e objetivo
RH
Admissão digital
Valida CPF, telefone, antecedentes e documentos.
Onboarding sem planilhas
RH
Conferência de folha
Cruza ponto, benefícios e aponta inconsistências.
Menos retrabalho no fechamento
RH
Gestão de férias
Valida saldo, conflitos e política de férias.
Self-service com governança
RH
Síntese de pesquisa de clima
Agrega respostas e gera relatório executivo.
RH foca em ação, não em planilha
Outros
Validação de fornecedores
CNPJ, situação fiscal, protestos e certidões.
Procurement com menos risco
Outros
Due diligence imobiliária
Matrícula, ônus, IPTU e proprietário.
Checklist automatizado para escritórios
Outros
Atendimento omnichannel
Cliente envia documento e recebe status automatizado.
Atendimento 24/7 com escalação humana
Outros
Monitoramento regulatório
Busca novas normas e resume impacto.
Compliance antecipado
Outros
Triagem de sinistros
Valida documentos e cruza com apólice.
Menos perícias desnecessárias
Outros
Qualificação de leads B2B
Valida CNPJ, porte e situação cadastral.
Comercial foca em leads qualificados
Outros
Auditoria interna contínua
Detecta anomalias em lançamentos e aprovações.
Governança proativa
Blueprint: Análise de Crédito Pré-Aprovada
Receita completa — inputs, tools, skills, rules e fluxo de execução.
Inputs
- cpf — Documento principal
- renda_declarada — Renda mensal em R$
- valor_solicitado — Montante do crédito
- produto — Ex: pessoal, consignado, veículo
- prazo_meses — Prazo desejado
Tools
- validar_cpfPROVIDER
nome_chave do site_provedor CPF
- consulta_serasa_scorePROVIDER
nome_chave bureau Serasa
- calcular_comprometimento_rendaPYTHON
função Python no sidecar
- consultar_historico_clienteDB
query histórico inadimplência
- notificar_analista_creditoTELEGRAM
notificação opcional
Skills & Rule
consulta-cpfconsulta-serasacalculo-score-credito- Rule:
saida-credito-json
Você é analista de crédito automatizado. Priorize consultas baratas. Não aprove se CPF inválido ou score_risco=alto.
Fluxo
- 1.UI/Telegram — Envia cpf, renda, valor
- 2.Worker — Stage 1: validar_cpf (barato)
- 3.Receita — Se valido=false → reprova sem bureau
- 4.DB — Consulta histórico interno
- 5.Serasa — Consulta bureau (pago)
- 6.Python — Calcula score e limite
- 7.Worker — Retorna JSON aprovado/limite/taxa
Blueprint: Admissão Digital de Colaborador
Admissão digital com validação documental e notificação multicanal.
Inputs
- cpf — CPF do candidato
- telefone — Celular com DDD
- email — E-mail pessoal
- cargo — Cargo pretendido
- data_admissao — Data prevista
Tools
- validar_cpf (PROVIDER)
- validar_telefone (PROVIDER)
- consulta_antecedentes (PROVIDER)
- enviar_boas_vindas (EMAIL)
- notificar_rh (TELEGRAM)
Skills & saída
validar-docs-admissao— Ordem: CPF → telefone → e-mailconsulta-antecedentes— Só após documentos válidos
{ aprovado, pendencias[], checklist_onboarding[], nivel_risco }
Pronto para operar automações com SafeHarn?
Acesse a plataforma, explore o catálogo de oportunidades e monte agentes auditáveis para o seu domínio.
Acessar a SafeHarnQuer adaptar o SafeHarn ao seu contexto?
A RTS-IT customiza o produto ou integra com Projetos & Consultoria.