كيف تختار إطار العمل
لقد كتبت Agent يدويًا بنفسك، وتعرف ما تفعله كل خطوة في الحلقة. في هذا القسم ننظر إلى ما تقدمه لك الأطر الرئيسية، وأي السيناريوهات تناسب كل منها، ثم نعيد كتابة مثال الفصل الثاني باستخدام أحدها.
تستحق توصية Anthropic في مقال «Building effective agents» أن تتذكرها أولًا: ابدأ باستخدام واجهة النموذج الكبير مباشرة، فكثير من الأنماط يمكن تنفيذها بأسطر قليلة من الكود؛ وإذا استخدمت إطار عمل، فافهم ما يفعله على مستوى الأساس.
جدول واحد
| ما هو | اللغة | هل يدعم النماذج الصينية / النماذج المحلية | مناسب لـ | |
|---|---|---|---|---|
| كتابة يدوية (هذا الدرس) | حلقة while واحدة | أي لغة | نعم، أي واجهة متوافقة مع OpenAI | لتعلم المبادئ؛ عندما تكون المتطلبات بسيطة وتريد تحكمًا كاملًا |
| OpenAI Agents SDK | إطار عمل Agent خفيف: Agent، أدوات، Handoff، حواجز حماية، جلسات، تتبع | Python (0.25.0) | نعم، الوثائق الرسمية تعطي طريقة الاتصال بمزودين آخرين، وقد اختبرناه فعليًا مع Ollama المحلي ونجح | عندما تريد تعاونًا جاهزًا بين عدة Agent وحواجز حماية، دون أن تكون مقيدًا بمزود نماذج واحد |
| Claude Agent SDK | استخدام Claude Code كمكتبة: نفس الأدوات والحلقة وإدارة السياق | Python، TypeScript | الوثائق الرسمية تذكر فقط استخدام Claude عبر منصات مثل Bedrock وGoogle Cloud وMicrosoft Foundry، ولا توضح إمكانية الاتصال بنماذج مزودين آخرين | عندما تحتاج إلى Agent برمجي قوي يستطيع قراءة الملفات وكتابتها وتشغيل الأوامر |
| LangGraph | إطار تنسيق أساسي: يعرّف العملية برسم بياني من «حالة + عقد + حواف» | Python | نعم | العمليات المعقدة طويلة التشغيل التي تحتاج إلى استمرارية وتدخل بشري وتحكم صريح في كل خطوة |
| Dify | منصة مفتوحة المصدر لبناء تطبيقات الذكاء الاصطناعي، مع تنسيق بصري | بدون كتابة كود | نعم | لبناء أدوات داخلية من غير المبرمجين؛ عندما تحتاج إلى نشر خاص |
| 扣子 (Coze) | منصة من ByteDance؛ النسخة مفتوحة المصدر تسمى Coze Studio | بدون كتابة كود | — | البناء البصري |
بعض التفاصيل التي يجب توضيحها:
- هل يمكن استخدام Claude Agent SDK مع النماذج الصينية؟ هذا سؤال شائع في عمليات البحث. الوثائق الرسمية التي وجدناها تذكر فقط أن المصادقة تتم بمفتاح API من Anthropic، أو استخدام Claude عبر منصات سحابية مثل Amazon Bedrock وGoogle Cloud وMicrosoft Foundry، ولا تذكر الاتصال بنماذج مزودين آخرين.
- ترخيص Dify ليس Apache القياسي 2.0، بل «نسخة معدلة من Apache 2.0»: لا يجوز استخدام شفرته المصدرية لتشغيل خدمة متعددة المستأجرين دون إذن، ولا يجوز إزالة الشعار ومعلومات حقوق النشر من الواجهة الأمامية. أحدث إصدار 1.20.0 (2026-11-18).
- كوزي: يركّز coze.cn الآن على "مساعد الذكاء الاصطناعي للمكاتب"؛ أما Coze Studio مفتوح المصدر فيستخدم ترخيص Apache 2.0، لكن آخر إصدار له كان v0.5.1 بتاريخ 2026/2/5.
إعادة كتابة الفصل الثاني باستخدام OpenAI Agents SDK
pip install openai-agents، ثم (تنزيل step_sdk.py):
import os
from agents import Agent, Runner, AsyncOpenAI, OpenAIChatCompletionsModel, set_tracing_disabled
from agents.decorators import tool
set_tracing_disabled(disabled=True) # 没有 OpenAI 平台的 key 时要关掉 tracing
client = AsyncOpenAI(base_url=os.environ.get("AGENT_BASE_URL", "http://localhost:11434/v1"),
api_key=os.environ.get("AGENT_API_KEY", "ollama"))
model = OpenAIChatCompletionsModel(model=os.environ.get("AGENT_MODEL", "qwen3:8b"), openai_client=client)
@tool
def add(a: float, b: float) -> float:
"""计算两个数的和"""
return a + b
@tool
def multiply(a: float, b: float) -> float:
"""计算两个数的积"""
return a * b
agent = Agent(name="计算助手", instructions="用工具做计算,最后用中文回答。", tools=[add, multiply], model=model)
result = Runner.run_sync(agent, "一箱苹果 24 个,我买了 17 箱,又多拿了 9 个。一共多少个?请用工具计算。")
print(result.final_output)يجب أن ترى (على الجهاز المحلي qwen3:8b):
تم شراء 417 تفاحة إجمالًا. عملية الحساب كالتالي:
1. 17 صندوقًا من التفاح: 17 × 24 = 408 تفاحة
2. إضافة 9 تفاحات إضافية: 408 + 9 = 417 تفاحةبالمقارنة مع الفصل الثاني: لم يعد من الضروري كتابة JSON Schema الخاص بـ tools يدويًا (يُولَّد من تعليقات الأنواع وسلاسل التوثيق)، كما أن الحلقات ومطابقة tool_call_id ودمج الرسائل يقوم بها Runner جميعها.
ثلاث نقاط رئيسية عند الاتصال بنماذج غير OpenAI (من الوثائق الرسمية):
- استخدام
OpenAIChatCompletionsModel: يعتمد الـ SDK افتراضيًا على واجهة Responses الجديدة من OpenAI، والتي لا تدعمها العديد من مزودي الخدمات الآخرين، فتظهر 404. - إذا لم يكن لديك مفتاح منصة OpenAI، فقم بـ
set_tracing_disabled(True)، وإلا فسيُبلغ رفع التتبع عن 401. @toolهو اختصار لـ@function_toolفي الإصدار الجديد، وما يُكتب في الدروس القديمة على الإنترنت@function_toolلا يزال يعمل.
كيف تختار
ابحثحالتي هي……
انقر على واحد لترى.
اختبر معرفتكعند ربط OpenAI Agents SDK بـ Ollama المحلي، لماذا نستخدم OpenAIChatCompletionsModel؟
تحقق من ذلك
- أستطيع ذكر السيناريوهات المناسبة لكل من الحلول الخمسة
- نجحت في تشغيل مثال الاتصال بنموذج محلي باستخدام OpenAI Agents SDK
- أعرف النقاط التي يجب الانتباه إليها في كل من Claude Agent SDK و Dify
القسم التالي: الأمان: الصلاحيات والعزل الآمن وحقن التعليمات.