Framework · Pydantic
Tổng quan về Pydantic AI
Framework agent Python của đội ngũ Pydantic, được xây dựng xoay quanh type hints, đầu ra có cấu trúc được xác thực và dependency injection. Framework nổi bật với khả năng thực thi bền vững trên bảy engine, từ Temporal đến Airflow, đồng thời tích hợp Pydantic Evals.
Phù hợp nhất với: Agent Python an toàn kiểu dữ liệu, có đầu ra cần được xác thực và cho phép bạn chọn engine thực thi bền vững.
Thông tin chính
- Đơn vị duy trì
- Pydantic
- Ngôn ngữ
- Python
- Giấy phép
- MIT
- Phiên bản mới nhất
2.52.0· 30 tháng 9, 2026- Repository
- pydantic/pydantic-ai
- Tùy chọn chạy trên nền tảng lưu trữ
- Không có
Bắt đầu nhanh
Cài package, thiết lập thông tin xác thực, rồi chạy agent đơn giản nhất theo tài liệu chính thức. ID model sử dụng trong tài liệu có thể chưa được bật cho tài khoản của bạn.
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.9Tính năng
| Mọi model | Có | Đổi model chỉ cần thay đổi một chuỗi; có sẵn model để kiểm thử ngoại tuyến |
|---|---|---|
| MCP client | Có | Được thêm vào agent dưới dạng một MCP capability |
| MCP server | Chưa xác nhận | |
| Đa agent | Có | Có SubAgents capability và luồng điều khiển có kiểu dữ liệu với Pydantic Graph |
| Lượt chạy bền vững | Có | Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru hoặc Airflow |
| Phê duyệt của con người | Có | Quy trình phê duyệt cũng hoạt động trong chế độ thực thi bền vững |
| Tracing | Có | Tích hợp gốc với OpenTelemetry; chỉ cần một dòng để gửi trace đến Logfire |
| Evals | Có | Pydantic Evals là một package riêng trong cùng dự án |
Các thay đổi gần đây
- Đã chuyển sang nhánh 2.x; nhánh 1.x vẫn nhận các bản phát hành bảo trì, chẳng hạn v1.107.7 vào ngày 30 September 2026.
- Package pydantic-ai-harness mới bổ sung Coder, Researcher và SubAgents.
- Đã bổ sung giọng nói thời gian thực, tạo ảnh và embeddings.
- Tài liệu đã chuyển sang pydantic.dev/docs/ai/.