OpenAIChatModel إلى Venice واستمر في استخدام باقي واجهة PydanticAI كالمعتاد.
المتطلبات الأساسية
- Python 3.9 أو أحدث
- مفتاح Venice API
الإعداد
ثبّت PydanticAI مع دعم OpenAI:pydantic-ai، التي تتضمن إضافات OpenAI.
أضف مفتاح Venice 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:
venice_parameters (كشط الويب، الاستشهادات، الشخصيات، ضوابط التفكير، ومفاتيح التشفير من طرف إلى طرف).
النماذج الموصى بها
تتغير معرّفات النماذج بمرور الوقت — تأكد من المعرّفات الحالية عبر
GET /models أو نظرة عامة على النماذج.
ميزة الخصوصية
يُستخدم PydanticAI كثيرًا لبناء وكلاء يتعاملون مع بيانات التطبيقات وسياق المستخدم والأدوات الداخلية. إقرانه بـ Venice يُبقي هذا التدفق على استدلال خاص وغير مُقيَّد:- الاحتفاظ الصفري بالبيانات على النماذج الخاصة — لا تُحفَظ المطالبات وحمولات الأدوات بعد الطلب
- تحليل غير مُقيَّد عندما يحتاج الوكلاء إلى نقد صريح أو اختبار من الفريق الأحمر
- بنية متوافقة مع OpenAI حتى تتمكن من ترحيل تطبيقات PydanticAI الحالية بمجرد تغيير عنوان المزوّد الأساسي ومفتاح API
استكشاف الأخطاء وإصلاحها
401 غير مصرَّح به
401 غير مصرَّح به
تأكد من ضبط
VENICE_API_KEY (أو OPENAI_API_KEY) في العملية التي تُشغّل الوكيل. أعِد تشغيل الصدفة أو العملية بعد تغيير متغيرات البيئة.النموذج غير موجود أو أخطاء غير متوقعة في نقطة النهاية
النموذج غير موجود أو أخطاء غير متوقعة في نقطة النهاية
استخدم معرّف نموذج حديث من صفحة النماذج. اضبط
base_url على https://api.venice.ai/api/v1 دون مسار لاحق — يُضيف PydanticAI /chat/completions تلقائيًا.فشل Responses API أو بادئة openai:
فشل Responses API أو بادئة openai:
يُفضَّل استخدام
OpenAIChatModel مع OpenAIProvider صريح. تجنّب اختصار الوكيل openai: المجرّد، الذي قد يستهدف واجهة Responses من OpenAI بدلًا من Chat Completions.يتم تجاهل الأدوات أو المخرجات المُهيكَلة
يتم تجاهل الأدوات أو المخرجات المُهيكَلة
اختر نموذجًا يدعم استدعاء الدوال، وحدّد في
instructions متى يجب أن تُستخدم الأدوات، واحرص على أن تكون سلاسل التوثيق (docstrings) دقيقة — يبني PydanticAI مخططات JSON من التوقيعات والوثائق.وثائق PydanticAI
الوكلاء والأدوات والتبعيات وأنواع المخرجات
نماذج Venice
تصفح النماذج والقدرات المدعومة