Um framework TypeScript modular para criar agentes de IA com suporte a múltiplos provedores, execução em sandbox isolado e integração com o Model Context Protocol (MCP).
import { createAgent } from '@sofik/ai-agents'; const agent = await createAgent({ name: 'meu-agente', provider: 'anthropic', model: 'claude-opus-4-6', tools: [bashTool, readFileTool, writeFileTool], memory: { backend: 'sqlite' }, }); const { response } = await agent.run( 'Analise o repositório e gere um relatório detalhado' );
Funcionalidades
O SOFIK oferece um kit completo para construir, implantar e escalar agentes de IA com confiabilidade de nível empresarial e flexibilidade focada no desenvolvedor.
Alterne entre Anthropic Claude, OpenAI, Google Gemini e GitHub Copilot. Failover automático com circuit breaker garante alta disponibilidade.
Execute código com segurança em containers Docker isolados. Arquitetura cliente-servidor impede escapes do ambiente e protege o host.
Mantenha o histórico de conversas entre sessões com backends SQLite ou JSON. Busca semântica via RAG para recuperação inteligente de contexto.
Orquestre interações complexas entre agentes com um motor baseado em grafos direcionados, com ramificações, loops e execução paralela.
Suporte nativo ao Model Context Protocol. Conecte agentes a qualquer servidor MCP e exponha contexto e ferramentas da sua infraestrutura existente.
OpenTelemetry integrado com rastreamento estruturado, estimativa de custos e métricas de performance prontas para monitoramento em produção.
Respostas ao vivo via Server-Sent Events (SSE). Acompanhe o agente pensando e respondendo sem esperar a conclusão completa.
Hooks de ciclo de vida em cada etapa para estender o comportamento do agente. Crie plugins reutilizáveis para logging, cache ou validação.
Agentes podem criar sub-agentes especializados para tarefas complexas. Delegação hierárquica resolve problemas de múltiplas etapas.
Arquitetura
O SOFIK implementa um loop agêntico limpo e extensível, onde os agentes recebem entradas, raciocinam sobre a melhor ação, chamam ferramentas e iteram até concluir a tarefa.
Hooks de Ciclo de Vida
onAgentStart
Antes do agente iniciar
onToolCall
Antes de executar ferramenta
onToolResult
Após retorno da ferramenta
onModelResponse
Após resposta da IA
onIteration
A cada ciclo do loop
onAgentEnd
Tarefa concluída
Pacotes
Instale apenas o que precisa. Cada pacote é independente e focado em uma única responsabilidade — composível do zero.
Orquestração principal, loop agêntico e delegação de sub-agentes
Camada de adaptador multi-provedor com failover e circuit breakers
Histórico persistente com backends SQLite/JSON e suporte a RAG
Ferramentas prontas: leitura/escrita de arquivos, bash, busca na web e mais
Motor de workflow baseado em grafos direcionados para orquestração
Integração com Model Context Protocol para conexão com servidores externos
Sistema de plugins com hooks de ciclo de vida para estender comportamentos
Configurações de agentes versionadas em JSON com suporte a testes A/B
OpenTelemetry com rastreamento de custos e tracing estruturado
Utilitários HTTP com lógica de retry e tratamento de requisições
Servidor de execução isolada baseado em Docker para código seguro
Logging estruturado com níveis configuráveis e formatos de saída
Início Rápido
Certifique-se de ter Node.js v22+, pnpm v10+ e Docker instalados.
# Node.js v22+ node --version # v22.0.0+ # pnpm v10+ npm install -g pnpm # Docker (para execução em sandbox) docker --version
Clone o repositório e instale todas as dependências.
git clone https://github.com/brunozilio/sofik-ai.git
cd sofik-ai
pnpm install
Copie o arquivo de exemplo e adicione suas credenciais.
cp .env.example .env # Edite o .env com suas chaves: ANTHROPIC_API_KEY=sua_chave_aqui OPENAI_API_KEY=sua_chave_aqui # opcional GOOGLE_API_KEY=sua_chave_aqui # opcional
Experimente um dos 26 exemplos progressivos para ver o SOFIK em ação.
# Rodar o exemplo hello world pnpm --filter examples run start:01 # Ou iniciar o servidor HTTP de produção pnpm --filter server run start
O SOFIK é gratuito, open source e feito para desenvolvedores. Dê uma estrela no repositório, explore os exemplos e comece a construir hoje.