Apresentação do produto INTELECTO — framework/plataforma para criar…
INEMA
inematds.github.io/intelecto ↗
- URLs, bancos, endpoints
-
flags (modo debug, ambiente, etc.)
-
Subir com Docker Ex.:
docker compose up -d -
Verificar logs Se conectou no canal? Se carregou configs? Se conseguiu falar com o modelo?
-
Teste ponta a ponta Mandar mensagem no canal e validar:
-
resposta correta
- comportamento esperado
- memória (se aplicável)
- ferramentas funcionando
Em resumo: aqui você sai do “projeto pronto” para “assistente no ar”.
Aqui vai cada um dos 5 passos explicado em detalhes, do jeito que normalmente acontece na prática ao criar um assistente com o INTELECTO.
1) Passou o documento de referência (my-framework-ingredients.md)⌗
Esse arquivo é a especificação do seu assistente. Ele responde: “o que o assistente deve ser e fazer?”
O que normalmente entra nele:
-
Objetivo do assistente Ex.: atendimento ao público, suporte interno, triagem de mensagens, automações, relatórios, etc.
-
Canal de atendimento Ex.: Telegram, WhatsApp, Web, e-mail, etc.
-
Personalidade e regras Tom de voz (formal / amigável), limites (o que não pode), como responder, como pedir confirmação, etc.
-
Memória / conhecimento Se deve lembrar do usuário, por quanto tempo, se busca em documentos, como registra informações importantes.
-
Ferramentas e integrações Ex.: ler planilhas, consultar API, buscar dados, criar tarefas, enviar mensagens, etc.
-
Infra / execução Ex.: usar Docker, banco, filas, logs, onde hospedar, variáveis de ambiente necessárias.
Em resumo: esse documento vira a “receita”. Se ele estiver claro, o resto flui muito mais rápido.
2) Pediu para gerar um plano⌗
Aqui você manda o Claude (com base no documento) não construir ainda, mas primeiro planejar.
O plano costuma trazer:
-
Arquitetura do projeto pastas, módulos, onde fica canal, memória, agentes, configs
-
Workstreams (frentes de trabalho) Ex.:
- Infra / Docker / env
- Canal (Telegram/WhatsApp)
- Agentes (orquestração e fluxos)
- Memória
- Integrações / ferramentas
- Testes e observabilidade
-
Dependências e ordem correta Ex.: não dá pra testar o canal sem configurar
.env; não dá pra usar memória sem storage definido. -
Checklist de entregáveis “quando terminar, o assistente deve fazer X, Y, Z”.
Em resumo: o plano evita bagunça e refação, porque organiza o que fazer, em que ordem, e por quê.
3) O Claude fez perguntas durante o planejamento⌗
Essas perguntas aparecem porque o documento raramente define 100% das decisões.
Exemplos comuns do que ele pergunta:
-
Como vai rodar? Docker Compose ou direto no sistema? Vai hospedar onde?
-
Qual modelo/provedor de IA? OpenAI, Anthropic, local, fallback, limites de custo.
-
Como será a memória? Só memória de conversa? Memória longa? Vetores (RAG)? Banco? Quais dados podem ser guardados?
-
Que tipo de ferramentas o agente pode usar? Pode executar comandos? Pode acessar internet? Pode escrever arquivos? Pode chamar APIs?
-
Segurança e governança Dados sensíveis, logs, permissões, isolamento, “o que o bot nunca faz”.
-
Comportamento em caso de erro Repetir, pedir confirmação, encaminhar para humano, registrar incidente.
O valor aqui é que essas respostas personalizam o INTELECTO para o seu cenário e evitam decisões “chutadas”.
4) Executou o plano⌗
Depois do plano e das respostas, começa a construção de verdade.
Normalmente o Claude gera:
-
Estrutura do projeto pastas, módulos e arquivos base
-
Configuração principal do INTELECTO regras do assistente, prompt do sistema, agentes e fluxos
-
Canal de comunicação Ex.: Telegram: conexão, handlers de mensagem, comandos, roteamento para o agente
-
Memória / persistência Ex.: histórico de conversa, perfil do usuário, logs; dependendo do projeto, RAG e base vetorial
-
Ferramentas / integrações Ex.: consultar um endpoint, criar tarefas, buscar informações, registrar atendimento, etc.
-
Observabilidade mínima logs, mensagens de erro compreensíveis, modos de debug
-
Testes rápidos fluxo básico: “recebe → entende → responde → registra”.
Importante: “executar o plano” não é só gerar arquivos — é garantir que o conjunto roda e faz o mínimo prometido.
5) Você copiou o .env e subiu o Docker⌗
Essa é a hora de “dar vida” ao projeto.
O que acontece:
-
Configurar o
.envVocê coloca: -
chaves de API (modelo de IA)
- tokens do canal (Telegram/WhatsApp)
Aqui está o resumo do processo em 5 passos para criar seu assistente com o INTELECTO:
🚀 CRIAR ASSISTENTE EM 5 PASSOS⌗
1️⃣ Documento de referência⌗
Você cria e entrega o arquivo my-framework-ingredients.md, definindo tudo o que o assistente deve ter (canais, memória, IA, segurança, etc.).
2️⃣ Solicitação do plano⌗
Você pede para o Claude gerar um plano estruturado de construção, organizando etapas, dependências e arquitetura.
3️⃣ Perguntas de alinhamento⌗
Durante o planejamento, o Claude faz perguntas estratégicas (ex.: Docker ou instalação direta? qual modelo usar?) para ajustar o projeto.
4️⃣ Execução do plano⌗
Após aprovação, o Claude gera todos os arquivos automaticamente, implementando a estrutura completa do assistente.
5️⃣ Configuração e subida⌗
Você copia o arquivo .env, insere suas chaves e executa o projeto (ex.: docker compose up).
✅ O assistente entra no ar.
CRIE ASSISTENTE EM 5 PASSOS
5 passos numerados com linha conectando cada um:
a. Passou o documento de referência (my-framework-ingredients.md)
b. Pediu para gerar um plano
c. O Claude fez perguntas durante o planejamento
d. Executou o plano
e. Você copiou o .env e subiu o Docker
📌 Visão Geral⌗
Uma página apresenta uma comparação entre 9 frameworks de agentes de IA, analisando centenas de funcionalidades para ajudar você a escolher o melhor “ingrediente” para construir seu assistente com INTELECTO.⌗
🧠 O Que Está Comparando⌗
🧩 9 Frameworks Principais⌗
Os frameworks são apresentados como opções em uma “mercearia” de tecnologia para agentes de IA. Cada um tem foco diferente:
- OpenClaw – Plataforma integrada com muitos recursos e canais.
- ZeroClaw – Alta eficiência e performance em Rust.
- NanoClaw – Simplicidade e isolamento por grupo de conversa.
- NanoBot – Framework Python leve com muitos provedores e canais.
- PicoClaw – Executa IA em dispositivos de borda muito leves.
- IronClaw – Foco em segurança forte com sandboxing.
- TinyClaw – Organização de agentes em equipes colaborativas.
- Agent Zero – Framework com aprendizado contínuo e memória avançada.
- Awesome OpenClaw – Biblioteca de referência com muitos plugins e guias.
Essa comparação ajuda a decidir qual base usar para construir um assistente com o INTELECTO ideal para seu projeto.
🔑 Conceitos-Chave na Comparação⌗
A comparação usa várias categorias de funcionalidades:
🧬 Identidade e Personalidade⌗
Como sua IA se “apresenta” — com personalidade, valores e estilo de resposta.
🔐 Segurança e Proteção⌗
Nível de isolamento, defesa contra injeção de prompt e proteção de dados.
💬 Canais de Comunicação⌗
Integração com WhatsApp, Telegram, Discord, Slack, e-mail, voz e navegador web.
🧠 Memória e Conhecimento⌗
Como o assistente armazena e recupera informações de sessões e documentos.
🤖 Automação e Agendamento⌗
Capacidade do assistente de executar tarefas programadas e respostas automáticas.
🔗 Integrações⌗
Conexões com serviços externos e protocolos (como MCP), plugin SDKs e fallback de modelos de IA.
📊 Ideia de Uso⌗
A tabela comparativa permite que você:
- Escolha quais funcionalidades importam (ex.: segurança, canais, memória)
- Monte um “carrinho de ingredientes” para seu projeto INTELECTO personalizado
- Entenda trade-offs entre frameworks (ex.: simplicidade vs. segurança vs. escalabilidade)
🧠 Conclusão⌗
Essa comparação é um guia visual e prático para ajudar você a decidir qual base tecnológica usar ao construir um assistente inteligente com INTELECTO, com foco em características como identidade, canais, memória, automação e integrações robustas.
📌 Visão Geral⌗
O guia explica como construir um assistente funcional (ex.: bot para Telegram) usando o INTELECTO, sem precisar programar, utilizando o Claude Code como ferramenta para gerar automaticamente o código do projeto.
A ideia central é: você define o que quer que o assistente faça → o Claude Code planeja → constrói tudo para você → você só configura as chaves e executa.
🛠️ Caminho do Zero ao Assistente Pronto⌗
🧱 Etapas Utilizadas no Processo⌗
1️⃣ Documento de referência⌗
Você escolhe as funcionalidades desejadas (canal, memória, modelo de IA, Docker, personalidade etc.) e gera um arquivo de especificação (ex.: my-framework-ingredients.md) descrevendo o assistente.
2️⃣ Planejamento da construção⌗
O Claude Code lê o documento e cria um plano estruturado com:
- Workstreams
- Dependências
- Ordem de implementação
- Estrutura de pastas e arquivos
Ele pode fazer perguntas para decisões importantes (ex.: Docker ou instalação direta? qual modelo de IA?).
3️⃣ Execução automatizada⌗
Após o plano aprovado, o Claude Code:
- Cria todos os arquivos do projeto
- Configura memória
- Implementa o canal (ex.: Telegram)
- Monta a estrutura de agentes
- Gera arquivos de configuração (.env, Docker, etc.)
Tudo na ordem correta.
4️⃣ Inicialização⌗
Você:
- Adiciona suas chaves de API no
.env - Executa o projeto (ex.:
docker compose up) - O assistente começa a funcionar no canal escolhido.
📋 Processo Resumido⌗
- Escolher funcionalidades do INTELECTO
- Gerar o arquivo de especificação
- Pedir ao Claude Code para construir tudo
- Responder perguntas de configuração
- Executar o projeto
- Testar e ajustar em português
🎯 Principais Benefícios⌗
- ✅ Não exige programação manual
- ✅ Processo guiado e estruturado
- ✅ Pode ser ajustado em linguagem natural
- ✅ Repetível e escalável
INTELECTO - Seu ASSISTENTE IA
1