تجهيز البيئة والنموذج
بعد إنهاء هذا القسم، سيكون لديك على حاسوبك بيئة Python مثبتة التبعيات، ونموذج قادر على استدعاء الأدوات، وستعرف كيفية استخدام ثلاثة متغيرات بيئة للتبديل بين النماذج المختلفة.
1. بيئة Python
تحتاج إلى Python 3.10 أو أحدث. أنشئ بيئة افتراضية وثبّت مكتبتين:
python3 -m venv .venv
source .venv/bin/activate # Windows:.venv\Scripts\activate
pip install openai mcpopenai: لاستدعاء النموذج. رغم أن اسمها openai، إلا أنها تستطيع الاتصال بأي واجهة "متوافقة مع OpenAI"، ومعظم خدمات النماذج المحلية متوافقة.mcp: تُستخدم في المرحلة الثالثة لكتابة خادم وعميل MCP.
الإصدارات التي نستخدمها: openai 3.57.0، وmcp 2.3.0.
2. اختر نموذجًا
يحتاج الـ Agent إلى نموذج يدعم استدعاء الأدوات (tool calling / function calling). هناك طريقان، اختر أحدهما:
ابحثأريد استخدام…
انقر على واحد لترى.
تقرأ جميع أكواد هذا الدرس الإعدادات من ثلاثة متغيرات بيئة، والقيم الافتراضية هي Ollama المحلي:
| متغير البيئة | Ollama المحلي | السحابي |
|---|---|---|
AGENT_BASE_URL | http://localhost:11434/v1 (افتراضي) | عنوان الواجهة الذي يقدمه مزود الخدمة |
AGENT_API_KEY | ollama (افتراضي، املأه بأي قيمة) | مفتاح API الخاص بك |
AGENT_MODEL | qwen3:8b (افتراضي) | اسم النموذج لدى مزود الخدمة |
عند استخدام نموذج سحابي، قم بضبطها أولًا في الطرفية (macOS / Linux):
export AGENT_BASE_URL="服务商给的地址"
export AGENT_API_KEY="你的 key"
export AGENT_MODEL="模型名"لا تكتب مفتاح API في الكود، ولا ترفعه إلى Git أبدًا.
3. تأكد أولًا من أن الاتصال يعمل
احفظ ما يلي باسم hello.py وشغّله:
import os
from openai import OpenAI
client = OpenAI(base_url=os.environ.get("AGENT_BASE_URL", "http://localhost:11434/v1"),
api_key=os.environ.get("AGENT_API_KEY", "ollama"))
resp = client.chat.completions.create(
model=os.environ.get("AGENT_MODEL", "qwen3:8b"),
messages=[{"role": "user", "content": "用一句话介绍你自己"}])
print(resp.choices[0].message.content)ينبغي أن ترى النموذج يرد بجملة تعريفية عن نفسه.
::: خطأ warning: Using SOCKS proxy, but the 'socksio' package is not installed لقد ضبطت وكيلًا (proxy) من نوع SOCKS في طرفيتك (متغير بيئة مثل ALL_PROXY)، وستحاول مكتبة openai الاتصال عبره. هناك حلّان: إذا كان الاتصال بخدمة محلية أو بـ Ollama على جهازك لا يحتاج إلى وكيل، فألغِه قبل التشغيل، مثل env -u ALL_PROXY -u all_proxy python hello.py؛ وإذا كنت بحاجة فعلًا إلى الوكيل، فنفّذ pip install "httpx[socks]". وقد واجهنا هذا الخطأ أثناء إعداد هذه الدورة. :::
اختبر معرفتكلماذا يمكن استخدام مكتبة openai لاستدعاء DeepSeek أو Qwen أو Ollama المحلي؟
تحقق من ذلك
- يظهر openai و mcp في
pip list - اخترت النموذج، وأعرف كيفية ملء متغيرات البيئة الثلاثة
- طبع
hello.pyرد النموذج
في القسم التالي سننتقل إلى التطبيق: جعل النموذج يستدعي دالة.