O que é Pydantic AI?
O Pydantic AI é um framework de agentes da equipe por trás do Pydantic, a biblioteca de validação de dados da qual dependem a maioria dos SDKs de IA em Python. Ele usa type hints do Python para que as entradas das ferramentas e as saídas dos agentes sejam validadas, e os editores podem detectar erros antes de você rodar o código.
A versão 2 ficou estável em 23 de junho de 2026. Ela é construída em torno de capacidades: pacotes combináveis de ferramentas, hooks, instruções e configurações de modelo. Um pacote separado, o Pydantic AI Harness, acrescenta memória, guardrails, subagentes, planejamento, gerenciamento de contexto e um agente de programação completo, e a execução durável, para que os agentes sobrevivam a reinicializações, roda em oito engines, incluindo Temporal, DBOS e Prefect.
Ele é agnóstico em relação ao modelo e emite traces OpenTelemetry comuns, que funcionam com qualquer backend ou com o Pydantic Logfire, o produto pago de observabilidade da empresa.
Quanto custa Pydantic AI?
| Plano | Preço | O que inclui |
|---|---|---|
| Library | Free | MIT |
| Logfire Personal | Free | Até 10M registros/mês |
| Logfire Team | $49/month | Mais $2 por milhão de registros extra |
Gratuito e de código aberto sob a licença MIT. Observabilidade com Logfire: Personal gratuito até 10M registros/mês, Team $49/mês mais $2 por milhão de registros extra. O Pydantic AI Gateway acrescenta uma margem de 5% sobre os provedores embutidos.
Pydantic AI vale a pena?
O Pydantic AI é o framework de agentes para código que precisa ser mantido, não só demonstrado. Tem cerca de 20,800 estrelas no GitHub, licença MIT e lançou a v2.60.0 em 23 de outubro de 2026. Argumentos de ferramentas e saídas estruturadas são validados contra modelos Pydantic, então uma resposta malformada do modelo falha de forma ruidosa em vez de escorrer para o seu banco de dados, e a injeção de dependências permite que os testes troquem os modelos por modelos de teste.
O ritmo de versões é extraordinário: 25 versões menores da V2 entre a v2.36.0, em 29 de agosto, e a v2.60.0, em 23 de outubro, enquanto a V1 ainda recebe patches (v1.107.9 em 21 de outubro). Fixar versões não é opcional. O histórico de segurança mostra por quê: 19 avisos publicados, 13 deles desde agosto de 2026, a maioria na ferramenta web-fetch (contornos da blocklist de SSRF, travamentos do event loop com HTML hostil) e nos adaptadores de UI, onde um deles deixava executar uma chamada de ferramenta enviada pelo cliente.
A V2 mudou o formato do framework. As capacidades agrupam ferramentas, instruções, hooks e configurações em unidades que você lista em um agente, e o pacote Harness agora fornece memória, subagentes, planejamento, guardrails e um agente de programação pronto, o que reduz a distância em relação ao CrewAI e ao Agno em padrões prontos. A execução durável é incomumente ampla, com oito engines, do Temporal, DBOS e Prefect ao AWS Lambda e Airflow, cinco delas mantidas em conjunto com os fornecedores das engines. Tutoriais escritos para a V1 muitas vezes não batem mais.
A atração comercial puxa para os produtos do próprio Pydantic, embora nada obrigue a isso. A instrumentação é OpenTelemetry comum, então qualquer backend de rastreamento funciona; o Logfire é gratuito até 10 milhões de registros por mês para uma pessoa e custa $49 por mês para equipes, com $2 por milhão extra. O Pydantic AI Gateway oferece uma única chave para muitos provedores, com margem de 5% sobre os provedores embutidos e nenhuma sobre as suas próprias chaves, o que compra orçamentos e failover ao preço de mais um salto entre o agente e o modelo.
Onde ele se destaca
Uma equipe de backend em Python em uma empresa de logística
Extrair dados tipados de remessas de e-mails e PDFs para o banco de dados
Definir a saída como um modelo Pydantic e deixar o agente tentar de novo quando a validação falhar, para que linhas ruins nunca cheguem ao banco. Sem custo de framework; a conta são os tokens de modelo, e as novas tentativas de validação somam a ela.
Um engenheiro de plataforma cuja empresa já roda Temporal
Rodar jobs longos de agentes que sobrevivam a deploys e falhas
Adicionar a capacidade TemporalDurability para que cada chamada de modelo e de ferramenta vire uma activity do Temporal. Nenhuma infraestrutura nova além do cluster existente; o risco é acompanhar uma integração que muda rápido, em versões que saem várias vezes por semana.
Uma gerente de engenharia em uma startup de IA de 15 pessoas
Ter traces e visibilidade de custos dos agentes em produção
Enviar os traces OpenTelemetry embutidos para o Logfire Team, a $49 por mês por 10 milhões de registros e cinco assentos, depois $2 por milhão extra, ou para um backend existente sem custo de licença adicional.
Antes de decidir
- Configuração
- uv add pydantic-ai (ou pip) em Python 3.11 ou posterior; um agente tipado com uma ferramenta são poucas linhas. Extras como pydantic-ai[temporal] e pydantic-ai-harness são instalações separadas.
- Integrações
- OpenAI, Anthropic, Google, Bedrock, Azure AI Foundry, Groq, Mistral, xAI, Ollama e dezenas de outros; MCP; streams AG-UI e Vercel AI UI; voz em tempo real; Temporal, DBOS, Prefect, Restate, AWS Lambda e Airflow para durabilidade.
- Dados e privacidade
- Uma biblioteca: os dados vão para os provedores de modelo e os exportadores de traces que você configurar. Licença MIT. Um aviso de setembro constatou que include_content=False não ocultava exceções nem instruções nos traces, então confira o que o seu exportador recebe.
- Custo em escala
- O framework é gratuito. O Logfire Personal é gratuito até 10 milhões de registros por mês; o Team custa $49 por mês com 10 milhões de registros e $2 por milhão extra. O AI Gateway cobra margem de 5% sobre os provedores embutidos e nenhuma sobre as suas próprias chaves.
- Limites
- Ritmo de versões muito rápido, com V1 e V2 mantidas em paralelo; cerca de 1,500 issues e pull requests abertos; sem construtor visual.
O que é bom
- Entradas de ferramentas e saídas estruturadas validadas
- Agnóstico em relação ao modelo, com dezenas de provedores
- Execução durável em oito engines
- Agentes fáceis de testar com testes unitários
O que não é
- Várias versões por semana; fixar versões é essencial
- 19 avisos de segurança, a maioria em web-fetch e adaptadores de UI
- A V2 moveu extras para um pacote Harness separado
- Exige Python 3.11 ou mais recente
Ideal para
Engenheiros Python que constroem agentes de produção e querem tipagem forte, testabilidade e liberdade para trocar de modelo.
Alternativas ao Pydantic AI
Pydantic AI: perguntas frequentes
- Pydantic AI vale a pena?
- O Pydantic AI leva a disciplina do Python tipado aos agentes, ao custo de um ritmo de versões que você precisa fixar. Damos nota 4.5 de 5.
- Quanto custa Pydantic AI?
- Gratuito e de código aberto sob a licença MIT. Observabilidade com Logfire: Personal gratuito até 10M registros/mês, Team $49/mês mais $2 por milhão de registros extra. O Pydantic AI Gateway acrescenta uma margem de 5% sobre os provedores embutidos.
- Quais são as desvantagens de Pydantic AI?
- Várias versões por semana; fixar versões é essencial; 19 avisos de segurança, a maioria em web-fetch e adaptadores de UI; a V2 moveu extras para um pacote Harness separado; exige Python 3.11 ou mais recente.
- Para quem Pydantic AI é indicado?
- Engenheiros Python que constroem agentes de produção e querem tipagem forte, testabilidade e liberdade para trocar de modelo.
- Quanto custa Pydantic AI para uma equipe ou em produção?
- O framework é gratuito. O Logfire Personal é gratuito até 10 milhões de registros por mês; o Team custa $49 por mês com 10 milhões de registros e $2 por milhão extra. O AI Gateway cobra margem de 5% sobre os provedores embutidos e nenhuma sobre as suas próprias chaves.
- Pydantic AI é seguro para dados da empresa?
- Uma biblioteca: os dados vão para os provedores de modelo e os exportadores de traces que você configurar. Licença MIT. Um aviso de setembro constatou que include_content=False não ocultava exceções nem instruções nos traces, então confira o que o seu exportador recebe.
- Quais são as melhores alternativas ao Pydantic AI?
- As alternativas mais próximas que analisamos são OpenAI Agents SDK, LangGraph, Agno e smolagents.
Respostas verificadas em 23 de out. de 2026.