Escolher um framework de agentes: o que conta mesmo
Qualquer artigo que ordene frameworks de agentes por nome está desatualizado antes de ser indexado. Estas bibliotecas reescrevem as suas abstrações centrais a cada poucas versões, e o que hoje ganha uma comparação pode ter mudado quando o vosso projeto for para o ar.
Por isso este guia faz algo mais duradouro: lista as oito perguntas que determinam se daqui a seis meses ainda estarão contentes com a escolha, e explica o que custa cada resposta.
As oito perguntas, por ordem de importância#
- Consigo ler o ciclo? Sem o ficheiro onde a saída do modelo vira chamada de ferramenta, não se depura uma má execução.
- O que acontece numa falha de ferramenta — chega-me, ou é repetida invisivelmente com outro prompt?
- O meu prompt é o prompt do framework? Texto de sistema que não escreveram surpreende numa auditoria.
- O estado pode ser persistido e retomado, ou uma falha perde a execução?
- Como se definem as ferramentas e posso reutilizar essas definições fora?
- Como é a história das atualizações — houve renomeações centrais nas duas últimas versões?
- Posso trocar de modelo sem trocar de framework?
- Quanto acrescenta ao arranque a frio e a cada turno?
Três categorias, três acordos diferentes#
| Categoria | O que ganham | O que cedem | Faz sentido quando |
|---|---|---|---|
| SDK do fornecedor e ciclo próprio | Visibilidade total, poucas dependências | Repetições, estado e persistência escrevem vocês | Um agente, poucas ferramentas, muita depuração |
| Biblioteca de orquestração | Estado durável, ramos, repetições, retoma | Alguma visibilidade; agitação nas versões | Fluxos longos ou multipasso |
| Plataforma gerida | Alojamento, rastos, avaliação, interface | Portabilidade; preço por lugar ou execução | Equipa pequena, tarefa padrão, prova rápida |
Escrevam vocês o que deve continuar vosso#
Escolham o que escolherem, quatro ativos devem viver no vosso repositório numa forma que nenhum framework possui: os prompts, as definições de ferramentas com os esquemas JSON, o conjunto de avaliação e o formato dos rastos.
O teste que ninguém faz#
Antes de decidir, construam duas vezes o mesmo pequeno agente: uma com o favorito e outra com o SDK do fornecedor e um ciclo escrito à mão. Não estão a medir precisão — será parecida. Estão a medir quanto tempo levou, quão legível é o rasto e quão fácil foi descobrir porque falhou o caso sete.
Guardem a versão feita à mão: será a referência quando precisarem de provar se uma estranheza vem do prompt ou do framework.
Perguntas frequentes
É preciso framework para um primeiro agente?
Não. Um primeiro agente com três ferramentas é um ciclo, uma lista de esquemas e uma condição de paragem.
Uma plataforma gerida é uma armadilha?
Não, se mantiverem prompts, esquemas e avaliação portáteis.
Quanto é que o framework afeta a precisão?
Muito menos do que se pensa. A precisão vem do desenho das ferramentas, da ancoragem e da avaliação.
framework de agentes iamelhores frameworks de agentescomparação de bibliotecasorquestração llmescolher a stack
