Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Everything is a Plugin

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Everything is a Plugin é o princípio de arquitetura do DeepSeek Harness em que toda peça do agente pode ser trocada, adicionada ou removida como plugin, sem alterar o núcleo.

O princípio acompanha o código-fonte do DeepSeek Harness e leva a ideia de harness ao limite. Se um agente é o modelo mais o conjunto de ferramentas, memória, sessão e orquestração ao redor dele, nenhuma dessas partes precisa ser fixa. O núcleo não sabe nada de ferramenta ou provedor específico: só coordena o que foi plugado. O restante entra e sai pela configuração, sem tocar no core.

A consequência prática é tirar o peso da pergunta sobre qual é o melhor modelo. Um modelo mais fraco continua limitando o resultado, mas deixa de ser a única variável.

Os quatro blocos plugáveis

A arquitetura agrupa as peças em quatro blocos:

  • Inteligência: o modelo de linguagem e seu provedor.
  • Ação: as ferramentas que o agente chama.
  • Estado: sessão e storage.
  • Orquestração: o próprio laço do agente, que pode ser redefinido e encadeado.

A analogia é a de um jogo de corrida em que se troca qualquer peça do carro: troca o motor, troca a roda, o chassi continua o mesmo. Mudar o modelo não altera a sessão, as skills nem o contexto, a menos que isso também seja mudado de propósito. E a troca acontece com o sistema em execução: um plugin novo entra na mesma janela de sessão, sem reiniciar o contêiner.

Troca de modelo no meio do trabalho

Como o modelo é só mais um plugin, dá para trocar de provedor no meio de uma tarefa, até no meio do laço do agente, sem esperar a execução terminar e sem perder o contexto construído. O caso típico é o dos créditos de um provedor acabarem durante uma implementação: a tarefa segue com o modelo de outro fornecedor.

Esse é o ponto que separa o princípio de um roteador de modelos como o OpenRouter, que troca o motor mas não preserva o estado de uma execução em andamento da mesma forma. Também difere do fallback de modelos, em que a troca reage automaticamente a uma falha. A composição promete ainda um modelo diferente por agente dentro de um laço com vários agentes, estendendo a Seleção de Modelo por Agente ao nível do harness, mas esse cenário é uma promessa da ferramenta ainda sem confirmação prática.

Plugin temporário e plugin permanente

Um plugin pode existir em dois modos. O temporário vale até o harness ou a máquina reiniciar e então desaparece; para recuperá-lo é preciso pedir que seja reimplementado a partir da conversa anterior, gastando tokens de novo, ou guardá-lo antes numa pasta. O permanente fica instalado entre reinicializações.

Teste como temporário antes de tornar permanente

Criar um plugin direto como permanente pode quebrar partes centrais do sistema. Num caso real, o plugin quebrou o próprio chat do harness, e sem chat não havia como pedir que a mudança fosse desfeita: a saída foi desinstalar e reinstalar o projeto.

Criar ou alterar plugins exige o modo de criação. No modo padrão, mesmo com o pedido explícito no prompt, o agente não modifica a si mesmo.

Como plugins são escritos e o risco dos de terceiros

Plugins são escritos em TypeScript, com documentação pública, e um plugin aberto parecido com o desejado pode ser adaptado em vez de reescrito. O próprio harness gera plugins que alteram inclusive a sua interface, e uma ferramenta externa como o Claude Code também consegue, bastando receber o caminho da implementação de referência. Um plugin de microfone gerado pelo harness criou o botão mas não transcrevia a fala; corrigido pelo Claude Code sobre o mesmo código, funcionou. Outro exemplo é um painel de consumo por workspace, com total de tokens, número de requisições e modelos usados, uma forma simples de observabilidade de custo.

A liberdade tem contrapartida em segurança. Na fase de preview não há curadoria dos plugins publicados por terceiros, nem verificação de código malicioso ou de tentativa de roubo de dados. Enquanto isso durar, é mais seguro criar os próprios plugins.