Lampson como motor
Lampson como motor
O Lampson não é só um terminal e uma web para programar. Os agentes dele também podem ser usados a partir de outros aplicativos, como um motor: um bot que responde as mensagens do seu negócio, seu backend que pergunta algo a um agente, outra IA que usa os seus agentes como ferramenta.
Por baixo é o mesmo de sempre — o agente, suas ferramentas, suas permissões, as sessões e os traces —, com outras portas de entrada.
As portas§
| Porta | Para quê | Página |
|---|---|---|
lampson run | um script ou um cron: uma mensagem entra, a resposta sai (texto ou eventos JSON) | Sem interface |
API HTTP /v1 | seu app ou seu backend, com uma API key; resposta em JSON, em streaming ou por callback | API HTTP |
| Canais | Telegram, WhatsApp e Instagram (via Chatwoot), ou o que você adicionar como plugin | Canais |
| MCP | Claude, Cursor, ChatGPT ou outro Lampson usam os seus agentes como ferramenta | Lampson como servidor MCP |
| SDK | JavaScript/TypeScript (npm i lampson) e Python (pip install lampson) | SDK |
E quem atende todas essas portas são agentes definidos em arquivos: um .json com o prompt, as ferramentas exatas que ele pode usar, suas permissões e seu modelo.
Casos de uso§
1. Atender seus clientes por chat. Um agente com o seu catálogo e as suas regras responde no Telegram, ou no WhatsApp, Instagram e chat do site através do Chatwoot. Cada cliente tem a própria conversa; se alguém escreve três mensagens seguidas («oi» / «quanto custa o pão?» / «tem em estoque?»), recebe uma resposta que cobre tudo. E ele pode receber o pedido completo, com endereço, pagamento e número do pedido. → Canais · Receita: receber pedidos pelo chat
2. Colocar no seu app ou no seu backend. Um POST /v1/messages com uma API key, ou uma linha com o SDK. Seu app decide o que perguntar; o Lampson entra com o agente, as ferramentas dele e a memória da conversa. → API HTTP · SDK
3. Seus funcionários já usam uma IA. O agente do seu negócio se conecta como ferramenta MCP no Claude, no Cursor ou no ChatGPT; sua equipe pergunta de lá («quanto estoque sobrou e qual é a promoção desta semana?») sem abrir outro app, com as informações e as regras reais. → Lampson como servidor MCP
4. Dar dados sensíveis a uma IA sem entregar as chaves. No seu servidor, um agente do Lampson com um plugin só de leitura e caminhos limitados. Uma IA de fora pergunta «quantos pedidos teve ontem?» e recebe a resposta — nunca a senha do banco de dados.
5. Delegar o trabalho pesado a um modelo barato. Sua IA principal pede a um agente do Lampson, com DeepSeek ou Ollama local, que leia 40 arquivos e devolva um resumo. Quem paga é o modelo barato.
6. Agentes que falam com agentes, entre empresas. O agente de compras de um restaurante pergunta preço e estoque ao agente do fornecedor. Cada um com seu Lampson, sua API key e suas regras: um coloca a URL do outro no seu mcp.json e o agente dele ganha a ferramenta mcp_proveedor_ask. → Agente ↔ agente
7. Agentes que trabalham sozinhos, ou em equipe. Você dá um objetivo a um agente ("adicione tal funcionalidade com testes") e ele trabalha sozinho, em rodadas, pedindo sua aprovação antes do irreversível. Ou dá a uma equipe com papéis — CEO, CTO, Dev… —, cada um na sua branch do git, e nada chega à main sem você. → Objetivos · Equipes
O que o Lampson resolve para você§
- Uma conversa por cliente. Cada
thread(um número de telefone, um chat, um ticket) é a sua própria sessão, com seu histórico. - Uma caixa de entrada por conversa. Nunca rodam dois turnos ao mesmo tempo na mesma conversa; as mensagens que chegam em rajada se juntam em um turno, e o que chega enquanto o agente trabalha entra no turno em andamento. → A caixa de entrada
- Permissões sem um humano por perto. Um agente sem ninguém para aprovar roda em
strict(o perigoso é negado), a menos que você diga outra coisa; você pode autorizar ferramentas específicas uma a uma, ou mandar as aprovações para o seu celular. → Agentes - Traces. Cada turno fica no trace da sua sessão, venha de onde vier.
Começar§
1. Escreva um agente: .lampson/agents/tienda.agent.json no seu projeto. → Agentes 2. Teste sem interface: lampson run --agent tienda "oi". → Sem interface 3. Conecte: um canal (lampson channel on telegram), uma API key (lampson key add --agent tienda) ou o SDK.