سجلات التدقيق والأدوار والسياسات للبرمجة بالذكاء الاصطناعي
حوكمة البرمجة بالذكاء الاصطناعي بسجل تدقيق وأدوار مضمّنة ومخصصة وسياسات و MFA و SSO في خطة Enterprise، وحزمة أدلة موقّعة لكل تغيير يستطيع المدققون التحقق منها.
في AI CodeOps، الحوكمة هي مجموعة الضوابط المحيطة بكل جلسة ذكاء اصطناعي: الأدوار تقرر من يجوز له فعل ماذا، والسياسات تقرر ما يجوز للذكاء الاصطناعي فعله وما يحتاج إلى موافقة، وسجل التدقيق يسجل من غيّر ماذا، ويحصل كل تغيير على حزمة أدلة موقّعة. وهي معا تجيب عن الأسئلة الثلاثة التي يطرحها المدقق عن الكود الذي يكتبه الذكاء الاصطناعي: من سمح بهذا، وماذا فعل الذكاء الاصطناعي، وهل تستطيع إثبات ذلك.
الوكلاء الذين يعملون
تنطبق الحوكمة على كل وكيل، فهي تتعلق بالتحكم لا بعمل وكيل بعينه:
- سياسات لكل وكيل. يمكن لقاعدة على
agent.dispatchأن تسمح بخطوة وكيل معين أو تطلب موافقة عليها أو ترفضها، مثل Builder أو DevOps Engineer. والجلسة التي تحتوي على وكيل مرفوض لا تبدأ. - وكلاء مساحة العمل. يمكن لمساحة العمل أن تستبدل تعليمات وكيل مضمّن ونموذجه من Configure, Agents، وأن تضيق أدوات MCP التي يجوز لذلك الوكيل استدعاؤها. ولا يسري الاستبدال إلا على خطوات ذلك الوكيل.
- تسجيل لكل خطوة. تخزن كل خطوة وكيل مع وكيلها ونموذجها ورموزها وتكلفتها، وتنتهي في حزمة الأدلة.
راجع فهرس الوكلاء لمعرفة ما يفعله كل وكيل مضمّن.
السياسات
سياسات مساحة العمل تقرر ما يجوز لجلسة الذكاء الاصطناعي فعله. تسمي القاعدة إجراء، ونمط مورد اختياريا، وقرارا:
| الإجراء | ما يشمله | المورد |
|---|---|---|
workflow.dispatch | بدء جلسة | معرف سير العمل |
agent.dispatch | تشغيل خطوة وكيل | معرف الوكيل |
mcp.invoke | استدعاء أداة MCP | الخادم/الأداة |
diff.apply | تغيير ملف | مسار الملف |
shell.command | تشغيل أمر الاختبار | الأمر |
github.push | فتح طلب سحب | المالك/المستودع |
release.deploy | النشر تلقائيا | البيئة |
حين تنطبق عدة قواعد تغلب أشدها، فلا تستطيع قاعدة أضيفت لاحقا أن ترخي قاعدة سابقة بصمت. والإجراءات التي لا تحتمل انتظار شخص (استدعاءات أدوات MCP وأوامر الاختبار وعمليات النشر التلقائية) لا تقبل إلا السماح أو الرفض. وإعداد الثقة يغطي الإجراءات التي لا تنطبق عليها أي قاعدة: trusted يسمح بها، وlimited (الافتراضي) يطلب موافقة قبل طلب السحب الخاص بالجلسة، وnone يجعل الجلسات للقراءة فقط. وهذه مجموعة القواعد كما تحفظها صفحة Policies عبر PUT /api/policies، وهذا نصها:
{
"enabled": true,
"workspaceTrust": "limited",
"rules": [
{
"id": "infra-needs-review",
"action": "diff.apply",
"resource": "infra/**",
"decision": "ask",
"description": "Infra changes need an approval"
},
{ "id": "no-auto-prod", "action": "release.deploy", "resource": "production", "decision": "deny" },
{ "id": "payments-repo", "action": "github.push", "resource": "acme/payments", "decision": "ask" }
],
"expectedVersion": 7
}
مجموعة القواعد غير الصالحة ترفض مع سرد كل مشكلة فيها. ويسجل كل قرار رفض وكل قرار طلب موافقة.
الأدوار
لكل عضو دور واحد في كل مساحة عمل:
| الدور | الغرض منه |
|---|---|
| Owner | وصول كامل، ومنه تعيين مالكين آخرين. |
| Admin | كل شيء عدا تعيين مالكين أو تغيير دور مالك. |
| Developer | تشغيل الجلسات؛ وإدارة المشاريع والجداول الزمنية وعمليات النشر والحوادث والوكلاء المخصصين وفرز الملاحظات. |
| Member | تشغيل الجلسات؛ وإدارة عمليات النشر والحوادث وسجلات ADR. |
| Viewer | للقراءة فقط. لا يستطيع تشغيل جلسات ولا إنشاء مفاتيح API. |
| Security Admin | السياسات وسجل التدقيق والموافقات. بلا فوترة ولا أسرار. |
| DevOps Admin | المشاريع وأدلة التشغيل والجداول الزمنية وعمليات النشر والحوادث وخوادم MCP. لا يستطيع تغيير النماذج ولا المزودين. |
| Billing Admin | الفوترة والميزانية والاستخدام. بلا وصول إلى الكود ولا الأسرار ولا الأعضاء. |
| Secret Manager | أسرار مساحة العمل فقط. |
لا يستطيع إسناد دور يحمل صلاحيات إدارية إلا مالك، ولا يمكن أن تفقد مساحة العمل مالكها الأخير أبدا. والأدوار المخصصة (Enterprise) تبنى من الصلاحيات نفسها، من Settings, Roles & Permissions. راجع الأعضاء والأدوار.
بوابات الجودة المعنية
- الموافقات. كل تغيير من الذكاء الاصطناعي يحتاج إلى موافقة ممن يسمح له بالبت فيه، وهم افتراضيا المالكون والمسؤولون ومسؤولو الأمان. ومن بدأ الجلسة لا يستطيع الإدلاء بصوت الموافقة ما دام في مساحة العمل شخص آخر يملك صلاحية الموافقة؛ ومساحة العمل ذات الشخص الواحد تستطيع الموافقة الذاتية. ورفض واحد ينهي الطلب. ويمكن تسمية فرق أصحاب صلاحية موافقة.
- احتجاز بالسياسة. قرار طلب الموافقة (ask) على بدء سير عمل يفتح موافقة، وتنتظر الجلسة. وقرار طلب الموافقة على الملفات أو المستودع يحتجز طلب السحب إلى أن تجري الموافقة عليه.
- الإغلاق عند الخطأ. إذا تعذر تحميل السياسة فلا تبدأ الجلسة.
تشرح صفحة بوابات الجودة كيف تجتمع الموافقات والاختبارات والملاحظات.
سجل التدقيق
صفحة Audit Log (ضمن Measure) تسجل من غيّر ماذا: الأعضاء والأدوار، ومفاتيح API ونطاقاتها، والسياسات وقرارات الموافقة، والأسرار، ومفاتيح المزودين، والميزانيات، وخوادم MCP، والوكلاء، والجداول الزمنية، وتعديل الأشخاص لكود جلسة ذكاء اصطناعي، وتنزيلات حزم الأدلة. يخزن كل إدخال الوقت والحساب والإجراء والهدف وعنوان IP ووكيل المستخدم (user agent) ووصفا قصيرا. وتسجل أيضا المحاولات المرفوضة أو الفاشلة. وقراءته تحتاج إلى صلاحية التدقيق. ومدة حفظ الإدخالات تعتمد على خطتك؛ وفي خطة Enterprise تحفظ بلا حد زمني. ولا يوجد تصدير CSV بعد.
أمان تسجيل الدخول
- المصادقة الثنائية بتطبيق مصادقة أو مفتاح مرور (passkey)، مع رموز استرداد. ويجب أن يستخدمها المالكون والمسؤولون والأدوار التي تدير إعدادات حساسة.
- تسجيل الدخول الموحد عبر SAML 2.0 أو OIDC في خطة Enterprise، بعد أن تتحقق من نطاق بريدك الإلكتروني.
- مفاتيح API محددة النطاق مقيدة بالصلاحيات ونطاقات IP وحد المعدل وتاريخ الانتهاء. ويتصرف المفتاح بصفة العضو الذي أنشأه، بدور ذلك العضو الحالي.
حزم الأدلة الموقّعة
لكل تغيير زر Download evidence pack. تسجل الحزمة بصيغة JSON المهمة، والنماذج والفئات المستخدمة، ورموز كل تشغيل وتكلفته، والموافقات والأصوات، وقرارات السياسة، والملاحظات وفرزها، ونتائج الاختبار، وطلب السحب وعملية النشر وأي حادثة، وإدخالات التدقيق المتعلقة بذلك كله. والكود نفسه غير مضمّن؛ وتجزئة SHA-256 للفروقات تطابق الحزمة مع طلب السحب. والحزمة موقّعة بخوارزمية Ed25519، ويستطيع أي شخص فحصها على /evidence/verify دون حساب. راجع حزم الأدلة.
الأسئلة الشائعة
هل يمكنني تصدير سجل التدقيق؟
ليس بصيغة CSV بعد. يمكنك قراءته عبر JSON API، وتتضمن حزمة الأدلة لكل تغيير إدخالات التدقيق المتعلقة بذلك التغيير.
هل الأدوار المخصصة متاحة في كل خطة؟
لا. الأدوار المخصصة ميزة في خطة Enterprise. وكل الخطط تحصل على الأدوار المضمّنة.
هل يدعم AI CodeOps تزويد الحسابات عبر SCIM؟
لا. ينشئ SSO في خطة Enterprise الحسابات عند أول تسجيل دخول بدور افتراضي تختاره. و SCIM غير متاح.
هل يستطيع أحد التحقق من حزمة أدلة دون حساب في AI CodeOps؟
نعم. يستطيع أي شخص فحص الحزمة على /evidence/verify، أو دون اتصال بالشبكة باستخدام المفاتيح العامة المنشورة وسكربت Node.js قصير.
هل تُسجل التعديلات التي يجريها الأشخاص على الكود الذي كتبه الذكاء الاصطناعي؟
نعم. حين يعدّل أحد ملفا في تغيير جلسة ذكاء اصطناعي أو يضيفه أو يحذفه، يكتب التعديل في سجل التدقيق وتعود أي موافقة على ذلك التغيير إلى حالة الانتظار.
هل يمكنني تجربة سياسة قبل فرضها؟
نعم. حين تكون السياسة موقوفة لا يفرض شيء، لكن كل قرار كانت ستتخذه يسجل مع ذلك، فترى ما كانت القاعدة ستمنعه.