> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkestral.pro/llms.txt
> Use this file to discover all available pages before exploring further.
# A Cápsula (OEP)
> A tecnologia própria do Orkestral: o modelo premium compila a intenção numa unidade compacta e verificável que o modelo local executa com alta fidelidade.
A **Cápsula** é a camada entre o pensamento caro e a execução barata. É o que faz o
Orkestral ser diferente de um chat de IA ou de um editor: o modelo premium não executa
tudo, ele **compila** cada tarefa numa Cápsula, e o modelo local (o [Forge](/pt/forge))
executa essa Cápsula com fidelidade muito maior do que teria sozinho.
O protocolo interno que define esse formato se chama **OEP** (Orkestral Execution
Protocol).
## O problema que ela resolve
Um modelo local pequeno é rápido e gratuito, mas sozinho ele:
* não entende uma tarefa grande;
* precisa de contexto muito bem filtrado;
* precisa de instruções pequenas e claríssimas.
Um modelo premium entende tudo, mas é caro pra rodar a cada arquivo. A Cápsula junta o
melhor dos dois: o premium gasta tokens **uma vez** pra compilar; o local executa
**barato e quantas vezes precisar**.
## O que tem dentro de uma Cápsula
A Cápsula é compressão OPERACIONAL, não um resumo. Em vez de prosa repetida, ela carrega
estrutura que o executor consome sem re-inferir:
O objetivo em uma linha, mais os termos canônicos da tarefa.
O arquivo e a região (símbolo ou linhas) a tocar, não o arquivo inteiro.
O critério de pronto como predicados que a máquina confere (símbolo presente, imports intactos, sem encolhimento).
O que pode e o que não pode tocar (anti fora de escopo), aplicado de verdade.
As convenções do seu repositório, destiladas em regras curtas.
O que já deu errado neste repositório, pra o modelo não repetir.
## O ciclo: entende, compacta, executa, valida, aprende
```mermaid theme={null}
flowchart LR
A["Você descreve
o pedido"] --> B["Premium entende
o projeto"]
B --> C["Compacta numa
Cápsula"]
C --> D["Forge local
executa"]
D --> E["Valida o
contrato"]
E -->|passou| F["Pronto"]
E -->|falhou| G["Vira pitfall
e re-tenta"]
G --> D
G -.->|persiste| H["Escala pro
premium"]
```
O modelo premium lê o pedido e o projeto, com a ajuda da [base de conhecimento](/pt/knowledge-base).
Destila tudo numa Cápsula: alvo, contrato, padrões, pitfalls e um exemplar de edição já aceita.
O Forge aplica a mudança localmente, rápido e com custo de API zero.
O contrato é conferido de verdade. Pra frontend, o build roda. Veja [entrega provada](/pt/verified-delivery).
Cada falha vira um pitfall e cada acerto vira um exemplar. A próxima Cápsula já sai melhor no seu projeto.
## Como ela aprende com o seu projeto
A Cápsula é alimentada por duas memórias que crescem a cada execução:
* **RAG de acertos.** As edições que passaram viram exemplares; a próxima tarefa parecida recebe o exemplo certo.
* **RAG de erros (pitfalls).** Cada falha (âncora que não casou, import removido, build quebrado) vira uma regra curta de "quando, evite, porque". O mesmo erro converge em vez de ser re-descoberto.
Por design, o núcleo da Cápsula é **determinístico**: ele é montado dos sinais que o
pipeline já produz, então entrega valor antes mesmo de o premium refinar os campos de
texto livre. O premium eleva a qualidade, não cria a estrutura.
## Como você usa
Você não monta a Cápsula na mão. O fluxo é automático:
1. Você [conversa](/pt/chat) e descreve o que quer.
2. O orquestrador escreve um plano rico na [base de conhecimento](/pt/knowledge-base) e aponta a [issue](/pt/issues) pra ele.
3. Na execução, o sistema compila a Cápsula a partir do plano, do código e da memória de erros.
4. Você acompanha tudo nos [logs e na economia](/pt/observability): quanto o Forge resolveu local e quanto de premium foi evitado.
## Veja também
O modelo local que executa a Cápsula de graça.
As travas que confirmam que a Cápsula foi cumprida de verdade.