مفاتيح LLM API (أحضر مفتاحك الخاص)

BYOK (Bring Your Own Key) يعني أن FlexyAgents تستدعي مزودي النماذج بالبيانات الاعتمادية التي تسجّلها في لوحة التحكم (الإعدادات → مفاتيح LLM API؛ قد يتضمن المسار بادئة locale مثل /ar/). يُفوتر استخدام هذه الاستدعاءات لدى مزودك وفق عقدك؛ قد تستمر الخطط المستضافة في تطبيق حصص FlexyAgents حيث توفر المنصة النموذج.

مفتاح Google Gemini مهم خصوصًا إذا استخدمت وصف الصور (vision) أو نسخ الصوت/الفيديو عند الاستيراد أو زحف الويب: مع مفتاح Gemini نشط للمؤسسة، تستخدم هذه الوظائف مفتاحك ولا تستهلك حصص «التعرف على الصور» أو «نسخ الوسائط» المستضافة في خطة FlexyAgents.

أين تُضاف المفاتيح

اذهب إلى لوحة التحكم → الإعدادات → مفاتيح LLM API (قد تختلف التسميات قليلًا حسب locale). أضف مفتاحًا لكل مزود مطلوب. تُخزَّن المفاتيح مشفّرة؛ أعضاء المؤسسة المصرّح لهم فقط يمكنهم رؤيتها أو استبدالها.

بعد الحفظ، انتظر دقيقة لانتشار الإعداد قبل إعادة اختبار الوكلاء التي فشلت لنقص مفتاح.

المزودون المدعومون يشملون نماذج الدردشة الرئيسية (OpenAI-compatible حيث ينطبق، Anthropic، Google Gemini وغيرهم في الواجهة).
إذا كانت خطتك BYOK فقط لمزود، لن ينتقل الدردشة إلى مفاتيح FlexyAgents المستضافة — يجب تقديم مفتاح صالح.

Gemini واستيراد المعرفة

استيرادات وزحوفات الصور قد تنفّذ OCR (استخراج نص من البكسل) بلا Gemini. رؤية Gemini الاختيارية تولّد أوصافًا أغنى بلغة طبيعية للبحث والإجابات — هذا ما تسميه حدود الخطة «التعرف على الصور» عند الفوترة على بنية مستضافة.

كذلك، يمكن نسخ ملفات الصوت والفيديو بـ Gemini إن فُعّل؛ قد تعدّ الخطط المستضافة النسخ الناجحة ضمن حدود «نسخ الوسائط» الشهرية ما لم توفر المؤسسة مفتاح Gemini.

تعرض واجهة الاستيراد الاستخدام الشهري المستضاف للتعرف على الصور ونسخ الوسائط حتى يعرف المشغّلون قبل بلوغ الحدود.
إذا رأيت خطأ حصة عند الاستيراد، أضف مفتاح Gemini أو اطلب من admin رفع سقف الخطة؛ مسارات OCR وحدها قد تنتج نصًا بلا vision.

التدوير والاستجابة للحوادث

عامل مفاتيح LLM ككلمات مرور قاعدة بيانات: تدوير مجدول، تدوير فوري عند التسريب، وتوثيق أي فرق تملك أي حسابات مزود.

عند انتهاء مفتاح، يُرجع الوكلاء المعنيون أخطاء المزود — راجع سجلات لوحة التحكم واختبر الدردشة برسالة واحدة قبل الإعطاء.

فضّل مفاتيح أو مشاريع منفصلة لكل بيئة (staging مقابل الإنتاج) حتى لا يعرّض تسريب staging سقوف الإنفاق في الإنتاج.
استخدم تنبيهات وميزانيات لدى المزود؛ FlexyAgents لا تُستبدل ضوابط فوترة السحابة.

الامتثال وتدفق البيانات

DPA مع كل مزود نموذج يحكم المُعيدين للتعهيد والمناطق والاحتفاظ. تنقل FlexyAgents prompts والسياق المسترجَع إلى المزود الذي يختاره الوكيل.

لإقامة بيانات صارمة، أكّد خيارات نشر FlexyAgents ومنطقة المزود للمفتاح الذي تُعدّه.

مفاتيح LLM API (أحضر مفتاحك الخاص)

أين تُضاف المفاتيح

Gemini واستيراد المعرفة

التدوير والاستجابة للحوادث

الامتثال وتدفق البيانات

هل أنت مستعد لإطلاق مساعدين مرتكزين؟