الحسابات والوصول
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| المسؤول | دور في مساحة العمل يدير الإعدادات المخصصة للمسؤولين، مثل الميزانيات وقواعد الإنفاق وضوابط الحماية وسياسات الثقة، ويقرأ سجل التدقيق. | API، لوحة التحكم، CLI، MCP |
| العضو | دور في مساحة العمل يستخدم مساحة العمل ويمكنه رؤية قواعد الإنفاق فيها، لكنه لا يستطيع تغيير الإعدادات المخصصة للمالكين والمسؤولين. | API، لوحة التحكم، CLI، MCP |
| المالك | دور في مساحة العمل يدير الإعدادات نفسها المخصصة للمسؤولين ويتلقى رسائل البريد الموجّهة إلى المالكين، مثل تنبيهات إهمال النماذج. | API، لوحة التحكم، CLI، MCP |
| مساحة العمل | حاوية تفصل مفاتيح API وإعدادات التوجيه والإعدادات المسبقة وضوابط الحماية ووصول المسؤولين الخاصة بها عن مساحات العمل الأخرى. | API، لوحة التحكم، CLI |
المفاتيح والمصادقة
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| مفتاح API | سرّ يبدأ بـ phaseo_v1_sk_، يُرسل كرمز bearer لمصادقة طلبات النماذج والتوليد. | API، لوحة التحكم، CLI، SDK، MCP |
| BYOK | استخدام مفتاحك الخاص: توجّه Phaseo الطلبات باستخدام مفتاح API الخاص بك لدى المزوّد، ويحاسبك المزوّد على استخدام النموذج. | API، لوحة التحكم |
| البديل الاحتياطي لـ BYOK | إعداد لمساحة العمل يحدد ما إذا كان يجوز إعادة محاولة طلب BYOK فاشل باستخدام رصيد Phaseo. | API، لوحة التحكم |
| الصلاحية | إذن على مفتاح إدارة أو تسجيل دخول OAuth، مثل keys:write، يحدد واجهات الإدارة البرمجية التي يمكنه استدعاؤها. | API، لوحة التحكم، CLI، MCP |
| مفتاح الإدارة | سرّ يبدأ بـ phaseo_v1_mk_ لواجهات الإدارة البرمجية مثل المفاتيح والإعدادات المسبقة وضوابط الحماية؛ ولا يمكنه إرسال طلبات استدلال. | API، لوحة التحكم |
| تطبيق OAuth | تطبيق يسجّل دخول المستخدمين عبر Phaseo OAuth ويتصرف نيابةً عنهم ضمن النطاقات ومساحة العمل التي يوافقون عليها. | API، لوحة التحكم، CLI، MCP |
| حمل عمل موثوق | عملية نشر أو مهمة CI ترسل رمز OIDC قصير العمر من منصتها بدلًا من مفتاح API، وتطابقه سياسة ثقة. | API، لوحة التحكم |
النماذج والمزوّدون
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| طول السياق | حجم السياق الذي يدعمه مسار المزوّد لنموذج ما، ويظهر لكل مزوّد في صفحة النموذج. | API، لوحة التحكم |
| مهمل (نموذج) | أعلن المختبر أو المزوّد إيقاف النموذج، ولا تزال طلباته تُخدَم كالمعتاد. | API، لوحة التحكم |
| معرّف النموذج | المعرّف الذي ترسله في model، مثل openai/gpt-6-astra، ويظهر في البدء السريع في صفحة كل نموذج. | API، لوحة التحكم، CLI، SDK، MCP |
| نموذج خاص | عملية نشر مخصصة أو مستضافة ذاتيًا ومتوافقة مع OpenAI تُضاف إلى مساحة عملك، ولا يمكن لغير مساحة عملك رؤيتها أو استدعاؤها. | API، لوحة التحكم |
| المزوّد | شركة تستضيف نموذجًا وتحدد توفره ومعاملاته المدعومة وتسعيره وأداءه. | API، لوحة التحكم، SDK، MCP |
| أيقونة حالة المزوّد | الحالة التي تضبطها Phaseo يدويًا لمسار مزوّد: Active أو Lower priority (احتياطي فقط) أو Disabled. | لوحة التحكم |
| معرّف نموذج مقيّد بمزوّد | معرّف نموذج ببادئة مزوّد، مثل baseten:thinking-machines/inkling-small، يعمل لدى ذلك المزوّد دون بديل احتياطي. | API، SDK |
| التكميم | تخزين أوزان النموذج بنوع رقمي أصغر، مثل FP8 أو INT4، مما يسرّع الخدمة مقابل بعض الجودة. | API، لوحة التحكم، SDK |
| متوقف (نموذج) | مضى تاريخ الإيقاف؛ تعمل الطلبات ما دام مزوّد يقدّم النموذج، ثم تفشل مع 410 model_retired. | API، لوحة التحكم |
| نموذج قابل للتوجيه | نموذج له مسار مزوّد واحد على الأقل نشط على Gateway الآن؛ ولا يسرد GET /v1/models افتراضيًا إلا هذه النماذج. | API، لوحة التحكم، MCP |
الطلبات والاستجابات
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| الرموز المخزّنة مؤقتًا | رموز الإدخال التي قرأها المزوّد من ذاكرة التخزين المؤقت للموجّهات، وتُحتسب بسعر القراءة من الذاكرة المؤقتة وتظهر في cached_tokens. | API، SDK |
| Gateway | واجهة Phaseo البرمجية على https://api.phaseo.app/v1، التي توجّه كل طلب إلى مزوّد يستضيف النموذج. | API، SDK |
| معرّف التوليد | معرّف الطلب الذي يبدأ بـ G- ويُعاد في x-request-id وفي نصوص الأخطاء؛ استخدمه للسجلات وعمليات البحث والدعم. | API، لوحة التحكم، SDK |
| التخزين المؤقت للموجّهات | إبقاء بداية الموجّه ثابتة كي يقرأها المزوّد من الذاكرة المؤقتة ويحتسبها بسعر القراءة من الذاكرة المؤقتة. | API، SDK |
| جهد الاستدلال | مقدار تفكير نموذج الاستدلال قبل الإجابة، ويُضبط بـ reasoning.effort أو reasoning_effort، من none إلى max. | API، SDK |
| رموز الاستدلال | الرموز التي ينفقها نموذج الاستدلال قبل أن يجيب؛ وتُحتسب ضمن المخرجات وتستهلك جزءًا من حد المخرجات. | API، SDK |
| فئة الخدمة | فئة سرعة وسعر لطلب نصي (standard أو fast أو ultrafast أو flex)، لا يخدمها إلا المزوّدون الذين يقدّمونها. | API، SDK |
| معرّف الجلسة | قيمة session_id ترسلها لإبقاء طلبات المحادثة لدى مزوّد واحد، لمدة تصل إلى 24 ساعة من النشاط. | API، لوحة التحكم، SDK |
| البث | ضبط stream: true كي يرسل Gateway المخرجات كأحداث مرسلة من الخادم أثناء كتابة النموذج لها. | API، SDK |
| الرموز | الوحدات التي يقرأها النموذج كمدخلات ويكتبها كمخرجات؛ وكل رمز يضيف زمن استجابة وتكلفة. | API، لوحة التحكم، SDK |
| كائن الاستخدام | الحقل usage في الاستجابة، الذي يعرض أعداد رموز الإدخال والإخراج والذاكرة المؤقتة للطلب. | API، SDK |
التوجيه
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| قناتا مزوّدي ألفا والتجريبي | مفاتيح في إعدادات التوجيه كي لا يحصل مزوّدو المعاينة على حركة مرور إلا عند اشتراكك؛ ويسمح provider.include_alpha بمزوّدي ألفا لكل طلب. | API، لوحة التحكم |
| التوجيه التلقائي | أرسل phaseo/auto لتختار Phaseo نموذجًا لكل طلب بناءً على حمل العمل وهدفك وحدود السعر. | API، لوحة التحكم، CLI، SDK، Slack |
| المسار الديناميكي | تدفق قواعد ذو إصدارات مرتبط بمفاتيح API، يمكنه التفرع وتقسيم حركة المرور وتحديد سقف للاستخدام وتبديل النماذج. | API، لوحة التحكم |
| الموجّه المجاني | أرسل phaseo/free لتشغّل Phaseo الطلب على نموذج مجاني متاح، دون الحاجة إلى رصيد. | API، SDK |
| النماذج البديلة | نماذج مدرجة في models تُجرَّب بالترتيب عندما ينتهي النموذج السابق بـ 429 أو 500 أو 502 أو 503 أو 504. | API، SDK |
| الإعداد المسبق | نموذج وموجّه نظام ومعاملات وقواعد مزوّدين محفوظة يستخدمها المستدعون بإرسال اسمها، مثل @support-triage. | API، لوحة التحكم، SDK |
| تسمية إصدار الإعداد المسبق | اسم مثل production يشير إلى إصدار منشور واحد من الإعداد المسبق؛ ونقله يدفع الطلبات إلى الأمام أو يعيدها إلى الخلف. | API، لوحة التحكم، SDK |
| قالب الموجّه | رسائل إعداد مسبق تتضمن {{variables}}، بحيث لا يرسل كل طلب سوى مرجع الإعداد المسبق وقيم المتغيرات. | API، لوحة التحكم، SDK |
| المزوّد البديل | عندما يفشل المزوّد المختار، يجرّب Gateway المزوّد المؤهل التالي للنموذج نفسه. | API، SDK |
| ترتيب المزوّدين | طريقة ترتيب المزوّدين: balanced (الافتراضي، التكلفة لكل إجابة ناجحة) أو price أو latency أو throughput. | API، لوحة التحكم، CLI، SDK |
| التوجيه الإقليمي | إرسال الطلبات النصية إلى eu.api.phaseo.app أو us.api.phaseo.app لاستخدام المسارات التي تعمل هناك فقط. | API، SDK |
| توجيه النماذج المتوقفة | إعداد اختياري لمساحة العمل يرسل طلبات نموذج لا يقدّمه أي مزوّد إلى بديل معتمد أو مختار. | API، لوحة التحكم |
ضوابط الحماية والخصوصية
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| ضابط الحماية | سياسة على مفاتيح API أو الأعضاء تقيّد المزوّدين والنماذج ومعالجة البيانات وتفحص الموجّهات؛ ولا تضع سقفًا للإنفاق. | API، لوحة التحكم |
| إجراء ضابط الحماية | ما يفعله فحص المحتوى في ضابط الحماية عند وجود تطابق: الإشارة أو الحجب الجزئي أو المنع. | API، لوحة التحكم |
| تسجيل الإدخال والإخراج | إعداد خصوصية يخزّن موجّه كل طلب واستجابته، لتتمكن من عرضه أو إعادة تشغيله أو فتحه في الدردشة. | API، لوحة التحكم، الدردشة |
| فحص حقن الموجّهات | فحص في ضابط الحماية يبحث في المحتوى الذي يقدّمه المستخدم عن أنماط حقن الموجّهات الشائعة. | API، لوحة التحكم |
| فحص المعلومات الحساسة | فحص في ضابط الحماية يعثر على بيانات مثل عناوين البريد الإلكتروني وأرقام الهواتف وأرقام البطاقات قبل أن يغادر الطلب Phaseo. | API، لوحة التحكم |
| ZDR | عدم الاحتفاظ بالبيانات: لا يحتفظ المزوّد بالموجّهات أو المخرجات؛ ويمكنك اشتراطه لكل طلب أو لكل ضابط حماية أو لكل مساحة عمل. | API، لوحة التحكم، CLI، SDK، MCP |
الأدوات والمخرجات
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| Decisions API | POST /v1/decisions، الذي يجيب عن أسئلة محددة النوع (predicate وchoice وscore) مع احتمالات، بترتيب طرحها. | API، SDK |
| إصلاح الردود | إضافة تصلح JSON شبه الصالح، مثل JSON داخل سياج Markdown، قبل أن يصل إلى المحلل لديك. | API، SDK |
| أداة الخادم | أداة phaseo: تشغّلها Phaseo عندما يستدعيها النموذج، مثل phaseo:web_search أو phaseo:web_fetch أو phaseo:datetime أو phaseo:advisor. | API، SDK، الدردشة |
| المخرجات المنظّمة | إرسال JSON Schema كي يعيد النموذج JSON بهذا الشكل بدلًا من نص حر. | API، SDK |
| استدعاء الأدوات | وصف دوالك في tools كي يعيد النموذج استدعاءً يشغّله تطبيقك، ثم يجيب بالنتيجة. | API، SDK |
التكلفة والحدود والفوترة
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| الميزانية | سقف إنفاق لمساحة العمل (يومي أو أسبوعي أو شهري أو مدى الحياة)؛ وتتلقى الطلبات التي تتجاوزه 429 key_limit_exceeded. | API، لوحة التحكم |
| الرصيد | رصيد مدفوع مسبقًا لمساحة العمل تنفقه الطلبات المدفوعة بأسعار الكتالوج؛ وتخضع عمليات الشراء لرسوم 5% (بحد أدنى 1 دولار)، ولا تحتاج نماذج :free إلى أي رصيد. | API، لوحة التحكم، CLI، MCP |
| ميزانية القسم | سقف إنفاق يومي أو أسبوعي أو شهري على المفاتيح وطلبات OAuth التي تُحتسب لقسم واحد. | API، لوحة التحكم |
| حد المفتاح | سقف يومي أو أسبوعي أو شهري للطلبات أو الإنفاق على مفتاح API واحد، يُتحقق منه في كل طلب. | API، لوحة التحكم، CLI |
| حد المعدل | عدد الطلبات المسموح به في الدقيقة لكل مستخدم في كل مساحة عمل، ويرتفع مع ترسّخ مساحة العمل. | API، CLI |
| تنبيه الإنفاق | الإشعار الذي ترسله قاعدة الإنفاق عندما يتجاوز الإنفاق أو التوقع أو الارتفاع المفاجئ أو الرصيد الحد المحدد لها. | API، لوحة التحكم |
| قاعدة الإنفاق | قاعدة تنبّه عندما يتجاوز الإنفاق لنطاق ما حدًا معينًا، ويمكنها منع الطلبات اللاحقة مع 429 spend_rule_blocked. | API، لوحة التحكم |
المراقبة
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| إسناد التطبيق | ترويسات مثل X-App-Id وX-Title وHTTP-Referer تجمع استخدام الطلب تحت تطبيق واحد. | API، SDK |
| سجل التدقيق | سجل من غيّر المفاتيح والأعضاء وعناصر التحكم الإدارية الأخرى، ولا يقرؤه إلا المالكون والمسؤولون. | API، لوحة التحكم، CLI |
| Broadcast | يرسل أثرًا لكل طلب عبر Gateway إلى أداة مراقبة أو ويب هوك أو حاوية تخزين أو مستودع بيانات، دون تغيير في الكود. | API، لوحة التحكم |
| الفتح في الدردشة | يتابع طلبًا مخزّنًا أو دورًا من جلسة كمحادثة في الدردشة، بالنموذج نفسه أو بنموذج آخر. | لوحة التحكم، الدردشة |
| مصنِّف الطلبات | تصنيف ونموذج يضعان تسمية لكل طلب مكتمل، وتُخزَّن كتسميات طلبات يمكنك التصفية بها. | API، لوحة التحكم |
| تسمية الطلب | زوج مفتاح وقيمة، مثل team=support، يُرسل في الترويسة X-Phaseo-Metadata لتصفية الإنفاق والسجلات. | API، SDK |
| سجلات الطلبات | سجل لكل طلب يتضمن استخدامه وزمن استجابته وتكلفته وأخطاءه والمزوّد الذي خدمه. | API، لوحة التحكم، CLI، MCP |
المهام غير المتزامنة
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| مهمة غير متزامنة | طلب فيديو أو دفعة يعيد مهمة فورًا؛ وتستعلم عنها دوريًا أو تنتظر ويب هوك حتى تنتهي. | API، SDK |
| الدفعة | مهمة Batch API لأحمال العمل الكبيرة المؤجلة، يستهدف فيها كل صف نموذجًا واحدًا. | API، SDK |
| مهمة الفيديو | طلب Video API يعيد مهمة؛ نزّل الفيديو عندما تصبح حالتها completed. | API، SDK |
| نقطة نهاية الويب هوك | عنوان URL لمساحة العمل يتلقى أحداث حالة موقّعة لمهام الفيديو والدفعات. | API، لوحة التحكم |
المؤسسات
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| القسم | مجموعة من أعضاء مساحة العمل، تُدار يدويًا أو تُزامَن من دليلك، يمكن أن تستهدفها الميزانيات وحدود المعدل وقواعد الإنفاق. | API، لوحة التحكم |
| الدليل | أقسام المؤسسة في مساحة العمل والاستحقاقات الفعلية لكل عضو، ويديرها المالكون والمسؤولون. | API، لوحة التحكم |
| إضافة الهوية | إضافة مساحة العمل اللازمة لتفعيل SSO أو SCIM وإنشاء رموز التزويد وإدارة الدليل. | API، لوحة التحكم |
| SCIM | تزويد أعضاء مساحة العمل والأقسام من مزوّد الهوية لديك باستخدام رمز تزويد SCIM. | API، لوحة التحكم |
| Self Serve Enterprise | اشتراك شهري لمساحة العمل يشمل SSO وSCIM وإدارة الدليل والأقسام ودعمًا ذا أولوية عبر البريد الإلكتروني. | لوحة التحكم |
| SSO | تسجيل الدخول الموحّد لأعضاء مساحة العمل عبر SAML أو مزوّد OIDC مخصص. | API، لوحة التحكم |
CLI وMCP وحزم SDK والتطبيقات
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| مهارات الوكلاء | تعليمات Phaseo العامة لوكلاء البرمجة، وتغطي Gateway وحزم SDK والإعدادات المسبقة والتوجيه وعمليات الانتقال. | API، CLI، SDK |
| حزمة SDK للعميل | حزمة Phaseo للغتك فيها دالة واحدة لكل نقطة نهاية في Gateway، مثل @phaseo/sdk أو phaseo. | SDK |
| Docs MCP | خادم MCP للقراءة فقط على https://phaseo.app/docs/mcp يتيح لمساعدي البرمجة البحث في هذا التوثيق وقراءته. | MCP |
| Phaseo CLI | الأمر phaseo لإنشاء المفاتيح وتغيير الإعدادات وأتمتة الأعمال الإدارية من سطر الأوامر أو CI. | CLI |
| Phaseo MCP | خادم MCP يمنح عملاء الذكاء الاصطناعي بيانات حية عن النماذج والأسعار والاستخدام ومساحة العمل، ويمكنه اختياريًا إدارة حسابك. | MCP |
| وكيل Slack | وكيل Phaseo في Slack، الذي يرد على الإشارات والرسائل المباشرة بالنموذج الذي اختارته مساحة عملك. | لوحة التحكم، Slack |
مراحل الميزات
| المصطلح | المعنى | ينطبق على |
|---|---|---|
| ألفا | ميزة مبكرة قد تتغير كثيرًا أو تُزال. | API، لوحة التحكم، CLI، SDK، MCP، الدردشة، Slack |
| تجريبي | ميزة تعمل في استخدامها الرئيسي، وإن كانت تفاصيلها قد تتغير؛ ويُعلن عن التغييرات في سجل التغييرات. | API، لوحة التحكم، CLI، SDK، MCP، الدردشة، Slack |
| مهملة (ميزة) | ميزة لا تزال تعمل لكنها ستُزال؛ وتعرض صفحتها تاريخ الإزالة عند تحديده. | API، لوحة التحكم، CLI، SDK، MCP، الدردشة، Slack |
| معاينة الميزات | صفحة الإعدادات التي توضّح ما إذا كانت واجهتا Video API وBatch API مفعّلتين لمساحة عملك. | لوحة التحكم |
| عند الطلب | ميزة تُفعَّل لكل مساحة عمل على حدة؛ وإلى أن تُفعَّل، تكون صفحة إعداداتها مخفية وتعيد واجهتها البرمجية خطأً. | API، لوحة التحكم |
| متاحة للجميع | ميزة مستقرة، تظهر دون شارة مرحلة. | API، لوحة التحكم، CLI، SDK، MCP، الدردشة، Slack |