---
title: Lampson como motor
description: Use os agentes do Lampson dentro dos seus apps — um bot no WhatsApp ou Telegram, seu backend, outra IA — por CLI, API HTTP, MCP ou SDK.
---
# 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](/pt/docs/headless) |
| **API HTTP** `/v1` | seu app ou seu backend, com uma API key; resposta em JSON, em streaming ou por callback | [API HTTP](/pt/docs/api) |
| **Canais** | Telegram, WhatsApp e Instagram (via Chatwoot), ou o que você adicionar como plugin | [Canais](/pt/docs/channels) |
| **MCP** | Claude, Cursor, ChatGPT ou outro Lampson usam os seus agentes como ferramenta | [Lampson como servidor MCP](/pt/docs/mcp-server) |
| **SDK** | JavaScript/TypeScript (`npm i lampson`) e Python (`pip install lampson`) | [SDK](/pt/docs/sdk) |

E quem atende todas essas portas são [agentes definidos em arquivos](/pt/docs/agents): 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](/pt/docs/channels) · [Receita: receber pedidos pelo chat](/pt/docs/orders)

**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](/pt/docs/api) · [SDK](/pt/docs/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](/pt/docs/mcp-server)

**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](/pt/docs/agents#ferramentas-e-permissoes). 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](/pt/docs/mcp-server#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](/pt/docs/objectives) · [Equipes](/pt/docs/teams)

## 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](/pt/docs/api#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](/pt/docs/agents#ferramentas-e-permissoes)
- **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](/pt/docs/agents)
2. Teste sem interface: `lampson run --agent tienda "oi"`. → [Sem interface](/pt/docs/headless)
3. Conecte: um canal (`lampson channel on telegram`), uma API key (`lampson key add --agent tienda`) ou o SDK.