Pi Agent: Installation & Authentication

آخر تحديث: 2026-08-31

--- title: "التثبيت والمصادقة" description: "تعرّف على كيفية تثبيت Pi Agent وإعداد بيئة Python وتكوين مفاتيح API ومزوّدي النماذج وإتمام التشغيل الأول." order: 2 lang: ar

الأدوات الحادة تُنجز العمل الجيد. هذا الدرس يُهيّئ بيئة تطوير Pi Agent في 5 دقائق.

1. المتطلبات

تحقق من إصدار Python:

python --version
# Python 3.11.8

2. تثبيت Pi Agent

(1) التثبيت عبر pip (الموصى به)

pip install pi-agent

(2) التثبيت من المصدر

git clone https://github.com/pi-agent/pi-agent.git
cd pi-agent
pip install -e .

(3) التحقق من التثبيت

pi-agent --version
# Pi Agent v0.8.0

(4) التبعيات الاختيارية

pip install pi-agent[all]          # تثبيت جميع التبعيات الاختيارية
pip install pi-agent[deepseek]     # دعم DeepSeek
pip install pi-agent[local]        # دعم النماذج المحلية (llama.cpp)
pip install pi-agent[tools]        # مجموعة أدوات موسعة

3. المصادقة وتكوين النموذج

يدعم Pi Agent عدة مزوّدي نماذج لغوية كبيرة. تحتاج إلى تكوين مفاتيح API قبل الاستخدام.

(1) متغيرات البيئة (الموصى بها)

# DeepSeek
export PI_DEEPSEEK_API_KEY="sk-xxxxxxxx"

# OpenAI
export PI_OPENAI_API_KEY="sk-xxxxxxxx"

# Anthropic
export PI_ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"

Windows PowerShell:

$env:PI_DEEPSEEK_API_KEY = "sk-xxxxxxxx"

(2) ملف التكوين

أنشئ ~/.pi-agent/config.yaml:

providers:
  deepseek:
    api_key: "sk-xxxxxxxx"
    base_url: "https://api.deepseek.com"
    model: "deepseek-chat"

  openai:
    api_key: "sk-xxxxxxxx"
    model: "gpt-4o"

  anthropic:
    api_key: "sk-ant-xxxxxxxx"
    model: "claude-sonnet-4-20250514"

default_provider: deepseek

(3) التكوين في الكود

from pi_agent import Agent

agent = Agent(
    name="my_agent",
    provider="deepseek",
    api_key="sk-xxxxxxxx",
    model="deepseek-chat"
)

4. نظرة عامة على مزوّدي النماذج

مثال 1: التبديل بين مزوّدين متعددين (الصعوبة: ⭐)

from pi_agent import Agent

deepseek_agent = Agent(provider="deepseek", model="deepseek-chat")
openai_agent = Agent(provider="openai", model="gpt-4o")

result_d = deepseek_agent.chat("Explain quantum computing in one sentence")
result_o = openai_agent.chat("Explain quantum computing in one sentence")

print(f"DeepSeek: {result_d}")
print(f"OpenAI: {result_o}")

5. اختبار التشغيل الأول

بعد التثبيت والتكوين، شغّل اختباراً سريعاً:

pi-agent chat "Hello, Pi Agent!"

المخرجات المتوقعة:

Pi Agent v0.8.0
Provider: deepseek (deepseek-chat)
Hello! I'm Pi Agent, how can I help you?

أكملت أليس إعدادها في 3 دقائق باتباع هذه الخطوات. يقول بوب: "تثبيت Pi Agent أبسط من معظم أدوات Python — ثبّت، أعد مفتاحاً، وابدأ."

❓ أسئلة شائعة

📖 ملخص

• يتطلب Python 3.9+؛ pip install pi-agent يبدأك مباشرة
• ثلاث طرق للمصادقة: متغيرات البيئة (الموصى بها)، ملف التكوين، التكوين في الكود
• يدعم عدة مزوّدي نماذج لغوية كبيرة؛ DeepSeek يوفر أفضل قيمة؛ النماذج المحلية مجانية
• التشغيل الأول: استخدم pi-agent chat للتحقق من إعدادك

📝 تمارين

1. أساسي (الصعوبة: ⭐): ثبّت Pi Agent وتحقق باستخدام pi-agent --version.
2. متوسط (الصعوبة: ⭐⭐): أعد مزوّدي نماذج لغوية كبيرين على الأقل، أنشئ نسخ وكيل لكل منهما، وتحقق من الاتصال.
3. متقدم (الصعوبة: ⭐⭐⭐): اكتب سكريبت يكتشف تلقائياً مفاتيح API المتاحة ويسرد المزوّدين المتاحين حالياً.

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

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

من نحن