---
title: "Pydantic AI: recursos, versão e início rápido · DotsAgent"
description: "Pydantic AI, de Pydantic: licença, versão mais recente, suporte a MCP, execuções duráveis, aprovação humana, tracing e avaliações, além de um início rápido para copiar."
url: https://dotsagent.io/pt/frameworks/pydantic-ai
---

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](https://github.com/pydantic/pydantic-ai) · 20.308 estrelas
- **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.

`Instalar`

```
pip install pydantic-ai
```

Requer OPENAI_API_KEY (or use Agent('test') offline)

`Python`

```
from 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.9
```

[Fonte do início rápido](https://ai.pydantic.dev/)

## Recursos

| Qualquer modelo | — | Para trocar de modelo, basta alterar uma string; inclui um modelo para testes offline |
| --- | --- | --- |
| Cliente MCP | — | Adicionado ao agente como um recurso MCP |
| Servidor MCP | — | — |
| Multiagente | — | Recurso SubAgents e fluxo de controle tipado com Pydantic Graph |
| Execuções duráveis | — | Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru ou Airflow |
| Aprovação humana | — | A aprovação também funciona com execução durável |
| Rastreamento | — | Nativo do OpenTelemetry; uma linha envia traces para o Logfire |
| Avaliações | — | 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/.

## Alternativas na mesma linguagem

- [OpenAI Agents SDK](https://dotsagent.io/pt/frameworks/openai-agents-python)

- [Claude Agent SDK](https://dotsagent.io/pt/frameworks/claude-agent-sdk)

- [Google ADK](https://dotsagent.io/pt/frameworks/google-adk)

- [Microsoft Agent Framework](https://dotsagent.io/pt/frameworks/microsoft-agent-framework)

- [LangGraph](https://dotsagent.io/pt/frameworks/langgraph)

- [CrewAI](https://dotsagent.io/pt/frameworks/crewai)

## Fontes

1. [ai.pydantic.dev](https://ai.pydantic.dev/)/
2. [github.com](https://github.com/pydantic/pydantic-ai)/pydantic/pydantic-ai
3. [pypi.org](https://pypi.org/pypi/pydantic-ai/json)/pypi/pydantic-ai/json
4. [api.github.com](https://api.github.com/repos/pydantic/pydantic-ai/releases)/repos/pydantic/pydantic-ai/releases

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026