Framework · Pydantic
Pangkalahatang-ideya ng Pydantic AI
Isang Python agent framework mula sa team ng Pydantic, na nakabatay sa type hints, mga validated na structured output at dependency injection. Namumukod-tangi ito sa durable execution gamit ang pitong engine, mula Temporal hanggang Airflow, at kasama rin ang Pydantic Evals.
Pinakamainam para sa: Mga type-safe na Python agent na kailangang pumasa sa validation ang mga output, na may mapagpipiliang durable engine.
Mahahalagang detalye
- Tagapangasiwa
- Pydantic
- Mga wika
- Python
- Lisensya
- MIT
- Pinakabagong bersyon
2.52.0· Setyembre 30, 2026- Repository
- pydantic/pydantic-ai
- Hosted na opsyon
- Wala
Quickstart
I-install ang package, itakda ang mga credential, pagkatapos ay patakbuhin ang pinakasimpleng agent mula sa opisyal na dokumentasyon. Ang mga Model ID ay ang ginagamit sa dokumentasyon at maaaring hindi naka-enable sa account mo.
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.9Mga feature
| Anumang model | Oo | String lang ang babaguhin para magpalit ng model; may kasama ring offline test model |
|---|---|---|
| MCP client | Oo | Idinadagdag bilang kakayahan ng MCP sa agent |
| MCP server | Hindi pa nakukumpirma | |
| Multi-agent | Oo | May SubAgents capability at typed na control flow gamit ang Pydantic Graph |
| Durable na mga run | Oo | Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru o Airflow |
| Pag-apruba ng tao | Oo | Gumagana rin ang approval sa durable execution |
| Tracing | Oo | Native sa OpenTelemetry; isang linya lang para ipadala ang mga trace sa Logfire |
| Evals | Oo | Pydantic Evals, isang hiwalay na package mula sa parehong proyekto |
Mga kamakailang pagbabago
- Lumipat na sa 2.x line; patuloy pa ring tumatanggap ng maintenance release ang 1.x, gaya ng v1.107.7 noong 30 September 2026.
- Idinadagdag ng bagong pydantic-ai-harness package ang Coder, Researcher at SubAgents.
- Idinagdag ang realtime voice, image generation at embeddings.
- Inilipat ang docs sa pydantic.dev/docs/ai/.