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

  1. زر https://platform.deepseek.com/
  2. سجّل الدخول
  3. انتقل إلى صفحة "API Keys"
  4. انقر "Create API Key"
  5. انسخ المفتاح (التنسيق: 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 يتضمن ذلك مُدمجاً.

📖 ملخص


📝 تمارين

  1. أساسي (الصعوبة: ⭐): سجّل حساب DeepSeek، احصل على مفتاح API، أعد Pi Agent، وأرسل رسالة.
  2. متوسط (الصعوبة: ⭐⭐): قارن deepseek-chat وdeepseek-reasoner في نفس المسألة الرياضية.
  3. متقدم (الصعوبة: ⭐⭐⭐): ابنِ أداة مراقبة تكلفة تسجل استخدام الرموز والمصروفات لكل استدعاء API.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%