أدلة الانتقالمن وكيل (proxy) داخلي للذكاء الاصطناعي
من وكيل داخلي إلى طبقة تحكم لا تحتاج إلى تشغيلها
كتبت فرق كثيرة خدمة صغيرة أمام OpenAI وAnthropic: تحتفظ بالمفاتيح، وتعيد المحاولة، وتسجّل الطلبات، وتحصي الرموز (tokens) مقابل جدول تكاليف، وتفرض حصة لكل فريق. تبيّن هذه الصفحة ما يقابل كل مهمة من هذه المهام في INFRO، وأيّها يبقى في كودك، وكيف تنقل خدمة واحدة في كل مرة بينما يبقى الوكيل يعمل.
خدمتك الخاصة أمام المزوّدين: المفاتيح، وإعادة المحاولة، والتسجيل، والحصص
التسجيل في INFRO ذاتي، دون وسيط. الكتالوج والتوثيق وعقد API متاحة للعموم، والبوابة قيد التشغيل، وكل ما يتجاوز v1 موسوم بـ «لاحقًا». الباقات والفترة التجريبية
أين وصلت الأمور
ما تفعله هذه الوكلاء الوسيطة عادةً
يحتفظ بمفاتيح المزوّدين، ويصدر مفاتيح داخلية لكل فريق، ويعيد المحاولة ويحوّل تلقائيًا عند الأعطال، ويسجّل الطلبات، ويسعّر الرموز من جدول يُحدَّث يدويًا، ويرفض فريقًا تجاوز حصته.
تكلفة الإبقاء عليها
هناك من يتولى جدول الأسعار، والنماذج الجديدة، والمعاملات الجديدة لدى كل مزوّد، وقاعدة البيانات خلف السجلات، والمناوبة على الوكيل نفسه.
طريقتان للانتقال
إما أن تستبدله: فتستدعي خدماتك INFRO، وهو يستدعي مزوّديك. وإما أن تبقيه خلف INFRO لفترة: اربط الوكيل كاتصال openai-compatible وانقل المزوّدين الذين يتصل بهم واحدًا تلو الآخر.
الوكيل الوسيط الذي كتبته يفعل ما تحتاجه بالضبط، ولهذا قيمة. أبقِ عليه إن كان أحد الأسباب التالية هو سبب وجوده.
- يغيّر الطلب: قوالب المطالبات، أو استرجاع يُحقن في السياق، أو تنقيح PII بنماذجك الخاصة، أو معالجة لاحقة للاستجابات. ضوابط الحماية في INFRO قواعد أنماط وفحوص بنماذج اتخاذ القرار؛ ولا تشغّل كودك في مسار الطلب.
- يجب أن يعمل داخل شبكتك أو في منطقة محددة. باقات INFRO مستضافة على شبكة Cloudflare؛ والنشر المستضاف ذاتيًا أو الهجين اتفاقية مؤسسية.
- يخدم نماذج لا تتيحها أي واجهة API لدى المزوّدين، مثل أوزان تستضيفها على وحدات GPU داخلية، ولا شيء غير ذلك. تستطيع INFRO التوجيه إلى ذلك الخادم كاتصال
openai-compatible، لكن الخادم يبقى لك. - صغير، ومملوك لك، ولا أحد يطلب ميزانيات أو توزيعًا للتكاليف أو تحويلًا تلقائيًا عند الأعطال. عندها تكون البوابة عملية انتقال بلا شيء في نهايتها.
التعديلات، صف لكل منها. كل ما لم يُذكر هنا يبقى كما هو.
| وكيلك الوسيط | INFRO | |
|---|---|---|
| عنوان URL الأساسي | المضيف الداخلي لوكيلك الوسيط. | https://api.infro.io/v1 (صيغة OpenAI)، و/v1/messages (صيغة Anthropic)، و/v1/responses (OpenAI Responses). |
| المفتاح | مفتاح داخلي أصدره وكيلك الوسيط لكل فريق أو خدمة. | مفتاح بوابة INFRO لكل خدمة، بقائمة سماح نماذج خاصة به، وقائمة مزوّدين، ونطاقات IP، وبيئة، وحد إنفاق. |
| معرّف النموذج | أي أسماء مستعارة عرّفها وكيلك الوسيط. | vendor/model، أو اسم مسار: المسار اسم مستعار يُحال إلى قائمة مرتبة من اتصالاتك، ويُعدَّل في لوحة التحكم. |
| الترويسات | ترويساتك الخاصة للفريق أو المستخدم أو الميزة. | X-INFRO-Feature أو X-INFRO-User-Id أو X-INFRO-Trace-Id، أو metadata.user_id وmetadata.session_id وmetadata.tags في الجسم. |
قبل · الوكيل الخاص بك
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://llm-proxy.internal.example.com/v1",
apiKey: process.env.LLM_PROXY_KEY,
defaultHeaders: { "X-Team": "search" },
});
await client.chat.completions.create({
model: "default-chat",
messages: [{ role: "user", content: "Hello" }],
});بعد · INFRO
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.infro.io/v1",
apiKey: process.env.INFRO_API_KEY, // one key per service
defaultHeaders: { "X-INFRO-Feature": "search" },
});
await client.chat.completions.create({
model: "default-chat", // a route with the same name
messages: [{ role: "user", content: "Hello" }],
});احتفظ بأسمائك المستعارة
أنشئ مسارًا لكل اسم مستعار عرّفته في الوكيل الوسيط، بالاسم نفسه، فتواصل الخدمات إرسال قيمة model نفسها. ويمكن تقييد المفتاح بمسارات مسمّاة، فلا يستطيع استدعاء نموذج مباشرةً.
انقل خدمة واحدة في كل مرة
اربط الوكيل الوسيط نفسه كاتصال openai-compatible، وأضفه هدفًا في مسار. يمكن أن تنتقل الخدمات إلى INFRO أولًا، ثم تُنقل المزوّدات الأصلية من الوكيل الوسيط إلى اتصالات مباشرة لاحقًا.
تتحوّل الفرق إلى مشاريع
تتحول حصص الفرق إلى ميزانيات للمشاريع وحدود إنفاق لكل مفتاح. ويمكن حصر وصول الأعضاء في المشاريع التي يعملون عليها.
ما يفعله إعدادك اليوم مقابل INFRO، مُتحقَّقًا منه وفق ما تطبّقه البوابة. يشير صف واحد إلى أن INFRO لا يوفّر ذلك.
| وكيلك الوسيط | ما تفعله هناك | في INFRO |
|---|---|---|
| خزنة المفاتيحالصيغة نفسها | مفاتيح المزوّدين في إعدادات الوكيل (proxy) أو في مخزن أسرار. | اتصالات المزوّدين مشفّرة أثناء التخزين، وأكثر من مفتاح لكل مزوّد، والمفاتيح الاحتياطية تُستخدم أخيرًا. |
| المفاتيح الداخليةالصيغة نفسها | مفاتيح يصدرها الوكيل الوسيط لكل فريق أو خدمة. | مفاتيح بوابة بقوائم سماح نماذج، وقوائم مزوّدين، ونطاقات IP، وبيئة، وحد إنفاق، وتدوير، ومفتاح إيقاف. |
| إعادة المحاولة والبدائل الاحتياطيةالصيغة نفسها | منطق برمجي داخل الوكيل الوسيط. | مسارات بأهداف مرتبة بالأولوية أو بأوزان، وقواعد شرطية على الطلب، وقواعد أعطال حسب نوع الخطأ (429، 5xx، انتهاء المهلة، الاتصال، بيانات الاعتماد، الإشراف على المحتوى). |
| الحصصالصيغة نفسها | عدّادات رموز أو دولارات لكل فريق. | ميزانيات لكل مؤسسة ومشروع وعضو ومفتاح وعميل نهائي ترفض عند السقف بـ 402، وتصمد تحت التزامن. |
| جدول الأسعارمختلف | جدول أسعار للرموز يُحدَّث يدويًا. | السعر المعلن للمورّد من كتالوج INFRO، وأسعارك المتفاوض عليها حيث تدخلها، وunpriced حيث لا يُعرف أيٌّ منهما، لا صفر أبدًا. |
| سجلات الطلباتمختلف | صفوف في قاعدة بياناتك. | سجل الطلبات والتتبّعات في لوحة التحكم، وGET /v1/requests، والتصديرات، وspans إلى مجمّع OpenTelemetry الخاص بك. التقاط المطالبات معطّل حتى تفعّله. |
| تحويلات المطالبات والاستجاباتلا شيء | القوالب والاسترجاع وتنقية البيانات بمنطقك الخاص. | غير متاح. تحظر ضوابط الحماية أو تحجب أو تنبّه وفق الأنماط وفحوص نماذج اتخاذ القرار؛ ولا تشغّل INFRO كودك. |
| النماذج المستضافة ذاتيًامختلف | vLLM أو TGI أو Ollama خلف الوكيل. | اتصال openai-compatible بذلك الخادم، يُوجَّه مثل أي مزوّد آخر. ويبقى تشغيل الخادم مسؤوليتك. |
| تشغيله بنفسكمختلف | يعمل حيث تنشره. | مستضافة. النشر المستضاف ذاتيًا أو الهجين اتفاقية مؤسسية، لا باقة.المؤسسات — متاح ضمن اتفاقية مؤسسية لا بالتسجيل الذاتي. |
ما لا يفعله INFRO
- تشغيل كودك الخاص في مسار الطلب: قوالب المطالبات، والاسترجاع، والتحويلات المخصّصة.
- Batch وFiles والضبط الدقيق وRealtime، أو التضمينات لدى مزوّدين غير OpenAI وAzure OpenAI وMistral أو نقطة نهاية متوافقة مع OpenAI.
- تثبيت المنطقة؛ أما حصر البيانات في منطقة محددة فمُدرج في خارطة الطريق وغير متاح حاليًا.
- نشر مستضاف ذاتيًا دون اتفاقية مؤسسية.
ما الذي لا ينتقل
- سجلات وكيلك الوسيط. لا توجد أداة استيراد؛ اتركها حيث هي.
- جدول أسعاره. أدخل الأسعار المتفاوض عليها في لوحة التحكم بدلًا من ذلك؛ وتأتي الأسعار المعلنة من الكتالوج.
- التحويلات المخصّصة. تبقى في كودك، قبل الاستدعاء إلى INFRO.
الأسئلة
- هل يمكن أن تقف INFRO أمام وكيلنا الوسيط الحالي؟
- نعم. اربط الوكيل الوسيط كاتصال
openai-compatibleبعنوان URL الأساسي ومفتاحه، ووجّه إليه مثل أي مزوّد أثناء نقل مصادره. - هل تتغير عقودنا مع المزوّدين؟
- لا. تربط حسابات المزوّدين التي تملكها، ويواصل مزوّدوك إصدار فواتيرهم لك مباشرةً بأسعارك. INFRO اشتراك بهامش 0% على الإنفاق على النماذج.
- ما الذي يبقى كودنا؟
- أي شيء يغيّر المطالبة أو الاستجابة: القوالب، والاسترجاع، والتنقيح المخصّص، والمعالجة اللاحقة.
انتقل معنا، أو بمفردك
يطابق برنامج الترحيل إعداداتك في وكيل (proxy) داخلي للذكاء الاصطناعي مع اتصالات INFRO ومساراته وميزانياته خلال مكالمة، وينقل معك الخدمة الأولى. ويستمر مزوّدوك في محاسبتك مباشرة؛ وINFRO اشتراك يضيف 0% على الإنفاق على النماذج.
المصادر
سلوك SDK الموصوف في هذه الصفحة مأخوذ من هذه المصادر، وقد قرأناها في 19 أكتوبر 2026.
- OpenAI — openai-node README (baseURL and defaultHeaders)اطّلعنا عليه في 19 أكتوبر 2026
- OpenAI — openai-python README (base_url and default_headers)اطّلعنا عليه في 19 أكتوبر 2026