Waafir
هذه الصفحة ترجمة آلية في انتظار المراجعة البشرية. قد تحتوي على أخطاء.

مرجع waafir-redact

يتيح الخادم waafir-redact ميزة الحجب في Waafir لعميل ذكاء اصطناعي متصل، بشكلين:

  • redact_text — كتلة نصية تُحجب مباشرةً وتُعاد فورًا.
  • redact_file / redact_file_status — مستند كامل في غرفة بيانات، يُحلَّل بحثًا عن المعلومات الشخصية (PII) ويُجهَّز للمراجعة البشرية.

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

الاتصال: https://app.waafir.io/api/mcp/waafir، أو خادم المجال https://app.waafir.io/api/mcp/waafir-redact؛ أسماء الأدوات متطابقة على كليهما — راجع الإعداد. لا تحتاج redact_text إلا إلى رمز PAT بنطاق read (أو أعلى) — فهي لا تمس أي غرفة بيانات، لذا لا يوجد فحص على مستوى الملف أو الغرفة يجب اجتيازه (لكنها لا تزال تحتاج إلى خطة مدفوعة وتفعيل الذكاء الاصطناعي، مثل كل أداة تشغّل نموذجًا).

أداتا المستندات كلتاهما لفريق الصفقة فقط. تحتاج redact_file إلى نطاق write وعضوية فريق الصفقة في غرفة البيانات — وكذلك redact_file_status، رغم أنها تقرأ فقط: فرمز PAT بنطاق read ضروري لكنه غير كافٍ، لأن وجود مهمة حجب هو بحد ذاته معلومة عن المستند. ويحصل المستدعي من خارج فريق الصفقة على FORBIDDEN، أيًا كان النطاق الذي يحمله الرمز. نطاق الرمز هو سقف الرمز؛ وعضوية فريق الصفقة هي سقف الشخص — ويجب اجتياز كليهما.

redact_text

احجب المعلومات الشخصية من كتلة نصية. يعالج النص وكيلُ الحجب الخاص بمؤسستك، وتُرجع الأداة النص المحجوب مع قائمة الكيانات التي حدّدها. ويمكنك اختياريًا حصر النتيجة في أنواع كيانات محددة.

المُدخلات

الحقلالنوعمطلوبالوصف
textstringنعمالنص المراد حجبه (يجب ألا يكون فارغًا).
typesstring[]لاقصر الحجب على أنواع المعلومات الشخصية هذه. احذفه لحجب كل ما يُكتشف.

المُخرجات

{ redacted_text, entities, truncated, processed_chars, total_chars, max_chars,
  filtered_out_count, unclassified_redacted_count, unclassified_types,
  filter_exact }
  • redacted_text — النص المحلَّل مع تسويد المقاطع الحساسة.
  • entities — المعلومات الشخصية التي أُزيلت. type هو التسمية التي استخدمها نموذج الحجب؛ وcanonical_type هو النوع القياسي الذي تقابله، أو null إذا تعذّر تصنيفها.
  • truncated / processed_chars / total_chars / max_chars — راجع حد الحجم.
  • filtered_out_count / unclassified_redacted_count / unclassified_types / filter_exact — راجع التصفية حسب النوع.

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

حد الحجم

لا يُحلَّل إلا أول 80,000 حرف. وقد كان هذا هو الحال دائمًا؛ لكن النتيجة تخبرك بذلك الآن. عندما تكون قيمة truncated هي true، فإن النص الذي يتجاوز processed_chars لم يُفحص قط — لا تتعامل مع الاستجابة على أنها حجب للمُدخل بأكمله. أرسل الباقي في استدعاء لاحق.

التصفية حسب النوع

لا يقبل types إلا هذه القيم:

name, email, phone, ssn, account, address, financial, confidential, url, username

⚠️ تغيير جذري (أغسطس 2026). كان types يقبل سابقًا أي سلسلة نصية. أما الآن فلا يقبل إلا القيم المذكورة أعلاه، وأي شيء آخر — "emails" أو "PII" أو "credit-card"، أو حالة أحرف مختلفة مثل "EMAIL" — يُرجع خطأ تحقق.

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

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

  • تكون قيمة filter_exact هي false (وتكون true كلما طُبّق المرشح بدقة)،
  • يذكر unclassified_redacted_count عدد الكيانات التي تأثرت بذلك، و
  • يسرد unclassified_types التسميات المعنية.

أما الكيانات التي استبعدتها عمدًا فتُحتسب بشكل منفصل، في filtered_out_count.

المتطلبات: خطة مدفوعة وتفعيل ميزات الذكاء الاصطناعي في مؤسستك (مفعّلة افتراضيًا؛ ويمكن لمسؤول المؤسسة إيقافها من الإعدادات ← الذكاء الاصطناعي والتكاملات). وتُرفض الاستدعاءات أيضًا بمجرد أن تبلغ مؤسستك حدّها اليومي لاستخدام الذكاء الاصطناعي، أو ما دامت Waafir قد أوقفت الميزة مؤقتًا؛ وتوضح رسالة الخطأ أيّ الحالتين.

redact_file

حلّل مستندًا كاملًا في غرفة بيانات بحثًا عن المعلومات الشخصية. هذه الأداة تحلّل فقط — لا يتغير المستند، ولا تتغير طريقة عرضه لأي أحد. التحليل غير متزامن؛ استطلع redact_file_status.

المُدخلات

الحقلالنوعمطلوبالوصف
file_idstringنعممعرّف UUID للملف.
override_redactedbooleanلاإعادة تحليل مستند سبق حجبه. وبدونه، يُرفض الملف المحجوب بالفعل.

المُخرجات

{ file_id, job_id, status: "analysis_started", applied: false,
  review_required: true, review_with, apply_via }

لا يوجد خيار auto_apply، وذلك عن قصد في التصميم — راجع الملاحظة في أعلى هذه الصفحة. ملفات الصور غير مدعومة.

المتطلبات: رمز PAT بنطاق write، وعضوية فريق الصفقة في غرفة البيانات، وخطة مدفوعة، وتفعيل ميزات الذكاء الاصطناعي في مؤسستك (مفعّلة افتراضيًا؛ ويمكن لمسؤول المؤسسة إيقافها من الإعدادات ← الذكاء الاصطناعي والتكاملات).

ملف لا يزال قيد الفحص. إذا كان الملف رفعًا جديدًا أو إصدارًا جديدًا لم تُنهِ Waafir فحصه بعد، تُجيب redact_file وredact_apply بـUNAVAILABLE مع error.reason: "ACTIVATION_PENDING" والرسالة This file is still being checked. Try again shortly. لا يُحلَّل شيء ولا يُطبَّق؛ استدعِ الأداة مجددًا بعد انتظار قصير.

redact_file_status

تحقق من تحليل حجب مستند.

المُدخلات

الحقلالنوعمطلوبالوصف
file_idstringنعممعرّف UUID للملف.

المُخرجات

{ file_id, status, entity_count?, applied: false, apply_via }
  • status — إحدى القيم idle وanalyzing وapplying وreview_ready وcompleted وfailed وerror. تصف applying وcompleted حجبًا يطبّقه شخص في واجهة Waafir — لا يمكنك الوصول إليهما من MCP، لكنك ستراهما إذا وافق شخص ما على المراجعة بينما تستطلع الحالة.
  • entity_count — عدد كيانات المعلومات الشخصية التي اقترحها التحليل، بمجرد أن تصبح المراجعة جاهزة.
  • تكون قيمة applied دائمًا false: فالموافقة على الحجب وتطبيقه يتمّان في واجهة Waafir.

تعامل مع أي قيمة status غير معروفة على أنها "واصل الاستطلاع"، لا على أنها خطأ. لا تُحتفظ بالحالات النهائية إلا لفترة وجيزة قبل تنظيف علامة المهمة، لذا فإن المستطلع الذي يصل متأخرًا يرى idle (أو review_ready معاد بناؤها) بدلًا من الحالة التي كان ينتظرها — وidle تعني "لا توجد مهمة قيد التنفيذ"، لا "لم يحدث شيء قط". استطلع حتى الحالة التي تريدها، مع مهلة نهائية، بدلًا من افتراض أن القيمة واحدة من قائمة ثابتة.

redact_history

أحدث تحليل حجب لملف، في صورة أعداد حسب نوع الكيان. لا يُرجع النص المحجوب نفسه أبدًا.

  • النطاق: read. لأعضاء فريق الصفقة، على ملف يجوز لهم قراءة محتواه.
  • المُدخلات: file_id (مطلوب).
  • المُخرجات: { file_id, analysis }. تكون analysis بالشكل { history_id, analysed_at, entities: { total, by_type } }، أو null إذا لم يُحلَّل الملف قط.

redact_list_terms

مصطلحات الحجب في غرفة بيانات: العبارات التي تُحجب دائمًا (always) والعبارات التي لا تُحجب أبدًا (never).

  • النطاق: read. لأعضاء فريق الصفقة.
  • المُدخلات: dataroom_id (مطلوب).
  • المُخرجات: { terms }، كلٌّ منها { id, term, kind, created_at }.

redact_add_term

أضف مصطلحًا إلى غرفة بيانات. يسري على عملية الحجب التالية لأي ملف في الغرفة ولا يغيّر أي ملف الآن.

  • النطاق: write. لأعضاء فريق الصفقة، على خطة مدفوعة.
  • المُدخلات: dataroom_id وterm (كلاهما مطلوب)؛ وkind (always أو never، والافتراضي always).
  • المُخرجات: { term }.

redact_remove_term

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

  • النطاق: write. لأعضاء فريق الصفقة.
  • المُدخلات: dataroom_id وterm_id (كلاهما مطلوب).
  • المُخرجات: { removed, term_id }.

redact_revert

ألغِ حجب ملف. يُقدَّم المستند الأصلي مجددًا فورًا لكل قارئ، بمن فيهم المستثمرون. وتُحفظ النسخة المحجوبة، بحيث يمكن إعادة تطبيقها.

  • النطاق: write. لأعضاء فريق الصفقة، على ملف يجوز لهم تعديله.
  • المُدخلات: file_id (مطلوب)؛ وconfirm_token.
  • خطوتان. بدون confirm_token لا يتغير شيء وتحصل على معاينة إضافةً إلى رمز. استدعِ مرة أخرى بالوسائط نفسها مع الرمز للتراجع.
  • يُرفض الملف غير المحجوب (409). وكذلك الملف الذي يجري عليه تحليل أو تطبيق نهائي للحجب (409): تُبلَّغ بذلك عند المعاينة، فلا يُصدر رمز لتراجع لا يمكن تنفيذه، ويُعاد الفحص عند التأكيد.

redact_apply

طبّق أحدث تحليل لملف من redact_file، مستثنيًا أي أنواع كيانات تستبعدها، ومضيفًا مصطلحات الحجب الدائم في غرفة البيانات. بعد ذلك يُقدَّم المستند المحجوب لكل قارئ، بمن فيهم المستثمرون. وتتراجع redact_revert عن ذلك.

  • النطاق: write. لأعضاء فريق الصفقة، على خطة مدفوعة، على ملف يجوز لهم قراءة محتواه.
  • المُدخلات: file_id (مطلوب)؛ وexclude_types؛ وconfirm_token.
  • خطوتان. بدون confirm_token لا يتغير شيء وتحصل على معاينة (الأهداف معدودة حسب النوع، دون النص أبدًا) إضافةً إلى رمز. استدعِ مرة أخرى بالوسائط نفسها مع الرمز لبدء التطبيق النهائي للحجب. إذا تغيّر التحليل أو الملف أو مصطلحات الغرفة أو الأهداف في الأثناء، يُرفض الاستدعاء وتعيد المعاينة.
  • عند إيقاف الذكاء الاصطناعي لمؤسستك، لا يمكن تطبيق سوى مصطلحات الحجب الدائم المحفوظة في الغرفة، كما في Waafir.