Pi Agent: Context Management

بنية السياق
├── موجه النظام     -> تعليمات ثابتة (تعريف الدور، قيود السلوك)
├── سجل المحادثات   -> تراكم ديناميكي (رسائل المستخدم + استجابات الوكيل)
├── استدعاءات الأدوات -> عملية استدعاء الأدوات ونتائجها
└── سياق محقون      -> حقن إضافي (محتويات ملفات، بيانات API، إلخ)

from pi_agent import Agent

agent = Agent(name="quick", context_window=2048)       # صغيرة: توفير الرموز
agent = Agent(name="long", context_window=16384)       # كبيرة: تذكر أكثر
agent = Agent(name="full", context_window=65536)       # الحد الأقصى: القدرة الكاملة للنموذج

from pi_agent import Agent

agent = Agent(truncation_strategy="remove_oldest")     # إزالة أقدم الرسائل
agent = Agent(truncation_strategy="summarize")         # الذكاء الاصطناعي يلخّص الرسائل القديمة
agent = Agent(truncation_strategy="sliding_window", keep_recent=10)  # الاحتفاظ بآخر N جولات

from pi_agent import Agent

agent = Agent(name="coder")

with open("main.py") as f:
    agent.inject_context("current_file", f.read())

agent.inject_context("project_info", {
    "name": "my_app",
    "framework": "FastAPI",
    "python_version": "3.11"
})

response = agent.chat("Help me add a health check endpoint")
# الوكيل يعرف أن المشروع يستخدم FastAPI، يُولّد كوداً بأسلوب FastAPI

agent = Agent(name="auto", auto_context=True)
# يحقن تلقائياً بنية دليل العمل ومعلومات git، إلخ.

# مطوّل
agent = Agent(system_prompt="You are a very excellent programming assistant, skilled in Python, respond in detail...")

# موجز
agent = Agent(system_prompt="Python expert. Be concise.")

agent.clear_history()         # مسح الكل عند تغيير الموضوع
agent.keep_recent(5)          # الاحتفاظ بآخر 5 جولات فقط

agent.summarize_context()     # تشغيل يدوي
agent = Agent(auto_summarize_threshold=3000)  # تلقائي عند الحد