Plataforma de agentes
Governança operacional para agentes de IA
Controle operacional de projetos, agentes, prompts, bases, ferramentas, analytics e rastreabilidade de IA.
Por que esse sistema foi necessário
Operações com IA precisavam controlar projetos, agentes, prompts, bases e ferramentas sem espalhar configuração por código, planilhas ou ajustes manuais.
O que precisava mudar
Sem governança, fica difícil saber qual agente usa qual base, quais ferramentas estão habilitadas, como validar respostas e como acompanhar consumo, feedback e histórico.
Como a solução organiza a operação
A solução centraliza configuração, teste, publicação e análise de agentes em uma plataforma administrativa com rastreabilidade entre projetos, bases, ferramentas e conversas.
O que a operação passa a controlar
- Projetos, agentes, prompts e ferramentas deixam de ficar espalhados entre código e planilhas.
- Bases de conhecimento e integrações passam a ter vínculos rastreáveis.
- Conversas de teste, feedback e analytics ajudam a acompanhar agentes antes e depois do uso operacional.
Área técnica
Como a solução foi organizada
A próxima seção detalha como a solução foi organizada tecnicamente: componentes, integrações, filas, armazenamento e pontos de controle.
Arquitetura de governança de agentes
01
Painel React
Projetos, agentes, chat, analytics e mapa
gestão
02
FastAPI
Contratos, autenticação e serviços de domínio
controle
03
MongoDB
Agentes, conversas, métricas e versões
ingestão
04
Postgres + pgvector
RAG e bases de conhecimento
05
RabbitMQ, Redis e Celery
Ingestão e tarefas assíncronas
execução
06
Ferramentas
Zabbix, Znuny, SMTP, PDF e dados tabulares
Decisões técnicas
- Separar configuração por projeto e por agente preserva contexto global e regras específicas.
- Combinar MongoDB para entidades operacionais e pgvector para conhecimento separa controle transacional de busca semântica.
- Executar ingestão e tarefas longas com filas e workers evita bloquear o painel administrativo.
Operação e continuidade
- Workers e filas processam ingestão e tarefas assíncronas sem bloquear a operação.
- Métricas de uso, consumo e feedback ajudam a acompanhar agentes em produção.
- Retenção configurável remove conversas antigas conforme necessidade operacional.
- Chat de teste e rastreabilidade ajudam a validar agentes antes do uso operacional.
Arquitetura
- React, Vite e TypeScript entregam o painel administrativo, analytics, chat e mapa do sistema.
- FastAPI organiza contratos REST, autenticação, serviços de agentes, projetos, ferramentas e conhecimento.
- MongoDB guarda entidades operacionais, conversas, métricas, feedback e versões publicadas.
- Postgres com pgvector sustenta busca vetorial e RAG sobre bases de conhecimento.
- Redis, RabbitMQ e Celery coordenam estado, filas e workers de ingestão.
- S3 armazena arquivos e anexos usados por bases e integrações.
- OpenAI e LangChain executam agentes com ferramentas como Zabbix, Znuny, SMTP, PDF e dados tabulares.
Tecnologias
- FastAPI
- React
- MongoDB
- Postgres
- pgvector
- Redis
- RabbitMQ
- Celery
- S3
- OpenAI
- LangChain
- Docker
- Traefik
Capacidades relacionadas
Atendimento e omnichannel
Organize canais, histórico, roteamento e automações para que a operação mantenha contexto de ponta a ponta.
- - Canais sem histórico único
- - Roteamento manual
- - Automações isoladas
Integrações e APIs
Conecte sistemas com contratos claros, webhooks, filas, sincronização e pontos de retomada.
- - Dados duplicados
- - Importação manual
- - Webhooks sem rastreabilidade
IA aplicada
Use copilotos, agentes e classificação onde a IA ganha contexto, permissão e rastreabilidade.
- - Triagem manual
- - Respostas sem contexto
- - Experimentos de IA sem fronteira
Automação
Transforme rotinas sensíveis e repetitivas em fluxos observáveis, recuperáveis e integrados.
- - Conferência manual
- - Filas invisíveis
- - Retomada dependente de pessoas