التكامل
التكامل
Connect EmpirioLabs to coding agents, IDEs, CLIs, conversation frontends, and OpenAI-compatible tools
معظم الأدوات تحتاج فقط إلى ثلاث قيم: مفتاح API، عنوان URL أساسي، ومعرف نموذج. EmpirioLabs يعرض إكمالات الدردشة المتوافقة مع OpenAI بالإضافة إلى نقطة نهاية رسائل على غرار Anthropic، لذا عادة ما يكون الإعداد عبارة عن قائمة منسدلة من مزود وتغيير رابط واحد.
أديري أمرًا واحدًا لخلق ملفاتٍ محلية مختارة إضافة أدوات على مستوى المستعمل وفحص للدخان مع العلم
استخدم https://api.empiriolabs.ai/v1 كرابط أساسي ومفتاح EmpirioLabs كرمز حامل.
يتوقع كلود كود شكل رسائل Anthropic. استخدم https://api.empiriolabs.ai بدون /v1 وحدد خيار النموذج المخصص.
اجلب GET /v1/models?available=true قبل ترميز معرفات النماذج في قوالب فرق أو سكريبتات مشتركة.
Codex CLI
Aider
Continue
OpenHands
Hermes Agent
SillyTavern
LobeChat
LiteLLMKilo, Roo, Cursorأحدث التجهيزات
استخدمي هذا عندما تريدين تجهيزاً للعمل بدون ملفات للثقب القيادة تدق نص المساعد من موقع الأطباء وتديره مع (بايتون) وتكتب فقط النطاقات التي تختارها وفيما يتعلق بالأدوات التي تدعم الثقوب المحلية المستمرة، يخزن المساعد المفتاح في ملفات المشاريع المتجاهلة بحيث لا تتوقف جلسات الطلبات التي أعيد فتحها على تصدير قذيفة.
أديروا القيادة
This default writes project-local files for OpenCode, Aider, Qwen Code, and OpenHands, including gitignored persistent accreditation for tools that can read them locally.
The helper creates timestamped supports before changing existing files, but it can write API keys into local .env, .empiriolabs-api-key, .qwen/settings.json, openhands.empiriolabs.toml, and some user config files. -الإستعراض قدّم ملفات قبل ارتكاب أيّ شيء. المُساعد لا يُثبت الأدوات نفسها.
ما كتبه المساعد
بشكل افتراضي، يقوم المساعد بجلب كتالوج live /v1/models?available=true ويكتب كل نموذج قادر على الدردشة (نص، متعدد الوسائط، برمج، استدلال) في أدوات تدعم إعداداتها الأصلية أداة اختيار متعددة النماذج (OpenCode، Continue، Qwen Code، goose). علم --model يختار الإعداد الافتراضي داخل تلك المجموعة المملوءة. مرر --no-populate-models إذا كنت تريد فقط النموذج الافتراضي المسجل.
يقوم المساعد بالتحقق من أسماء الأدوات ويخرج بخطأ لقيم غير معروفة. إذا لم تتطابق الأداة المختارة مع النطاق المختار، يقوم المساعد بطباعة ملاحظة. على سبيل المثال، --scope project --tools codex لا يكتب إعدادات Codex لأن Codex هو إعداد على مستوى المستخدم.
أما التكاملات غير المدرجة في هذا الجدول فهي معدات يدوية أو خطط على مستوى التطبيق. استخدام قيم الاتصال الواردة أدناه لكلاين، وزيد، ومدونة كيلو، ومدونة رو، ومجالات من نوع كورسور، ومواجهات الدردشة، واستضافت أجهزة الإعلام الإلكترونية.
تحديث القائمة النموذجية بعد إطلاق جديد
يقوم المساعد بجلب GET /v1/models?available=true في كل تشغيل ويعيد كتابة إعدادات النماذج المتعددة من تلك اللقطة الحية، بحيث تعكس قائمة النماذج المسجلة النماذج التي يتم إطلاقها في لحظة تنفيذ المساعد. إعادة تشغيل نفس الأمر بعد إطلاق نموذج جديد تضيفه إلى opencode.json OpenCode، وconfig.yaml Continue، وقائمة مزودي settings.json Qwen Code، وJSON الخاص بمزود المخصص من Goose دون أي تعديلات أخرى. لا تحتفظ Aider وOpenHands وClaude Code وCodex CLI وHermes Agent وOpenClaw بسجل متعدد النماذج في إعداداتها، لذا فإن تلك الأدوات تقرأ دائما النموذج الذي يمرره الكود عند وقت الطلب، مما يعني أنه لا حاجة لإعادة تشغيل المساعد لتلك الأدوات عند إطلاق نموذج جديد.
تأهب للسيارات (يتم تفاديه)
The setup command installs a platform-native scheduled task that re-fetches the EmpirioLabs model list every 6 hours so newly launched models appear in OpenCode, Qwen Code, Continue, and goose without any manual step. وتدار هذه الوظيفة بمفردها، في الخلفية، دون أن تكون هناك حاجة إلى دورة للقصف:
- ** Linux**: a marked entry in your user crontab (visible with
crontab -l) - MacOS: a user LaunchAgent at
~/Library/LaunchAgents/ai.empiriolabs.refresh.plist - ويندوز: مهمة جدولة المهام باسم “EmpirioLabs التحديث التلقائي”
وتقرأ الوظيفة مفتاح ” API ” من ~/.empiriolabs/.empiriolabs-api-key (المود 600 وتتجه اللوجز (المخدرات) والغطس (Linux/Windows) إلى ~/.empiriolabs/refresh.log.
مرر --no-auto-refresh إلى القيادة الإعدادية للاختيار، أو تشغيل المساعد في وقت لاحق مع --uninstall-auto-refresh لإزالة المهمة المقررة وتنظيف نقاط العلامات.
قيم الربط
بالنسبة للأدوات المتوافقة مع OpenAI، يجب عادة أن ينتهي رابط القاعدة عند /v1. لا تلصق مسار /v1/chat/completions الكامل في حقل رابط أساسي إلا إذا طلبت الأداة صراحة رابط نقطة نهاية كاملة.
ضوابط التفكير والتفسير
EmpirioLabs يعرض ضوابط التفكير فقط على النماذج التي تدرجها في صفحة النموذج أو المخطط القابل للقراءة آليا. لا ترسل هذه الحقول إلى كل نموذج بشكل افتراضي.
بالنسبة لإكمال وردود الدردشة المتوافقة مع OpenAI، يمكن أن تشمل الضوابط المدعومة enable_thinking أو thinking_budget أو reasoning_effort، حسب النموذج:
بالنسبة لنقطة نهاية الرسائل الأنثروبيكية، استخدام أسلوب الأنثروبيك للتفكير عندما يدعم النموذج التفكير:
reasoning_effort يقبل none وlow وmedium وhigh وmax في كل نموذج يستحق الاستدلال. EmpirioLabs يقوم بتطبيع القيمة إلى حقول الاستدلال المدعومة للنموذج المختار، بحيث تعمل نفس سلسلة الجهد عبر عائلات النماذج بغض النظر عما إذا كانت خدمة النموذج تتوقع reasoning_effort أو enable_thinking أو thinking_budget بشكل أصلي.
يتباين الدعم في مجال العنف:
اختبار الدخان
أدير هذا قبل تشكيل أداة أكبر إذا كان هذا يعمل، مفتاحك، الائتمانات، الشبكة، والهوية النموذجية جيدة.
لقائمة بطاقات الهوية النموذجية الحالية:
واجهات التحدي والدور
استخدم هذا القسم لتطبيقات الدردشة في BYOK، وأدوات تقمص الأدوار، وواجهات الويب المشتركة. عادة لا تحتاج هذه الأدوات إلى سكريبت المساعد. استخدم مفتاح واجهة برمجة التطبيقات EmpirioLabs، واختر نموذج دردشة مثل qwen3-max، واحتفظ بالأسرار في إعدادات التطبيق المحلية أو متغيرات البيئة.
بالنسبة لمحادثات تقمص الأدوار، نوصي عموما بالبدء بنماذج EmpirioLabs Native Inference أولا، ثم النماذج أو النسخ المدرجة في منطقة Singapore عندما لا تناسب التغطية الأصلية حالتك. تحقق من صفحة النماذج أو صفحة السعر قبل اختيار النموذج. كل نموذج يذكر موقعه الذي يخدم هناك. بالنسبة للنماذج التي تحتوي على نسخ، تحقق من مدخلات المتغيرات أيضا، لأن النسخة يمكن أن تقدم من منطقة مختلفة.
SillyTavern
SillyTavern هو واجهة أمامية محلية للعب الأدوار والدردشة مع الشخصيات. يعمل EmpirioLabs من خلال مصدر إكمال الدردشة المخصص المتوافق مع OpenAI.
- افتح (سيلي تافيرن) و اضغط على جهاز التحكم لفتح قنوات الاتصال
- اضبط نوع API على
Chat Completion. - اضبط مصدر إكمال الدردشة على
Custom (OpenAI-compatible). - وضع نقطة نهاية تعريفية/قاعدة URL إلى
https://api.empiriolabs.ai/v1. - الصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك في حقل مفتاح API مخصص.
- كليك كونتيك، ثم اختيار نموذج من الانزال أو نوع هويّة نموذجية مثل
qwen3-max.
لا تلصق https://api.empiriolabs.ai/v1/chat/completions في حقل رابط SillyTavern الأساسي. يضيف SillyTavern مسار إكمال الدردشة نفسه.
إذا كان الإنزال عارياً لكن اختبار الدخان الخاص بك يعمل، طباعة الهوية النموذجية يدوياً. إذا تسبب لاعب عينة خطأ في الطلب، يزيل بارامترات إضافية غير قياسية، ويعود إلى سلاسل الدردشة القياسية أولا.
PersonaLM
PersonaLLM هو تطبيق تقمص أدوار ودردشة شخصيات على iOS مع إعدادات bring-your-own-key مزودي الخدمة. EmpirioLabs يعمل من خلال محرك النصوص المخصص ل PersonaLLM.
- من الشاشة المنزلية، اسحب قائمة ثلاث دول في الأعلى اليسار.
- أفتحوا “ستينغز”
- محرك مفتوح
- اختر العرف
- اضبط رابط القاعدة على
https://api.empiriolabs.ai/v1. - قم بلصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك.
- في حقل العارضات، اضغط الزر على الحق في جلب قائمة النموذج الحي.
- اختر نموذج الدردشة مثل
qwen3-maxأوglm-5-1، ثم وفر محركات النص.
زر التفكير في PersonaLLM يرسل إعداد تفكير عند تفعيله ويحذف ضوابط التفكير عند تعطيله. EmpirioLabs يعامل حقل PersonaLLM المغفل على أنه يفكر فقط للنماذج التي يكون فيها الافتراضي هو التفكير. يتم تحديد هذا السلوك التوافقي لطلبات PersonaLLM؛ يجب على الأدوات الأخرى إرسال معلمات استدلال صريحة عندما تحتاج إلى تجاوز افتراضي النموذج.
Janitor AI
يمكن للذكاء الاصطناعي لعامل النظافة الاتصال EmpirioLabs من خلال تكوين الوكيل الخاص به. استخدم هذا المسار عندما تريد الاستمرار في استخدام واجهة دردشة عامل النظافة مع إحضار مفتاح EmpirioLabs خاص بك.
- افتحي دردشة جانيتور
- انقر على
using janitorأو زر القائمة بالقرب من أعلى الدردشة. - افتح
API Settings. - اختر تبويب
Proxy. - In Proxy Configurations, knock
+ New. - اضبط الاسم على
EmpirioLabs. - اضبط النموذج على
qwen3-max، أو معرف نموذج آخر منGET /v1/models?available=true. - اضبط رابط البروكسي على
https://api.empiriolabs.ai/v1/chat/completions. - الصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك في مفتاح API.
- أترك (كوزتوم برومبت) فارغاً إلا إذا كنت تستخدم واحداً من أجل تلك الشخصية أو الدردشة
- (كليك أد) ، أنقذي البيئات ثم أعيدي فتح صفحة (جانيتور آي) قبل إرسال الرسالة التالية
إذا كان لدى النظافة الاصطناعي مساعد + /chat/completions بجانب حقل رابط الوكيل، ابدأ ب https://api.empiriolabs.ai/v1 ودع المساعد يضيف المسار. يجب أن ينتهي رابط الحفظ ب /v1/chat/completions.
الطباعة
طباعة (ميند) يدعم نماذج الدردشة العرفية حيث تقدمين نقطة النهاية، هويّة نموذجيّة، وراسميّن اختياريين.
- افتح
Modelsمن الشريط الجانبي الأيسر. - افتح إعدادات النموذج، ثم اضغط
Add Custom Models. - استخدم نوع API
OpenAI Chat Completions APIإذا طلب النموذج ذلك. - اضبط واجهة برمجة تطبيقات نقطة النهاية على
https://api.empiriolabs.ai/v1/chat/completions. - وضع هوية نموذجية لـ
qwen3-maxأو نموذج آخر متاح. - أضف
Authorization: Bearer sk-empiriolabs-your_key_hereالرأس، أو الصق المفتاح في حقل مفتاح API الخاص ب TypingMind إذا كان النموذج يوفر واحدا. - “إختبار الذكاء، ثم أضف النموذج”
إعداد نموذج مخصص من TypingMind هو الاستثناء الرئيسي في هذه الصفحة: عادة ما يطلب نقطة نهاية إكمال الدردشة بالكامل، وليس فقط رابط القاعدة /v1.
Open WebUI
ويمكن لشبكة الإنترنت المفتوحة أن تتواصل مع مقدمي الخدمات المتوافقين مع نظام ” OpenAI ” من شاشات الاتصال المميزة.
- افتحي (أدمين ستينغز)
- اذهب إلى
Connectionsوأضف اتصال OpenAI جديد. - اضبط رابط الرابط على
https://api.empiriolabs.ai/v1. - قم بلصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك.
- وإذا كان الاكتشاف النموذجي بطيئاً أو واسعاً جداً، تُضاف هويات نموذجية مثل
qwen3-maxإلى مرشح الهويات النموذجية. - احفظ، ثم اختر نموذج EmpirioLabs في الدردشة.
بالنسبة لعمليات إطلاق الخواديم، المجموعة:
LibreChat
يدعم LibreChat نقاط نهاية مخصصة متوافقة مع OpenAI عبر librechat.yaml. استخدم متغيرا بيئيا لمفتاح نشر مشترك واحد، أو user_provided إذا كان يجب على كل مستخدم إحضار مفتاحه الخاص في واجهة المستخدم.
بالنسبة لنشر BYOK متعدد المستخدمين، قم بتغيير apiKey إلى:
أعد تشغيل LibreChat بعد تغيير librechat.yaml.
LobeChat
For self-hosted LobeChat, use the OpenAI provider with the EmpirioLabs API base URL:
ثم أعد تشغيل LobeChat واختر نموذج EmpirioLabs مفعل في محدد النماذج.
LiteLLM
EmpirioLabs مزود مدمج في LiteLLM، لذا يمكن لمجموعة تطوير البرمجيات ووكيل LiteLLM التوجيه إلى أي نموذج دردشة EmpirioLabs باستخدام بادئة empiriolabs/. في إصدارات LiteLLM التي سبقت المزود، استخدم النسخة الاحتياطية المتوافقة مع OpenAI أدناه.
يمكن أن تستخدم نسخ ” LiteLM ” القديمة (أو توليد الصور) الطريق المتوافق مع ” OpenAI ” مباشرة:
يجعل حقل sync: true نقطة نهاية الصورة تعيد الاستجابة النهائية على شكل OpenAI بدلا من غلاف المهام غير المتزامنة الافتراضي. صفحة مزود الخدمة الخاصة ب LiteLLM ل EmpirioLabs هي على docs.litellm.ai/docs/providers/empiriolabs.
وثيقة مفتوحة
يمكن للمساعد أن يكتب هذا تلقائياً
وضع الدليل:
In OpenCode, run /models and choose the EmpirioLabs provider. المفتاح المدعوم بالملف يستمر بالعمل بعد أن تغلق وتعيد فتح باب التسجيل
Claude Code
ويمكن للمساعد أن يكتب الأطر على مستوى المستخدم تلقائيا:
كود كلود ليس عميل إكمال الدردشة في OpenAI. يتحدث مع بوابات نماذج اللغة الكبيرة من خلال شكل رسائل Anthropic، والذي EmpirioLabs يعرض عند /v1/messages.
تركيبة مستمرة على مستوى المستعملين:
استخدم نموذجا تسرد صفحاته POST /v1/messages تحت نقاط النهاية المدعومة. إذا أبلغ Claude Code عن خطأ في عد الرموز الخاصة بالبوابة أو اكتشاف النموذج، قم بتشغيله عبر بوابة أو محول بصيغة Anthropic ينفذ عقد بوابة كلود كود الكامل، ثم وجه تلك البوابة إلى EmpirioLabs.
Cline
In the Cline extension UI:
- فتح كلين.
- اضبط مزود واجهة برمجة التطبيقات على
OpenAI Compatible. - اضبط عنوان URL الأساسي على
https://api.empiriolabs.ai/v1. - قم بلصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك.
- أدخل معرف النموذج مثل
qwen3-max. - قم بالتحقق، ثم أبدأ مهمة جديدة.
لكلين كلي:
Qwen الشيفرة
ويمكن للمساعد أن يكتب المشاريع أو أماكن الاستخدام تلقائيا:
إطلاق Qwen Code مباشرة مع EmpirioLabs كمزود متوافق مع OpenAI:
For persistent project setup:
أضف .qwen/settings.json إلى .gitignore إذا خزنت المفتاح هناك.
Codex CLI
ويمكن للمساعد أن يكتب تلقائياً كتلة مقدمي الخدمات على مستوى المستعملين:
أضف EmpirioLabs كمزود نموذج مخصص في ~/.codex/config.toml:
ثم إطلاق الكودوكس مع مفتاحك في البيئة:
استخدم هذا المسار مع EmpirioLabs نماذج تدعم POST /v1/responses.
Aider
ويمكن للمساعد أن يكتب تلقائياً عقداً للمعونة على مستوى المشاريع:
يستخدم Aider متغيرات البيئة المتوافقة مع OpenAI. النموذج يبدأ بالبادئة openai/.
استمر
يمكن للمساعد أن يكتب الوصية على مستوى المستعمل
يمكن لمزود OpenAI في Continue استهداف أي نقطة نهاية متوافقة مع OpenAI من خلال تعيين apiBase. ضع الأسرار في .env أو متجر كونتينيو السري بدلا من تسجيلها في config.yaml.
أضف السر في أحد المواقع .env المدعومة من Continue:
أفتح
ويمكن للمساعد أن يكتب مستنداً تلقائياً على مشروع ” أوف هاندز ”:
فتح الهوامش يكشف عن أماكن مقدمي الخدمات في وحدة التفتيش المشتركة ويعبرها إلى طبقة LLM.
بالنسبة لعمليات الإطلاق القائمة على البيئة:
For persistent project setup:
اركضوا في “افتح هادز” مع:
أضف openhands.empiriolabs.toml إلى .gitignore إذا خزنت المفتاح هناك.
”عميل “هيرمز
يمكن للمساعد أن يكتب سيارة (هيرمز) على مستوى المستعمل تلقائياً:
هيرميس لديه ساحر نماذج تفاعلي. اختر Custom endpoint، ثم أدخل:
الوصية اليدوية:
OpenClaw
يمكن للمساعد أن يكتب سيارة على مستوى المستعمل
أأمن مجموعة هي الساحرة المفتوحة
(أ) اختيار مُقدِّم أو مُقدِّم ومستخدم متوافق مع المعايير المحاسبية الدولية للقطاع العام:
من أجل الثقب اليدوي لـ (شيون 5) إستخدم هذه كسيارة جانبية أو إدمجها في وعاء (إف سيلو)
شغل openclaw config validate بعد التعديلات اليدوية.
الأوزة
ويمكن للمساعد أن يكتب مُقدِّم العتاد على مستوى المستعمل تلقائياً:
تدعم Goose مزودي خدمة متوافقين مع OpenAI مخصصين. يكتب المساعد هذا كempiriolabs.json في مجلد مزود المخصص الخاص ب goose.
Zed
وتدعم شركة Zed مقدمي الخدمات المتوافقين مع المعايير المحاسبية الدولية للقطاع العام في فريق العميل. إستعملْ UI’s Add Provider تدفقْ، أَو محرر
أضف المفتاح من خلال فريق العميل كي يخزنه (زيد) في متجر الحرق
Klo Code, Roo Code, Cursor, and similar IDEs
استخدم هذا الجدول في أي مكان تعرض فيه أداة OpenAI Compatible أو Custom OpenAI أو Override OpenAI Base URL.
عادة ما تكشف امتدادات Kilo Code وVS Code على نمط Roo هذا كملف تعريف لتكوين API. تشير وثائق Roo Code العامة وإشعارات المنتجات إلى مسار shutdown/archive في 15 مايو 2026، لذا تفضل Cline أو Kilo Code لقوالب جديدة على مستوى الفريق ما لم يعتمد فريقك بالفعل على Roo.
سلوك مفاتيح API المخصصة في مؤشر المؤشرات يعتمد على الإصدار وسطح الميزة. إذا كان بناء المؤشر يقبل فقط مفاتيح واجهة برمجة التطبيقات للمزود ولا يكشف رابط أساسي مخصص للميزة التي تريدها، فلا يمكن توجيهه مباشرة إلى EmpirioLabs لتلك الميزة.
الاضطرابات
أبقوا العملاء معاقبين
عندما يقوم مساعد برمجة ذكاء اصطناعي بتنفيذ تكامل EmpirioLabs لك، أعطه أولا حزمة المستندات القابلة للقراءة الآلي:
Endpoint shapes, request bodies, responses, examples, errors, jobs, usage, and save Playground conversation APIs.
Compbined context links for the Documentation tab, API Reference tab, and both together.
أخبر الوكيل أن يستعمل https://docs.empiriolabs.ai/ai-agent-api-reference-context.md كمرجع للآداب، https://docs.empiriolabs.ai/ai-agent-docs-context.md لتفاصيل النموذج والتسعير، و GET https://api.empiriolabs.ai/v1/models/\{model_id\} لبيانات نموذجية حية.
هذا يمنع العميل من التخمين بتشكيلات نقطة النهاية، هويات نموذجية، أو أسماء بارامتر.

