استخدام OpenCode مع Agent Redactor

المتطلبات الأساسية: ثبّت Agent Redactor من متجر Microsoft أو عبر الأمر المكوّن من سطر واحد في PowerShell. ستحتاج أيضًا إلى تثبيت OpenCode.

  1. إنشاء ملف تعريف وتهيئة بروكسي API

    من قائمة ملفات التعريف في الشريط الجانبي الأيسر، اختر ملف تعريف أو أنشئ ملفًا جديدًا. حدّد اسم ملف التعريف، واختر منفذًا محليًا متاحًا للـ URL المحلي (مثل 8080)، وأدخل نقطة نهاية إعادة التوجيه إلى الحقيقية لمزوّدك (مثل https://openrouter.ai/api/v1)، والصق مفتاح API الحقيقي الخاص بك. يتم تشفير المفتاح محليًا ولا يغادر جهازك أبدًا.

    قسم بروكسي API في Agent Redactor مع اسم ملف التعريف OpenRouter Provider وURL محلي localhost:8080 وإعادة التوجيه إلى openrouter.ai/api/v1 وحقل مفتاح API
    قم بتهيئة ملف التعريف. URL المحلي هو ما يتصل به OpenCode، وإعادة التوجيه إلى هي نقطة نهاية API الحقيقية.

  2. تفعيل الكشف بالذكاء الاصطناعي وقواعد التنقيح

    حدد فئات PII التي تريد تنقيحها. يمكنك أيضًا إضافة التعابير النمطية والكلمات المفتاحية للأسرار الخاصة بمشروعك.

    Agent Redactor مع تفعيل نموذج الكشف بالذكاء الاصطناعي وفئات PII محددة ولوحة الإحصائيات وسجلات تنقيح الجلسة التي تعرض PII المكتشفة
    كشف الذكاء الاصطناعي مفعّل مع تحديد جميع الفئات. تعرض سجلات تنقيح الجلسة PII التي تم اعتراضها (مثل اكتشاف «Bob» كـ private_person).

  3. افتح OpenCode

    شغّل OpenCode. ستظهر الواجهة الرئيسية مع حقل إدخال الدردشة ومحدد النموذج الحالي.

    الشاشة الرئيسية لـ OpenCode مع New session وحقل إدخال الدردشة ومحدد نموذج يعرض Big Pickle
    الشاشة الرئيسية لـ OpenCode مع حقل إدخال الدردشة ومحدد النموذج.

  4. افتح محدد النموذج

    اكتب /model في حقل إدخال الدردشة لفتح مربع حوار اختيار النموذج. يمكنك أيضًا استخدام الاختصار Ctrl+'.

    OpenCode مع كتابة /model في حقل إدخال الدردشة لعرض مطالبة اختيار النموذج
    اكتب /model لفتح محدد النموذج.

  5. انقر فوق «Connect provider»

    في مربع حوار اختيار النموذج، انقر فوق زر Connect provider في أعلى اليمين لإضافة اتصال مزوّد جديد.

    مربع حوار اختيار النموذج في OpenCode مع زر Connect provider في أعلى اليمين
    انقر فوق Connect provider لإضافة Agent Redactor.

  6. اختر «Custom OpenAI-compatible provider»

    من قائمة المزوّدين، مرر إلى قسم Other واختر Custom OpenAI-compatible provider. يتيح لك ذلك توجيه OpenCode إلى أي نقطة نهاية متوافقة مع OpenAI.

    مربع حوار Connect provider في OpenCode يعرض قائمة المزوّدين مع Custom OpenAI-compatible provider ضمن Other
    اختر Custom OpenAI-compatible provider من قسم Other.

  7. املأ تفاصيل المزوّد

    أدخل ما يلي في نموذج المزوّد المخصص:

    • Provider ID: agent-redactor
    • Display name: Agent Redactor
    • Base URL: http://localhost:8080/ (يجب أن يطابق المنفذ في Agent Redactor)
    • API key: اتركه فارغًا. يتولى Agent Redactor المصادقة عبر الرؤوس
    نموذج المزوّد المخصص في OpenCode مع Provider ID agent-redactor وDisplay name Agent Redactor وBase URL http://localhost:8080/
    املأ تفاصيل المزوّد. يجب أن تطابق Base URL منفذ بروكسي Agent Redactor لديك.

  8. أضف نموذجك وأرسله

    مرر لأسفل إلى قسم Models. أدخل معرف النموذج (مثل nvidia/nemotron-3-ultra-550b-a55b:free) واسمًا للعرض (مثل «Nemotron 3 Ultra»). انقر فوق Submit للحفظ.

    قسم Models في نموذج المزوّد المخصص في OpenCode مع معرف النموذج nvidia/nemotron-3-ultra-550b-a55b:free وزر Submit
    أضف النموذج وانقر فوق Submit.

  9. اختر نموذجك

    عد إلى مربع حوار /model وابحث عن «agent» — سترى مزوّد Agent Redactor مع النموذج تحته. حدده لتوجيه جميع الطلبات عبر البروكسي.

    محدد النموذج في OpenCode مع البحث عن agent وإظهار مزوّد Agent Redactor مع Nemotron 3 Ultra (Free)
    ابحث عن «agent» للعثور على مزوّد Agent Redactor واختر النموذج.

  10. ابدأ الدردشة

    أرسل رسالة. في هذا المثال، كتب المستخدم «My name is Bob». اكتشف Agent Redactor «Bob» كبيانات PII، ونقّحه قبل إعادة التوجيه إلى LLM، واستعادته في الاستجابة.

    دردشة OpenCode عبر Agent Redactor مع تنقيح الاسم Bob واستعادته في الاستجابة
    تم تنقيح «Bob» في الطريق إلى الخارج واستعادته بشفافية في الطريق إلى الداخل.

التحقق من التنقيح

افحص لوحة سجلات تنقيح الجلسة في Agent Redactor لمعرفة ما تم اعتراضه بالضبط.

إحصائيات Agent Redactor تعرض Requests: 1 وPII: 1 وسجلات تنقيح الجلسة تعرض PII private_person Bob
تعرض لوحة الإحصائيات «Requests: 1, PII: 1» وتدرج سجلات تنقيح الجلسة القيمة التي تم اعتراضها مع الطابع الزمني والنوع.
نصيحة: استخدم التعابير النمطية والكلمات المفتاحية في ملف التعريف الخاص بك للتعرف على الأسرار الخاصة بالمشروع التي قد يفوتها نموذج الذكاء الاصطناعي، مثل أسماء المضيفين الداخلية أو المعرّفات الخاصة أو الأسماء الرمزية للمشروع.