Framework · Pydantic
Pydantic AI w skrócie
Framework agentów w Pythonie od zespołu Pydantic, oparty na adnotacjach typów, walidowanych ustrukturyzowanych wynikach i wstrzykiwaniu zależności. Wyróżnia się trwałym wykonywaniem z użyciem siedmiu silników — od Temporal po Airflow — i zawiera też Pydantic Evals.
Najlepszy do: Agenty w Pythonie z kontrolą typów, których wyniki muszą przechodzić walidację, z możliwością wyboru silnika trwałego wykonywania.
Najważniejsze informacje
- Opiekun
- Pydantic
- Języki
- Python
- Licencja
- MIT
- Najnowsza wersja
2.52.0· 30 września 2026- Repozytorium
- pydantic/pydantic-ai
- Opcja hostowana
- Brak
Quickstart
Zainstaluj pakiet, skonfiguruj dane uwierzytelniające, a następnie uruchom najprostszego agenta z oficjalnej dokumentacji. Użyte identyfikatory modeli pochodzą z dokumentacji; dostęp do nich może nie być włączony na Twoim koncie.
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.9Funkcje
| Dowolny model | Tak | Zmiana modelu wymaga zmiany ciągu znaków; dostępny jest też model do testów offline |
|---|---|---|
| Klient MCP | Tak | Dodawana jako funkcja MCP agenta |
| Serwer MCP | Niepotwierdzone | |
| Wielu agentów | Tak | Funkcja SubAgents i typowany przepływ sterowania z Pydantic Graph |
| Trwałe uruchomienia | Tak | Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru lub Airflow |
| Zatwierdzanie przez człowieka | Tak | Zatwierdzanie działa również przy trwałym wykonywaniu |
| Śledzenie | Tak | Natywna obsługa OpenTelemetry; jednym wierszem kodu wysyłasz ślady do Logfire |
| Ewaluacje | Tak | Pydantic Evals, osobny pakiet w ramach tego samego projektu |
Najnowsze zmiany
- Projekt przeszedł na linię 2.x; wersja 1.x nadal otrzymuje wydania konserwacyjne, takie jak v1.107.7 z 30 September 2026.
- Nowy pakiet pydantic-ai-harness dodaje Coder, Researcher i SubAgents.
- Dodano głos w czasie rzeczywistym, generowanie obrazów i embeddings.
- Dokumentacja została przeniesiona na pydantic.dev/docs/ai/.