Framework · Pydantic
Pydantic AI in breve
Un framework per agent Python del team Pydantic, basato sui type hint, su output strutturati convalidati e sulla dependency injection. Si distingue per l’esecuzione durevole su sette motori, da Temporal ad Airflow, e include Pydantic Evals.
Ideale per: Agenti Python type-safe con output da convalidare e la possibilità di scegliere il motore per l’esecuzione durevole.
Informazioni principali
- Responsabile
- Pydantic
- Linguaggi
- Python
- Licenza
- MIT
- Ultima versione
2.52.0· 30 settembre 2026- Repository
- pydantic/pydantic-ai
- Opzione hosted
- Nessuno
Guida rapida
Installa il pacchetto, configura le credenziali, quindi esegui l'agente più semplice indicato nella documentazione ufficiale. Gli ID dei modelli sono quelli usati nella documentazione e potrebbero non essere abilitati per il tuo account.
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.9Funzionalità
| Qualsiasi modello | Sì | Per cambiare modello basta modificare una stringa; include un modello per i test offline |
|---|---|---|
| Client MCP | Sì | Aggiunto come funzionalità MCP dell’agente |
| Server MCP | Non confermato | |
| Multi-agent | Sì | Funzionalità SubAgents e flusso di controllo tipizzato con Pydantic Graph |
| Esecuzioni durevoli | Sì | Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru o Airflow |
| Approvazione umana | Sì | Le approvazioni sono disponibili anche con l’esecuzione durevole |
| Tracing | Sì | Nativo per OpenTelemetry; basta una riga per inviare le trace a Logfire |
| Valutazioni | Sì | Pydantic Evals, un pacchetto separato dello stesso progetto |
Modifiche recenti
- È passata alla serie 2.x; la serie 1.x continua a ricevere aggiornamenti di manutenzione, come v1.107.7 del 30 settembre 2026.
- Il nuovo pacchetto pydantic-ai-harness aggiunge Coder, Researcher e SubAgents.
- Aggiunti voce in tempo reale, generazione di immagini ed embeddings.
- La documentazione è stata spostata su pydantic.dev/docs/ai/.