AI CodeOps

مرجع قواعد السياسة

آخر تحديث

اكتب قواعد سياسة مساحة العمل لجلسات الذكاء الاصطناعي: الإجراءات السبعة، و allow و ask و deny، وأنماط الموارد، وأوضاع الثقة، ووضع التسجيل فقط، ومثال تطبيقي.

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

السياسات تحكم الجلسات فقط. أما ما يجوز للشخص فعله فيحدده دوره.

افتح السياسة

افتح Secure → Policies. تعرض الصفحة:

  • قسم Enforcement (الفرض): Enforced (مفروضة) أو Log only (تسجيل فقط).
  • الأقسام Rules in effect (القواعد السارية) و Trust posture (وضع الثقة) و Version (الإصدار).
  • قسم Rules: معرف كل قاعدة وإجراؤها وموردها وقرارها.
  • قسم What changed between versions: القواعد المضافة والمزالة والمتغيرة بين إصدارين محفوظين.
  • قسم How rules apply: الإجراءات وما يطابقه كل منها.
  • قسم Recent decisions: أحدث حالات الرفض والاحتجاز ونتائج وضع التسجيل فقط، مع الرابط View session.

تعرض الصفحة للأدوار التي لها صلاحية policy-manage: المالكون والمسؤولون ومسؤولو الأمان افتراضيا.

صيغة القاعدة

تعدل القواعد في نموذج، بطاقة لكل قاعدة، أو بوصفها مصفوفة JSON في التبويب Advanced (JSON). ولكل قاعدة الحقول التالية:

الحقلمطلوبما هو
idنعممن 1 إلى 64 حرفا: حروف وأرقام و . و _ و : و -. ويجب أن يكون فريدا.
actionنعمأحد الإجراءات أدناه، أو * لكل الإجراءات.
decisionنعمالقيمة allow أو ask (يحتاج إلى موافقة) أو deny.
resourceلانمط glob يطابق ما يمسه الإجراء. وحذفه يعني الكل.
descriptionلاحتى 500 حرف، ويعرض تحت معرف القاعدة.
enabledلاالقيمة false تبقي القاعدة لكنها توقف تطبيقها.

وفي النموذج تحمل هذه الحقول الأسماء Rule ID و Action و Decision و Resource و Description ومربع الاختيار On. ويمكن أن تضم السياسة حتى 200 قاعدة.

الإجراءات

الإجراءالتسميةالمورد الذي يطابقهمتى يفحصالقرارات
workflow.dispatchStart a sessionمعرف سير العملحين تبدأ جلسةallow, ask, deny
agent.dispatchRun an agent stepمعرف الوكيل، مثل builderحين تبدأ جلسة، لكل وكيل ستشغلهallow, ask, deny
mcp.invokeCall an MCP toolserver/toolحين تبدأ جلسة، لكل أداة MCP مربوطةallow, deny
shell.commandRun the test commandالأمرقبل أن تشغل الجلسة اختباراتكallow, deny
diff.applyChange a fileمسار الملف، مثل infra/**حين يفتح طلب السحب، لكل ملفallow, ask, deny
github.pushOpen a pull requestowner/repoحين يفتح طلب السحبallow, ask, deny
release.deployDeploy automaticallyاسم البيئةقبل نشر تلقائي بعد الدمجallow, deny

بعض الإجراءات لا تحتمل انتظار شخص، فلا تستطيع استخدام ask. ويرفض المحرر القرار ask عليها. والقرار ask المخزن على أحدها يطبق على أنه deny.

ما يفعله كل قرار:

  • بدء الجلسة (workflow.dispatch و agent.dispatch): القرار deny يرفض الجلسة. والقرار ask يحتجزها إلى أن يوافق عليها أحد في Review & Gate → Approvals؛ ورفضها أو ترك صلاحيتها تنتهي يلغيها.
  • أدوات MCP: الأداة غير المسموح بها لا تعرض على الوكلاء أبدا.
  • طلب السحب (github.push و diff.apply): القرار deny يرفض طلب السحب. والقرار ask يشترط مراجعة موافقا عليها للتغيير. وتبقى الجلسة تعمل وتقترح تغييرها؛ والقاعدة تقرر هل يستطيع الوصول.
  • النشر التلقائي: أي شيء غير allow يوقف النشر. ويسجل بوصفه عملية نشر ممنوعة لترى أنه لم يخرج.

كيف تقيّم القواعد

  1. تؤخذ في الحسبان كل قاعدة مفعلة يطابق حقلها action (أو قيمته *) ويطابق حقلها resource.
  2. يغلب أشد القرارات: القرار deny يغلب ask، والقرار ask يغلب allow. وترتيب القواعد لا يهم.
  3. إذا لم تنطبق أي قاعدة، يقرر وضع الثقة.

أنماط الموارد (globs)

  • النمط ** يطابق أي شيء، ومنه /.
  • النمط * يطابق أي سلسلة من الأحرف. وفي مسارات الملفات و server/tool و owner/repo، يتوقف عند /.
  • النمط ? يطابق حرفا واحدا.
  • غياب resource، أو القيمة * أو **، يطابق كل شيء.

فالنمط src/*.ts يطابق src/app.ts لكنه لا يطابق src/lib/app.ts؛ فاستخدم src/** للمجلد كله.

وضع الثقة

يسري الوضع حين لا تنطبق أي قاعدة.

الوضعالقرارات الافتراضية
trustedكل شيء مسموح به.
limited (الافتراضي)مثل trusted، لكن فتح طلب سحب قراره ask.
noneالقرار deny لأدوات MCP وأمر الاختبار وتغييرات الملفات وطلبات السحب وعمليات النشر التلقائية، ما لم يسمح بها.

كل جلسة تغير الكود تحصل أيضا على طلب مراجعة في Review & Gate → Approvals. والوضع يضيف إلى ذلك؛ ولا يزيله.

مثال

هذه السياسة تحتجز ترقيات التبعيات بانتظار موافقة، وتطلب مراجعة لأي تغيير في ملفات البنية التحتية، وتمنع عمليات النشر التلقائية إلى الإنتاج، وتبعد أداة MCP واحدة عن الوكلاء. وهي معروضة بصيغة JSON كما تراها في التبويب Advanced (JSON)، وهذا نصها:

[
  {
    "id": "approve-dependency-refresh",
    "action": "workflow.dispatch",
    "resource": "dependency-refresh",
    "decision": "ask",
    "description": "A person approves before a dependency upgrade session starts"
  },
  { "id": "review-infra-changes", "action": "diff.apply", "resource": "infra/**", "decision": "ask" },
  { "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" },
  { "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }
]

عدّل السياسة

  1. افتح Secure → Policies واختر Edit rules (تعديل القواعد).
  2. اختر وضعا في Trust posture.
  3. في التبويب Form، غيّر حقول قاعدة، أو اختر Add rule لإضافة قاعدة جديدة، أو Remove لحذف قاعدة. وأزل العلامة من مربع الاختيار On لتبقي القاعدة دون تطبيقها. وترتيب القواعد لا يهم.
  4. اختر Save (version → N) للحفظ.

لتعديل القواعد نصا، افتح التبويب Advanced (JSON). ويعدل التبويبان القواعد نفسها، فالتغيير الذي تجريه في أحدهما تجده حين تنتقل إلى الآخر. وإذا تعذرت قراءة JSON، أو كان فيه شيء ليس له حقل في النموذج، تبقى الصفحة في التبويب Advanced وتذكر ما يجب إصلاحه.

إذا كانت في قاعدة مشكلة، لا يحفظ شيء وتسرد كل مشكلة مع قاعدتها وحقلها، مثل Rule 2 (no-repo-deletes), Decision: "Call an MCP tool" (mcp.invoke) can't wait for an approval, so it can't use ask. Choose allow or deny. وفي النموذج تظهر كل رسالة أيضا تحت حقلها. وإذا حفظ شخص آخر وأنت تعدل، ترى الرسالة "Policy conflict" ولا تحفظ تغييراتك. وتبقى تعديلاتك في المحرر لتنسخها؛ فاختر Cancel لتحميل إصداره، ثم أجر تغييرك من جديد.

ينشئ كل حفظ إصدارا جديدا وإدخالا من النوع policy.updated في سجل التدقيق.

قارن الإصدارات

يعرض قسم What changed between versions الفرق بين إصدارين محفوظين من السياسة. ويفتح على الإصدار السابق في مقابل الحالي؛ واختر أي إصدارين آخرين في From و To. وترى:

  • القواعد التي تحمل الوسم Added أو Removed أو Changed، مع كل حقل تغير قبل التغيير وبعده؛
  • الحقل Trust posture، حين يتغير.

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

وضع التسجيل فقط

اختر Switch to log only لإيقاف الفرض دون حذف القواعد. يبقى كل قرار يحسب ويسجل، ويعرض بالوسم "logged" ضمن Recent decisions، لكن لا يمنع شيء ولا يحتجز. واختر Enforce لإعادة تشغيله. واستخدم وضع التسجيل فقط وأنت تضبط سياسة جديدة.

ولا تسجل إلا القرارات التي ليست سماحا صرفا.

الخطوات التالية

الأسئلة الشائعة

هل يهم ترتيب قواعدي؟

لا. تؤخذ كل قاعدة منطبقة في الحسبان ويغلب أشد القرارات، فإضافة قاعدة لا تستطيع أبدا إرخاء قاعدة سابقة.

هل تقيد السياسات ما يستطيع الأشخاص فعله؟

لا. السياسات تحكم ما يجوز لجلسات الذكاء الاصطناعي فعله. أما ما يجوز للشخص فعله فيحدده دوره.

هل يمكنني اختبار سياسة دون منع أحد؟

نعم. اختر Switch to log only. تبقى القواعد تقيّم ويسجل كل قرار، لكن لا يمنع شيء ولا يحتجز.

هل كانت هذه الصفحة مفيدة؟