العمل اليومي

استخدام بوت مساحة العمل

ابدأ Archibot داخل code-server وضعه في العمل: ما الذي يعرفه عن بيئة Archibus لديك، وما الذي يستطيع وما لا يستطيع فعله، ومطالبات جاهزة للاستخدام، وكيف يختلف عن دردشة Console.

أعضاء العملاءمسؤولو العملاءمشغّلو المنصة

آخر تحديث 19 يونيو 2026

تأتي كل مساحة عمل Archibus مزوَّدة بـ Archibot، وهو مساعد ذكاء اصطناعي مُدار يعمل داخل مساحة العمل ويفهم بيئة Archibus لديك مسبقًا. يستطيع قراءة كودك، والتحقق من عروض AXVW، وتنفيذ استعلامات للقراءة فقط على قاعدة بيانات مساحة العمل، والبحث عن الأشياء في مرجع Archibus، وقيادة التطبيق قيد التشغيل — كل ذلك دون أن تربط مفاتيح أو سياقًا. هذا الدليل موجّه لأي شخص يعمل في code-server، أيًا كان دوره.

أما عن بقية البيئة المحيطة به — المحرر، والتطبيق، وقاعدة البيانات — فراجع Work inside your workspace.

بدء تشغيل البوت

أمامك طريقتان للدخول:

• الطرفية. افتح طرفية في code-server (Terminal ← New Terminal) ونفّذ archibot start. يؤدي ذلك إلى إطلاق جلسة مُدارة — وهي في الأساس واجهة Codex CLI مُدارة مضبوطة لـ Archibus.
• لوحة المحرر. افتح لوحة Archibot من الشريط الجانبي للمحرر واكتب في مربع رسائلها — دون الحاجة إلى طرفية. يبدأ خيار Start Archibot في اللوحة جلسةً.

لا تحتاج إلى تسجيل الدخول. تحتفظ مساحة العمل بمفتاح مُدار مسبقًا، لذا يكون البوت جاهزًا في اللحظة التي تكون فيها مساحة العمل جاهزة. وإذا لم يُعثر على archibot، فقد لا يتضمن قالب مساحة العمل لديك Archibot المُدار — راجع ذلك مع مسؤول حسابك.

الدردشة من لوحة المحرر

أتفضّل البقاء في المحرر بدلًا من طرفية؟ افتح لوحة Archibot من الشريط الجانبي واستخدم مربع الرسائل في الأسفل. تحتوي اللوحة على أوضاع Chat وAgent وFull Access: استخدم Chat للأسئلة عن الملف أو المشروع الذي تعمل فيه، وAgent للسماح لـ Archibot بإجراء تغييرات في مساحة عملك، وFull Access لمنحه نطاقًا أوسع للتصرف في مساحة العمل. إنه يتحدث إلى البوت المُدار نفسه، بمهارات Archibus نفسها، التي في الطرفية — فاختر ما يناسب اللحظة.

ما الذي يعرفه ويستطيع فعله

أُعدّ Archibot بصفته مساعد مطوّر Archibus وWebCentral. وهو قادر منذ البداية على:

• العمل مع عروض AXVW — إنشاء هيكل عرض جديد، وشرح عرض موجود، والتحقق منه مقابل قواعد Archibus، مع الإبلاغ عن المشكلات المحددة التي يجب إصلاحها.
• قراءة قاعدة البيانات بأمان — تنفيذ استعلامات من نوع SELECT على قاعدة بيانات مساحة العمل لفحص المخطط، أو الاطلاع على صفوف نموذجية، أو تأكيد مصدر بيانات. النتائج محدودة عدد الصفوف وتحترم قيود العرض.
• تأليف مصادر البيانات وقواعد سير العمل والنماذج — والتحقق منها مقابل أعراف Archibus قبل أن تربطها.
• البحث عن الأشياء — البحث في مرجع Archibus المُجمَّع ومساعدة المنتج بدلًا من التخمين.
• رؤية التطبيق قيد التشغيل — فتح التطبيق الحي في متصفح بلا واجهة لتأكيد عرض ما أو لإعادة إنتاج مشكلة.
• التعامل مع أعمال البناء والتشغيل الروتينية — قراءة السجلات، وإعادة تشغيل Tomcat، واجتياز خطوات النشر أو الترحيل.

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

ما الذي لن يفعله

• لن يغيّر قاعدة البيانات. أداة الاستعلام لديه للقراءة فقط — بلا UPDATE أو INSERT أو DELETE. لا تزال تغييرات المخطط والبيانات تمر عبر عمليات الترحيل والمراجعة المعتادة لديك.
• لن يسرّب الأسرار. تُحجب مفاتيح المزوّد ويُعطَّل استرجاع بيانات الاعتماد الخام، وهو مُوجَّه للإبقاء على الرموز والمفاتيح وبيانات العملاء الخام بعيدًا عن الملفات والملاحظات وأي شيء يحفظه. التزم أنت بالخط نفسه.
• يتصرّف على ملفات مساحة عملك — راجع تعديلاته كما تراجع تعديلات زميل قبل إيداعها.

وصفات

مطالبات ملموسة لتجربتها. كن محددًا ووجّهه إلى الملف أو الجدول الذي تقصده؛ فكلما كنت أدقّ، كانت النتيجة أفضل.

بناء عرض AXVW

“أنشئ عرض AXVW يسرد الغرف لمبنى محدّد، مع مرشّح للمبنى وأعمدة لاسم الغرفة والمساحة والفئة. تحقّق منه وأصلح أي مشكلات قبل أن تنهي.”

التحقق من عرض موجود وإصلاحه

“تحقّق من schema/ab-products/.../my-view.axvw وأرشدني خطوة بخطوة لإصلاح كل خطأ تجده.”

فحص البيانات قبل البناء

“أرني الأعمدة في جدول rm، ثم أعِد 20 غرفة نموذجية مع المبنى والطابق الخاصين بها.”

إضافة قاعدة سير عمل

“أضف قاعدة سير عمل ترسل بريدًا إلكترونيًا إلى مدير المساحة عند تغيّر فئة غرفة، وأرني أين هي مسجّلة.”

العمل على نموذج

“في هذا النموذج، أضف حقل مستند للمخططات الطابقية وتحقّق من عناصر تحكم النموذج.”

تتبّع مصدر بيانات

“اعثر على مصدر البيانات وراء هذه اللوحة وأضف قيدًا بحيث يعرض السجلات النشطة فقط.”

معرفة سبب عدم ظهور تغيير

“تغيير العرض لدي لا يظهر في التطبيق. افحص سجلات Tomcat، وأخبرني بما هو خاطئ، وأعد تشغيل Tomcat إذا كان ذلك هو الحل.”

تأكيد أنه يُعرض

“افتح قائمة الغرف الجديدة في المتصفح وأكّد أنها تُحمّل دون أخطاء.”

البحث عن شيء ما

“كيف يتعامل Archibus مع تعدّد العملات في سجلات الإيجار؟ استشهد بالمرجع.”

إرساله للمراجعة

“لخّص التغييرات التي أجريتها، ثم قدّمها لمراجعة CI.”

يستخدم الطلب الأخير archibot-submit-review، الذي يحزم تغييراتك لتدفّق CI Review في Console — راجع Persistent environments and CI Review.

يُجرى التحقق وعمليات البحث في قاعدة البيانات عبر أدوات Archibus المدمجة في Archibot — وهنا يتحقق من عرض AXVW:

عندما تطلب منه تغيير شيء ما، يحرّر Archibot الملفات في مكانها ويظهر التغيير في Source Control، جاهزًا لتراجعه كأي تعديل آخر.

احتفظ بجلستك

ترتبط المحادثة بوقت تشغيل مساحة العمل. اسرد الجلسات السابقة بـ archibot sessions list وأعد فتح إحداها بـ archibot start --session <name>؛ بينما يبدأ archibot start بمفرده محادثة جديدة. لا تبقى الجلسة بعد عملية إيقاف/بدء أو إعادة بناء مساحة العمل، لذا عندما ينتج البوت شيئًا يهمّك — ملخّصًا، أو خطة، أو ملفًا مُولّدًا — احفظه: أودِعه في git، أو انسخه إلى Shared Drive. لا تعتمد على التمرير للخلف إلى طرفية ستمسحها إعادة التشغيل.

بوت مساحة العمل مقابل دردشة Console

يوجد Archibot أيضًا بصفته دردشة في المتصفح ضمن Console (Using ArchibotChat). يتشاركان المهارات ومعرفة Archibus نفسها، لكنهما يعملان في أماكن مختلفة:

• بوت مساحة العمل له يدان على مساحة عملك — فهو يقرأ ملفاتك، وينفّذ استعلامات على قاعدة بياناتك، ويعيد تشغيل تطبيقك، ويحرّر الكود في مكانه.
• دردشة Console تعمل في المتصفح وهي جيدة للأسئلة والتخطيط والمراجع عندما لا تكون داخل مساحة عمل.

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

أوامر أخرى

• archibot status وarchibot doctor — تحقّق من أن الجلسة المُدارة وأدواتها بحالة سليمة.
• archibot capabilities — اسرد ما يستطيع البوت المُدار فعله في مساحة العمل هذه.
• archibot skills list — اطّلع على مهارات Archibus المتاحة له.
• archibot versions — اعرض إصدارات الأداة والصورة المُدارة المستخدَمة.
• archibot feedback — أرسل ملاحظات منقّاة إلى فريق المنصة.
• archibot-v2 وarchibot-cc وcursor-agent — مساعدون مُدارون بأسلوب Cursor وأسلوب Claude، إذا كنت تفضّل تلك الواجهات. وهي تستخدم الوصول المُدار نفسه.

أدلة ذات صلة

• Work inside your workspace — المحرر والتطبيق وقاعدة البيانات والسجلات التي يعمل البوت عليها.
• Using ArchibotChat — نسخة الدردشة في المتصفح ومصادر سياقها.
• Workspace Archibot and Shared Drive — أين تحفظ ما ينتجه البوت.
• Persistent environments and CI Review — ما الذي يحدث بعد أن تقدّم التغييرات للمراجعة.
• Troubleshooting — الخطوات الأولى عندما يسيء البوت أو التطبيق التصرّف.