النماذج والمزوّدون
تعمل وكلاء HeroMate مع HeroMate Managed AI ومزوّدين مباشرين مثل OpenAI و Anthropic و Google Gemini. التبديل تغيير حقل واحد — دون إعادة كتابة كود ودون هيكل محوّل. أدواتك وذاكرتك وتوجيهاتك مستقلة عن النموذج.
المزوّدون المدعومون
| المزوّد | النماذج الشائعة | الأفضل لـ |
|---|---|---|
| HeroMate Managed AI | google/gemini-3.1-flash-lite-preview و google/gemini-2.5-flash-lite و openai/gpt-5-nano | دون بيانات اعتماد عميل وأرصدة مضمّنة وفاتورة مركزية |
| OpenAI | gpt-5-nano و gpt-5-mini و gpt-5.4-nano | أغراض عامة واستخدام أدوات قوي ونظام بيئي واسع |
| Anthropic | claude-haiku-4.5 | اتباع تعليمات قوي عندما يمكنك تحمّل التكلفة الأعلى |
| Google Gemini | gemini-3-flash-preview و gemini-2.5-flash-lite | رخيص جداً وسريع وممتاز لحالات الاستخدام عالية الحجم |
تُحمَّل القائمة الكاملة للنماذج المتاحة ديناميكياً في لوحة التحكم عندما تختار مزوّداً — سترى دائماً ما هو مدعوم حالياً. على HeroMate Managed AI، النماذج التي يمكنك اختيارها مقيّدة بالخطة وتُدار على مستوى المؤسسة في صفحة نماذج الذكاء الاصطناعي (/{org}/ai-models).
HeroMate Managed (دون بيانات اعتماد)
أسرع مسار يحتاج لا مفتاح API على الإطلاق. اضبط المزوّد على HeroMate Managed واختر نموذجاً — توجّه HeroMate الطلب عبر كتالوجها المدار (مدعوم بـ OpenRouter) وتفوتر الاستخدام كـ أرصدة ذكاء اصطناعي.
اضبط المزوّد
في عقدة الوكيل، اختر HeroMate Managed كمزوّد.
اختر نموذجاً
اختر من الكتالوج المدار. تعتمد النماذج الظاهرة على خطتك (توافر النموذج المدار مقيّد بالخطة — راجع صفحة نماذج الذكاء الاصطناعي للمؤسسة).
تم
لا بيانات اعتماد مطلوبة. يُقاس الاستخدام كأرصدة ذكاء اصطناعي — راجع الذكاء الاصطناعي المدار وأرصدة الذكاء الاصطناعي.
ربط مزوّد (BYOK)
لإحضار مفتاحك لـ OpenAI أو Anthropic أو Gemini، احفظ بيانات اعتماد أولاً.
احصل على مفتاح API
- OpenAI → platform.openai.com → API keys
- Anthropic → console.anthropic.com → API keys
- Google → ai.google.dev → Get API key
احفظه في HeroMate
افتح لوحة تحكم مشروعك → Credentials → Add new → اختر المزوّد → الصق مفتاحك. أعطه اسماً واضحاً مثل «OpenAI Production».
استخدمه في وكيلك
في عقدة الوكيل، اختر المزوّد ثم اختر بيانات الاعتماد التي حفظتها للتو. يمتلئ قائمة النماذج تلقائياً. مع BYOK تدفع للمزوّد مباشرة — لا تضيف HeroMate هامشاً على رموزك.
تبديل المزوّدين
تبديل النماذج — حتى عبر المزوّدين — مجرد تحرير عقدة الوكيل. لا يتغيّر شيء آخر:
- يبقى توجيه النظام نفسه
- تبقى أدواتك نفسها
- تبقى ذاكرتك نفسها (مخزَّنة كأجزاء محتوى، لا بتنسيقات خاصة بالمزوّد)
- يبقى كود واجهتك نفسه
هذا يجعل اختبار A/B واستراتيجيات الاحتياطي تافهة. ابنِ مرة وجرّب أي نموذج.
اختيار النموذج المناسب
معرّفات النماذج أدناه أمثلة — راجع دائماً القائمة المباشرة في لوحة التحكم لما هو متاح حالياً على خطتك.
رخيص وسريع
أمثلة: gemini-2.5-flash-lite أو gpt-5-nano. ممتاز لروبوتات الدردشة عالية الحجم والتصنيف واستخدام الأدوات البسيط.
متوازن
أمثلة: gemini-3.1-flash-lite-preview أو gpt-5-mini. توازن جيد بين الجودة وزمن الاستجابة والتكلفة.
أعلى قدرة
أمثلة: gpt-5.4-nano أو claude-haiku-4.5. للوكلاء الذين يحتاجون قدرة أكبر دون القفز إلى نماذج باهظة جداً.
سياق طويل
أمثلة: gemini-3.1-flash-lite-preview أو gemini-2.5-flash-lite. عندما تحتاج مستندات كبيرة أو سجلات طويلة مع التحكم في التكلفة.
درجة الحرارة
يتحكم حقل temperature في العشوائية:
- 0.0 – 0.3 → حتمي ووقائعي. استخدم للاستخراج والتصنيف والمخرج المنظَّم.
- 0.5 – 0.8 → متوازن. الافتراضي لمعظم وكلاء الدردشة.
- 0.9 – 1.2 → إبداعي ومتنوّع. استخدم للعصف الذهني وتوليد المحتوى والردود المتنوعة.
الافتراضي هو 0.7.
الحد الأقصى لرموز المخرج
يحدّ حقل max_output_tokens عدد الرموز التي يمكن للنموذج توليدها في رد واحد. الافتراضي 1024. ارفعه للإجابات الطويلة؛ اخفضه لإبقاء الردود (والتكلفة) ضيقة. على HeroMate Managed AI تُثبَّت هذه القيمة بخطتك، لذا قد تُحد الطلبات الكبيرة جداً تلقائياً.
المخرج المنظَّم
أحياناً تريد أن يُرجع الوكيل JSON مطابقاً لشكل محدد بدل نص حر — لتحليل المشاعر أو استخراج البيانات أو الوسم أو سير العمل البرمجي.
مرّر مخطط JSON في حقل output_schema:
{
"type": "object",
"properties": {
"sentiment": {
"type": "string",
"enum": ["positive", "negative", "neutral"]
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"summary": { "type": "string" }
},
"required": ["sentiment", "confidence"]
}
مع هذا مضبوطاً، يطابق رد الوكيل المخطط دائماً. يصل الرد في حقل object بدل content:
{
"object": {
"sentiment": "positive",
"confidence": 0.87,
"summary": "Customer is satisfied with delivery speed."
}
}
مخرج منظَّم + أدوات
يمكنك دمج المخرج المنظَّم مع الأدوات. سيستدعي الوكيل الأدوات حسب الحاجة أثناء المحادثة، ثم ينتج إجابته النهائية كـ JSON مطابق لمخططك.
الاستخدام والتكلفة
يتضمن كل رد وكيل كتلة usage:
{
"usage": {
"prompt_tokens": 1820,
"completion_tokens": 142,
"total_tokens": 1962
}
}
تعتمد كيفية الفوترة على الوضع الذي يعمل فيه الوكيل:
BYOK (مفتاحك). تدفع للمزوّد مباشرة — لا تضيف HeroMate هامشاً على رموزك. تُفوتر بيانات الاعتماد التي أضفتها من OpenAI / Anthropic / Google حسب تسعيرهم العام.
HeroMate Managed AI. يُقاس الاستخدام كـ أرصدة ذكاء اصطناعي (مُسعَّرة كـ «أرصدة ذكاء اصطناعي / 1M رمز»). يُرجع الوكيل كتلة managed_ai_billing بجانب usage، وتُسحب التكلفة من أرصدة خطتك الشهرية أولاً، ثم من أي حزم شحن مشتراة. هناك تحويل أرصدة — ليس تمرير مباشر. تحصل الخطط المجانية على +5 أرصدة ذكاء اصطناعي/يومياً؛ يحصل Pro على 100/شهرياً. راجع أرصدة الذكاء الاصطناعي والذكاء الاصطناعي المدار.
النماذج التي يمكنك استخدامها مقيّدة بالخطة
على HeroMate Managed AI، يُدار كتالوج النماذج المتاح على مستوى المؤسسة في صفحة نماذج الذكاء الاصطناعي (/{org}/ai-models) ويعتمد على خطتك. مع BYOK يمكنك استخدام أي نموذج يدعمه مفتاح مزوّدك.