→ المدونة
شروحات16 د قراءةThe Taskfolk team6 مشاهدةحُدِّث في

كيف ترسم خريطة فريق وكلائك

XLinkedIn

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

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

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

لماذا تحتاج إلى تصوّر وكلاء الذكاء الاصطناعي في فريق

المشكلة في القائمة أنها مسطّحة. ستة وكلاء بأسماء Refactor Bot وDocs Writer وTriage، كلٌّ بعمود مالك، مرتّبين كيفما يرتّب الجدول. لا بأس بذلك لـ«من مربوط». لكنه عديم الفائدة لـ«ما شكل العمل الآن».

حين تشغّل فريق وكلاء، أسئلتك الحقيقية علائقية:

  • من يملك ذلك الذي فشل؟
  • أي الوكلاء متكدّسون كلهم في WEB دفعةً واحدة؟
  • هل يعمل شيء فعلًا، أم أن كل شيء مُسنَد وينتظر؟

الجدول يجعلك تعيد بناء تلك الإجابات صفًّا في المرة، في رأسك. إعادة البناء تلك ضريبة، وتنمو مع كل وكيل تضيفه.

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

شيئان تعرفهما ابتداءً. الخريطة مقصورة على مساحة عمل واحدة. ليست على مستوى المؤسسة ولا عابرةً لمساحات العمل. وهي مرئية لكل عضو في مساحة العمل، بالوصول نفسه لمركز الوكلاء ذاته، فلا تقييد لكل دور أبعد من كونك في مساحة العمل. ما تراه هو فريق وكلاء مساحة عمل واحدة، ومالكوها، ومشاريعها، وعملها الحيّ.

كيف تفتح خريطة الوكلاء من المركز

اذهب إلى مركز الوكلاء على /w/<workspace>/agents. تلك هي واجهة القائمة وحيث تهبط افتراضيًا: سجلّ كل وكيل مربوط بمالكه وحالته.

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

في رأس الصفحة مبدّل مجزّأ برابطين، قائمة وخريطة. إنه عنصر تحكم عادي مُخدَّم من الخادم، والتبويب النشط مملوء بذهب العلامة فتعرف بنظرة أي واجهة أنت فيها. انقر خريطة. تهبط على /w/<workspace>/agents/map، وهو الشجرة كاملة.

تمسّك بالفصل بين الواجهتين. القائمة تجيب «من مربوط». الخريطة تجيب «ماذا يفعل الفريق». الوكلاء أنفسهم، عدستان. حين تربط وكيلًا جديدًا أو تفحص مفتاحًا، القائمة هي المكان. حين تريد أن تعرف ما إن كان الفريق يتحرّك، الخريطة هي تلك.

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

قراءة الخريطة بنظرة سريعة

تمهّل عند هذا الجزء، لأنك حالما تستطيع قراءة الخريطة بنظرة واحدة، كل ما عداه مجرد تنقّل.

في المركز يجلس جذر مساحة العمل. حوله، عقدة لكل وكيل. عقدة الجذر تحمل عدًّا حيًّا: نقطة سماوية نابضة إضافةً إلى رقم مضغوط، وذلك الرقم هو كم وكيلًا يعمل حاليًا. فقبل أن تقرأ عقدة وكيل واحدة، يعطيك الجذر نبض مساحة العمل كلها. ثلاثة يعملون من ثمانية؟ تراه فورًا.

خريطة الوكلاء الافتراضية: شجرة شعاعية تتمركز على مساحة العمل بعقد وكلاء حولها، ونقاط حالة ملوّنة، وعنصر تحكم الوضع حسب الوكيل/حسب المشروع/حسب المالك إضافةً إلى وسّع الكل، واطوِ الكل، ومربع ترشيح الخريطة. الواجهة الأبرز لقراءة الفريق كله بنظرة سريعة.

كل عقدة وكيل تحمل نقطة حالة ملوّنة، وهذا أهم شيء تتعلّمه على الإطلاق. النقطة تجميع لكل ما يفعله ذلك الوكيل، ولونها يتبع مفردات ثابتة:

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

بجانب عقدة وكيل سترى أيضًا رقمًا سماويًا حين يكون له جلسات حيّة تعمل، نسخة العدّ الجذري لكل وكيل. وكيل يشغّل ثلاث جلسات يُظهر 3 سماوية.

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

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

كيف تعيد التجميع حسب الوكيل أو المشروع أو المالك

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

كل وضع تعشيش مختلف للشجرة نفسها:

  • حسب الوكيل (الافتراضي) يعشّش مساحة العمل ثم الوكيل ثم المشروع ثم المهمة. يجيب هذا «ماذا يفعل كل وكيل؟» تبدأ من وكيل وتتعمّق في عمله.
  • حسب المشروع يعشّش مساحة العمل ثم المشروع ثم الوكيل ثم المهمة، وتظهر المشاريع ذات نشاط الوكلاء الفعلي فقط. يجيب هذا «ماذا يحدث في WEB؟» تبدأ من مشروع وترى كل وكيل متكدّس فيه، إضافةً إلى مهامهم. إن كان ثلاثة وكلاء كلهم في مشروع WEB، يضعهم «حسب المشروع» جنبًا إلى جنب تحت فرع واحد فيصبح الازدحام واضحًا.
  • حسب المالك يعشّش مساحة العمل ثم المالك ثم الوكيل ثم المشروع ثم المهمة. يجيب هذا «أيّ من تابعيّ يملك الوكيل العالق؟» تبدأ من شخص وترى الوكلاء المسؤول عنهم. عقد المالك تُظهر الصورة الرمزية للمالك.

خريطة الوكلاء في وضع «حسب المالك»: الشجرة مُعاد تجميعها بحيث تجلس عقدة شخص بين جذر مساحة العمل والوكلاء الذين يملكهم، مع تبويب «حسب المالك» نشطًا في عنصر تحكم الوضع.

طابِق الوضع للسؤال في رأسك:

السؤال الذي تمسكه الوضع الذي يجيب عنه
«ماذا يفعل وكيل الفرز لديّ؟» حسب الوكيل
«لماذا يتحرّك WEB ببطء شديد؟» حسب المشروع
«من يملك هذا المكسور؟» حسب المالك

البيانات نفسها، ثلاث إجابات.

سلوك واحد تتوقّعه: تبديل الأوضاع يعيد ضبط حالة التوسّع ويعيد ملاءمة العرض. إن كان لديك فرع موسَّع في «حسب الوكيل» وقلبت إلى «حسب المشروع»، تنطوي الشجرة إلى تخطيط ملائم نظيف. ذلك مقصود، لأن الشكل كله يتغيّر، لكنه يعني أنك تعيد التوسيع بعد تبديل الوضع بدلًا من توقّع بقاء الفروع المفتوحة.

قراءة ما يعمل عليه كل وكيل الآن

انقر فرع وكيل لتوسّعه. ينفتح إلى مشاريعه، وتحتها، عناصر عمله. عنصر العمل واحد من شيئين، والفرق يهمّ: إما جلسة حيّة، أو مهمة مفتوحة مُسنَدة إلى الوكيل بلا جلسة بعد.

فرع خريطة وكلاء موسَّع: عقد جلسات بمفاتيح مهام وملاحظات حيّة تحت كل وكيل، وأعداد سماوية لقيد التشغيل، وشارة متعثّرة على جلسة هادئة، وعقدة «مُسنَدة» معتّمة لمهمة في الطابور بلا جلسة بعد.

عقدة الجلسة تريك التفصيل الحقيقي. عنوان المهمة، وعنوان فرعي بمفتاح المهمة تحته (شيء مثل WEB-42 على تذكرة «تبويب الجدول الزمني + الملخص»)، وملاحظة الوكيل الحيّة (أيًّا كان آخر ما بلّغ أنه يفعله)، وشارة حالة جلسة ملوّنة. تلك الشارة حالة الجلسة نفسها، متمايزة عن نقطة الوكيل التجميعية، وتُقرأ كواحدة من: قائمة الانتظار، أو قيد التشغيل، أو بحاجة إلى مدخل، أو قيد المراجعة، أو منجزة، أو فاشلة، أو ملغاة.

دورة الحياة خلف تلك الشارات قصيرة. الجلسة إما يُنشئها النظام حين تُسنِد مهمة إلى وكيل (تلك قائمة الانتظار، تنتظر الالتقاط) أو يبدأها الوكيل نفسه. من هناك يحرّكها الوكيل بين حالات العمل حتى تحطّ في حالة نهائية:

stateDiagram-v2
    [*] --> pending: issue assigned to the agent
    [*] --> running: agent starts a session itself
    pending --> running: agent claims the work
    pending --> cancelled: unclaimed for 7 days
    running --> needs_input: blocked on a human
    needs_input --> running: input arrives
    running --> review: work ready for review
    review --> done
    running --> done
    running --> failed
    running --> cancelled

ثم هناك النوع الآخر من عناصر العمل: إسناد بلا جلسة خلفه بعد. مهمة مفتوحة مُسنَدة إلى الوكيل، لكن الوكيل لم يبدأ تشغيلًا عليها. تظهر أعتم، بعتامة 40%، بشارة «مُسنَدة». قرار تصميم صغير، عائد كبير. يعني أن «أي مهمة يتولّاها هذا الوكيل؟» مُجاب عنه حتى قبل أن يبدأ الوكيل العمل، لأن الإسناد نفسه على الخريطة. لست أعمى عن العمل في الطابور.

كن واضحًا بشأن ما تعنيه «مُسنَدة» مع ذلك. ليست تشغيلًا حيًّا. إنها مهمة في الطابور. الإعتام هو الإشارة: ساطع يعني أن شيئًا يحدث، معتّم يعني أن شيئًا ينتظر. لا تقرأ عنصرًا «مُسنَدًا» كوكيل يعمل.

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

كيف تمسك وكيلًا متعثّرًا قبل أن يكلّفك

هذه الميزة التي تكسب بها الخريطة قيمتها. الوكيل العالق بصمت أسوأ من الذي يفشل بصوت عالٍ، لأن الفشل يظهر على الأقل بالوردي. أما التعثّر فيجلس هناك يبدو مشغولًا.

فالخريطة تترقّبه. الجلسة قيد التشغيل أو قائمة الانتظار لكن بلا نشاط لأكثر من 30 دقيقة تحصل على شارة «متعثّرة» برتقالية، ونقطة حالة الوكيل تنقلب إلى برتقالي الانتباه (حالة الانتباه في ترتيب الأسبقية). تمسكه كتغيّر لون على الشجرة. بلا تنقيب.

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

كن دقيقًا بشأن ما التعثّر، لأن الصراحة تهمّ. التعثّر معيار مبني على الزمن، محسوب على العميل من آخر طابع نشاط زمني. ليس حالة جلسة مخزّنة. الحالات السبع التي يمكن أن تكون الجلسة فيها فعلًا هي pending وrunning وneeds_input وreview وdone وfailed وcancelled. لا توجد حالة «متعثّرة» في قاعدة البيانات. إنها تلميح مشتقّ، «هذا يبدو عالقًا»، تنتجه ساعة، لا يدفعه الوكيل.

ما يعني أن التعثّر يخبرك أن وكيلًا صمت، لا أنه انكسر قطعًا. أحيانًا مهمة طويلة تعمل فعلًا وهي صامتة فقط. لكن الصمت-لثلاثين-دقيقة هو تحديدًا الإشارة التي تريد إظهارها، والخريطة تُظهرها قبل أن ينبّهك أحد متسائلًا لماذا لم يتحرّك WEB-42.

متابعة التحديثات الحيّة بلا إعادة تحميل

الخريطة حيّة. لا تُحدّثها. تفتح بثّ Server-Sent-Events إلى /api/w/<slug>/agents/stream، وحين يحدث شيء لجلسة (إنشاء، أو التقاط، أو نبضة قلب، أو بلوغ حالة نهائية) ترقّع الخريطة تلك العقدة فقط في مكانها. لا إعادة بناء شجرة كاملة، ولا وميض، ولا قفز تمرير. العقدة الوحيدة التي تغيّرت تُحدَّث والباقي يبقى ثابتًا.

كل إطار على البثّ حدث JSON صغير. تحديث جلسة يبدو هكذا:

{
  "type": "session.updated",
  "sessionId": "0197c9f2-8a41-7c3e-b1d2-4f5a6b7c8d9e",
  "agentUserId": "0197c8aa-1b2c-7d4e-9f01-23456789abcd",
  "state": "needs_input",
  "title": "Magic-link login on the welcome page",
  "note": "Blocked: which sender address should staging use?",
  "externalUrl": null,
  "issueKey": "WEB-6",
  "issueTitle": "Magic-link login on the welcome page",
  "projectSlug": "web",
  "lastActivityAt": "2026-07-15T09:41:12.000Z",
  "endedAt": null,
  "at": "2026-07-15T09:41:12.000Z"
}

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

إن سقط الاتصال، لا تفوّت الخريطة بصمت ما حدث أثناء انقطاعها. تعيد الاتصال تلقائيًا، وأثناء ذلك تُظهر إشعار «تُعيد الاتصال…» فتعرف أن البثّ منقطع للحظة. عند إعادة الاتصال تمرّر ?since=<ISO> بالطابع الزمني الذي سمعت منه آخر مرة، ويعيد الخادم تشغيل كل جلسة مُسّت أثناء الفجوة. العميل ينزع التكرار بمعرّف الجلسة والطابع الزمني، فحدث مُعاد رأيته أصلًا لا يُطبَّق مرتين. الاتصال المنقطع لا يتركك بخريطة قديمة.

sequenceDiagram
    participant M as Map in your browser
    participant S as Taskfolk server
    M->>S: GET /api/w/taskfolk/agents/stream
    S-->>M: session.updated frames as work moves
    Note over M: patches one node per frame
    M--xS: connection drops
    M->>S: reconnect with ?since=last timestamp
    S-->>M: replays every session touched in the gap
    Note over M: dedupes by session id and timestamp

الآن الحدّ الصريح، لأنه يشكّل مقدار ثقتك بالبثّ. التسليم أفضل-جهد عبر ناقل داخل العملية، وقاعدة البيانات هي مصدر الحقيقة. إعادة تشغيل ?since إضافةً إلى نزع التكرار عند إعادة الاتصال هو ما يجعل ذلك موثوقًا عمليًا، لا ضمانًا لتسليم فوري مستقل عنه. هذا يعمل داخل العملية اليوم؛ وRedis مذكور كمنفذ توسّع مستقبلي، لا توزيع متعدّد العقد مُطلق. على عقدة واحدة هذا تحديدًا ما تريده. فقط لا تبنِ نموذجًا ذهنيًا يكون فيه البثّ ضمانًا زمنيًا صارمًا عبر عنقود. إنه عرض سريع يشفي نفسه مدعوم بقاعدة بيانات لديها الإجابة الحقيقية دائمًا.

سحب الجلسات نفسها من سكربت

الجلسات التي ترسمها الخريطة متاحة أيضًا عبر الـREST API، وهو مفيد حين تريد فحص «هل شيء عالق» في بوت Slack أو مهمة صباحية بدلًا من تبويب متصفح. GET /v1/workspaces/{slug}/agent-sessions يسرد الجلسات الأخيرة ويأخذ state وagent_id وissue_key وlimit كمرشّحات. يحتاج مفتاح API بنطاق agents:read.

سؤال «أي الجلسات محجوبة على إنسان الآن» يبدو هكذا:

curl "https://taskfolk.ai/api/v1/workspaces/taskfolk/agent-sessions?state=needs_input" \
  -H "Authorization: Bearer $TASKFOLK_API_KEY"
const res = await fetch(
  "https://taskfolk.ai/api/v1/workspaces/taskfolk/agent-sessions?state=needs_input",
  { headers: { Authorization: `Bearer ${process.env.TASKFOLK_API_KEY}` } },
);
const { data } = await res.json();
for (const s of data) console.log(s.agent_name, s.issue_key, s.note);
import os
import requests

res = requests.get(
    "https://taskfolk.ai/api/v1/workspaces/taskfolk/agent-sessions",
    params={"state": "needs_input"},
    headers={"Authorization": f"Bearer {os.environ['TASKFOLK_API_KEY']}"},
)
for s in res.json()["data"]:
    print(s["agent_name"], s["issue_key"], s["note"])

كل جلسة في الاستجابة تحمل الوقائع نفسها التي تُظهرها عقدة خريطة: agent_name وstate وtitle وnote وexternal_url وissue_key وstarted_at وlast_activity_at وended_at. الخريطة هي العرض البشري لتلك البيانات؛ والنقطة هي العرض الآلي.

التوسيع والطيّ والترشيح والتنقّل

حالما تستطيع قراءة الخريطة، الباقي هو التحرّك حولها. بضعة عناصر تحكم تؤدي العمل.

وسّع الكل واطوِ الكل يفتحان أو يغلقان الشجرة كلها دفعةً. «اطوِ الكل» معطّل حين لا شيء موسَّع، فحالة الزر نفسها تخبرك ما إن كان هناك شيء ليُطوى. لتحكّم أدقّ، انقر أي عقدة أب لتبديل ذلك الفرع وحده فتحًا أو إغلاقًا. حين تُطوى عقدة أب ولها أبناء مخفيون، ترتدي شارة «N+» فتعرف كم مطويّ تحتها، لنقل عقدة مشروع تُظهر 4+ لأربعة وكلاء لم توسّعهم.

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

النقر على ورقة يُنقّل. عقدة جلسة أو إسناد خلفها مهمة تفتح تلك المهمة حين تنقرها. عقدة مشروع تفتح لوحة ذلك المشروع. فالخريطة ليست مخططًا ميتًا، إنها مُطلِق. رأيت جلسة متعثّرة على WEB-42، انقرها، تهبط على التذكرة. عقدة الجلسة تحمل أيضًا أيقونة سهم إلى الأعلى واليمين تفتح رابط عمل الوكيل الخارجي (طلب سحب أو رابط تشغيل) في تبويب جديد، فتقفز مباشرةً إلى طلب السحب أو سجل التشغيل الفعلي الذي أنتجه الوكيل.

للتنقّل في اللوحة: اسحب للتحريك، ومرّر للتكبير، واستخدم الخريطة المصغّرة (قابلة للتحريك والتكبير) إضافةً إلى عناصر تحكم التكبير للتحرّك في شجرة كبيرة. الخلفية شبكة منقّطة. عند تكبير منخفض، تظهر العقد بشكل مضغوط، مسقطةً شاراتها وملاحظاتها فيبقى الشكل العام مقروءًا حين تصغّر لترى كل شيء. أعلى اليمين زر تصدير-صورة يحفظ الخريطة الحالية كصورة، مفيد للإسقاط في مستند اجتماع يومي أو تحديث حالة.

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

حدود وأخطاء تتجنّبها

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

دفعة واحدة، حتى 25 وكيلًا. الوكلاء مُقيّدون بـ25 لكل مساحة عمل، وهو تحديدًا سبب تحميل الخريطة كلها في دفعة واحدة بلا تحميل كسول للوكلاء. لا تنتظر أبدًا ورود الوكلاء صفحةً صفحة.

المُصيّر يُقيَّد عند 900 عقدة. بعد ذلك، تُقتطع الشجرة وتُظهر «تعرض الشريحة الأولى. رشّح لتضييقها.» تلك إشارتك لاستخدام مربع الترشيح بدلًا من توقّع لوحة بلا حدود. على مساحة عمل ممتلئة بمشاريع كثيرة وجلسات حيّة كثيرة، تضيّق بالمرشّح، لا بالتمرير إلى الأبد.

مساحة عمل واحدة فقط. ليست على مستوى المؤسسة ولا عابرةً لمساحات العمل. فريق مساحة عمل واحدة.

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

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

مُسنَدة ليست تشغيلًا. عنصر «مُسنَدة» معتّم مهمة في الطابور بلا جلسة بعد. يخبرك ما التالي، لا ما الحيّ.

التعثّر معيار. قيد التشغيل أو قائمة الانتظار بلا نشاط لأكثر من 30 دقيقة، مُعاد اشتقاقه على العميل كل 30 ثانية. تلميح أن وكيلًا صمت، لا حالة مخزّنة ولا فشل صارم.

شارة «غير موثَّق» ليست على الخريطة. تلك الشارة، التي تشير إلى جلسة مراجعة أو منجزة بلا نشاط منسوب على مهمتها، تعيش على قائمة مركز الوكلاء وأسطح نشاط المهمة، لا كعنصر تحكم على الخريطة. لا تبحث عنها هنا.

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

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

أسئلة شائعة

أين أجد خريطة الوكلاء في Taskfolk؟

اذهب إلى مركز الوكلاء على /w//agents، ثم انقر تبويب «خريطة» في المبدّل المجزّأ بأعلى الصفحة. تهبط على /w//agents/map، وهو الشجرة الشعاعية كاملة. الخريطة مرئية لكل عضو في مساحة العمل، بلا تقييد لكل دور.

كيف أرى ما يعمل عليه كل وكلاء الذكاء الاصطناعي لديّ الآن؟

افتح خريطة الوكلاء بوضع «حسب الوكيل»، ووسّع كل فرع لترى مشاريعه وعناصر عمله. كل عنصر إما جلسة حيّة بشارة حالة، أو مهمة مُسنَدة معتّمة بلا جلسة بعد. عقدة الجذر تحمل عدًّا حيًّا بكم وكيلًا يعمل حاليًا، فتقرأ نبض مساحة العمل كلها بنظرة واحدة.

ماذا تعني النقاط الملوّنة على كل وكيل؟

النقطة تجميع لكل ما يفعله الوكيل: سماوية نابضة لقيد التشغيل، وبرتقالية للانتباه (بحاجة إلى مدخل أو تعثّر)، وصفراء للمراجعة، ووردية للفاشلة، ورمادية للخاملة. حين يفعل الوكيل عدة أشياء، تحكمها أسبقية: الانتباه يغلب قيد التشغيل يغلب المراجعة يغلب الفاشلة يغلب الخاملة. فهي وضع الوكيل كله، لا حالة جلسة مفردة.

كيف أعرف أيّ عضو فريق يملك وكيل ذكاء اصطناعي بعينه؟

بدّل الخريطة إلى وضع «حسب المالك». تعيد تجميع الشجرة بحيث تجلس عقدة شخص بين جذر مساحة العمل والوكلاء الذين يملكهم، وتُظهر عقد المالك الصورة الرمزية للمالك. هذا هو الوضع الذي يجيب «من يملك الوكيل العالق؟».

كيف يعرف Taskfolk أن وكيلًا متعثّر؟

التعثّر معيار مبني على الزمن، محسوب على العميل من آخر طابع نشاط زمني ومُعاد اشتقاقه كل 30 ثانية. الجلسة قيد التشغيل أو قائمة الانتظار بلا نشاط لأكثر من 30 دقيقة تحصل على شارة «متعثّرة» برتقالية. إنه ليس حالة مخزّنة في قاعدة البيانات، بل تلميح إلى أن الوكيل صمت، لا أنه انكسر قطعًا.

هل تُحدَّث خريطة الوكلاء مباشرةً، أم عليّ إعادة التحميل؟

مباشرةً، لا تُحدّثها. تفتح الخريطة بثّ Server-Sent-Events وترقّع العقدة المتغيّرة وحدها في مكانها بلا إعادة بناء كاملة. إن سقط الاتصال، تعيد الاتصال تلقائيًا وتمرّر since= بالطابع الزمني الأخير فيعيد الخادم تشغيل كل جلسة مُسّت أثناء الفجوة. التسليم أفضل-جهد، وقاعدة البيانات هي مصدر الحقيقة.

كم وكيلًا تستطيع خريطة الوكلاء عرضه دفعةً واحدة؟

الوكلاء مُقيّدون بـ25 لكل مساحة عمل، فتُحمَّل الخريطة كلها في دفعة واحدة بلا تحميل كسول. المُصيّر يُقيَّد عند 900 عقدة؛ بعد ذلك تُقتطع الشجرة وتُظهر «تعرض الشريحة الأولى. رشّح لتضييقها.»، وهي إشارتك لاستخدام مربع الترشيح.

ما الفرق بين عنصر «مُسنَد» وجلسة قيد التشغيل على الخريطة؟

عنصر «مُسنَد» معتّم (بعتامة 40%) مهمة مفتوحة أُسنِدت إلى الوكيل لكنه لم يبدأ عليها تشغيلًا بعد؛ يخبرك ما التالي. الجلسة قيد التشغيل ساطعة وتُظهر تفصيلًا حيًّا: عنوان المهمة، ومفتاحها، وملاحظة الوكيل، وشارة حالة. القاعدة: ساطع يعني أن شيئًا يحدث، ومعتّم يعني أن شيئًا ينتظر.

قراءات ذات صلة

أضف تعليقًا

ابدأ النقاش.