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

1. حاجز حماية المراقبة فقط في إعداد مسبق واحد

مُسجّل الامتثال (مراقبة فقط) يعيش في فئة Compliance في منتقي قوالب حواجز الحماية. إنه قاعدة pii واحدة بإجراء flag — الإجراء الذي يسجّل مطابقة ويترك حركة المرور وشأنها. لا حجب، لا إخفاء، لا استدعاء نموذج، ولا تغيير في SDK: تعيش السياسة في البوابة، ويبقى تطبيقك يستدعي /v1/chat/completions تماماً كما كان.

علّم، لا تفرض أبداً

الإجراء flag — يضيف ملاحظة لمطابقة ويدع الطلب والاستجابة يمران دون مساس. لا يُحجب شيء، لا يُخفى شيء.

كلتا المرحلتين

المرحلة both — تمسح القاعدة الطلب واستجابة النموذج، فترى PII في طريق الدخول وطريق الخروج.

حصة إضافية صفر

كشف PII المدمج مطابقة سلاسل حتمية — لا استدعاء judge للأعلى، لا رموز إضافية، لا شيء يتسلسل خلف نموذج.
Flag = مراقبة فقط. إجراء flag يسجّل مطابقة ولا يغيّر حركة المرور. إنه الأداة الصحيحة لقياس سياسة قبل أن تفرضها، أو للاحتفاظ بسجل امتثال دون تغيير السلوك. انظر الإجراءات لمقايضة block / mask / flag الكاملة.

2. الإعداد المسبق مُسجّل الامتثال، تماماً كما يُشحَن

افتح زر New guardrail المنقسم في عرض Guardrails بوحدة التحكم واختر فئة قوالب Compliance. بذرة مُسجّل الامتثال (مراقبة فقط) هي قاعدة pii واحدة:
الحقلالقيمة
النوعpii
المرحلةboth (الطلب + الاستجابة)
الإجراءflag (مراقبة فقط)
الكياناتemail، phone، ssn، credit_card، ip
كل مطابقة على أي من تلك الكيانات تُسجَّل؛ لا يُحجب أو يُعدَّل شيء. الإعداد المسبق بذرة، لا قفل — حرّر مجموعة الكيانات، أعد تسميته، أو ركّب قواعد أكثر قبل ربط مفتاح.
يعمل التعليم حياً على الطلبات — تُطلق القاعدة على حركة المرور الحقيقية لحظة ربط مفتاح، فتمتلئ تغذية المطابقات من استدعاءاتك الفعلية، لا من مهمة عيّنات منفصلة.

3. طبّق الإعداد المسبق في وحدة التحكم

كل خطوة هنا إجراء وحدة تحكم تحت جلستك الخاصة. إنشاء وتحرير حواجز الحماية يتطلب Developer+ في مساحة العمل. ولا يستخدم سوى الاستدعاء النهائي /v1/* مفتاح الترحيل sk-orca-....
1

افتح القالب

في وحدة التحكم، افتح Guardrails، انقر زر New guardrail المنقسم، واختر Compliance Logger (observe-only) من فئة قوالب Compliance.
2

سمِّ واحفظ

امنح حاجز الحماية اسماً (≤ 64 حرفاً)، مثل compliance-logger، اقتطع أو وسّع قائمة الكيانات اختيارياً، واحفظ. اترك الإجراء على flag — فهذا ما يبقيه مراقبة فقط.
3

اختبره

افتح علامة التبويب Test، الصق عينة في مرحلة input، وشغّل السياسة محلياً — بدون استدعاء للأعلى، بدون حصة (انظر §5).
4

اربط مفتاحاً

حرّر مفتاح API واختر compliance-logger من قائمة Guardrail المنسدلة (يضبط guardrail_id على المفتاح)، أو علّمه افتراضي مساحة العمل. انظر اربط بمفتاح وافتراضي الحساب.

4. مثال واحد ملموس

حاجز حماية باسم compliance-logger (الإعداد المسبق، دون تغيير) مربوط بمفتاح. استدعِ البوابة تماماً كما كان — بدون ترويسات جديدة، بدون تغيير في SDK:
curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Reply to jane@acme.com about her SSN 123-45-6789"}
    ]
  }'
يمر الطلب دون تغيير — يرى النموذج الأعلى النص نفسه بالضبط، والاستجابة غير معدّلة، وتحصل على إكمال عادي. خلفه، تعلّم قاعدة pii كلاً من email وssn، وتهبط كل مطابقة في تغذية المطابقات لمساحة العمل. لا يرى المستدعي فرقاً أبداً؛ وأنت تحصل على مسار التدقيق.
المراقبة فقط تعني لا تطبيق. مُسجّل الامتثال لا يحجب التسريبات ولا ينقّح البيانات — يسجّلها. عندما تكون مستعداً للتصرف، بدّل الإجراء إلى block أو mask، أو اقرنه بإعداد مسبق فارض مثل PII Shield أو احجب الأسرار.

5. اختبر قبل أن تربط

أثبت أن القاعدة تعلّم ما تتوقعه قبل أن يشير إليها أي مفتاح. افتح علامة التبويب Test داخل المحرر، الصق عينة، اختر مرحلة، وشغّل:
Reply to jane@acme.com about her SSN 123-45-6789
يقيّم الـ sandbox السياسة الحالية محلياً ويعيد الحكم — لقاعدة تعليم، ترى أي كيانات طابقت، بلا إرسال للأعلى وبلا قياس. لمسح مقابل مجموعة من الصياغات، تعيش أداة التقييم على بُعد علامة تبويب واحدة.

6. انظر ما أُطلق

هذا هو المغزى كله من إعداد مراقبة فقط مسبق: تغذية Matches. كل ظهور مُعلَّم يسجّل مطابقة — نوع القاعدة، الإجراء، المرحلة، وسلسلة تفصيل — تبرز عند GET /api/guardrail/match (Member). السلسلة الفرعية المطابقة نفسها (البريد الإلكتروني الفعلي، SSN) تُسجَّل فقط عند تفعيل Log raw content، وهو مُطفأ افتراضياً.
لسجل امتثال، إبقاء Log raw content مُطفأً عادةً هو المغزى: تتعلّم أن SSN ظهر وكم مرة، دون نسخ بيانات منظَّمة رجوعاً إلى قياسك عن بُعد. فعّله لكل حاجز حماية فقط عندما تحتاج السلسلة الفرعية للفرز؛ الإعداد غير رجعي. انظر تغذية المطابقات و التسجيل والخصوصية.
صفِّ التغذية حسب المرحلة لرؤية أين تدخل PII حركة مرورك — مطالبات المدخلات مقابل مخرجات النموذج — وحسب نوع القاعدة لعزل قاعدة pii. الكيان المطابق (email، ssn، …) محمول في سلسلة تفصيل كل مطابقة. تلك الإشارة هي ما يخبرك ما إذا كنت مستعداً لقلب الإجراء من flag إلى block أو mask. كل تحرير لحاجز الحماية يكتب صف تاريخ مُصدَّراً في نفس المعاملة — قارن أي إصدارين بـ diff وتراجع من عرض History. انظر الإصدارات.

7. من المراقبة فقط إلى الفرض

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

8. إلى أين تذهب بعد ذلك

الإجراءات: block / mask / flag

نموذج الإجراء الكامل — متى تراقب، متى تنقّح، متى ترفض.

PII Shield

النظير الفارض — أخفِ PII على الطلب بدلاً من تسجيله فقط.

تغذية المطابقات

تصفّح، جمّع، صفِّ، وصدِّر كل ظهور مُعلَّم.

التسجيل والخصوصية

مفتاح Log raw content وما يُسجَّل افتراضياً.
حاجز حماية المراقبة فقط لا يبوّب شيئاً بنفسه — إنه سطح قياس. للصورة الأوسع لكيف تقسم حواجز الحماية وجدار الحماية العمل، انظر حواجز الحماية مقابل جدار الحماية. للمحرك الكامل — المراحل، القواعد المتقدمة، والمسارات — اقرأ مرجع حواجز الحماية.