← Voltar ao índice

BlackCat Validator Gateway

Gateway de IA com roteamento inteligente entre modelos (Anthropic Claude, Groq, Ollama), cache semântico com SQLite, auditoria de custos e healthcheck de serviços.

Porta: 8090 (interno: 127.0.0.1)
Stack: Python + FastAPI
Cache: SQLite
Acesso: Somente interno (VPS)
FastAPI Python Anthropic Claude Groq API Ollama SQLite (cache + audit) Pydantic

Especificação do Produto

Missão

Gateway de validação e qualidade para projetos BlackCat — roda suítes de testes, valida endpoints e garante integridade antes de deploys.

Usuários-alvo

Claudinho (agente IA), equipe de desenvolvimento

Status

✅ Produção — validator.blackcatcorp.com.br

Funcionalidades principais
Próximos passos

Roteamento de Modelos IA

Prioridade padrão:
1. Ollama (local) — llama4:maverick
2. Groq — llama-3.3-70b-versatile (fallback)
3. Anthropic — claude-haiku-4-5 (fallback)

Pode ser forçado por: { "model": "anthropic" | "groq" | "ollama" }

Endpoints

GET/
Info básica do gateway (nome, versão, modelos configurados).
GET/status
Status de todos os serviços BlackCat monitorados. Inclui URLs e status HTTP de: ShapeOS, Edilenelura, Consultor IA, RingCore, TruckRightWay, Kali, Omicron.
POST/ai/query Requer X-API-Key (opcional se VALIDATOR_API_KEY não definido)
Executa query de IA com cache semântico.
{
  "prompt": "string",
  "history": [],           // histórico de mensagens anteriores
  "model": null,           // null = auto-roteamento | "anthropic" | "groq" | "ollama"
  "app": "my-app",         // identificador para auditoria
  "skip_cache": false,     // true = ignora cache e regera
  "ttl": 3600              // TTL do cache em segundos
}
GET/audit/log
Log de auditoria das últimas queries. Query params: ?limit=50&app=my-app
GET/audit/costs
Relatório de custos estimados por modelo e por app. Útil para controle de gasto com LLMs.
DELETE/cache/flush
Limpa todo o cache semântico do SQLite.

Schema do Cache (SQLite)

cache:
  key (hash SHA256 do prompt+model+history)
  response TEXT
  model TEXT
  tokens_in INT
  tokens_out INT
  created_at INT (unix timestamp)
  ttl INT (segundos)

audit:
  id INT PRIMARY KEY
  ts INT
  app TEXT
  model TEXT
  prompt_hash TEXT
  tokens_in INT
  tokens_out INT
  latency_ms INT
  cached INT (0/1)
  cost_usd REAL

Serviços Monitorados

IDURL
shapeoshttps://shapeos.blackcatcorp.com.br
edilenelurahttps://admin.edilenelura.com.br
ia-documentalhttps://consultor.blackcatcorp.com.br
ringcorehttps://ringcore.blackcatcorp.com.br
truckrightwayhttps://truckrightway.blackcatcorp.com.br
kalihttps://kali.blackcatcorp.com.br
omicronhttps://omicron.blackcatcorp.com.br

Variáveis de Ambiente

VariávelPadrãoDescrição
VALIDATOR_API_KEY(vazio)API Key opcional para proteger /ai/query
ANTHROPIC_API_KEYClaude API Key
GROQ_API_KEYGroq API Key
OLLAMA_BASE_URLhttp://localhost:11434URL do Ollama local
OLLAMA_MODELllama4:maverickModelo Ollama padrão
GROQ_MODELllama-3.3-70b-versatileModelo Groq padrão
ANTHROPIC_MODELclaude-haiku-4-5-20251001Modelo Anthropic padrão
DB_PATH/data/validator.dbCaminho do SQLite
CACHE_TTL_SECONDS3600TTL padrão do cache

Gerado automaticamente — BlackCat Corp • Voltar ao índice