Qwen Character API
مرجع API كامل لنماذج لعب الأدوار Qwen Character من Alibaba. تستخدم نماذج Qwen Character نقطة نهاية chat completions في Flaq AI، لكنها تدعم أيضا حقولا خاصة بالشخصيات للذاكرة طويلة المدى، ومحاكاة الدردشة الجماعية، والاستكمال الجزئي من assistant.
متغيرات النموذج
يدعم هذا API متغيرين للنموذج:
مقارنة سريعة
كيف يعمل لعب أدوار الشخصيات
استخدم رسائل system وuser وassistant العادية للعب دور شخصية واحدة. ضع تعليمات الشخصية الثابتة في رسالة system للطلب الحالي. عند تفعيل الذاكرة طويلة المدى، ضع ملف الشخصية القابل لإعادة الاستخدام في profile.
في محاكاة الدردشة الجماعية، لا يستنتج Qwen Character أسماء المتحدثين تلقائيا من profile. يجب على المستدعي كتابة أسماء المتحدثين في بداية content لكل رسالة، مثل Cheng Yi: أو Ling Lu:. لجعل النموذج يتابع كشخصية محددة، أضف رسالة assistant أخيرة يكون content فيها هو بادئة المتحدث المستهدف واضبط partial: true.
partial حقل على مستوى الرسالة في رسالة assistant الأخيرة. وليس معامل طلب على المستوى الأعلى.
Qwen Plus Character
نقطة النهاية
http
معاملات الطلب
مطلوب
الترويسات
دعم الرسائل
حقول الرسائل
اختياري
عند تفعيل الذاكرة طويلة المدى، يجب تقديم:
- ترويسة طلب
x-session profileفي جسم الطلبenable_long_term_memory: true
يدعم skip_save_types هذه القيم:
طلب لعب أدوار أساسي
javascript
طلب الذاكرة طويلة المدى
javascript
محاكاة الدردشة الجماعية باستخدام partial
تُنفّذ محاكاة الدردشة الجماعية عبر نص الرسائل. لا يعيّن API أسماء المتحدثين أو ينقلها تلقائيا. اكتب اسم كل متحدث يدويا في بداية content، ثم أضف رسالة assistant أخيرة تحتوي على بادئة المتحدث المستهدف وpartial: true.
javascript
المتابعة كشخصية باستخدام partial
استخدم نمط partial نفسه عندما لا يكون المستخدم قد رد بعد، لكنك تريد أن تواصل الشخصية الكلام. أضف رسالة assistant أخيرة تحتوي على بادئة الشخصية.
javascript
Qwen Flash Character
معاملات الطلب
نفس بروتوكول Qwen Plus Character، مع هذه الاختلافات:
مثال طلب
javascript
تنسيق الاستجابة
تعيد نماذج Qwen Character اللغوية الكبيرة استجابات إكمال متوافقة مع OpenAI. عند استخدام stream: true، تكون الاستجابة في صورة Server-Sent Events؛ وعند استخدام stream: false، تكون الاستجابة كائن JSON واحدًا.
أفضل الممارسات
- ضع تعليمات الشخصية على مستوى الطلب في رسائل
system. - ضع خلفية الشخصية القابلة لإعادة الاستخدام في
profileفقط عند تفعيل الذاكرة طويلة المدى. - أعد استخدام قيمة
x-sessionنفسها عبر المحادثات ذات الصلة عند تفعيل الذاكرة طويلة المدى. قد تُحذف الجلسات غير المستخدمة لمدة 365 يوما. - استمر في إرسال رسائل المحادثة الحديثة عندما يكون ذلك مفيدا؛ يمكن للذاكرة طويلة المدى والسياق قصير المدى العمل معا.
- في محاكاة الدردشة الجماعية، اكتب أسماء المتحدثين يدويا في
content. لن يستنتج API الأسماء منprofile. - استخدم
partial: trueفقط في رسالة assistant الأخيرة عندما يجب أن يتابع النموذج من بادئة. - استخدم Qwen Flash Character للعب الأدوار الخفيف وQwen Plus Character لجودة حوار أغنى.