Pi Agent: DeepSeek Configuration
آخر تحديث: 2026-08-31
--- title: "تكوين DeepSeek" description: "تعمّق في تكوين DeepSeek كمزوّد نماذج لغوية لـ Pi Agent، بما في ذلك معلمات API واختيار النموذج وتحسين التكلفة والخيارات المتقدمة." order: 3 lang: ar
DeepSeek هو المزوّد الأكثر توصية لـ Pi Agent — رخيص، قادر، ممتاز بالصينية. هذا الدرس يغطي التكوين الكامل لـ DeepSeek.
1. لماذا DeepSeek
| الميزة | الوصف |
|---|---|
| فعالية عالية من حيث التكلفة | إدخال ¥1/مليون رمز، إخراج ¥2/مليون رمز |
| ممتاز بالصينية | تدريب صيني أصلي، فهم وتوليد متفوق |
| استدعاء الدوال | يدعم استدعاء الأدوات |
| سياق طويل | نافذة سياق 64K |
| استجابة سريعة | زمن استجابة أولية منخفض |
2. الحصول على مفتاح API
- زر https://platform.deepseek.com/
- سجّل الدخول
- انتقل إلى صفحة "API Keys"
- انقر "Create API Key"
- انسخ المفتاح (التنسيق:
sk-xxxxxxxxxxxxxxxx)
ملاحظة: يُعرض المفتاح مرة واحدة فقط. احفظه بأمان. إذا انكشف، احذفه فوراً وأنشئ جديداً.
3. التكوين الأساسي
(1) الحد الأدنى من التكوين
YAML
providers:
deepseek:
api_key: "sk-xxxxxxxx"
(2) التكوين الكامل
YAML
providers:
deepseek:
api_key: "sk-xxxxxxxx"
base_url: "https://api.deepseek.com"
model: "deepseek-chat"
temperature: 0.7
max_tokens: 4096
top_p: 0.95
timeout: 60
default_provider: deepseek
(3) متغيرات البيئة
BASH
export PI_DEEPSEEK_API_KEY="sk-xxxxxxxx"
export PI_DEEPSEEK_BASE_URL="https://api.deepseek.com"
4. اختيار النموذج
| النموذج | حالة الاستخدام | السياق | السعر (لكل مليون رمز) |
|---|---|---|---|
| deepseek-chat | المحادثة العامة | 64K | إدخال ¥1 / إخراج ¥2 |
| deepseek-reasoner | الاستدلال المعقد | 64K | إدخال ¥4 / إخراج ¥16 |
مثال 1: مقارنة النماذج (الصعوبة: ⭐)
PYTHON
from pi_agent import Agent
chat_agent = Agent(name="quick", provider="deepseek", model="deepseek-chat")
reasoner_agent = Agent(name="thinker", provider="deepseek", model="deepseek-reasoner")
print(chat_agent.chat("1+1=?"))
print(reasoner_agent.chat("Prove that the square root of 2 is irrational"))
5. ضبط المعلمات
(1) temperature
يتحكم في عشوائية المخرجات؛ القيم الأقل أكثر تحديداً:
PYTHON
code_agent = Agent(model="deepseek-chat", temperature=0.1) # الكود: دقيق
creative_agent = Agent(model="deepseek-chat", temperature=1.0) # الإبداع: متنوع
(2) max_tokens
يتحكم في الحد الأقصى لطول الاستجابة:
PYTHON
brief_agent = Agent(model="deepseek-chat", max_tokens=256) # ردود قصيرة
essay_agent = Agent(model="deepseek-chat", max_tokens=8192) # مقالات طويلة
(3) تكوين استدعاء الأدوات
PYTHON
agent = Agent(
provider="deepseek",
model="deepseek-chat",
tools=["search", "calculator"],
tool_choice="auto" # auto | required | none
)
| tool_choice | السلوك |
|---|---|
| auto | الوكيل يقرر ما إذا كان سيستدعي الأدوات |
| required | يجب استدعاء أداة |
| none | لا يُسمح باستدعاء الأدوات |
6. تحسين التكلفة
تعالج أليس آلاف الطلبات يومياً. تستخدم هذه الاستراتيجيات:
PYTHON
agent = Agent(
provider="deepseek",
model="deepseek-chat",
max_tokens=2048,
temperature=0.3,
context_window=4096
)
ينصح بوب: "استخدم deepseek-chat للأسئلة البسيطة، وdeepseek-reasoner فقط للاستدلال المعقد. Chat يتعامل مع 90% من السيناريوهات."
❓ أسئلة شائعة
س واجهة DeepSeek API تعيد خطأ 401؟
ج مفتاح API غير صالح أو منتهي الصلاحية. تحقق منه على المنصة — تأكد من عدم وجود مسافات أو أسطر جديدة زائدة.
س الاستجابات بطيئة؟
ج تحقق من اتصال الشبكة، قلّل max_tokens، صغّر نافذة السياق. قد يزداد زمن الاستجابة في أوقات الذروة.
س هل واجهة DeepSeek API متوافقة مع OpenAI؟
ج نعم. تنسيق واجهة DeepSeek متوافق مع OpenAI. يمكنك تعيين base_url إلى DeepSeek واستخدام حزمة OpenAI. Pi Agent يتضمن ذلك مُدمجاً.
📖 ملخص
- DeepSeek هو مزوّد النماذج اللغوية الموصى به لـ Pi Agent بفعالية تكلفة ممتازة
- احصل على مفتاح API وقم بالتكوين عبر ملف التكوين أو متغيرات البيئة
- deepseek-chat للاستخدام اليومي، deepseek-reasoner للاستدلال المعقد
- حسّن باستخدام معلمات temperature وmax_tokens وtool_choice
📝 تمارين
- أساسي (الصعوبة: ⭐): سجّل حساب DeepSeek، احصل على مفتاح API، أعد Pi Agent، وأرسل رسالة.
- متوسط (الصعوبة: ⭐⭐): قارن deepseek-chat وdeepseek-reasoner في نفس المسألة الرياضية.
- متقدم (الصعوبة: ⭐⭐⭐): ابنِ أداة مراقبة تكلفة تسجل استخدام الرموز والمصروفات لكل استدعاء API.