أدلة القرارات والآثار
سجل تدقيق وكيل الذكاء الاصطناعي
اربط الطلبات والمصادر والموافقات ومحاولات الأدوات بالنتائج الفعلية، عبر عقد أحداث وتمرين لإعادة بناء نشر تعديل عقد.
عندما يصل إجراء مختلف عليه إلى المدقق، تكون عبارة «تم» في المحادثة دليلًا ضعيفًا. يحتاج المراجع معرفة الطلب المخول ونسخة المصدر وما اعتمده الشخص وما حاولت الأداة تنفيذه وما سجله النظام المستهدف فعلًا.
ينبغي أن يحفظ سجل الوكيل هذه السلسلة دون جمع كل محتوى المحادثات إلى أجل غير محدد. يقدم الدليل لمالكي الخدمات وفرق التدقيق والهندسة تصميمًا للأدلة، باستخدام مثال أصلي لنشر تعديل عقد يفصل الطلب عن محاولة التنفيذ وعن الأثر المتحقق.
ابدأ بالسؤال الذي يجب أن يجيب عنه المراجع
لنفترض مساعدًا يجهز تعديل عقد معتمدًا للنشر في مستودع داخلي، ثم تكتشف المؤسسة ظهور نسخة خاطئة. الأسئلة المفيدة محددة: هل اعتمد المراجع النسخة 3 أم 4؟ هل استهدف الطلب سجل المستودع الصحيح؟ هل رفعت نسخة أحدث أثناء انتظار الاعتماد؟ هل أعادت الخدمة المحاولة بعد انتهاء المهلة؟
قد يتضمن تفريغ التعليمات قرائن ويعجز مع ذلك عن الإجابة. تحدد سلسلة أحداث جيدة الوثيقة والاعتماد والإجراء والنتيجة مباشرة. حدد أسئلة التدقيق قبل منتج التسجيل. فقد تحتاج إجابة معرفية مراجع مصادر، بينما يحتاج تعديل سجل أدلة صلاحية وأثر.
افصل المحادثة والتتبع والدليل التجاري
تسجل المحادثة ما قيل، ويشرح التتبع التقني انتقال الطلب بين المكونات، ويسجل حدث التدقيق قرارًا أو تغير حالة مؤثرًا. يمكن ربطها، لكنها ليست بدائل متطابقة.
تصف وثائق التتبع في OpenTelemetry المقاطع وسياق التتبع والروابط بين العمليات. تربط معرفاتها التشخيص بالحالة، لكنها لا تثبت بمفردها صحة اعتماد عقد أو نجاح نشره. يأتي المعنى من تعريف أحداث التطبيق وملاحظات النظام المعتمد.
لا تشترط الاطلاع على التفكير الداخلي الخفي للنموذج. تتكون الأدلة من المدخلات المسموحة أو مراجعها ونسخ المصادر والمقترح وتقييم السياسة والقرار البشري والأثر. وقد يكون تفسير النموذج اللاحق جوابًا مولدًا جديدًا، لا بديلًا موثوقًا لسجل التقط وقت الحدث.
تعريف أدنى لحدث التدقيق
| مجموعة الحقول | السؤال | اختيار تصميمي |
|---|---|---|
| هوية الحدث والحالة | أي حدث يخص أي طلب؟ | معرف حدث فريد وحالة مستقرة ومحاولة مترابطة |
| الوقت والترتيب | متى وقع ومتى سجل؟ | وقت الحدث والاستقبال والمنطقة والسابق السببي |
| الفاعل والصلاحية | من طلب واقترح واعتمد ونفذ؟ | مرجع هوية موثقة ودور وقرار |
| المورد ونسخة المصدر | أي عنصر وأي دليل؟ | معرف عقد ونسخة تعديل ومرجع دليل مضبوط |
| الإصدار والسياسة | أي تنفيذ وقواعد طبقت؟ | إصدار النموذج والإعداد والأداة والسياسة |
| المقترح والمحاولة | ما المسموح وما أرسل؟ | عملية وهدف موحدان وبصمة محتوى محمية |
| النتيجة المرصودة | ماذا حدث فعلًا؟ | سجل الوجهة ونسخته ونتيجة تحقق أو حالة مجهولة صريحة |
| معالجة الأدلة | من يفحصها ولأي مدة؟ | فئة وصول واحتفاظ ومرجع مخزن الأدلة |
هذا تصميم تطبيق مقترح، لا مخطط قانوني موحد. لا تملأ الحقول ببيانات شخصية إذا كفى مرجع مستقر مقيد. احتفظ بنسخ مخطط الحدث ليفسر المراجع السجلات القديمة. وعند تغير معنى حقل، غير الإصدار بدل إعادة استعمال اسمه بصمت.
أعد بناء نشر التعديل دون تخمين
يسمح المثال بالنشر عبر أداة مستودع مسجلة بعد اعتماد صريح. المعرفات افتراضية، وتقرر المؤسسة أن تغير نسخة الوثيقة يحتاج اعتمادًا جديدًا.
- تسجيل الطلب: تطلب الحالة C-1042 نشر التعديل A-91 بالنسخة 3 في العقد R-28.
- إعداد المقترح: يربط المساعد المصدر المعتمد بهدف ومحتوى محددين.
- التقاط الاعتماد: يوافق مراجع مخول على النسخة والهدف تحت السياسة P-7.
- فحص الشرط السابق: أصبحت نسخة المصدر أحدث، فترفض الخدمة المقترح القديم وتسجل السبب.
- مراجعة المقترح المعدل: تحصل النسخة 4 على اعتماد مستقل ومرجع دليل.
- محاولة النشر: ترسل الأداة الطلب المعتمد بمعرف عملية مستقر.
- التحقق من الأثر: يعيد المستودع مراجعة النشر 12، ويؤكد الاستعلام ظهور الوثيقة المطلوبة.
يجب أن يميز المراجع منع الطلب القديم الصحيح عن عطل خدمة وعن نشر مكتمل. عند انتهاء المهلة، سجل نتيجة مجهولة ثم تحقق منها. لا تحول غياب الاستجابة إلى نجاح، ولا تستبدل سجل المحاولة عندما يجد فحص لاحق النشر.
يوضح التسلسل الاختبارات: غير الوثيقة بعد الاعتماد، وأعد معرف العملية، وأخر الاستجابة، واسحب صلاحية المراجع قبل التنفيذ. افحص حالة الوجهة وسلسلة الأحداث. يشرح نموذج الإشراف ربط الاعتماد بإجراء، ويحول دليل التقييم الحالات إلى دليل إطلاق.
لا تخلط عرض التسلسل بإعادة إنتاج النتيجة
يعيد عرض التدقيق بناء الأحداث المسجلة، ولا ينتج بالضرورة جواب النموذج نفسه بإعادة التعليمات. قد تتغير النماذج والأدوات والبيانات والأذونات، ولا يضمن الاحتفاظ بالإعداد تطابق خدمة احتمالية. احفظ المخرج الفعلي اللازم أو مرجع دليل مضبوطًا عند الحاجة.
إعادة تنفيذ الأداة تختلف عن فحصها. يجب ألا يحتاج المراجع نشر التعديل مجددًا لفهم النشر الأول. وفر عرض تحقيق للقراءة، وافصل عنه الاستعادة المخولة. احفظ العلاقة بين الأصل والإعادة والتحقق اللاحق والإجراء التعويضي.
انتبه إلى ترتيب الزمن في الأنظمة الموزعة. سجل وقت الحدث والاستقبال، واستخدم روابط سببية بدل افتراض تطابق الساعات. لا تجعل تأخر وصول سجل يوحي بأن الاعتماد جاء بعد التنفيذ إذا أثبتت الأدلة غير ذلك، ولا تستخدم ترتيب عرض مريحًا لإخفاء اعتماد مفقود فعلًا.
احمِ الأدلة من النظام الذي تراجعه
قيد الكتابة والقراءة والتصدير وإدارة مخزن التدقيق. يجب ألا يمحو الوكيل تاريخه. اختر سجلات تضاف دون تعديل وسياسات تخزين محمية وفحوص سلامة مستقلة تناسب الحاجة. قد تكشف البصمة تغير المحتوى إذا كان مرجعها موثوقًا؛ لكنها لا تثبت صدق المحتوى الأصلي أو تخويل الإجراء.
سجل التصحيح كحدث إضافي يشرح علاقته بالأصل. حذف الحدث غير المريح أو تعديله يزيل السياق. وفي الوقت نفسه، يجب أن تتوافق حماية الدليل مع الاحتفاظ والإتلاف المنطبقين. صمم ذلك مع الخصوصية وإدارة السجلات، بدل اعتبار عدم القابلية للتعديل إذنًا بالاحتفاظ الأبدي.
اختبر تعطل التسجيل: غياب المجمع وامتلاء الطابور وفشل الكتابة. حدد الإجراءات التي تستمر بتخزين محلي متين والتي تتوقف لغياب الدليل المطلوب. لا ينبغي لخدمة عالية الأثر أن تمضي بصمت دون الأدلة التي يعتمد عليها تصريحها.
قلل المحتوى الحساس عند الجمع
تحذر إرشادات التسجيل لدى OWASP من تسجيل الأسرار والبيانات الحساسة غير اللازمة مباشرة، وتوصي باختبار فشل التسجيل. طبق ذلك قبل الجمع؛ فإخفاء سر في لوحة لا يزيله من المخزن والنسخ والتصدير.
افصل الحدث عن أدلته المقيدة. قد يحدد الحدث الحالة والعملية والنتيجة، ثم يصل المحقق المخول لنسخة الوثيقة عند الحاجة. لا تسجل رموز الوصول وكلمات المرور والمرفقات الخام وكل سياق النموذج افتراضيًا. افحص الأخطاء أيضًا، فقد تعيد رسالة استثناء محتوى الطلب.
للبيانات الشخصية السعودية، وائم الأغراض والوصول والاحتفاظ والحقوق مع مراجعة النظام. وإذا غادرت الأدلة أو التتبعات البيئة المعتمدة، فأدخلها في سجل إقامة البيانات. لا يعفي التدقيق التدفق من هذه المراجعات.
قدم لكل مراجع العرض الذي يحتاجه
قد يحتاج محلل التشغيل أعداد الإخفاق وحالة الأدوات، والأمن قرارات الصلاحية والوجهات، ومراجع الأعمال الوثيقة والتغيير والنتيجة، والخصوصية دليل الوصول والاحتفاظ. امنح هذه العروض صراحة بدل إتاحة جميع المحادثات للجميع.
اختبر قابلية التحقيق. اختر حالة مغلقة واطلب من شخص مخول لم يبنِ الوكيل الإجابة: ما المطلوب، وما المسموح، وما المعتمد، وماذا حدث، وما دليل كل إجابة؟ سجل الروابط الناقصة والوقت. يفيد التمرين أكثر من الاحتفاء بحجم السجلات.
حدث سجل التدقيق مع الخدمة
تحتاج الأداة الجديدة تعريف أحداث وتحقق نتائج قبل الإطلاق، والمصدر الجديد مراجع نسخ، والاعتماد المعدل سجل قرار محدثًا. تجعل سياسة الحوكمة ذلك جزءًا من اعتماد التغيير، وتنبه المراقبة التشغيلية إلى الفجوات والنتائج المجهولة والروابط المقطوعة.
يمكن تحديد تطوير الوكيل لدى Open for AI لإنتاج الأدلة التي يحتاجها مسارك. أحضر إجراءً قد يحتاج المدقق إعادة بناءه وحدد سلسلة أحداثه قبل تقرير كمية المحتوى المحتفظ به.