تخطَّ إلى المحتوى
AppArch AppArch Docs

الذكاء الاصطناعي (Claude / OpenAI / Gemini)

يُضبط الذكاء الاصطناعي في AppArch مرة واحدة للتثبيت كلّه على يد مشغّل التثبيت. لا تستطيع مساحات العمل إضافة مفتاح خاص بها، ولا يوجد مدخل للذكاء الاصطناعي تحت Integrations.

الإعداد

Section titled “الإعداد”

افتح Administration ← Settings ← Assistant (/management/settings/assistant) واضبط:

  • Provider - Anthropic (Claude) أو OpenAI أو Google (Gemini). مزوّد واحد في كل مرة.
  • API key - مفتاح المشغّل نفسه؛ يُحاسب المزوّد على الاستخدام في ذلك الحساب.
  • Models on offer - كل النماذج المسموح لهذا التثبيت باستخدامها. الأول هو الافتراضي. وعند إدراج أكثر من نموذج يختار المستخدمون لكل سؤال في تبويب Ask في Archito.
  • Offer the assistant to users - يفعّل تبويب Ask في Archito.
  • Allow fix suggestions on findings - مفتاح منفصل، لأن كل اقتراح يرسل نتيجةً إلى المزوّد.
  • Token budgets - سقوف يومية وأسبوعية اختيارية، لكل مساحة عمل وللتثبيت كلّه.

كل شيء معطّل افتراضيًا. لا يمكن تفعيل المساعد ولا اقتراحات الإصلاح قبل أن يقبل المشغّل اتفاقية معالجة الذكاء الاصطناعي في الصفحة نفسها.

يُشفَّر مفتاح الـ API بالمفتاح الرئيسي للتثبيت. ولا يُعرض مجددًا بعد الحفظ - تظهر آخر أربعة أحرف منه فقط.

ما الذي يستخدمه

Section titled “ما الذي يستخدمه”
الميزةمن يفعّلهاما الذي يُرسَل إلى المزوّد
اقتراح إصلاح على نتائج ArchPilot وArchScanالمشغّل: Allow fix suggestionsمفتاح القاعدة، والخطورة، ومسار الملف والسطر، ونص النتيجة، واقتراح المحلّل نفسه
تبويب Archito ← Askالمشغّل: Offer the assistantالسؤال والأرقام المستخدمة للإجابة (أسماء المشاريع، أعداد النتائج، إجماليات الفحص)
أحكام الذكاء الاصطناعي على تعليقات مراجعة MRمساحة العمل: إعدادات ArchPilot، اختياري؛ يتطلّب أحد مفتاحَي المشغّلتعليقات المراجعة المعلّقة التي تُصنَّف
مولّد MD، وضع الذكاء الاصطناعيالمشغّل: Allow fix suggestionsمعطيات المشروع، ومسوّدة القالب المولَّدة، وشريحة سطحية من المستودع: الوصف، والوسوم، وقائمة الجذر، وبضعة ملفات manifest (مثل package.json و*.csproj وgo.mod، مقتطعة) وملف README الموجود

لا ترسل أيٌّ منها المستودع كاملًا. كيف يبدو المساعد للمستخدمين: Archito، المساعد.

اقتراحات الإصلاح

Section titled “اقتراحات الإصلاح”
  • تُكتب الإجابة بلغة لوحة القارئ (التركية، الإنجليزية، الألمانية، الفرنسية، الإسبانية، الروسية، العربية، الأذربيجانية؛ وأي لغة أخرى تعود إلى الإنجليزية)، بالنموذج الافتراضي.
  • تُخزَّن كل إجابة مع النتيجة، مع المزوّد والنموذج وعدد رموز الإدخال والإخراج واللغة. من يفتح النتيجة نفسها لاحقًا يرى الإجابة المخزّنة دون إنفاق رموز من جديد. وإعادة التوليد إجراء مقصود.

مولّد MD

Section titled “مولّد MD”

دون ذكاء اصطناعي يعمل مولّد MD في وضع القالب (الإنجليزية فقط). راجع مولّد MD.

الحدود

Section titled “الحدود”
  • حدّ المعدّل: 30 استدعاءً للذكاء الاصطناعي كحدّ أقصى لكل مساحة عمل في الدقيقة، عبر كل الميزات. يُحفظ العدّاد في Redis؛ وإذا تعذّر الوصول إلى Redis لا يُطبَّق الحدّ.
  • ميزانيات الرموز: لكل مساحة عمل يوميًا وأسبوعيًا، وللتثبيت يوميًا وأسبوعيًا. 0 يعني بلا حدّ. يبدأ اليوم عند منتصف الليل UTC والأسبوع يوم الاثنين. سقف التثبيت هو الغالب دائمًا. تحتسب الميزانيات تبويب Ask وتصنيف تعليقات المراجعة.

الشبكة

Section titled “الشبكة”

تستدعي الـ Api المزوّد مباشرة:

  • https://api.anthropic.com
  • https://api.openai.com
  • https://generativelanguage.googleapis.com

لا يوجد وسيط (relay) يستضيفه AppArch. في شبكة معزولة اترك الذكاء الاصطناعي معطّلًا - فلا شيء يمكنه الوصول إليه.