اسأل التطبيق في Home والتطبيقات المنشورة
تتوفر App Chat داخل App Shell منشور عندما يفعّلها الناشر وتكون للمستخدم صلاحية حالية لمصدر أو إجراء معتمد. أما دردشة Home المدمجة فهي تصميم قيد التنفيذ: مصدر Studio الحالي يعرض صفحات المهام والتطبيقات، ولا يضم لوحة دردشة أو زر تشغيل في Home. لا يكفي وجود إعداد أو أهلية في الخادم لاعتبار الدردشة متاحة للمستخدم. تختلف Ask Inflow عن دردشة التطبيق المنشور.
للمستخدمين
افتح التطبيق من «التطبيقات» في Inflow Home. إذا فعّل الناشر الدردشة وكان لديك وصول حالي إلى مصدر أو إجراء معتمد واحد على الأقل، يظهر زر المساعدة داخل التطبيق. اطرح سؤالًا عن البيانات أو المهام أو الإرشادات التي وافق عليها الناشر. راجع الاستشهادات وافتح المصدر للتحقق؛ يعاد فحص صلاحية الوصول عند فتحه.
الإجابة إرشاد وليست حقيقة عمل مؤكدة. إذا لم يتوفر دليل كافٍ، فلا تعتبر الإجابة إثباتًا. لا تلصق كلمات المرور أو معلومات حساسة غير مرتبطة بالتطبيق.
قد يقترح التطبيق إكمال مهمة أو إجراءً آخر معتمدًا. راجع الهدف والقيم والحقول المطلوبة والسبب قبل التأكيد. إنشاء المسودة لا يغير بيانات العمل؛ لا ينفذ الإجراء إلا بعد تأكيد صريح، ثم يعيد النظام فحص الصلاحية والإصدار الحاليين. إذا كانت النتيجة غير محسومة، استخدم «التحقق من النتيجة» بهوية العملية نفسها؛ لا تنشئ عملية جديدة لتخمين نتيجة الأولى.
ميّز بين طلباتك والمهام التي تنتظر قرارك
سارة مديرة لديها مهام موافقة، وتقدّم أيضًا طلبات إجازة لنفسها. يختلف السؤالان داخل التطبيق نفسه:
| السؤال | الدليل المناسب | ما الذي تتحقق منه؟ |
|---|---|---|
| «ما المهام التي تنتظر موافقتي؟» | مهام سارة المفتوحة المتاحة لها في صندوق المهام المعتمد للتطبيق. | قارن المهام بعرض العمل المعتاد. القائمة الجزئية لا تثبت العدد الكامل ولا تشمل أعمال الشركة كلها. |
| «هل طلبي ما زال بانتظار الموافقة؟» | سجل الطلب المقصود الذي تستطيع سارة قراءته. | تحقق من مرجع الطلب وصاحبه وحالته الحالية؛ مهام الموافقة الموكلة إلى سارة لا تثبت حالة طلبها الشخصي. |
| «هل LR-1005 ما زال بانتظار الموافقة؟» | سجل LR-1005 المسموح به. | افتح السجل بالطريق المعتاد إن كان متاحًا وتحقق من المرجع والحالة. معرفة المرجع لا تمنح صلاحية الوصول. |
| «كم طلبًا بانتظار الموافقة؟» | عدد الطلبات المسموح بها في الحالة التي تعني الانتظار، من مصدر السجلات. | الطلبات سجلات: لا تُحسب مهام سارة المفتوحة ضمن هذا العدد ولا تظهر كمصدر له. تحقق من المرشح ونطاق الصلاحية. |
| «كم طلب إجازة حالته قيد الانتظار؟» | عدد من مصدر السجلات المسموح به إذا كان يدعم التجميع المعتمد. | تحقق من المرشح ونطاق الصلاحية؛ هذا ليس تلقائيًا عدد مهام سارة أو طلبات الشركة كلها. |
خلو صندوق مهام سارة لا يعني أن طلباتها لا تنتظر قرار شخص آخر. ووجود مهام تنتظر قرارها لا يثبت شيئًا عن طلب إجازتها. عبارة بانتظار الموافقة تصف حالة، ولا تنفذ إجراء الموافقة. إذا التبس المقصود، فاذكر مرجع الطلب أو وضّح أنك تسأل عن مهام الموافقة الموكلة إليك.
إذا كنت مقدّم طلبات وصاحب مهام موافقة معًا، فقد تبقى مهامك المفتوحة ضمن السياق المرسل إلى المساعد عند سؤاله عن طلبك. صياغة السؤال لا تضمن فصل الموضوعين في الإجابة. قبل الاعتماد على حالة الطلب، تحقق من الطلب نفسه في عرض السجل المعتاد المسموح به؛ عنوان المهمة أو عددها أو غياب استشهاد المهمة لا يكفي.
كلمة «طلباتي» تساعد على فهم السؤال، لكنها لا تنشئ مرشح ملكية ولا تغيّر الصلاحيات. تظل مصادر التطبيق وصلاحيات الصفوف والحقول والمهام العادية هي التي تحدد ما يمكن قراءته. تحقق من هوية الطلب ونطاق الإجابة بدل افتراض أن صياغة السؤال تفرض تقييدًا أمنيًا.
ميّز بين تعذّر الإجابة والإجابة ذات الحدود
الأمثلة التالية تعليمية افتراضية، وليست محادثات ملتقطة أو صياغة مضمونة. افترض أن التطبيق يتيح معلومات الإجازات المسموح بها، ولا يتوفر دليل على الراتب للسؤال المطروح.
| الموقف | كيف تقرأ النتيجة؟ | الخطوة التالية |
|---|---|---|
| تسأل عن راتب هدى، فتوضح الإجابة أن المعلومات المتاحة لا تجيب عن السؤال، ولو ذكرت طلب إجازة سابقًا. | قد يحذف App Chat الاستشهادات عندما يتعرف إلى تعذّر الإجابة. بقاء إحالة أو ذكر طلب سابق لا يجعل معلومات الإجازة دليلًا على الراتب. | استخدم المصدر المعتاد المسموح به أو اسأل مالكه؛ لا تستنتج قيمة الراتب أو سبب غياب الوصول. |
| تسأل عن LR-1005، فتثبت قراءة حالية مسموح بها أنه قيد الانتظار، ثم تذكر الإجابة أن الراتب غير وارد. | يمكن أن تبقى إحالة سجل الإجازة مع هذا التحفّظ. تدعم الإحالة الحقائق المقروءة عن الطلب، ولا تدعم الراتب الغائب. | افتح سجل الطلب المسموح به وتحقق من المعلومة المطلوبة. |
| يعيد بحث ناجح ومسموح به صفر طلبات مرفوضة ضمن المرشح المحدد. | الصفر قد يكون إجابة بيانات فعلية، ويختلف عن خطأ المصدر أو رفض الإجابة؛ ولا يثبت غياب الطلبات خارج نطاق البحث المسموح به. | تحقق من نطاق البحث وأي تنبيه إلى عدم اكتمال النتائج. |
| يعثر البحث على LR-1005 ولا يعثر على طلبات إضافية مطابقة ضمن نطاقه. | قد تبقى إحالة السجل مع عبارة «لم أعثر على طلبات أخرى». لا تَعِد هذه العبارة ببحث شامل للشركة. | تحقق من السجل وحدود البحث. |
| الإجراء المطلوب لا ينطبق على السجل المختار ولا تُنشأ مسودة مقترح. | لا تعرض إجابة عدم الانطباق استشهادات، ولا تثبت تنفيذ إجراء. | افتح المهمة أو النموذج المعتاد المسموح به، وحدد الهدف ثم راجع مقترحًا صالحًا إن عُرض. |
اقرأ ما تثبته الإجابة فعلًا وما تغطيه مصادرها. لا تفترض أن كل إجابة غير مدعومة ستخفي الاستشهادات؛ التعرّف الحالي لا يضمن العرض نفسه لكل صياغة. وجود الاستشهاد أو غيابه ليس إيصال تنفيذ. بعد إجابة مستندة إلى سجل، حتى مع تحفّظ، قد تطلب إعداد موافقة على ذلك الطلب؛ لكن يلزم وجود مهمة منطبقة ومسموح بها، ومراجعة الهدف، والتأكيد الصريح. إذا لم يتضح الهدف فاذكره أو استخدم النموذج المعتاد. وعند الشك في نتيجة عملية، استخدم التحقق من الحالة للعملية نفسها قبل محاولة إجراء آخر.
عندما يسمّي مقترح الموافقة سجلًا مرتبطًا
لنفترض أن سارة طلبت: «جهّز موافقة على إجازة هدى ناصر». قد يعرض App Chat بطاقة موافقة مقترحة تسمّي سجل الإجازة المرتبط LR-1005 وتعرض حقلًا مسموحًا مثل 5 أيام. يصبح السجل والحقول الظاهرة على البطاقة جزءًا من أدلة الإجابة، حتى إن جاءت من قراءة مختلفة عن الاستشهاد الأول. وقبل عرض الإجابة، يعيد Inflow فحص أن السجل نفسه والحقول نفسها ما زالت مقروءة ومسموحًا بالإفصاح عنها للذكاء الاصطناعي. يظل المقترح مسودة؛ على سارة مراجعته وتأكيده صراحةً قبل تنفيذ إجراء المهمة المعتاد.
بعد موافقة سارة تحتفظ المحادثة بكلمات المقترح وبالسطر الذي يذكر ما سيُحدَّث في طلب الإجازة LR-1005، ويُضاف إيصال تحتهما. وإذا حدّث القرار السجل المرتبط، يسرد الإيصال ما كتبه الخادم فعلًا، مثل تغيّر الحالة من معلق إلى موافق في طلب إجازة LR-1005. يُذكر الحقل المحمي باسمه دون قيمه. قد يخلو إيصال يُقرأ لاحقًا عبر التحقق من الحالة من هذه الأسطر؛ افتح السجل للتأكد من قيمه الحالية.
إذا سُحبت صلاحية الوصول إلى LR-1005 أو صلاحية الإفصاح عن حقل ظاهر قبل هذا الفحص، تُحجب الإجابة والمقترح. وإذا فتحت سارة المحادثة لاحقًا بعد سحب الصلاحية، فقد تظهر الإجابة المحفوظة كمرفوضة أو محجوبة بدل تكرار صياغة الموافقة السابقة. هذا إجراء لحماية الوصول، ولا يعكس إجراءً سبق أن أكدته سارة. لمعرفة الحالة الحالية للمهمة، افتح عرض المهمة أو السجل المعتاد المسموح به وتحقق منه هناك. الإجابة القديمة المخفية أو المرفوضة لا تثبت أن المهمة قُبلت أو رُفضت.
اطرح سؤالًا واضحًا وتحقق من المهمة المستهدفة والسجل المرتبط قبل التأكيد. مثال: إذا كانت البطاقة تعرض هدى ناصر · LR-1005 · 5 أيام، فتأكد من أنها الطلب المقصود. وإذا غاب الاسم أو المفتاح أو عدد الأيام أو لم يطابق المطلوب، فتوقف وافتح نموذج المهمة المعتاد. لا تستنتج وجود سجل مرتبط من الاسم وحده.
إجابات الأعداد وأسئلة المتابعة وتسميات السجلات
عند الإجابة عن سؤال يتضمن عددًا، لا يحدد العدد وحده الشخص أو الطلب المطابق. تسمية سجل تحتاج إلى دليل حالي بعد فحص الصلاحية. يمكن لسؤال متابعة واضح عن السجل الجاري الحديث عنه أن يستخدم السياق بعد فحص جديد. وقد يُسمّى سجل سبق الحديث عنه إذا أكدت قراءة حالية مسموح بها مطابقته لجميع مرشحات المطابقة التامة المدعومة في إحدى قراءات الاختيار لهذا السؤال. ليس مطلوبًا أن يكون ضمن أول صفوف النتائج، لكن ذكره سابقًا أو وجود عدد فقط لا يكفي. إذا تعذّر إثبات هذه العلاقة، فاطلب قائمة أو اذكر السجل؛ ولا تفترض أن طلبًا سابقًا ينتمي إلى المجموعة المعدودة. إذا قال Chat لم أتمكن من تحديد السجلات من نتائج هذا السؤال. اطلب عرضها، أو اذكر السجل الذي تقصده، فاطلب منه عرض السجلات المطابقة أو اذكر الطلب المقصود؛ ولا تستنتج هوية شخص من العدد.
تحذف ملخصات المهام مراجع الحالات الداخلية ذات الشكل الآلي. لكن البحث عن سجل مرتبط المستخدم في مقترح المهمة يتبع مسارًا منفصلًا، وقد يرسل مفتاح السجل الخاص به إلى الإجابة ويعرضه على بطاقة المقترح؛ ولا يضمن مرشح ملخص المهمة إخفاء كل هذه المفاتيح. قد تظهر مراجع تجارية مقروءة مثل LR-1005 أو INV-2026-11-0001 إذا سمح المصدر بذلك. إذا عرضت بطاقة المقترح مفتاحًا مولّدًا أو غير مألوف، فلا تؤكد الإجراء اعتمادًا على هذا الاسم. افتح عرض المهمة أو السجل المعتاد المسموح به وتحقق من الهدف، أو اطلب من مالك التطبيق تحديده.
لا يرسل App Chat قيم النموذج غير المحفوظة تلقائيًا. إذا كان سؤالك يعتمد على قيم لم تُحفظ، فاستخدم النموذج المعتاد أو احفظها عبر مساره الطبيعي أولًا. اسأل فقط عن معلومات من المصادر التي وافق عليها الناشر ولديك صلاحية قراءتها حاليًا.
يظل التطبيق العادي قابلًا للاستخدام عندما يكون الذكاء الاصطناعي متوقفًا أو غير متاح. إذا لم يظهر زر المحادثة، فقد تكون الدردشة غير مفعلة لهذا التطبيق أو قد لا تتوفر لك صلاحية مصدر معتمد. عدم الظهور لا يمنح صلاحية جديدة، ولا ينبغي أن يؤدي إلى طلب شبكي من الدردشة.
دردشة Home — تصميم غير متاح للمستخدم
لا توجد دردشة Home للمستخدم حاليًا. لا يتضمن المصدر الحالي إعدادًا أو مسارات API أو زرًا أو لوحة دردشة لـ Home. استخدم Chat داخل App Shell منشور إذا ظهر زر التطبيق وكانت لديك صلاحية الوصول.
يعرف مصدر توجيه مزودي الذكاء الاصطناعي غرضًا منفصلًا اسمه home-app-chat، لكن لا توجد حاليًا إعدادات أو مسارات أو واجهة Home Chat. لا يؤدي اسم الغرض وحده إلى إتاحة ميزة للمستخدم. يظل إعداد App Shell المنشور مستقلًا.
تتضمن فكرة Home Chat المقترحة استكمال مهمة أو التعليق عليها بعد إعادة التحقق من الصلاحية والتأكيد الصريح. هذا المسار غير متاح للمستخدم حاليًا.
لمسؤولي المنصة
لا يوجد في المصدر الحالي إعداد inflow.home.app-chat.enabled أو واجهة Home Chat. يظهر home-app-chat فقط كاسم غرض لتوجيه المزود؛ ولا ينشئ هذا الاسم شاشة أو يمنح صلاحية.
إذا أُطلقت هذه الميزة مستقبلًا، فيجب تأهيل توجيهها ومضيفها قبل الاستخدام. لا تغيّر افتراضيات app-chat الخاصة بـ App Shell المنشور أو studio-agent الخاص بـ Ask Inflow لهذا الغرض. تُحفظ بيانات اعتماد OpenRouter في مخزن الاعتمادات الآمن من جهة الخادم فقط؛ لا تضعها في custom_config.properties أو ملف متعقّب أو حالة المتصفح أو أدلة الإثبات. وجود اسم غرض مزود لا يهيئ اتصالًا ولا يثبت طلبًا ناجحًا للمزود.
للناشرين
- افتح شاشة
APPSHELLالمقصودة في Interface Designer. - انشر محتوى المساعدة أولًا، ثم افتح App Chat في Interface Designer. الدردشة متوقفة افتراضيًا؛ فعّل Enable App Chat.
- اختر تسمية اختيارية في Chat launcher label.
- تحت Approved App Sources، اختر Source type وPermitted source، وأدخل Display label اختياريًا ثم اضغط Add source. تشمل الأنواع الظاهرة Record Type وTask Inbox وGuidance Document وProcess Guidance وInterface Help. اختر من الخيارات المتاحة والمسموح بها فقط؛ لا تخمّن معرّفًا ولا تكتبه يدويًا. بالنسبة إلى Interface Help، تعرض القائمة مستند المصمم الحالي وصلاحيات عرض الشاشة، ولا تتحقق من حالة النشر؛ تحقّق بشكل مستقل من نشر صفحة المساعدة المحددة.
- تحت Approved App Actions، اختر Action type وPermitted action، وأدخل Display label اختياريًا ثم اضغط Add action. أضف إجراءً فقط إذا كان هدفه ومعالجه الحاليان مدعومين، مثل إجراء مهمة أو سجل أو عملية أو نموذج منشور. وجود النوع في القائمة لا يثبت أن الهدف صالح لهذا التطبيق؛ ويجب أن يطلب الإعداد المحفوظ تأكيدًا صريحًا.
- احفظ مسودة App Shell وانشر الإصدار الجديد بعد إضافة المصادر أو الإجراءات. تعديل المسودة وحده لا يغير التطبيق المنشور. تحقّق من التطبيق المنشور ومن وصول قارئ عادي مخوّل على حدة.
كل مصدر أو إجراء مضاف يضيّق إعداد التطبيق ولا يمنح المستخدم صلاحية الوصول الأساسية إلى السجل أو المهمة أو المستند أو العملية. تحكم الصلاحيات الحالية وسياسة النموذج والبيئة في ظهور الدردشة ومحتواها. فعّل كل تطبيق مقصود على حدة؛ لا تفعّل جميع التطبيقات دفعة واحدة.
مؤشرات واجهة الناشر الحالية:
- الإعدادات:
interface.designer.app-chat.settings - التفعيل والتسمية:
interface.designer.app-chat.enabledوinterface.designer.app-chat.label - إضافة مصدر:
interface.designer.app-chat.source.kindو.targetو.add - إضافة إجراء:
interface.designer.app-chat.action.kindو.targetو.add
مؤشرات واجهة المستخدم داخل التطبيق تُبنى على agentBase الفعلي للمضيف، وتشمل ${agentBase}.app-chat.toggle و${agentBase}.app-chat.panel و${agentBase}.app-chat.prompt و${agentBase}.app-chat.send و${agentBase}.app-chat.proposal.{id}.confirm. لا تستخدم بادئات أو مسارات من وصف أقدم لم يثبتها المضيف الحالي.
حدود الميزة وحالة التحقق
لا يفعّل وجود إعداد أو مثال أو شاشة منشورة مزود الذكاء الاصطناعي. تتطلب الإجابة المستندة إلى المصدر سياسة بيئة معتمدة ومصدرًا مفهرسًا ومتاحًا حاليًا. فتح Home أو التطبيق لا ينبغي أن يبدأ اتصالًا بمزود الذكاء الاصطناعي.
مثال Home Training يتضمن نسخة معطلة للاستخدام العادي ونسخة اختيارية مهيأة للمساعدة، بلا إجراءات أو بيانات اعتماد. استيراد المثال يغير مسودة الشاشة فقط؛ ولا ينشرها أو يمنح صلاحيات أو يثبت جاهزية الفهرسة والمزود. راجع دليل مثال Home Training ودليل Home.
هذا الدليل يشرح الاستخدام والإعداد المقصودين. لا يثبت تفعيل تطبيق في بيئة تشغيل أو نجاح رحلة المستخدم. يبقى تأهيل النشر، وصلاحيات المصدر، والذكاء الاصطناعي الفعلي، والتأكيدات، واختبارات العربية وRTL ضمن بوابات SCRUM-4924. تركز حزمة الأدلة اليدوية الحالية على لقطات شاشة مشروحة؛ لا تتطلب فيديوهات سردية.