الانتقال إلى المحتوى الرئيسي
PydanticAI هو إطار عمل للوكلاء بلغة Python من فريق Pydantic. يمنحك تبعيّات مُنمَّطة، واستدعاء أدوات، ومخرجات مُهيكَلة، وبثًّا فوق مزوّدي LLM. يعمل Venice كواجهة خلفية متوافقة مع OpenAI — وجّه OpenAIChatModel إلى Venice واستمر في استخدام باقي واجهة PydanticAI كالمعتاد.

المتطلبات الأساسية

الإعداد

ثبّت PydanticAI مع دعم OpenAI:
يمكنك أيضًا تثبيت الحزمة الكاملة pydantic-ai، التي تتضمن إضافات OpenAI. أضف مفتاح Venice API إلى البيئة:
احتفظ بمفاتيح API خارج نظام التحكم بالمصدر. يُفضَّل استخدام متغيرات البيئة أو مدير أسرار في الإنتاج.

اضبط Venice كمزوّد للنموذج

يتحدث Venice واجهة OpenAI Chat Completions. استخدم OpenAIChatModel مع OpenAIProvider وعنوان Venice الأساسي:
استخدم OpenAIChatModel (Chat Completions)، وليس OpenAIResponsesModel / اختصار openai:. مسار التوافق الأساسي في Venice هو /chat/completions. تثبيت Chat Completions يتفادى سلوكيات خاصة بـ Responses تستخدمها نماذج OpenAI الافتراضية في إصدارات PydanticAI الأحدث.

متغيرات البيئة

يقرأ OpenAIProvider أيضًا OPENAI_API_KEY وOPENAI_BASE_URL. يمكنك ضبط Venice بهذه الطريقة بدلًا من تمرير الوسائط في الكود:

شغّل وكيلًا

الاستخدام غير المتزامن يتبع النمط ذاته مع await agent.run(...):

بثّ الاستجابة

استخدم run_stream عندما ترغب في استقبال الرموز فور وصولها:

المخرجات المُهيكَلة

مرّر نموذج Pydantic كـ output_type للتحقق من الإجابة النهائية للوكيل:
تصفّح النماذج التي تدعم الاستجابات المُهيكَلة واستدعاء الدوال قبل الاعتماد على المخرجات المُهيكَلة المستندة إلى الأدوات في الإنتاج.

الأدوات

سجّل الأدوات باستخدام @agent.tool_plain (بدون سياق الوكيل) أو @agent.tool (يحتاج إلى RunContext):

المعاملات الخاصة بـ Venice

مرّر الخيارات الخاصة بـ Venice عبر ModelSettings.extra_body. على سبيل المثال، فعّل بحث الويب المدمج باستخدام venice_parameters:
يمكنك أيضًا تجاوز الإعدادات لكل تشغيل:
راجع مواصفات API للاطلاع على القائمة الكاملة لـ venice_parameters (كشط الويب، الاستشهادات، الشخصيات، ضوابط التفكير، ومفاتيح التشفير من طرف إلى طرف).

النماذج الموصى بها

تتغير معرّفات النماذج بمرور الوقت — تأكد من المعرّفات الحالية عبر GET /models أو نظرة عامة على النماذج.

ميزة الخصوصية

يُستخدم PydanticAI كثيرًا لبناء وكلاء يتعاملون مع بيانات التطبيقات وسياق المستخدم والأدوات الداخلية. إقرانه بـ Venice يُبقي هذا التدفق على استدلال خاص وغير مُقيَّد:
  • الاحتفاظ الصفري بالبيانات على النماذج الخاصة — لا تُحفَظ المطالبات وحمولات الأدوات بعد الطلب
  • تحليل غير مُقيَّد عندما يحتاج الوكلاء إلى نقد صريح أو اختبار من الفريق الأحمر
  • بنية متوافقة مع OpenAI حتى تتمكن من ترحيل تطبيقات PydanticAI الحالية بمجرد تغيير عنوان المزوّد الأساسي ومفتاح API

استكشاف الأخطاء وإصلاحها

تأكد من ضبط VENICE_API_KEY (أو OPENAI_API_KEY) في العملية التي تُشغّل الوكيل. أعِد تشغيل الصدفة أو العملية بعد تغيير متغيرات البيئة.
استخدم معرّف نموذج حديث من صفحة النماذج. اضبط base_url على https://api.venice.ai/api/v1 دون مسار لاحق — يُضيف PydanticAI /chat/completions تلقائيًا.
يُفضَّل استخدام OpenAIChatModel مع OpenAIProvider صريح. تجنّب اختصار الوكيل openai: المجرّد، الذي قد يستهدف واجهة Responses من OpenAI بدلًا من Chat Completions.
اختر نموذجًا يدعم استدعاء الدوال، وحدّد في instructions متى يجب أن تُستخدم الأدوات، واحرص على أن تكون سلاسل التوثيق (docstrings) دقيقة — يبني PydanticAI مخططات JSON من التوقيعات والوثائق.

وثائق PydanticAI

الوكلاء والأدوات والتبعيات وأنواع المخرجات

نماذج Venice

تصفح النماذج والقدرات المدعومة