QuickAgent - الدليل

دليل مستخدم QuickAgent

QuickAgent مساحة عمل لوكلاء AI تضع العمل المحلي أولاً. يحوّل هدفاً إلى Run دائم، ويقيّد ذلك الـ Run باستخدام Workspace Profile، ويطلب المراجعة قبل الإجراءات الحساسة، ويحتفظ بالنتائج المتحققة في Artifacts.

البدء

افتح Settings > AI، أضف موفراً، وشغّل اختبار الاتصال الخاص به.
افتح Settings > Workspace Profiles. اختر الموفّر والأدوات والاتصالات وجذور الملفات ومصادر Knowledge ونطاقات Memory التي يجوز استخدامها.
حدد New Chat، واختر ملف التعريف، وأكّد وجهة الموفّر المعروضة أعلى المحادثة.
صِف نتيجةً. أضف فقط الملفات والمجلدات والوسائط وKnowledge أو Memory اللازمة لهذا الـ Run.
راجع الخطة والموافقات والتأكيد Critical ومعاينة إرسال البيانات عند ظهورها.
تتبّع العمل في Timeline. افتح المخرجات المكتملة من Artifacts وافحص مسار التدقيق في السجل.

نصيحة: ابدأ بـ Workspace Profile محدود. وسّع أدواته أو جذوره فقط عندما يعرض QuickAgent سبباً محدداً لعدم الإتاحة.

نظرة عامة على الواجهة

القسم	الغرض منه
المحادثات	المحادثات ووجهة الموفّر وContext Tray والخطط والموافقات وRun Timeline النشط.
عمليات التشغيل	كل مهمة مخططة أو قيد التشغيل أو متوقفة مؤقتاً أو مجدولة أو فاشلة أو مكتملة.
صندوق وارد الموافقات	مراجعات الإجراءات المعلقة وCritical وإرسال البيانات التي تحتاج إلى قرارك.
Artifacts	ملفات وتقارير وسجلات ووسائط وجداول وبيانات عمليات متحققة أنشأتها Runs.
الأتمتة	الجداول الزمنية والمراقبات وخطافات الويب وأحداث التطبيقات ومشغلات Shortcut/App Intent.
Skills	تعليمات قابلة لإعادة الاستخدام تتضمن مدخلات محددة النوع وأدوات مسموحة واتصالات مطلوبة ومستوى المخاطر والمخرجات.
الاتصالات	الموفّرون وملفات المتصفح وجذور الملفات/VFS وSSH وMCP وHTTP/SaaS وجسور المنزل وقنوات الإشعارات.
Knowledge	مجلدات مفهرسة ومحتوى QuickNote ومقتطفات الويب وملفات PDF ومصادر Office.
السجل	قرارات سلامة وإجراءات أدوات ووجهات وطوابع زمنية قابلة للإلحاق فقط.
الإعدادات	المظهر واللغة وAI والأدوات والسلامة وWorkspace Profiles والاختصارات والأذونات والمساعدة وPro.

الموفّرون وWorkspace Profiles

يمكن لـ QuickAgent استخدام System AI عندما يوفّر نظام التشغيل قدرة متوافقة، وموفّرات محلية مثل Ollama أو LM Studio أو DeskLLM، ونقاط نهاية LAN أو OpenAI-compatible مخصصة، وموفّرات سحابية مُعَدّة مثل Anthropic أو Gemini. يتحدد التوفر من خلال اختبار قدرة مباشر؛ فاسم الموفّر وحده لا يعني أنه جاهز.

Workspace Profile هو غلاف أذونات الـ Run. يلتقط لقطة للموفّر/النموذج المحدد والأدوات المسموحة والاتصالات وجذور الملفات ومصادر Knowledge ونطاقات Memory وتجاوزات السلامة والميزانية. يجعل تغيير الإعداد لاحقاً اللقطة قديمة ويتطلب مراجعة.

قاعدة الوجهة: لا ينتقل QuickAgent بصمت أبداً من موفّر على الجهاز أو محلي إلى السحابة. تظل الوجهة النشطة ظاهرة في Chat وفي كل مراجعة لإرسال البيانات.

Runs والموافقات والاسترداد

عناصر تحكم Run

إيقاف مؤقت يطلب توقفاً تعاونياً عند نقطة تحقق دائمة.
استئناف يتابع الـ Run نفسه والعمل المكتمل.
إيقاف يلغي عمل الموفّر والأدوات. لا يُبلّغ عن تأثير خارجي متوقف أو غير مؤكد على أنه نجاح.
إعادة المحاولة تتوفر فقط عندما يستطيع QuickAgent تحديد حد آمن لإعادة المحاولة.

مستويات السلامة

المستوى	المعنى
آمن	اقرأ أو افحص أو حوّل ضمن ملف التعريف النشط.
موافقة	راجع عملية كتابة عادية أو إجراءً خارجياً.
أكد أن	راجع تغييراً ذا تأثير أعلى أو أصعب في الرجوع عنه.
Critical	تأكيد قوي في كل مرة؛ لا توافق القواعد عليه تلقائياً مطلقاً.

تعرض الموافقة الهدف الدقيق والوجهة والوسائط المقترحة والمخاطر وحالة التراجع. إذا حررت وسيطاً، يتحقق QuickAgent من الإجراء المحرر ويفحص مخاطره مجدداً.

نتيجة غير مؤكدة: بعد حدوث مقاطعة، تحقق من النظام الهدف أولاً. اختر «تحققت — أعد المحاولة» فقط عندما يكون تكرار الإجراء مناسباً. «استئناف» وحده لا يكرر أبداً تأثيراً خارجياً غير مؤكد.

Runs متعددة الوكلاء

يمكن للأهداف المعقدة استخدام مخطط وعاملين متخصصين محددي النوع ومراجع ومراجع أمان. يعرض Timeline كل تسليم ومراجعة وإعادة محاولة وبديل وحدود الاستجابة النهائية. لا يتلقى العاملون إلا التقاطع الرباعي بين أدوات Skill وأدوات Workspace Profile وأدوات الدور والأدوات المتاحة حالياً.

تحد الميزانيات العالمية ولكل دور عدد الاستدعاءات والوقت والتكلفة وبايتات الشبكة والرموز. عند بلوغ ميزانية، يوقف QuickAgent مؤقتاً. يعرض الحدود الحالية والمقترحة، ولا يزيدها إلا بعد مراجعة صريحة. تستمر الميزانية المعتمدة وسجل الدور المكتمل بعد إعادة التشغيل.

السياق وKnowledge وذاكرة AI

Context Tray

أضف ملفات ومجلدات وصوراً وإطارات فيديو وصوتاً وملاحظات صوتية ومحتوى QuickNote أو Knowledge أو Workspace Memory. يستخرج QuickAgent المحتوى المدعوم أو يلخصه ويعرض ما إذا كان المرفق سيُرسل مباشرةً إلى موفّر.

Knowledge

تُفهرس مصادر Knowledge بصورة منفصلة عن المحادثة. لا يمكن لـ Run البحث إلا في المصادر التي يسمح بها Workspace Profile، وتحتفظ الاستشهادات بهوية مصدرها.

Memory

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

الأدوات والاتصالات

يغطي الكتالوج المباشر عمليات الملفات/VFS؛ وOffice وPDF والبيانات المهيكلة؛ والوسائط وOCR؛ واستخدام المتصفح والكمبيوتر؛ وأوامر التطوير؛ وSSH؛ وMCP؛ وHTTP وSaaS؛ وجسور المنزل الذكي؛ والإشعارات؛ والجداول؛ والمراقبات؛ والتحكم في الأتمتة. قد تضيف خوادم MCP المتصلة أدوات ديناميكية بعد التحقق من المخطط وإعادة QuickAgent لتقييم المخاطر.

Settings > Tools يوضح سبب جاهزية أداة أو تعطيلها. تشمل الأسباب الشائعة اتصالاً مفقوداً أو إذناً من نظام التشغيل أو نظاماً أساسياً غير مدعوم أو قيداً من Workspace Profile أو نقطة نهاية غير مختبرة أو قدرة موفّر غير متاحة.

استخدام الكمبيوتر: التقاط الشاشة والتحكم في إمكانية الوصول/الإدخال إذنان منفصلان. أبقِ المعاينة المرئية وزر الإيقاف الطارئ متاحين. لا توفر الأنظمة الأساسية المحمولة التحكم نفسه غير المقيد على سطح المكتب.

الأتمتة

يمكن أن تبدأ الأتمتة من الوقت أو ملف/مجلد أو الويب أو خطاف ويب أو البريد الإلكتروني أو التقويم أو الشبكة أو المضيف أو الجهاز أو المستشعر أو الموقع أو حدث التطبيق أو Shortcut/App Intent أو الأمر أو المشغلات اليدوية عندما يدعمها النظام الأساسي. ينشئ المشغّل Run عادياً؛ ولا يتجاوز Workspace Profile أو فحوصات الموافقة أو Critical أو إرسال البيانات.

تستمر مراقبة سطح المكتب فقط أثناء تشغيل عملية التطبيق.
تستعيد الأنظمة الأساسية المحمولة العمل المتأخر عند عودة التطبيق إلى المقدمة.
استخدم Shortcut/App Intent أو مرحّل أحداث موثوقاً عندما يكون تسليم نظام التشغيل مطلوباً.
تظل الأحداث في قائمة الانتظار والإيقاف المؤقت والإلغاء والحذف صريحة، حتى لا تُهمَل الأحداث بصمت.

Skills وحزم Skills

تخزن Skill مطالبة تركز على النتيجة ومتغيرات محددة النوع وتوصية بالموفّر وأدوات مسموحة واتصالات وقدرات مطلوبة وأقصى مستوى للمخاطر وArtifacts متوقعة. قبل الاستخدام، يعرض QuickAgent المدخلات والأذونات الفعلية؛ ولا تمنح المعاينة الإذن بحد ذاتها.

توفر سبع حزم مدمجة Skills حقيقية لـ Office والبرمجة والمنزل الذكي والبحث وأتمتة المتصفح والإدارة الشخصية والاستجابة للحوادث. يمكنك تثبيت Skills وتحديثها وإلغاء تثبيتها وتخصيصها وتكرارها واستيرادها وتصديرها. يتلقى JSON المستورد معاينة للثقة والناشر والتوقيع والإذن والمخاطر والنظام الأساسي والتعارض. ينشئ «الاحتفاظ بكليهما» مشتقاً محلياً غير موقّع بدلاً من وراثة ثقة ناشر آخر.

Artifacts والسجل والتراجع

تحتفظ Artifacts ببايتات المخرجات والبيانات الوصفية والإصدارات والأصل وRun المصدر وبيانات العمليات. وفقاً لقدرات النظام الأساسي، يمكنك فتحها أو مشاركتها أو تصديرها أو إظهارها. تعرض العمليات المؤهلة تراجعاً تمت مراجعته؛ ولا يُعاد تشغيل العمل المتلف أو غير المؤكد تلقائياً أبداً.

السجل قابل للإلحاق فقط. رشّحه حسب آمن أو موافقة أو تأكيد أو Critical، وصدّر التدقيق عندما تحتاج إلى سجل خارجي.

الإعدادات

عام: المظهر واللغة وملفات تعريف مساحة العمل والاختصارات والمساعدة والأذونات.
الذكاء الاصطناعي: المزوّدون ونقاط النهاية والنماذج وبيانات الاعتماد والاختبارات المباشرة.
الأدوات: جاهزية الكتالوج ودعم المنصات وأسباب الإعداد.
الأمان: قواعد الموافقة وسلوك إرسال البيانات ومصادقة الجهاز وسياسة الذاكرة المحددة النطاق.
متقدم: الاسترداد والتشخيصات المخصّصة لاستكشاف الأخطاء وإصلاحها.

اختصارات لوحة المفاتيح

على macOS، يربط التطبيق المعروض Ctrl بالاختصارات المناسبة لمفتاح Command الخاص بالمنصة. وتُعد صفحة الاختصارات داخل التطبيق المرجع المعتمد وتدعم التخصيص.

الاختصار	الإجراء
`Ctrl` + `N`	New Chat
`Ctrl` + `L`	تركيز المؤلف
`Ctrl` + `Shift` + `Space`	إيقاف التشغيل النشط مؤقتًا أو استئنافه
`Ctrl` + `.`	إيقاف التشغيل النشط
`Ctrl` + `1` … `9`	فتح الدردشات عبر السجل
`Ctrl` + `,`	فتح الإعدادات
`F1`	افتح المساعدة & الخصوصية
`Esc`	إغلاق مربع حوار أو إلغاء التفاعل الحالي غير المدمّر

ملاحظات المنصة

المنصة	الحدود المهمة
macOS	معزول في وضعي Debug وRelease. يستخدم الوصول إلى الملفات الجذور المحددة/إشارات الأمان ذات النطاق المحدد. يُعد تسجيل الشاشة وإمكانية الوصول أذونَي نظام منفصلين. تظل عمليات التكامل مع العمليات المحلية والاختصارات خاضعة لاختبار الإمكانات.
Windows	تعتمد ميزات الملفات وOffice/PDF/البيانات والمتصفح والتطوير والوصول عن بُعد والتحكم بسطح المكتب على بيئة التشغيل والأذونات المثبّتة. لا تتوفر عمليات التكامل المخصّصة لـ Apple مع إظهار السبب بوضوح.
iPhone / iPad	تستخدم الملفات منتقي النظام. يُطلب الوصول إلى الكاميرا والميكروفون والتعرّف على الكلام والصور والشبكة المحلية والإشعارات بحسب السياق. لا تُضمن المراقبة في الخلفية؛ استخدم Shortcuts/App Intents أو الاستدراك في المقدمة.
Android	تستخدم الملفات والمجلدات Storage Access Framework. يتبع العمل في الخلفية قيود Android. لا يُعد التحكم بالإدخال المستند إلى إمكانية الوصول ممنوحًا لمجرد إعلان خدمة.
الويب	يستخدم تخزين الجلسة فقط للميزات التي تتطلب استمرارية أصلية، ويعطّل بوضوح إمكانات الجهاز وجذر الملفات والعملية المحلية والخلفية غير المدعومة.

نصائح & حيل

ابدأ بملف تعريف مساحة عمل محدود، وأضف أداة أو اتصالًا أو جذر ملفات فقط عندما يُظهر التشغيل متطلبًا محددًا.

امنح كل طلب نتيجة واضحة ومخرجًا متوقعًا وحدًا للمراجعة كي يظل التقدم سهل التدقيق.

استخدم Knowledge للمصادر المفهرسة القابلة لإعادة الاستخدام وContext للمواد المطلوبة للتشغيل الحالي فقط.

عندما يكون تأثير خارجي غير مؤكد، افحص الوجهة قبل إعادة المحاولة؛ لا يكرر Resume ذلك تلقائيًا أبدًا.

استكشاف الأخطاء وإصلاحها

المشكلة	ما يجب التحقق منه
يتعذر على المزوّد التشغيل	افتح Settings > AI. تحقق من الإعدادات والمصادقة وقدرات النموذج وإمكانية الوصول إلى نقطة النهاية والمهلة وتفاصيل حد المعدل، ثم شغّل اختبار الاتصال.
أداة معطّلة	افتح Settings > Tools واقرأ السبب المباشر. راجع المنصة الحالية والإذن واختبار الاتصال وملف تعريف مساحة العمل والجذر المحدد.
يبدو أن التشغيل عالق	افتح Runs وTimeline. قد يكون متوقفًا مؤقتًا أو بانتظار إدخال أو موافقة أو تأكيد Critical أو مراجعة إرسال البيانات أو مراجعة الميزانية. يظل الإيقاف متاحًا.
تغيّر إذن	افتح Help > Overview أو Settings، ثم افتح إعدادات النظام. أعد اختبار الاتصال أو الأداة المتأثرة بعد العودة.
إجراء خارجي غير مؤكد	تحقق من النظام الهدف. أبقِ التشغيل متوقفًا مؤقتًا أو أوقفه ما لم تتحقق من أن إعادة المحاولة مناسبة.
لم يتم تشغيل Automation في الخلفية	لا تضمن أنظمة تشغيل الأجهزة المحمولة الاستقصاء العشوائي. عُد إلى المقدمة للاستدراك أو اضبط Shortcut/App Intent أو مصدر أحداث موثوقًا.
لا يمكن فتح Artifact أو تصديره	تحقق مما إذا كانت بياناته الثنائية لا تزال متاحة، وما إذا كانت المنصة تدعم الإجراء، وما إذا كان إذن الوجهة المختارة لا يزال صالحًا.

الخصوصية والأذونات والتراخيص

يخزن QuickAgent المحادثات وعمليات التشغيل والموافقات وبيانات Knowledge الوصفية وSkills والإعدادات محليًا. تستخدم بيانات الاعتماد تخزينًا محميًا من المنصة. لا يغادر المحتوى الجهاز إلا عبر مزود أو خدمة متصلة تضبطها، وتتلقى الإرسالات الخارجية معاينة تراعي الوجهة.

تُطلب الأذونات بحسب السياق: الملفات/المجلدات والصور والكاميرا والميكروفون والتعرّف على الكلام والشبكة المحلية والإشعارات وتسجيل الشاشة والتحكم بإمكانية الوصول/الإدخال مستقلة. تؤدي إزالة إذن إلى عدم إتاحة الإمكانية المتأثرة بدلًا من إظهار نجاح زائف.

افتح Settings > Help & Privacy للاطلاع على جدول إمكانات المنصة الحالية و تراخيص مفتوحة المصدر للإشعارات المتعلقة بالحزم والمكونات الأصلية المضمّنة.

Free وPro: تظل جميع ميزات الوكيل متاحة في Free. التجربة لمدة سبعة أيام بلا إعلانات؛ وبعدها قد تعرض الأجهزة المحمولة إعلانات وقد يعرض سطح المكتب تذكيرًا يوميًا. يزيل Pro هذه الرسائل عبر اشتراك سنوي أو شراء مدى الحياة.