Framework · Pydantic
Pydantic AI em resumo
Um framework de agentes para Python da equipe Pydantic, desenvolvido com foco em type hints, saídas estruturadas validadas e injeção de dependências. Destaca-se pela execução durável em sete mecanismos, do Temporal ao Airflow, e inclui o Pydantic Evals.
Ideal para: Agentes Python com segurança de tipos cujas saídas precisam ser validadas, com a opção de escolher o mecanismo de execução durável.
Principais informações
- Responsável pela manutenção
- Pydantic
- Linguagens
- Python
- Licença
- MIT
- Versão mais recente
2.52.0· 30 de setembro de 2026- Repositório
- pydantic/pydantic-ai
- Opção hospedada
- Nenhum
Início rápido
Instale o pacote, configure as credenciais e execute o agente mais simples da documentação oficial. Os IDs dos modelos são os usados na documentação e talvez não estejam habilitados na sua conta.
pip install pydantic-aifrom typing import Literal
from pydantic import BaseModel, Field
from pydantic_ai import Agent, RunContext
class Sentiment(BaseModel):
label: Literal['positive', 'negative', 'neutral']
score: float = Field(ge=-1, le=1)
agent = Agent('openai:gpt-6-sol', output_type=Sentiment)
@agent.tool
def recent_reviews(ctx: RunContext, product: str) -> list[str]:
"""Fetch recent review snippets for a product."""
return ['The new release fixed everything I complained about!']
result = agent.run_sync('How are people feeling about the Extract app?')
print(result.output)
#> label='positive' score=0.9Recursos
| Qualquer modelo | Sim | Para trocar de modelo, basta alterar uma string; inclui um modelo para testes offline |
|---|---|---|
| Cliente MCP | Sim | Adicionado ao agente como um recurso MCP |
| Servidor MCP | Não confirmado | |
| Multiagente | Sim | Recurso SubAgents e fluxo de controle tipado com Pydantic Graph |
| Execuções duráveis | Sim | Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru ou Airflow |
| Aprovação humana | Sim | A aprovação também funciona com execução durável |
| Rastreamento | Sim | Nativo do OpenTelemetry; uma linha envia traces para o Logfire |
| Avaliações | Sim | Pydantic Evals, um pacote separado do mesmo projeto |
Mudanças recentes
- Passou para a linha 2.x; a linha 1.x continua recebendo atualizações de manutenção, como a v1.107.7 em 30 September 2026.
- O novo pacote pydantic-ai-harness adiciona Coder, Researcher e SubAgents.
- Adicionou voz em tempo real, geração de imagens e embeddings.
- A documentação foi transferida para pydantic.dev/docs/ai/.