Your AI Connector Docs

نموذج الذكاء الاصطناعي و BYOK

تشرح هذه الصفحة نموذج الذكاء الاصطناعي الذي يشغل برنامج الروبوت الخاص بك، وسبب دعم مزود واحد فقط لـ BYOK (إحضار مفتاحك الخاص)، وكيفية إعداد مفتاحك الخاص إذا كانت خطتك تتضمن ذلك.


ما هو نموذج الذكاء الاصطناعي الذي يشغل الروبوت

تستخدم المنصة Anthropic Claude كنموذج أساسي لروبوتك. تم اختيار Claude لأنه، بعد اختبارات مكثفة عبر كل نموذج رائد رئيسي (مصطلح صناعي لأكثر نماذج الذكاء الاصطناعي تقدمًا المتاحة) في السوق، هو الوحيد الذي يتعامل مع حجم رسائل الإنتاج بشكل موثوق.

لا تحتاج إلى اختيار نموذج. تختار المنصة تلقائياً النموذج المناسب لكل مهمة وتحافظ على انخفاض تكلفة المحادثة الواحدة.


لماذا Anthropic فقط لـ BYOK

يسأل العملاء غالبًا عما إذا كنا سنضيف دعمًا لـ OpenAI أو Google Gemini أو OpenRouter أو النماذج مفتوحة المصدر لـ BYOK. الإجابة الصادقة هي: لا يوجد أي منها، عند استخدامه بشكل خام وغير مُحسّن، يصمد عند حجم الإنتاج الفعلي.

بالنسبة للمشاريع الصغيرة، يعتبر معدل نجاح 9 من 10 من الذكاء الاصطناعي أمرًا مقبولاً. بمجرد أن تبدأ في إجراء محادثات حقيقية مع العملاء على نطاق واسع، فإن معدل فشل بنسبة 10% يعني حجوزات معطلة، وإجابات خاطئة، ومتابعات فائتة، ومبيعات مفقودة. هذا هو النطاق الذي نراه حتى من النماذج الرائدة من الدرجة الأولى من مزودين آخرين (حوالي 6-10% في الحالات الصعبة والمفتعلة، أي أسئلة الاختبار الصعبة والمقصودة) - وذلك قبل الأخذ في الاعتبار النماذج الأرخص.

تندرج المشكلات تحت ثلاث فئات:

  • الحالات الاستثنائية تتعطل بشكل غير متوقع. يمكن أن يعمل النموذج بشكل مثالي لمئات الدردشات، ثم فجأة يبدأ في هلوسة استدعاء أداة، أو يدعي أنه فعل شيئًا لم يفعله، أو يسقط التعليمات في منتصف المحادثة.
  • السياق الطويل لا يتم التعامل معه بشكل جيد. تستخدم استجابة الروبوت الواحدة سجل الدردشة، والأسئلة الشائعة، ومنطق المتابعة، واستدعاءات الأدوات، والاستنتاج. تعاني معظم النماذج من هذا الحجم وتنتج مخرجات أسوأ.
  • “الأرخص” نادرًا ما يكون كذلك. يتم تعويض السعر المعلن الأقل لكل رمز (token) من خلال المزيد من عمليات إعادة المحاولة، والمزيد من رموز المخرجات، وتحويل أسوأ. تنتهي التكلفة الحقيقية لكل محادثة ناجحة بأن تكون أعلى.

إن دعم 100 نموذج مختلف هو أقرب إلى كونه شعارًا تسويقيًا منه إلى قدرة حقيقية. نحن نفضل أن نقدم لك مزودًا واحدًا يعمل بشكل موثوق بدلاً من خمسة مزودين يتعطل كل منهم بطرق مختلفة.


Max

Max مصمم خصيصاً لمحادثات المبيعات والدعم التي تديرها المنصة فعلياً. تبلغ تكلفته جزءاً بسيطاً من سعر Pro (0.25 رصيد لكل إجراء) ويحافظ على دقته في المواقف التي قد تخطئ فيها النماذج الاقتصادية.

لا يحتاج Max إلى إعداد: لا اختيار للنموذج، ولا حساب مزود، ولا مفتاح. إنه النموذج الأكثر دقة الذي نقدمه، والأفضل في الالتزام بما تقوله شركتك فعلياً. لمعرفة كيف يقارن Max بنموذج Claude والنماذج الاقتصادية التابعة لجهات خارجية التي يسأل عنها العملاء غالباً، راجع لماذا يعتبر Max هو الخيار الأفضل قيمة.

من يمكنه رؤية فئة Max

إذا كان محدد جودة الذكاء الاصطناعي في علامة تبويب تعليمات الذكاء الاصطناعي الخاصة بالوكيل (Agent) يظهر Pro ولكن لا يظهر Max أو Mini، فهذا يعني ببساطة أن Max غير مفعل للحساب الذي سجلت دخولك به. هناك أمران يفعّلان هذا الخيار:

  • الحسابات المشمولة في خطة مدى الحياة المؤهلة تحصل على Max تلقائياً.
  • أي حساب آخر يحتاج إلى تفعيل Max عليه بشكل صريح.

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

ربط مفتاح Anthropic الخاص بك (BYOK) لا علاقة له بظهور Max من عدمه. يعمل الاثنان جنباً إلى جنب — راجع ملاحظة الاستثناء تحت إعداد BYOK لمعرفة كيفية محاسبة وكيل Max عند ربط مفتاح خاص بك. إزالة مفتاح API الخاص بك لن تجعل Max يظهر.

فئة Mini

إذا كان بإمكانك رؤية Max، فيمكنك أيضاً رؤية Mini، بتكلفة 0.15 رصيد لكل إجراء. Mini هو نفس نموذج الذكاء الاصطناعي الخاص بـ Max ولكن بسعر أقل، مع وجود مقايضتين:

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

يظل Max هو الخيار الموصى به لأي شيء قد تؤدي فيه التفاصيل الخاطئة إلى خسارة عملية بيع — مثل الحجوزات، وأسئلة التسعير، والدعم ذي المخاطر الحقيقية. بينما يناسب Mini المحادثات ذات الحجم الكبير والحساسة للسعر حيث تكون السرعة والتكلفة أكثر أهمية من النسبة المئوية الأخيرة من الدقة.

يتوفر Mini في نفس أداة اختيار جودة الذكاء الاصطناعي (AI Quality) مثل Max، في كل حساب يحتوي على Max. ومثل Max، لا يستخدم Mini أبداً مفتاح BYOK، لذا لا يتم استخدام (أو محاسبة) مفتاح Anthropic المتصل أثناء عمل الوكيل (Agent) على Mini.

ما الذي يغطيه سعر 0.15 لنموذج Mini. ينطبق سعر Mini على كل ما يحدث داخل المحادثة المباشرة: ردود الذكاء الاصطناعي، واستدعاءات أدوات الذكاء الاصطناعي (مثل حجز موعد أو تنبيه موظف بشري)، وتقييمات الدردشة (تحديد ما إذا كان يجب تجاهل المحادثة أو إغلاقها)، ومعالجة المقاطعات (عندما يرسل جهة الاتصال رسالة جديدة بينما لا يزال الروبوت يكتب رده)، وملخصات الدردشة، ووضع العلامات التلقائي بواسطة الذكاء الاصطناعي. ميزات الذكاء الاصطناعي الفردية خارج المحادثة — تحسين الوكيل (Optimize with AI)، وإنشاء قاعدة المعرفة، ووضع العلامات الذي يتم عبر واجهة برمجة التطبيقات (API) — لها سعر ثابت قدره 0.25 رصيد لكل من Max و Mini، لذا قد ترى إدخالات بقيمة 0.25 في سجل رصيدك حتى عندما يتم ضبط كل وكيل على Mini. هذه الميزات هي المقصودة، وليس نموذج Max الذي يجيب على محادثاتك.


إعداد BYOK

ميزة BYOK مضمنة في خطتي Agency و Agency Unlimited، وفي مستويات AppSumo مدى الحياة بدءاً من Plan 2 فصاعداً. وهي ليست جزءاً من خطة Business. إذا كانت خطتك تتضمن هذه الميزة، فيمكنك ربط مفتاح Anthropic API الخاص بك (وهو رمز خاص من حسابك على Anthropic يسمح للمنصة بفوترة استخدامك للذكاء الاصطناعي مباشرةً إليك بدلاً من استخدام أرصدة المنصة).

المفاتيح الرسمية من Anthropic فقط هي التي تعمل. يأتي المفتاح الصالح من حسابك الخاص على console.anthropic.com ويبدأ دائمًا بـ sk-ant-. المفاتيح الواردة من الموزعين أو الوكلاء أو مواقع “واجهة برمجة تطبيقات Claude المخفضة” (التي تبدأ غالبًا ببادئة مختلفة) غير مدعومة ولن يتم حفظها. كن حذرًا من عروض رموز Claude الرخيصة التي تقل كثيرًا عن أسعار Anthropic نفسها - لا يمكن لأحد إعادة بيع وصول Claude بشكل قانوني بأقل مما تفرضه Anthropic، وتلك العروض هي في الغالب عمليات احتيال مبنية على مفاتيح مسروقة أو تم إعدادها للحصول على تفاصيل الدفع الخاصة بك.

هل تستخدم هاتفاً؟ قد تكون القائمة الجانبية اليسرى مخفية. اضغط على أيقونة القائمة (☰) أولاً، ثم اضغط على Settings.

ألا ترى مفاتيح BYOK API في مجموعة الإعدادات المتقدمة؟ يظهر هذا القسم فقط في الخطط التي تتضمن ميزة BYOK. إذا كان حسابك مُداراً من قبل مزود خدمة، فإنه يظهر فقط عندما يقوم بتفعيل استخدام مفتاح API الخاص بك (Bring Your Own API Key) لحسابك.

  1. في الشريط الجانبي الأيسر الرئيسي، انقر فوق Settings (أيقونة الترس بالقرب من الأسفل).
  2. في صفحة الإعدادات، في القائمة اليمنى، قم بالتمرير إلى مجموعة Advanced.
  3. انقر فوق BYOK API Keys.
  1. انقر على إضافة مفتاح (Add key) في بطاقة Anthropic. سيظهر حقل المفتاح السري (Secret key) (العنصر النائب sk-ant-…).
  1. الصق مفتاح واجهة برمجة تطبيقات (API) Anthropic الخاص بك في الحقل، ثم انقر على حفظ المفتاح (Save key).

بمجرد التفعيل، تستخدم الوكلاء (Agents) في مستوى جودة الذكاء الاصطناعي Pro مفتاحك الخاص للردود، وستدفع لشركة Anthropic مباشرة مقابل هذا الاستخدام بدلاً من استهلاك رصيد المنصة على تلك الردود. الوكلاء في مستوى Max أو Mini لا يستخدمون مفتاحك أبداً ويستمرون في استخدام الرصيد (انظر الاستثناء أدناه). تستمر البنية التحتية للقنوات (خوادم WhatsApp Web، وأرقام الهواتف، وما إلى ذلك) في استخدام الرصيد كالمعتاد.

استثناء واحد — مستوى Max. إذا تم ضبط جودة الذكاء الاصطناعي للوكيل على مستوى Max، فسيتم محاسبة هذا الوكيل بمعدل 0.25 رصيد لكل إجراء حتى عند توصيل مفتاحك الخاص (BYOK) — فمستوى Max لا يستخدم مفتاح Anthropic الخاص بك أبداً. (ينطبق الشيء نفسه على Mini، حيثما توفر: 0.15 رصيد لكل إجراء، ولا يستخدم مفتاحك أبداً.) لمحاسبة الردود على حساب Anthropic الخاص بك، أبقِ الوكيل على مستوى Pro. المستويات هي Max و Pro و Mini؛ ولا يوجد مستوى قياسي (Standard) منفصل. يوجد محدد جودة الذكاء الاصطناعي (AI Quality) في علامة تبويب تعليمات الذكاء الاصطناعي (AI Instructions) الخاصة بكل وكيل. تعرض صفحة إعدادات مفاتيح واجهة برمجة التطبيقات الخاصة بك (BYOK API Keys) إشعاراً في كل مرة يكون فيها مفتاحك مسجلاً ولكن واحداً أو أكثر من وكلائك لا يزال يعمل على مستوى Max، مع إدراج أسمائهم — حتى تتمكن من معرفة سبب استمرار استهلاك الرصيد في لمحة سريعة.

ملاحظة حول التكلفة: لم يعد استخدام مفتاحك الخاص (BYOK) هو الخيار الأرخص. عند توصيل مفتاح خاص، يعمل وكيلك باستخدام Claude وتدفع أسعار Anthropic المباشرة (تقوم Anthropic بفوترتك بناءً على استخدامك الفعلي، تماماً مثل فاتورة المرافق). عند القياس عبر الحسابات التي تستخدم مفتاحها الخاص، تبلغ تكلفة رد الذكاء الاصطناعي الواحد حوالي 3 أضعاف تكلفة نفس الرد على Max وأكثر من 5 أضعاف تكلفته على Mini، بمجرد احتساب العمليات الخلفية التي يطلقها الرد (البحث في قاعدة المعرفة، فحص البريد المزعج، استخراج الأسماء والبريد الإلكتروني، تقييمات الدردشة، التصنيف)، وكلها مشمولة في سعر Max و Mini الثابت ولكن يتم فوترتها لكل رمز (token) عند استخدام مفتاحك الخاص. ببساطة، Max و Mini أرخص بكثير، كما أن Max هو النموذج الأكثر دقة الذي نقدمه. استخدم خيار BYOK فقط عندما تريد فوترة استخدام الذكاء الاصطناعي على حسابك الخاص في Anthropic، وليس لتوفير المال.

لماذا يكلف الرد الأول في المحادثة أكثر بكثير من بقية الردود. يعمل التخزين المؤقت عن طريق حفظ سياق المحادثة لدى Anthropic في المرة الأولى التي يتم إرسالها فيها، ثم إعادة استخدامه. كتابة هذا السياق تكلف أكثر من الطلب العادي؛ وكل رد يعيد استخدامه يكلف حوالي جزء من عشرين من التكلفة. لذا يبدو الرد الأول باهظ التكلفة بشكل مثير للقلق، بينما تكون الردود التي تليه رخيصة جداً. أي شيء كبير في المحادثة يجعل ذلك الرد الأول أكبر — والمستند الذي يقوم الزائر برفعه هو السبب الرئيسي. ملف PDF مكون من 24 صفحة يعادل حوالي 70,000 رمز (token)، لأن كل صفحة يتم إرسالها كنص وصورة للصفحة، وتبقى في المحادثة، لذا يتم إعادة إرسالها (وإعادة تخزينها مؤقتاً) مع كل رد. إذا ظلت المحادثة هادئة لأكثر من ساعة، تنتهي صلاحية النسخة المخزنة ويدفع الرد التالي تكلفة الكتابة مرة أخرى.

إذا كنت تبني شيئاً يعتمد بكثافة على المستندات — مثل أدوات شرح العقود، أو البحث في الأدلة، أو أي شيء يقوم فيه الأشخاص برفع ملفات — فإن مستوى Max عادة ما يكون الخيار الأنسب: فهو بتكلفة ثابتة قدرها 0.25 رصيد لكل رد بغض النظر عن حجم المستند، لذا لا توجد زيادة مفاجئة في تكلفة الرسالة الأولى ولا يوجد تعرض لتكلفة لكل رمز (per-token) على الإطلاق. راجع لماذا تعتبر Max هي القيمة الأفضل لمعرفة كيف تقارن Max من حيث الجودة والتكلفة.

إذا فشل مفتاح BYOK الخاص بك (غير صالح، أو تجاوز الحصة، أو تم تقييد معدل الاستخدام — مما يعني أن Anthropic قد حدت مؤقتًا من عدد الطلبات التي يمكن لمفتاحك إجراؤها)، فإن استمرار عمل الروبوت الخاص بك يعتمد على مفتاح التبديل “Fallback to credits” الموجود في نفس صفحة مفاتيح BYOK API:

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

في كلتا الحالتين، ستتلقى بريدًا إلكترونيًا في المرة الأولى التي يفشل فيها مفتاحك (وليس رسالة واحدة لكل محاولة).


أسئلة متكررة

هل يمكنني استخدام OpenAI أو Gemini أو مزود آخر لـ BYOK؟ ليس حالياً بالنسبة للمزودين الآخرين. بالنسبة لمعظم الأشخاص، الإجابة موجودة بالفعل هنا: Max و Mini، بتكلفة 0.25 و 0.15 رصيد لكل إجراء.

هل سيتم استخدام مفتاح BYOK الخاص بي لكل شيء؟ معظم عمليات الذكاء الاصطناعي معفاة من رسوم الرصيد عند توصيل مفتاح Anthropic الخاص بك (BYOK): ردود الذكاء الاصطناعي، استخدام الأدوات، تحسين الوكيل، إنشاء قاعدة المعرفة، والبحث عبر الويب، كلها تعمل باستخدام مفتاحك. هناك أربعة أشياء لا تزال تكلف أرصدة حتى مع توصيل مفتاح: مستوى Max بتكلفة 0.25 رصيد لكل إجراء، ومستوى Mini بتكلفة 0.15 (وهذا يشمل استيراد قاعدة المعرفة المرتبط بوكيل مضبوط على Max، بتكلفة 0.25 لكل جزء)؛ أداة العثور على العملاء المحتملين (Lead Finder) بتكلفة 0.25 لكل عنوان بريد إلكتروني يتم العثور عليه؛ والأتمتة (Automations) بتكلفة 0.25 لكل تشغيل بالإضافة إلى 0.25 لكل خطوة ذكاء اصطناعي. للحفاظ على عمل الوكيل بالكامل باستخدام مفتاحك الخاص بتكلفة 0 رصيد، اتركه على مستوى Pro. يتم فوترة رسوم القنوات (رسوم WhatsApp Web الشهرية، ورسوم تسليم رسائل WhatsApp والقوالب) بشكل منفصل عن استخدام الذكاء الاصطناعي في كلتا الحالتين. إذا فشل المفتاح في مكالمة كان من المفترض أن تعمل عليه، فإن اعتماد المنصة على الأرصدة كبديل يعتمد على مفتاح الرجوع إلى الأرصدة (Fallback to credits) الخاص بك — راجع مفتاح “الرجوع إلى الأرصدة” الموضح أعلاه في هذه الصفحة.

متى تكون ردود الذكاء الاصطناعي مجانية (بتكلفة 0 رصيد) بالضبط؟ ميزة إحضار مفتاحك الخاص (BYOK) مخصصة لكل حساب على حدة. لا تستهلك ردود الذكاء الاصطناعي أي رصيد فقط عندما يكون هذا الحساب قد ربط مفتاحه الخاص من Anthropic. وبدون وجود مفتاح خاص، يتم خصم الرصيد من الردود بالمعدل العادي.

هل يؤثر BYOK على تسليم الرسائل أو موثوقية القناة؟ لا. يغير BYOK فقط كيفية محاسبتك على استدعاءات الذكاء الاصطناعي الخاصة بروبوتك. كل شيء آخر — توجيه الرسائل، وبنية القناة التحتية، والمتابعات، والبث (Broadcasts) — يعمل بنفس الطريقة تماماً.


انظر أيضاً: لماذا تعتبر فئة Max هي الأفضل قيمة · إعداد روبوت الذكاء الاصطناعي الخاص بك · وكلاء الذكاء الاصطناعي