البدء
في هذه الصفحة
ينقلك هذا الدليل بمنشأتك من نقطة الصفر إلى أول طلب ناجح في ثلاث خطوات، ثم يوضّح كيفية التحقق من نجاحه.
قبل أن تبدأ
- يجب أن تكون Organisation Administrator. يتوفر Model Router لـ Organisation Administrator فقط، في منشآت Technology Stack.
- اختر المنشأة التي تريد ضبطها باستخدام محدد المنشأة في شريط الأدوات الرئيسي لـ Performance Hub.
- احرص على أن تكون لديك بطاقة فوترة محفوظة للمنشأة، أو كن مستعدًا لإضافة بطاقة. تُحصّل عمليات الشحن من بطاقة الفوترة المحفوظة؛ وإذا لم تكن هناك بطاقة محفوظة، تعرض صفحة Balance & Top-up الرسالة "No card on file." مع رابط Add payment details.
الخطوة 1: تفعيل Model Router
افتح Model Router من القائمة الرئيسية (ضمن مجموعة AI Modules & Agents). إذا لم تكن الوحدة قد فُعّلت لهذه المنشأة بعد، فستظهر لك صفحة Welcome to Model Router:
"امنح عملك وصولاً مدفوعاً مقدماً إلى كتالوج من نماذج الذكاء الاصطناعي الرائدة من خلال نقطة نهاية واحدة متوافقة مع OpenAI. تتصل وكلاء الذكاء الاصطناعي في Performance Hub تلقائياً، ويمكنك إنشاء مفاتيح API لدمج نفس النماذج في برامجك الخاصة - مع حدود إنفاق وشفافية كاملة في الاستخدام."
الشكل 1: صفحة Welcome to Model Router التي تظهر للمنشأة قبل تفعيل الوحدة
تحتوي الصفحة على ثلاثة أزرار: Enable Model Router، وRead the documentation (الذي يفتح هذه الوثائق)، وExplore first without enabling. وأسفلها، تعرض ثلاث خطوات مراحل الإعداد:
| الخطوة | ما تنص عليه | الزر |
|---|---|---|
| 1. Enable & add a billing card | "Turn on prepaid AI inference for this facility and store a billing card if you have not already — nothing is charged until you top up." | Enable module |
| 2. Top up your balance | "Add prepaid credit with your stored billing card (minimum $10). Turn on auto top-up so inference never stops because the balance ran out." | Top up |
| 3. Connect an agent or create an API key | "Paired AI Agent devices connect automatically. For your own software, create an API key and point any OpenAI-compatible SDK at our endpoint." | Create an API key |
لكل خطوة أيضًا رابط Learn more.
انقر على Enable Model Router (أو Enable module) لتشغيل الوحدة.
قائمة التحقق للإعداد
بعد تفعيل الوحدة، يظهر شريط قائمة التحقق للإعداد أعلى Model Router إلى أن يكتمل الإعداد. يحمل العنوان Finish setting up Model Router ويعرض الوقت المقدّر (مثل ~3 min left)، وعدد الخطوات المكتملة (مثل 2 of 3 complete)، وزر Resume الذي يوسّع قائمة التحقق الكاملة. لكل خطوة Review (أو Review again) وLearn more؛ ويطوي Collapse القائمة مرة أخرى. عندما تتبقى خطوة واحدة، يظهر العنوان الفرعي الموسّع بالنص "Just one step to go before AI requests start flowing. Steps can be done in any order."
الشكل 2: شريط قائمة التحقق للإعداد الذي يظهر إلى أن يكتمل الإعداد
الخطوات المطلوبة هي Add a billing card وTop up your balance وConnect an agent or create an API key. أما الخطوات الاختيارية، وهي Set spend limits وTurn on auto top-up وVerify your first request، فيمكن تجاهلها باستخدام Skip for now.
الخطوة 2: إجراء أول عملية شحن
انتقل إلى Budgets & Limits ← Balance & Top-up.
الشكل 3: بطاقة Top up balance (القيم المسبقة، والمبلغ، والبطاقة المحفوظة) وبطاقة Auto top-up
- في بطاقة Top up balance، اختر قيمة مسبقة ($25 أو $50 أو $100 أو $250 أو $500 أو $1000) أو اكتب مبلغًا. "Minimum top-up is $10."
- تحقّق من البطاقة المحفوظة المعروضة أسفل المبلغ (مثل "Amex ending 0005 · exp 06/29"). استخدم Edit payment details إذا كانت بحاجة إلى تحديث.
- انقر على Top up $–.––. عند النجاح سترى "Top-up successful. Your balance has been credited." تظهر عمليات الشحن في الرصيد فورًا.
موصى به: في بطاقة Auto top-up، شغّل Enable auto top-up، واضبط When balance is below وTop up by (بحد أدنى $10 أيضًا)، وانقر على Save changes. بعد ذلك تُحصّل الرسوم من بطاقتك تلقائيًا كلما انخفض الرصيد عن الحد، فلا يتوقف الاستدلال بشكل غير متوقع أبدًا. راجع الميزانيات وعمليات الشحن للاطلاع على التفاصيل.
الخطوة 3: إرسال أول طلب
اختر المسار الذي ينطبق عليك:
إذا كانت لديك AI Agents أو Workflows
لا حاجة إلى أي ضبط، إذ تتصل أجهزة وكيل الذكاء الاصطناعي المقترنة بهذه المنشأة تلقائيًا، ويمكن لـ Workflows الاتصال أيضًا. افتح Settings (رمز الترس) ← Service Access & API Keys وتأكّد من ظهور وكيلك ضمن Connected Services بالحالة متصل. راجع Connected Services.
إذا كنت تربط برامجك الخاصة
- افتح Settings (رمز الترس) ← Service Access & API Keys وانقر على Create key. انسخ السر من مربع الحوار "Copy your API key": "This is the only time the full key is shown. Store it somewhere safe."
- استخدم Base URL ومثال الطلب المعروضين في بطاقة Connecting to the API في الصفحة نفسها. اختبار بسيط:
curl https://app.performancehub.co/ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'
راجع ربط تطبيقك للاطلاع على أمثلة Python وTypeScript.
الخطوة 4: التحقق
افتح علامة التبويب Logs. ينبغي أن يظهر طلبك التجريبي خلال لحظات، مع نموذجه وأعداد الرموز المميزة والتكلفة والسرعة والحالة success. إذا لم يظهر، فراجع استكشاف الأخطاء وإصلاحها.
الخطوات التالية الموصى بها
- ضع حدودًا للإنفاق: Budgets & Limits ← Spend Limits. يُعد السقف الشهري شبكة أمان معقولة؛ راجع الميزانيات وعمليات الشحن.
- راجع كتالوج النماذج: الإعدادات ← Models. جميع النماذج مفعّلة افتراضيًا؛ استخدم الإعدادات المسبقة السريعة لتضييق المجموعة إذا كانت لديك تفضيلات بشأن المزوّدين أو الميزانية. راجع Models.
- فكّر في Guardrails: الإعدادات ← Guardrails لإخفاء معلومات التعريف الشخصية، وحجب الأسرار، والحماية من حقن المطالبات. لا يكون أي منها مفعّلًا افتراضيًا. راجع Guardrails.