Pydantic AI إطار عمل بلغة Python لبناء الوكلاء من فريق Pydantic. ولأي خدمة ليس لها مزوّد مدمج فيه، تقول وثائقه أن تستخدم OpenAICompatibleProvider مع base_url الخاص بالخدمة. ويقدّم BroadNet Inference إكمال المحادثات القياسي على https://inference.broadnet.ai/v1، فهذا هو الطريق. موقع BroadRouter هو موقع BroadNet نفسها، ويتبع هذا الدليل وثائق Pydantic AI كما هي في الإصدار 2.68.
التثبيت
pip install "pydantic-ai-slim[openai]"
export BROADNET_API_KEY='your-broadnet-key'
الاتصال
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai_compatible import OpenAICompatibleProvider
model = OpenAIChatModel(
'broadnet/glm-5.3',
provider=OpenAICompatibleProvider(
'broadnet',
base_url='https://inference.broadnet.ai/v1',
api_key=os.environ['BROADNET_API_KEY'],
),
)
agent = Agent(model)
result = agent.run_sync('Give me three names for a Go linting tool.')
print(result.output)
تشغيل هذه الشيفرة هو الاختبار: ظهور إجابة مطبوعة يعني أن المفتاح والعنوان ومعرّف النموذج صحيحة.
- الوسيط الأول هو معرّف النموذج المُرسَل إلى BroadNet. استخدمه كما هو تمامًا، مع البادئة
broadnet/. - اسم المزوّد (
'broadnet'هنا) يُسجَّل في كل استجابة. وتقول وثائق Pydantic AI أن تُبقيه ثابتًا، لأنه يحدّد أي بيانات من الاستجابات السابقة تُعاد إلى الخدمة. - ابقَ على
OpenAIChatModel. تقول وثائق Pydantic AI ألّا تستخدمOpenAIResponsesModelإلا إذا كانت الخدمة تطبّق Responses API. وBroadNet لا يدرجها.
الأدوات والمخرجات المنظَّمة
from pydantic import BaseModel
class City(BaseModel):
name: str
country: str
agent = Agent(model, output_type=City)
print(agent.run_sync('Which city hosts the Burj Khalifa?').output)
استخدم broadnet/glm-5.3 أو broadnet/qwen3.8-27b للأدوات والمخرجات المنظَّمة؛ فوثائق BroadNet لا تدرج الميزتين إلا لهذين النموذجين.
متى تضبط ملف تعريف النموذج
يختار Pydantic AI ملف تعريف الطلب (profile) بناءً على اسم النموذج. وإذا تجاهلت الخدمة ميزة أو رفضتها، تقول وثائقه أن تمرّر OpenAIModelProfile خاصًا بك. وهناك إعدادان يستحقان المعرفة مع BroadNet:
from pydantic_ai.profiles.openai import OpenAIModelProfile
model = OpenAIChatModel(
'broadnet/glm-5.3',
provider=OpenAICompatibleProvider('broadnet', base_url='https://inference.broadnet.ai/v1', api_key=os.environ['BROADNET_API_KEY']),
profile=OpenAIModelProfile(
openai_chat_supports_max_completion_tokens=False, # send max_tokens, the field BroadNet documents
openai_supports_strict_tool_definition=False, # only if strict tool schemas are rejected
),
)
مرّر حد المخرجات عبر إعدادات النموذج، مثل agent.run_sync(prompt, model_settings={'max_tokens': 2000}). ويُحتسب الاستدلال المنطقي ضمنه في DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B.
أي نموذج تختار
| الوكيل | النموذج |
|---|---|
| الأدوات والمخرجات المنظَّمة | broadnet/glm-5.3 |
| الصور أو النصوص العربية، مع الأدوات | broadnet/qwen3.8-27b |
| المستندات الطويلة، خطة بسعر ثابت | broadnet/deepseek-v4.1-flash |
| الرصيد المبدئي المجاني | broadnet/gemma-4-26b-a4b (سياق 32,768 رمزًا) |
حل المشكلات
- 401. المفتاح خاطئ أو منتهي الصلاحية أو استُنفدت حصته.
- 404 أو النموذج غير موجود. يجب أن ينتهي
base_urlبـ/v1. تحقّق من معرّف النموذج. تحتاج النماذج المدفوعة إلى شحن الرصيد؛ فرصيد $5 لا يغطي إلاbroadnet/gemma-4-26b-a4bونموذجَي Transcribe. - مخرجات فارغة أو حلقة إعادة محاولة بسبب التحقق. استهلك الاستدلال المنطقي ميزانية المخرجات. ارفع
max_tokens. لماذا تصل الإجابات فارغة. - 400 على تعريفات الأدوات. اضبط
openai_supports_strict_tool_definition=Falseفي ملف التعريف، واستخدم نموذجًا يدرج BroadNet له الأدوات. - 429 عند تشغيل الوكلاء بالتزامن. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع الأخطاء وإعادة المحاولة.
