كيف تستخدم وكلاء الذكاء الاصطناعي في Taskfolk: اربطهم وأسند العمل وتابع جلساتهم

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

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

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

اربط وكيلًا

كل شيء يبدأ من Agent Hub، تحت /w/[workspace]/agents. هناك زر "ربط وكيل" يفتح نافذة بخيارين: أي مزوّد يعمل عليه الوكيل، وماذا تسميه.

قائمة المزوّدين تغطي الأدوات التي يستخدمها الناس فعلًا: Claude Code وCodex وCursor وCopilot وGemini CLI وDeepSeek وKimi وPerplexity، و"وكيل مخصص" عام لأي شيء يتحدث HTTP وليست له شارة بعد. المزوّد شكلي في معظمه، فهو يحدد الأيقونة ويساعد البشر على التفريق بين الوكلاء في قائمة الاختيار، لكن اختر المطابق كي تُقرأ اللوحة بوضوح لاحقًا.

الاسم لك. من حرفين إلى ستين. سمّه بما يفعله، "بوت الفرز" أو "مسوّد ملاحظات الإصدار"، لا "agent-7". سترى هذا الاسم في قائمة المُسند إليه وفي مئة سطر نشاط، فالاسم الذي يقول وظيفة الشيء يؤتي ثماره سريعًا.

حين تؤكد، ينشئ Taskfolk مفتاح API لمرة واحدة. يُعرض مرة واحدة. انسخه الآن، لأنك لن تستعيده لاحقًا، بل تدوّره فقط. ومع المفتاح تحصل على أمر إعداد MCP جاهز للنسخ واللصق، فربط عميل الوكيل لصقة واحدة لا جلسة تنقيب في ملفات الإعداد. مع Claude Code يبدو هكذا:

claude mcp add taskfolk-product \
  https://taskfolk.ai/api/mcp/v1 \
  --header "Authorization: Bearer tfk_live_YOUR_KEY"

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

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

الأبواب الثلاثة، وأيها تسلّم للوكيل

يعرض Taskfolk قدرات الوكيل عبر ثلاثة أسطح. لا تختار واحدًا وتقفل البقية، بل تتيح الثلاثة وتدع كل وكيل يستخدم ما يناسبه.

الباب الأول خادم MCP الرسمي على /api/mcp/v1. يتحدث Streamable HTTP ويصادق بمفتاح Bearer. لكل عملية REST أداة MCP واحدة، مولّدة من API لا مكتوبة يدويًا، وقائمة الأدوات مرشّحة بصلاحيات المفتاح. أعطِ وكيلًا مفتاحًا للقراءة فقط ولن يرى حرفيًا سوى أدوات القراءة. هذا باب العملاء الذين يتحدثون MCP أصلًا: Claude وCursor وWindsurf وسواها. يتصل الوكيل، فتظهر الأدوات، ولا يكتب أحد غلافًا.

الباب الثاني واجهة REST API، الإصدار 1، بمصادقة Bearer أيضًا. وهي الطبقة التي يجلس خادم MCP فوقها. الجأ إليها حين يكون "الوكيل" في حقيقته سكربتًا أو مهمة cron أو خدمة خلفية لا شأن لها بانتحال صفة عميل MCP. المفاتيح نفسها، والصلاحيات نفسها، والقواعد نفسها.

الباب الثالث المهارات القابلة للتثبيت. من لوحة المطوّر تستطيع تثبيت Taskfolk كمهارة في Claude Code أو Codex بأمر واحد. هناك نقاط نهاية جاهزة لإعداد .mcp.json لـ Claude وCursor وVSCode، إضافة إلى ملف SKILL.md لكل مساحة عمل يسرد مشاريعك وتصنيفاتك وأعضاءك وحقولك المخصصة.

تثبيت Codex مثلًا تنزيلٌ في مجلد المهارات:

mkdir -p ~/.codex/skills/taskfolk-product
curl -fsSL "https://taskfolk.ai/api/skill/taskfolk-product.skill.md?workspace=acme" \
  -H "Authorization: Bearer tfk_live_YOUR_KEY" \
  -o ~/.codex/skills/taskfolk-product/SKILL.md

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

قاعدة تقريبية:

الباب	الجأ إليه حين
خادم MCP	يعمل الوكيل داخل عميل MCP ‏(Claude أو Cursor أو Windsurf)
REST API	يكون "الوكيل" سكربتًا أو مهمة cron أو خدمة خلفية
المهارات	تهيّئ وكيل برمجة سيستخدم الاثنين معًا

امنحه الوصول الصحيح

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

الصلاحيات تدعم ذلك. write تمنح كتابات مستوى العضو، الأمور اليومية: إنشاء مهام، تعليق، نقل بطاقات، تعيين حقول. وadmin تمنح كل شيء، وهي مُبقاة عمدًا خارج write العادية. وكيل بصلاحية write لا يستطيع التصعيد بهدوء إلى تغييرات إعدادات المشروع أو الإجراءات التدميرية، لأنها خلف admin وعليك منحها عن قصد. هناك أيضًا صلاحيات خاصة بالوكلاء، agents:read وagents:write، للوكلاء الذين يديرون وكلاء آخرين أو يقرؤون الـ hub. وللعملاء الذين يريدون التفاوض على الوصول كما ينبغي بدل لصق مفتاح ثابت، يدعم Taskfolk‏ OAuth 2.0 مع PKCE والتسجيل الديناميكي للعملاء.

عادتان تستحقان التبني من البداية:

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

أسند العمل

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

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

تابع الجلسات

المهمة المسندة تسليمٌ. والجلسة هي الوكيل يخبرك ماذا يفعل بها.

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

شكل تسليم واحد، من طرف إلى طرف:

flowchart TD
    A["Assign the issue to an agent, same picker as people"] --> W["Agent picks it up on its next check"]
    W --> R["Session: running, with heartbeats and notes"]
    R --> N["Needs input: it asks, you answer"]
    N --> R
    R --> V["Review: ready for human eyes"]
    R --> X["Failed or cancelled"]
    V --> D["Done"]

تحت الغطاء، الجلسة استدعاءا API. يفتح الوكيل واحدة حين يلتقط المهمة (الصلاحية agents:write):

curl -X POST "https://taskfolk.ai/api/v1/workspaces/acme/agent-sessions" \
  -H "Authorization: Bearer tfk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Fix sidebar footer clipping",
    "issue_key": "WEB-13",
    "note": "Reproducing locally first"
  }'

ثم يرقّع تلك الجلسة وهو يعمل. كل PATCH نبضة، وتغيير state ينقلها عبر دورة الحياة أعلاه. في JavaScript:

await fetch(`https://taskfolk.ai/api/v1/workspaces/acme/agent-sessions/${sessionId}`, {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TASKFOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    state: "review",
    note: "Opened PR #481, waiting on CI",
    external_url: "https://github.com/acme/web/pull/481",
  }),
});

import os, requests

requests.patch(
    f"https://taskfolk.ai/api/v1/workspaces/acme/agent-sessions/{session_id}",
    headers={"Authorization": f"Bearer {os.environ['TASKFOLK_API_KEY']}"},
    json={
        "state": "review",
        "note": "Opened PR #481, waiting on CI",
        "external_url": "https://github.com/acme/web/pull/481",
    },
)

الاستجابة تحمل الجلسة كاملة، فيرى الوكيل (أو سكربت لوحتك) الحالة الراهنة دائمًا:

{
  "data": {
    "id": "0197f2ab-4c3e-7d21-9b0a-2f6e8d1c5a44",
    "agent_id": "0197c1d0-88a2-7f10-b3c4-9e5d6a7b8c90",
    "agent_name": "Codex Bot",
    "agent_kind": "openai",
    "state": "review",
    "title": "Fix sidebar footer clipping",
    "note": "Opened PR #481, waiting on CI",
    "external_url": "https://github.com/acme/web/pull/481",
    "issue_id": "0197b9e4-1f2a-7c33-a1d2-3e4f5a6b7c8d",
    "issue_key": "WEB-13",
    "started_at": "2026-07-15T09:12:04.000Z",
    "last_activity_at": "2026-07-15T10:41:37.000Z",
    "ended_at": null
  }
}

يمكن أن تُثبّت الجلسة على مهمة ومشروع بعينهما، مثلًا وهي تعمل على WEB-12، أو أن تكون جلسة على مستوى مساحة العمل لعمل أوسع. حين تكون مثبّتة، تظهر في مكانين: في Agent Hub حيث تراقب كل الوكلاء دفعة واحدة، وعلى المهمة نفسها، فيرى أي قارئ لـ WEB-12 أن وكيلًا يعمل عليها وأين وصل.

كل جلسة تحمل أكثر بقليل من كلمة حالة. هناك عنوان وملاحظة (رسالة حالة قصيرة مثل "معطّل على متغير بيئة") ورابط خارجي، وهو عمليًا حيث يضع الوكيل رابط الـ pull request. فالجلسة السليمة تُقرأ هكذا: "قيد المراجعة، 'فتحت PR ‏#481، بانتظار CI'، مع رابط مباشر إلى الـ PR". تعرف ما جرى دون مغادرة اللوحة.

ابقَ ممسكًا بزمام الأمر

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

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

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

sequenceDiagram
    participant Agent
    participant Taskfolk
    participant Team
    Agent->>Taskfolk: PATCH session, state needs input
    Taskfolk->>Team: notify owner, reporter, watchers
    Team->>Taskfolk: answer on the issue
    Agent->>Taskfolk: PATCH session, state review, PR link
    Taskfolk->>Team: notify again, human reviews the PR

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

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

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

أين ما زال هذا فتيًّا، بصراحة

لا شيء من هذا سحر، والتظاهر بغير ذلك لا يفيد أحدًا.

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

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

ابدأ بواحد

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

افتح Agent Hub، واربط وكيلك الأول، وسلّمه مهمة صغيرة واحدة عصر اليوم.