O Pydantic AI é um framework Python para construir agentes, criado pelo time que mantém a biblioteca Pydantic. A proposta é trazer para o código de agentes a mesma disciplina de tipos e validação usada em APIs Python.
Para que serve
- Construir agentes com saídas estruturadas e validadas por schema
- Expor funções Python como ferramentas do agente, com tipagem verificada
- Trocar de modelo sem reescrever o agente, incluindo provedores compatíveis com OpenAI
- Testar e avaliar agentes com casos determinísticos e modelos de teste
Como funciona
- O agente é declarado com modelo, instruções e ferramentas tipadas
- As respostas podem ser forçadas a um modelo Pydantic, eliminando parsing frágil
- Injeção de dependências entrega contexto, conexões e configuração às ferramentas
- Há suporte a MCP, grafos de agentes e execução em fluxos com estado
- A observabilidade usa OpenTelemetry e integra-se ao Pydantic Logfire
Disponibilidade
- Biblioteca open source sob licença MIT, instalada via
pip install pydantic-ai - Documentação oficial com guias, exemplos e referência de API
Pontos de atenção
- É um framework de código: exige Python e conhecimento de programação
- A versão 2.x tem ritmo de release acelerado; revise o changelog ao atualizar
- A escolha do modelo muda custo e qualidade; teste com dados reais