نظرة عامة على Pydantic AI

إطار عمل للوكلاء بلغة Python من فريق Pydantic، يرتكز على تلميحات الأنواع والمخرجات المنظّمة والمتحقق من صحتها وحقن الاعتماديات. يتميز بدعم التنفيذ المتين على سبعة محركات، من Temporal إلى Airflow، ويضم Pydantic Evals.

الأنسب لـ: وكلاء Python آمنون من ناحية الأنواع، يجب التحقق من صحة مخرجاتهم، مع حرية اختيار محرك التنفيذ المتين.

معلومات أساسية

الجهة المسؤولة عن الصيانة

Pydantic

اللغات

Python

الترخيص

MIT

أحدث إصدار

2.52.0 · 30 سبتمبر 2026

المستودع

pydantic/pydantic-ai · 20,308 نجمة

خيار الاستضافة

لا يوجد

البدء السريع

ثبّت الحزمة، واضبط بيانات الاعتماد، ثم شغّل أبسط وكيل وفقًا للوثائق الرسمية. معرّفات النماذج هي المعتمدة في الوثائق، وقد لا تكون مفعّلة في حسابك.

pip install pydantic-ai

يتطلب OPENAI_API_KEY (or use Agent('test') offline)

from 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

مصدر البدء السريع

الميزات

التغييرات الأخيرة

• انتقل إلى سلسلة 2.x؛ وما زالت إصدارات 1.x تتلقى تحديثات صيانة، مثل v1.107.7 الصادر في 30 September 2026.
• تضيف الحزمة الجديدة pydantic-ai-harness أدوات Coder وResearcher وSubAgents.
• أُضيفت إمكانات الصوت الآني وتوليد الصور والتضمينات.
• انتقلت الوثائق إلى pydantic.dev/docs/ai/.

بدائل باللغة نفسها