เฟรมเวิร์ก · Pydantic
ภาพรวม Pydantic AI
เฟรมเวิร์กเอเจนต์ Python จากทีม Pydantic ที่ออกแบบโดยใช้ type hints, structured output ที่ผ่านการตรวจสอบ และ dependency injection เป็นหลัก จุดเด่นคือรองรับการรันงานต่อเนื่องบนเอนจิน 7 แบบ ตั้งแต่ Temporal ไปจนถึง Airflow และมาพร้อม Pydantic Evals
เหมาะสำหรับ: เอเจนต์ Python แบบ type-safe ที่ต้องตรวจสอบความถูกต้องของ output ได้ พร้อมให้เลือกเอนจินสำหรับการรันงานต่อเนื่อง
ข้อมูลสำคัญ
- ผู้ดูแล
- Pydantic
- ภาษา
- Python
- ไลเซนส์
- MIT
- เวอร์ชันล่าสุด
2.52.0· 30 กันยายน 2569- Repository
- pydantic/pydantic-ai
- ตัวเลือกแบบโฮสต์
- ไม่มี
Quickstart
ติดตั้งแพ็กเกจ ตั้งค่าข้อมูลรับรอง แล้วเรียกใช้ agent ตัวอย่างที่เล็กที่สุดจากเอกสารทางการ Model ID เป็นค่าที่เอกสารใช้ และอาจยังไม่ได้เปิดใช้งานในบัญชีของคุณ
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.9ฟีเจอร์
| ใช้ได้กับทุกโมเดล | ใช่ | เปลี่ยนโมเดลได้ด้วยการแก้ string เพียงจุดเดียว และมีโมเดลสำหรับทดสอบแบบออฟไลน์ให้ด้วย |
|---|---|---|
| MCP client | ใช่ | เพิ่มความสามารถ MCP ให้กับเอเจนต์ได้ |
| MCP server | ยังไม่ยืนยัน | |
| หลาย agent | ใช่ | มีความสามารถ SubAgents และควบคุม flow ด้วย Pydantic Graph แบบมี type |
| การทำงานต่อเนื่องแบบทนทาน | ใช่ | รองรับ Temporal, DBOS, Prefect, Restate, AWS Lambda, Kitaru หรือ Airflow |
| การอนุมัติโดยมนุษย์ | ใช่ | รองรับการอนุมัติระหว่างการรันงานต่อเนื่องด้วย |
| Tracing | ใช่ | รองรับ OpenTelemetry โดยตรง ส่ง traces ไปยัง Logfire ได้ด้วยโค้ดเพียงบรรทัดเดียว |
| Evals | ใช่ | Pydantic Evals เป็นแพ็กเกจแยกต่างหากจากโปรเจกต์เดียวกัน |
การเปลี่ยนแปลงล่าสุด
- เปลี่ยนมาใช้เวอร์ชันสาย 2.x ส่วน 1.x ยังได้รับอัปเดตเพื่อบำรุงรักษา เช่น v1.107.7 เมื่อ 30 September 2026
- แพ็กเกจใหม่ pydantic-ai-harness เพิ่ม Coder, Researcher และ SubAgents
- เพิ่มเสียงแบบเรียลไทม์ การสร้างภาพ และ embeddings
- ย้ายเอกสารไปที่ pydantic.dev/docs/ai/