Skip to content

تجهيز البيئة والنموذج ​

بعد إنهاء هذا القسم، سيكون لديك على حاسوبك بيئة Python مثبتة التبعيات، ونموذج قادر على استدعاء الأدوات، وستعرف كيفية استخدام ثلاثة متغيرات بيئة للتبديل بين النماذج المختلفة.

1. بيئة Python ​

تحتاج إلى Python 3.10 أو أحدث. أنشئ بيئة افتراضية وثبّت مكتبتين:

bash
python3 -m venv .venv
source .venv/bin/activate        # Windows:.venv\Scripts\activate
pip install openai mcp
  • openai: لاستدعاء النموذج. رغم أن اسمها openai، إلا أنها تستطيع الاتصال بأي واجهة "متوافقة مع OpenAI"، ومعظم خدمات النماذج المحلية متوافقة.
  • mcp: تُستخدم في المرحلة الثالثة لكتابة خادم وعميل MCP.

الإصدارات التي نستخدمها: openai 3.57.0، وmcp 2.3.0.

2. اختر نموذجًا ​

يحتاج الـ Agent إلى نموذج يدعم استدعاء الأدوات (tool calling / function calling). هناك طريقان، اختر أحدهما:

ابحثأريد استخدام…

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

تقرأ جميع أكواد هذا الدرس الإعدادات من ثلاثة متغيرات بيئة، والقيم الافتراضية هي Ollama المحلي:

متغير البيئةOllama المحليالسحابي
AGENT_BASE_URLhttp://localhost:11434/v1 (افتراضي)عنوان الواجهة الذي يقدمه مزود الخدمة
AGENT_API_KEYollama (افتراضي، املأه بأي قيمة)مفتاح API الخاص بك
AGENT_MODELqwen3:8b (افتراضي)اسم النموذج لدى مزود الخدمة

عند استخدام نموذج سحابي، قم بضبطها أولًا في الطرفية (macOS / Linux):

bash
export AGENT_BASE_URL="服务商给的地址"
export AGENT_API_KEY="你的 key"
export AGENT_MODEL="模型名"

لا تكتب مفتاح API في الكود، ولا ترفعه إلى Git أبدًا.

3. تأكد أولًا من أن الاتصال يعمل ​

احفظ ما يلي باسم hello.py وشغّله:

python
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 رد النموذج

في القسم التالي سننتقل إلى التطبيق: جعل النموذج يستدعي دالة.

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.