# ينبغي لجلسة المساعد أن تحافظ على سياق المحادثة.

Canonical URL: https://www.iagenify.com/ar/news/iagenify-sdk-persistent-assistant-sessions

تجمع جلسات IaGenify SDK استدعاءات النموذج ضمن سياق واحد، مع ذاكرة اختيارية واستمرار يتجاوز الطلب الواحد.

## Key points
- تجمع الجلسة الاستدعاءات المرتبطة بدلاً من إعادة بناء المحادثة في كل طلب.
- تظل الذاكرة خياراً صريحاً يحدده التطبيق.
- تتيح الأدوار المحفوظة أسئلة المتابعة من دون إعادة إرسال السجل كله في كل مرة.

يكفي استدعاء نموذج منفرد لتحويل قصير. لكن المساعد المفيد يحتاج غالباً إلى أكثر من ذلك: أن يجيب عن سؤال متابعة مع الاحتفاظ بسياق المهمة. تمنح جلسات IaGenify SDK هذه الاستدعاءات مساحة مشتركة.

## أنشئ المساعد ثم تابع المحادثة

تبدأ الجلسة بنموذج وإعداداته. يستطيع التطبيق تحديد الدور والتعليمات ومخطط إخراج اختياري وخيار الذاكرة، ثم استدعاء `generate()` مع تقدم المحادثة.


```
const assistant = await api.models.create({
  model: "your-model",
  settings: { role: "Research assistant" },
  memory: true,
});

const first = await assistant.generate({
  inputs: [{ type: "text", content: "Summarize this topic." }],
});
const followUp = await assistant.generate({
  inputs: [{ type: "text", content: "What should I read next?" }],
});
```

ينتمي الاستدعاء الثاني إلى المساعد نفسه. لا يحتاج التطبيق إلى اعتباره طلباً منفصلاً أو إلى جمع كل الرسائل السابقة يدوياً. ويوفر SDK مكاناً واضحاً لإدارة السياق.

## تبقى الذاكرة خياراً للتطبيق

لا ينبغي لكل طلب أن يحتفظ بمحادثة. قد تكون الترجمة مستقلة، بينما تحتاج محادثة الدعم أو البحث إلى الاستمرارية. يتيح الخيار `memory` للتطبيق تحديد ذلك.

يوفر نموذج الجلسة طريقة موحدة للتعامل مع محادثات النماذج والوكلاء: للجلسة هوية وسياق وأدوار متتابعة يستطيع البرنامج استكمالها.

## سياق من دون نقل المحادثة كاملة

عندما تطول المحادثة، يصبح إرسال سجلها كاملاً مع كل طلب أمراً مرهقاً. توفر الجلسة مكاناً ثابتاً لربط الأدوار وتطبيق قواعد السياق.

لكن الذاكرة ليست خفية: يقرر المطورون تفعيلها والمعلومات التي يرسلونها ووقت بدء محادثة جديدة.

## أساس للعمل الممتد

تتيح الجلسات المستمرة تنقيح إجابة أو طرح سؤال آخر أو متابعة مهمة لاحقاً. كما توفر للتطبيق وحدة ثابتة يرتبط بها سجل المحادثة.

> تكون المحادثة مفيدة عندما يبني الدور التالي على السابق، مع بقاء التحكم فيما يُحفظ بيد التطبيق.

يظل هذا الأساس محورياً في SDK: المساعد ليس prompt فحسب، بل تفاعل يستطيع التطبيق تشكيله ومتابعته.

## FAQ
### ما جلسة المساعد؟
مورد نموذج بإعداداته يجمع الاستدعاءات المرتبطة لتشارك السياق.

### هل الذاكرة مفعّلة دائماً؟
لا. يختار التطبيق تفعيلها عند إنشاء المساعد.

### هل أحتاج إلى إعادة إرسال كل الرسائل السابقة؟
تتيح الجلسة متابعة الاستدعاءات المرتبطة من دون إعادة بناء السجل كاملاً لكل سؤال.

### هل ينبغي أن يستخدم كل استدعاء ذاكرة؟
لا. استخدمها للتفاعلات التي تحتاج إلى الاستمرارية؛ ويمكن للمهام المستقلة أن تبقى بلا حالة.
