الكائنات

ChatRequest

الحقول

• messagesarray of ChatMessageمطلوب

  items ≥ 1

• collectionstring

  القيمة الافتراضية: "default"

• tagsarray of string | null
• exportstring | null
• card_idsarray of string | null

  items ≤ 50

• streamboolean

  القيمة الافتراضية: false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  عدم أخذ الإجابة من ذاكرة الإجابات المؤقتة (الزر «Get a fresh answer» (الحصول على إجابة جديدة) تحت الإجابة المخزنة مؤقتًا). تحل الإجابة الجديدة محل السجل المخزن مؤقتًا.

  القيمة الافتراضية: false

• languagestring | null

  لغة الإجابة: رمز ISO 639-1 (de، en، ru، …) للإجابة بتلك اللغة. مع auto أو بلا الحقل، تُكتشف اللغة من السؤال. تمرّر الواجهة لغة الاقتراح المكتوب بلغة أخرى صراحةً (Starter.language).

• scopeChatScope | null

  نطاق السؤال: عدة مجموعات، ومصدر، ووسوم، وفترة زمنية. تحل مجموعات النطاق محل collection. يحصر المصدر الإجابة في مجموعته (وفي بطاقاته). تُضاف الوسوم إلى tags. تحصر الفترة الإجابات المالية فيها. لا يمكنك اختيار إلا ما يراه المستخدم (المجموعات: collections.no_access/collections.not_found؛ المصدر: sources.not_found). مع conversation_id يُحفظ النطاق في المحادثة. بلا الحقل يُطبَّق نطاق المحادثة؛ والقيمة null أو النطاق الفارغ يمحوه.

• request_idstring

  مفتاح عدم التكرار للسؤال. أرسل المفتاح نفسه في كل إعادة محاولة للتدفق الخاص بسؤال واحد (إعادة المحاولة بعد انقطاع الاتصال؛ وهنا لا تستأنف الترويسة Last-Event-ID التدفق بل تُسجَّل فقط). إعادة المحاولة بمفتاح إجابة محفوظة بالفعل لا تنشئ سؤالًا ثانيًا: تُرسَل النتيجة المحفوظة مرة أخرى في حدث done واحد (مع token بالنص)، حتى إن استُنفد حد الأسئلة أو الرصيد. وإذا كانت الإجابة السابقة لا تزال قيد الإعداد لعميل انقطع اتصاله، يتوقف إعدادها وتُعَدّ الإجابة من جديد.

  length ≤ 64

• version_ofinteger (int64)

  ينشئ إصدارًا جديدًا من مداخلة هذا السؤال في المحادثة (question_id من سجل المحادثة): سؤال معدَّل (نص جديد في messages)، أو إجابة مُعادة الإعداد (النص نفسه، عادةً مع bypass_cache)، أو السؤال نفسه بقيمة أخرى للحقل quality (مثلًا precise بعد إجابة fast). يُحتفظ بزوج السؤال والإجابة السابق. تبقى المداخلات التي تليه في فرعه وتُخفى من سجل المحادثة ما دام الإصدار الجديد هو المختار (FeedItem.versions، POST /v1/conversations/{conv_id}/versions). السجل المستخدم للإجابة هو الفرع المختار حتى هذه المداخلة. لا تغيّر قيمة quality للإصدار إعدادات المحادثة. يتطلب conversation_id؛ والسؤال من محادثة أخرى يعيد 404 questions.not_found.

• qualitystring

  الموازنة بين سرعة البحث الذي تقوم عليه النتيجة ودقته: fast أسرع، وprecise أدق. القيمة الافتراضية: precise.

  القيم المسموح بها: fastprecise

يُستخدم في

• POST/v1/chatبث إجابة المساعد (SSE)