Skip to content

كيف تختار إطار العمل ​

لقد كتبت 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):

python
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):

text
تم شراء 417 تفاحة إجمالًا. عملية الحساب كالتالي:

1. 17 صندوقًا من التفاح: 17 × 24 = 408 تفاحة
2. إضافة 9 تفاحات إضافية: 408 + 9 = 417 تفاحة

بالمقارنة مع الفصل الثاني: لم يعد من الضروري كتابة JSON Schema الخاص بـ tools يدويًا (يُولَّد من تعليقات الأنواع وسلاسل التوثيق)، كما أن الحلقات ومطابقة tool_call_id ودمج الرسائل يقوم بها Runner جميعها.

ثلاث نقاط رئيسية عند الاتصال بنماذج غير OpenAI (من الوثائق الرسمية):

  1. استخدام OpenAIChatCompletionsModel: يعتمد الـ SDK افتراضيًا على واجهة Responses الجديدة من OpenAI، والتي لا تدعمها العديد من مزودي الخدمات الآخرين، فتظهر 404.
  2. إذا لم يكن لديك مفتاح منصة OpenAI، فقم بـ set_tracing_disabled(True)، وإلا فسيُبلغ رفع التتبع عن 401.
  3. @tool هو اختصار لـ @function_tool في الإصدار الجديد، وما يُكتب في الدروس القديمة على الإنترنت @function_tool لا يزال يعمل.

كيف تختار ​

ابحثحالتي هي……

انقر على واحد لترى.

اختبر معرفتكعند ربط OpenAI Agents SDK بـ Ollama المحلي، لماذا نستخدم OpenAIChatCompletionsModel؟

تحقق من ذلك ​

  • أستطيع ذكر السيناريوهات المناسبة لكل من الحلول الخمسة
  • نجحت في تشغيل مثال الاتصال بنموذج محلي باستخدام OpenAI Agents SDK
  • أعرف النقاط التي يجب الانتباه إليها في كل من Claude Agent SDK و Dify

القسم التالي: الأمان: الصلاحيات والعزل الآمن وحقن التعليمات.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.