كيف تضبط صلاحيات الحقول لوكيل الذكاء الاصطناعي

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

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

لماذا قد ترغب في تقييد ما يعدّله وكيل الذكاء الاصطناعي

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

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

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

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

أين تعيش صلاحيات الوكلاء في مركز الوكلاء

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

عمود المفتاح مهمّ لاحقًا، فأبقِ عينك عليه. لكل صفّ وكيل قائمة نقاط، زرّ النقاط الثلاث في نهاية الصفّ. افتحها فتحصل على إعادة تسمية، وصلاحيات، وقطع الاتصال. الصلاحيات هي ما نريد.

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

افتح مربّع الصلاحيات واختر قائمة سماح

من قائمة نقاط الوكيل، اختر الصلاحيات. يفتح ذلك مربّعًا عنوانه "What can this agent edit?". هذا هو سطح التحكّم كلّه، وهو أبسط مما يبدو.

في الأعلى مربّع اختيار واحد: "All fields (no restrictions)". حين يكون مفعّلًا، الوكيل بلا سياسة ويستطيع الكتابة في كل شيء، وهي الحالة الافتراضية. تحته شبكة من عمودين بها 14 مربّع اختيار للحقول:

• Title
• Description
• Status
• Priority
• Assignees
• Labels
• Milestone
• Sprint
• Release
• Estimate
• Time spent
• Completion %
• Start date
• Due date

يوضّح المربّع القصد بسطر مساعد: "Choose which issue fields {name} may change through its API key. A write to any other field is rejected with a clear error, so a triage agent stays a triage agent." تلك العبارة الأخيرة هي النموذج الذهني. أنت ترسم صندوقًا حول عمل الوكيل.

لنفعل وكيل الفرز فعلًا. أزِل تأشير "All fields (no restrictions)" أولًا. لحظة تفعل، تنشط الشبكة بلا شيء مؤشَّر، ما يعني أنّ الوكيل الآن لا يستطيع الكتابة في شيء. ثم أشّر الحقول الأربعة التي يحتاجها وكيل الفرز فعلًا: Status وPriority وLabels وAssignees. اترك العشرة الباقية فارغة. انقر "Save permissions". يؤكّد تنبيه ذلك: "Agent permissions updated".

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

الحالات الثلاث: كل الحقول، مجموعة جزئية، ولا كتابة

هذا هو الجزء الذي يُعثِر الناس، فتمهّل هنا. الحالات ثلاث لا اثنتان، والفرق بين اثنتين منها يسهل تفويته.

الحالة	مربّع "All fields"	الشبكة	ما يستطيع الوكيل كتابته
كل الحقول (null)	مؤشَّر	مُتجاهَلة	كل حقل من الـ 14. الافتراضي لوكيل مُوصَّل حديثًا، وتمامًا كسلوك عضو بشري.
مجموعة جزئية	غير مؤشَّر	بعض المربّعات مؤشَّرة	الحقول المؤشَّرة فقط. كل ما عداها مرفوض. مثال الفرز: أربعة مفعّلة، عشرة معطّلة.
قائمة سماح فارغة	غير مؤشَّر	لا شيء مؤشَّر	لا حقل مهمّة إطلاقًا. كل كتابة حقل مرفوضة.

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

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

كيف تعرف أيّ الوكلاء مقيَّد

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

أيّ وكيل له سياسة مضبوطة (أيّ شيء غير null، أي مجموعة جزئية أو قائمة سماح فارغة) يعرض شارة "Restricted" بنفسجية بجوار بادئة مفتاحه في عمود المفتاح. غياب الشارة يعني غياب السياسة، ما يعني أنّ الوكيل يستطيع الكتابة في كل حقل.

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

كيف تبدو الكتابة المرفوضة فعلًا

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

لنقل إنّ وكيلًا مقيَّد على Title وDescription، وحاول رغم ذلك إغلاق تذكرة. الكتابة PATCH عادية لمهمّة على واجهة API العامة:

curl -X PATCH "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/issues/WEB-12" \
  -H "Authorization: Bearer tfk_live_a1b2..." \
  -H "Content-Type: application/json" \
  -d '{"status": "done"}'

const res = await fetch(
  "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/issues/WEB-12",
  {
    method: "PATCH",
    headers: {
      Authorization: "Bearer tfk_live_a1b2...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ status: "done" }),
  },
);

import requests

res = requests.patch(
    "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/issues/WEB-12",
    headers={"Authorization": "Bearer tfk_live_a1b2..."},
    json={"status": "done"},
)

بأيّ طريقة وصلت، تجيب الـ API بـ HTTP 403 برسالة تسمّي الحقل بالضبط وتُدرِج ما هو مسموح:

{
  "error": {
    "code": "forbidden",
    "message": "This agent's field policy does not allow writing 'status'. Allowed fields: title, description. An owner or admin can change this on the Agents page."
  }
}

تلك الرسالة تؤدّي عملًا حقيقيًا. تخبر الوكيل (ومن يقرأ سجلّاته) بدقّة أيّ حقل حُظر، وما الذي يجوز له لمسه بدلًا منه، ومن يستطيع تغيير القاعدة. بلا تخمين.

سبب صمود هذا أنّ التنفيذ موحَّد عبر كل مسار كتابة. لا يهمّ كيف يحاول الوكيل تغيير الحقل:

• نقطة نهاية PATCH للمهمّة عبر REST.
• نقطة نهاية انتقال الحالة المخصّصة (نقل تذكرة بين الأعمدة).
• أداة MCP update_issue، التي تعيد الدخول إلى خطّ PATCH نفسه داخليًا بدل سلوك مسار منفصل.
• نقطة نهاية PATCH المنفصلة لتتبّع الوقت (التقدير، المصروف، الإكمال).

flowchart LR
  A[REST issue PATCH] --> E[Field policy check]
  B[Transition endpoint] --> E
  C[MCP update_issue] --> E
  D[Time tracking PATCH] --> E
  E -->|field allowed| F[Write applied]
  E -->|field blocked| G[403 names the field]

الأربعة تهبط عند الفحص نفسه. فلا يستطيع وكيل تهريب تغيير حالة عبر نقطة الانتقال بعد أن رفضه PATCH العادي، ولا يستطيع تمرير كتابة عبر MCP للتملّص من السياسة. البوّابة نفسها، في كل مرّة.

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

ما لا تغطّيه السياسة

الصدق بشأن الحواف أهمّ من جعل هذا يبدو أكبر مما هو. هذا ما لا تفعله سياسة الحقول.

إنها لكل حقل، لا لكل قيمة. تستطيع السماح بالحالة أو حظرها. لا تستطيع قول "يجوز ضبط الحالة على قيد المراجعة لا على منجزة". الحقل مفعّل أو معطّل؛ والقيم داخله ليست مُبوَّبة فرديًا. إن احتجت وكيلًا يستطيع تقديم التذاكر جزئيًا لكن لا يُغلقها أبدًا، فهذه السياسة ليست الأداة (قواعد انتقالات سير العمل آلية مختلفة).

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

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

بعض الحقول تنطوي في رمز واحد. بضعة أشياء قد تظنّها منفصلة هي مفتاح واحد. الحالة تغطّي الحالة، ومعرّفها الأساسي، وطابع الحلّ الزمني، كلّها تحت مربّع "Status" واحد. والمُسند إليهم يغطّي المُسند إليه الأساسي ومجموعة المُسنَد إليهم المتعدّدين كمربّع "Assignees" واحد. لا يمكنك فصلها.

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

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

تحقّق أنّ الوكيل أنجز العمل فعلًا: شارة "Unverified"

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

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

flowchart TD
  A[Session marked review or done] --> B{Anchored to an issue?}
  B -->|no| C[Never flagged]
  B -->|yes| D{External link provided?}
  D -->|yes| C
  D -->|no| E{Attributed activity or comment during the session?}
  E -->|yes| F[No badge]
  E -->|no| G[Pink Unverified badge]

تظهر الشارة في مكانين: على صفوف الجلسات في مركز الوكلاء، وعلى بطاقة "Agent activity" في تفاصيل المهمّة نفسها. مرّر فوقها فيشرح التلميح معناها: "This session claims the work is done, but no attributed change (activity or comment) was recorded on the issue during it, and no link was provided."

اقرأ التحفّظات بعناية، لأنّ هذه إرشادية، لا حُكم قاطع.

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

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

سياسة انطلاق معقولة لأدوار الوكلاء الشائعة

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

دور الوكيل	قائمة السماح	لماذا
وكيل فرز	Status, Priority, Labels, Assignees	يفرز العمل الوارد ويوجّهه. لا شأن له بإعادة كتابة الأوصاف أو ضبط التواريخ.
وكيل تسجيل الوقت	Estimate, Time spent, Completion %	يسجّل الجهد والتقدّم، لا غير.
وكيل مستندات أو كتابة	Title, Description	ينظّف الصياغة والعناوين. لا ينبغي أن ينقل التذاكر بين الأعمدة.
وكيل تخطيط	Sprint, Release, Milestone, Start date, Due date	يجدول العمل في دورات، لكنه يترك الحالة اليومية والإسناد لتدفّق الفرز.

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

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