AgentX عمليًا 5: تعرّف على لوحة التحكم

في الجزء 3 أنشأت وكيلًا، وأعطيته معلومات، وتحققت من أجوبته في نافذة اختبار صغيرة. هذا يثبت أن الوكيل يعمل، لكنه لا يخبرك كيف تراقبه حين يبدأ عملًا حقيقيًا.

هذه هي وظيفة لوحة التحكم. في هذا الجزء تتابع مهمة واحدة من أولها إلى آخرها عبر أربع صفحات: تنشرها في Hub، وتراها تعمل في Live، وتجدها بعد انتهائها في Activity، وتقرأ ما تعتبره صفحة Monitor ما زال بحاجة إليك.

هذا هو الجزء 5 من سلسلة AgentX عمليًا، وهي أدلة قصيرة ينتهي كل جزء منها بشيء واحد يعمل.

ما الذي ستحصل عليه في النهاية

• مهمة أعطيتها لوكيل من لوحة التحكم، مع جوابها.
• المهمة نفسها في كل صفحة من الصفحات الأربع، لتعرف أي صفحة تجيب عن أي سؤال.
• عنصر في Monitor عالجته وأزلته من القائمة.

AgentX جزء من برنامج منتجات Noqta وما زال تجريبيًا. في هذا الإصدار ستصادف عقبتين صغيرتين، في الخطوتين 3 و8، ولكل منهما حل يستغرق ثواني.

المتطلبات

• AgentX مع وكيل واحد يعمل، من الجزء 3: وكيل على Claude Code وفي ملف CLAUDE.md الخاص به بعض المعلومات.
• الإصدار 0.206.0 من AgentX أو أحدث. تحقق بالأمر agentx --version. للإصدارات الأقدم لوحة تحكم مختلفة، فيها شريط تبويبات في الأعلى بدل قائمة على اليسار. للتحديث، أعد تشغيل أمر التثبيت من الجزء 2.
• متصفح وطرفية.

كيف شغّلناه. كما في الأجزاء السابقة، شغّلنا كل شيء في مجلد منزلي نظيف ومنفصل، على جهاز Mac يشغّل نسخة أخرى من AgentX. استخدمت الخدمة الخلفية التجريبية المنفذ 19021 ولوحة التحكم المنفذ 19031. عندك ستظهر القيم الافتراضية: 18800 و4202. سمّينا حاسوبنا my-laptop واختصرنا مسارات المجلدات. وكيل الاختبار عندنا كان الوكيل المبدئي Assistant، مع معلومات ساعات العمل نفسها التي أعطيناها لوكيل Support في الجزء 3. إذا اتبعت الجزء 3، فأرسل مهمتك إلى @support.

الخطوة 1: شغّل الخدمة الخلفية ولوحة التحكم

الخدمة الخلفية (daemon) هي التي تشغّل الوكلاء. لوحة التحكم موقع صغير منفصل يعرض ما تفعله هذه الخدمة. من مجلد my-agentx، تحقق من الخدمة:

agentx daemon status

  my-laptop (my-laptop)
  Status: running — uptime 21s
  AgentX 0.206.0 (6dac66d)   node my-laptop
  ...
  Agents:
    Assistant (claude-code)
      /Users/you/my-agentx/agents/assistant
 
  Dashboard: http://127.0.0.1:4202

إذا ظهرت AgentX is stopped، فشغّل agentx daemon start --detach. ثم شغّل لوحة التحكم في طرفية ثانية واتركها مفتوحة:

agentx board serve

الخطوة 2: افتح Hub

افتح http://127.0.0.1:4202 في متصفحك. تنفتح صفحة Hub، وهي الصفحة الرئيسية للوحة التحكم.

ثلاثة أمور يجب معرفتها عن هذه الشاشة:

• القائمة على اليسار تجمع الصفحات: Work (فيها Live وRunning now وProjects وActivity)، وAutomation، وFleet، وOwner. الرقم بجانب كل صفحة يعدّ ما فيها.
• الوسط هو شريط المنشورات. كل مهمة تُعطى لوكيل تصبح منشورًا هنا، وجوابها تحته.
• أعلى اليمين يعرض الإصدار الذي تشغّله الخدمة الخلفية ومنذ متى. عندنا كان 0.206.0 · 6dac66d since Nov 3, 10:01 AM. إذا لم يظهر شيء، فلوحة التحكم لا تصل إلى الخدمة؛ عد إلى الخطوة 1.

لا تطلب لوحة التحكم كلمة مرور على حاسوبك. كل من يستخدم الحاسوب يستطيع استخدامها، لذا اقفل الشاشة حين تبتعد.

الخطوة 3: فعّل الطلبات

اكتب مهمة في الخانة أعلى شريط المنشورات، مثل @support Are you open on Saturday?، ثم اختر Post. على تثبيت جديد، هذا ما ظهر لنا:

Not posted: Requests are off on this computer, so nothing would give the agent the post.

المنشور في Hub هو طلب (request): يسجّله AgentX ويتابعه حتى يُنجز. هذه الميزة معطّلة في التثبيت الجديد. فعّلها في agentx.json، في المستوى الأعلى من الملف، بجانب agents:

"requests": { "enabled": true },

احفظ الملف. لا حاجة لإعادة تشغيل أي شيء: حفظناه والخدمة الخلفية تعمل، ومرّ المنشور التالي. في لوحة التحكم أيضًا مفتاح لهذه الميزة في Settings › Requests، لكننا لم نجرّبه.

الخطوة 4: أعطِ وكيلك مهمة

انشر المهمة نفسها مرة أخرى. هذه المرة تقول الخانة:

Posted: Assistant gets it within a minute, and its answer shows on the post.

الاسم بعد @ يحدد أي وكيل يتسلم المهمة. يظهر المنشور فورًا، وعليه in progress وNo result yet.

الخطوة 5: تابعها في Live

اختر Live من القائمة. تجيب Live عن سؤال واحد: ما الذي يعمل الآن؟ وتتحدّث كل ثانيتين ما دامت مفتوحة.

تحت Running now، كل بطاقة مهمة قيد التنفيذ. بطاقتنا كانت تقول my-laptop · requests · for 9 s، مع اسم الوكيل وما طُلب منه. ويعرض Latest آخر ما فعله. اختر البطاقة لتفتح المهمة وتتابعها لحظة بلحظة.

تحت Machines بطاقة لكل حاسوب يشغّل AgentX، مع عدد المهام التي تعمل عليه. لا تلمس Restart when idle الآن. فهو لا يعمل إلا إذا كان هناك مدير خدمات (launchd على Mac، أو systemd على Linux) يعيد تشغيل AgentX بعد توقفه، وAgentX الذي شُغّل من طرفية، كما فعلنا، ليس له مدير خدمات. الجزء 9 يشرح إعادة التشغيل الآمنة.

انتهت مهمتنا في أقل من عشر ثوانٍ، لذا قد تحتاج إلى النشر ثم الانتقال بسرعة إلى Live لتراها. بعد انتهائها تختفي البطاقة وتعرض Live Running now 0.

الخطوة 6: اقرأ الجواب في Hub

عد إلى Hub. الجواب على المنشور:

No, we are closed on Saturday. Our hours are Monday to Friday, 9:00–17:00.

جاء الجواب من المعلومات الموجودة في ملف CLAUDE.md الخاص بالوكيل، كما في الجزء 3. اختر Thread لقراءة المحادثة كاملة.

في الإصدار 0.206.0 بقي المنشور يحمل in progress بعد الجواب. السبب ميزة الطلبات من الخطوة 3، فهي تُبقيه مفتوحًا؛ ولم يعطّل ذلك شيئًا، والوكيل لم يكن ما زال يعمل.

الخطوة 7: ابحث عن التشغيل في Activity

اختر Activity من القائمة. تعرض Live ما يعمل الآن، أما Activity فتعرض ما عمل سابقًا، من الأحدث إلى الأقدم.

عندنا ظهر 1 run in the last 24 h, newest first: Assistant، وDone، والسؤال، وfrom a message on requests، و9 s.

• التبويبات تحت العنوان تفرز التشغيلات حسب طريقة انتهائها: All وDone وFailed وRunning وStopped.
• المرشّحات تحصر العرض في وكيل واحد أو مشروع واحد أو مصدر واحد (مهام مجدولة، أو سير عمل، أو منشورات Hub، أو رسائل).
• 24 h و7 d و30 d تحدد إلى أي مدى تعود في الزمن.

هذه هي الصفحة التي تفتحها حين يقول أحدهم «الوكيل لم يجبني». إذا كان التشغيل موجودًا وعليه Done، فقد أدّى الوكيل دوره. وإذا لم يكن موجودًا أصلًا، فالرسالة لم تصل إلى AgentX.

Timeline، بجانب Feed قرب العنوان، تفتح صفحة Activity القديمة، حيث يظهر كل تشغيل شريطًا في خط وكيله. وفيها أيضًا Map تُظهر كيف ينتقل العمل من وكيل إلى آخر، وتفيدك حين يصبح لديك أكثر من وكيل.

الخطوة 8: اعرف ما يحتاجك في Monitor

ما زالت Monitor صفحة من لوحة التحكم القديمة، لذا لها شكلها الخاص ولا تظهر في قائمة Hub. افتح http://127.0.0.1:4202/monitor.

بعد انتهاء كل مهمة، يطلب AgentX من Claude Code مراجعتها وتدوين ما بقي. وترتّب Monitor هذه الملاحظات في Only you (تحتاج إلى شخص)، وAgents can handle، وIn motion، وSession briefings. تستخدم المراجعة حساب Claude Code المسجّل على الحاسوب الذي يشغّل الخدمة الخلفية، وهو الحساب نفسه الذي يستخدمه وكيلك.

في المرة الأولى فشلت المراجعة عندنا. كان الشريط العلوي يقول 1 Review failed، والملخص في الأسفل يذكر هذا السبب:

Review failed
[ { "code": "too_small", "minimum": 1, ... "path": [ "actions", 1, "minutes" ] } ]

قدّر المراجِع إحدى المهام بصفر دقيقة، فرفض AgentX ملاحظة مراجِعه نفسه. لا علاقة لوكيلك بذلك. اختر Retry على الملخص. عندنا نجحت المحاولة الأولى: عادت Reviews failed إلى 0 وظهرت بطاقة تحت Only you.

لاحظ المراجِع أن لا شيء يبيّن من أين جاءت ساعات العمل التي ذكرها الوكيل، فطلب من شخص أن يؤكدها:

Confirm the real Saturday and weekday hours. If they differ from Mon–Fri 9–17,
correct the answer and add the hours to memory or the wiki so future answers
are grounded.

هذه هي فائدة Monitor: تخبرك بما لا يستطيع التحقق منه إلا شخص. وهنا تعرف أن الساعات صحيحة لأنك أنت من كتبها. اختر Done. تخرج البطاقة من القائمة، ولم تعد بعد أن أعدنا تحميل الصفحة. أما Snooze فيؤجّل البطاقة إلى وقت لاحق. لا يقوم أي من الزرّين بالعمل نفسه؛ وظيفتهما ترتيب القائمة فقط.

تحقق من أن كل شيء يعمل

1. يعرض Hub منشورك مع جواب الوكيل.
2. تعرض Activity، مع اختيار 24 h، التشغيل وعليه Done.
3. تعرض Live القيمة Running now 0 وحاسوبك تحت Machines.
4. تعرض Monitor على /monitor القيمة 1 / 1 تحت Nodes reporting، و0 تحت Reviews failed، ولا شيء تحت Only you بعد أن اخترت Done.

حل المشكلات

Not posted: Requests are off on this computer... أضف "requests": { "enabled": true } إلى agentx.json، كما في الخطوة 3.

الصفحة لا تفتح. لوحة التحكم لا تعمل. شغّلها بالأمر agentx board serve واترك الطرفية مفتوحة.

الصفحة تفتح، لكن الإصدار في أعلى اليمين غائب أو لا يظهر أي جهاز في Live. لوحة التحكم لا تصل إلى الخدمة الخلفية. شغّل agentx daemon status، وشغّل الخدمة إذا كانت متوقفة.

المهمة لا تظهر أبدًا في Live. ربما انتهت: المهام القصيرة تنتهي في ثوانٍ. ابحث في Activity. وإذا لم تجدها هناك أيضًا، فتحقق من وجود خطأ على المنشور في Hub.

اختيار تشغيل في Activity يفتح صفحة فيها محادثة فارغة وعلامة حمراء HTTP 404. رأينا ذلك في الإصدار 0.206.0 لمهمة نُشرت في Hub. الصفحة نفسها تقول إن التشغيل انتهى وإن محادثته موجودة حيث بدأت. اقرأ الجواب على منشور Hub بدلًا من ذلك.

Review failed في Monitor. اقرأ السبب على الملخص. خطأ التحقق الذي في الخطوة 8 زال بالضغط على Retry. وإذا كان السبب claude CLI not found on the daemon PATH، فـ Claude Code غير مثبّت للخدمة الخلفية: ثبّته، ثم سجّل الدخول بتشغيل claude مرة واحدة.

تبقى Monitor فارغة. المراجعات لا تبدأ إلا بعد انتهاء المهمة، وبعض الأعمال الروتينية لا تُراجع أبدًا. تحقق في Activity من أن المهمة انتهت.

التالي في السلسلة

الخطوة التالية تقرير يومي مجدول، ليؤدي الوكيل عملًا دون أن تطلبه منه كل مرة. أما وضع وكيلك على Telegram فهو الجزء 4، ويصدر على حدة. وإلى ذلك الحين، توثيق AgentX موجود على github.com/anis-marrouchi/agentx.

الخلاصة

أعطيت وكيلًا مهمة من لوحة التحكم، ثم تابعتها في كل صفحة مهمة: Hub للسؤال والجواب، وLive أثناء عملها، وActivity بعد انتهائها، وMonitor لما لا يتحقق منه أحد غيرك. وفعّلت أيضًا الطلبات وأعدت مراجعة فاشلة، وهما العقبتان في هذا الإصدار.

إذا أردت وكلاء مثل هذا يُراقَبون ويُعتنى بهم لصالح عملك، تواصل معنا.