# مزوّدو النماذج والمفتاح التجريبي

كل رمز من هذه الفئة: ما يعنيه، وسببه الأكثر شيوعًا، وما يجب فعله، ومن يستطيع فعله.

[كل رموز الأخطاء](https://www.azothos.ai/ar/docs/errors)

### `provider_key_rejected`

- **ما يعنيه**: رفض مزوّد النماذج مفتاح API الذي أدخلته، فلم يُحفظ.
- **السبب الأكثر شيوعًا**: مفتاح ملغى لدى المزوّد، أو منسوخ بشكل ناقص، أو تابع لحساب أو مشروع آخر.
- **ما يجب فعله**: رفض المزوّد مفتاح API هذا، لذا لم يُحفظ. انسخه مجددًا من لوحة تحكم المزوّد — قد يكون ملغى أو ناقصًا.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_permission_denied`

- **ما يعنيه**: قبِل مزوّد النماذج مفتاح API الخاص بمساحة العمل لكنه رفض هذا الاستدعاء (HTTP 403).
- **السبب الأكثر شيوعًا**: لا يملك حساب المفتاح أو مشروعه حق الوصول إلى النموذج، أو أن النموذج غير متاح في منطقته، أو تنقص المفتاحَ صلاحيةٌ يحتاجها الاستدعاء (مفتاح مقيَّد أو للقراءة فقط).
- **ما يجب فعله**: قبِل المزوّد المفتاح لكنه رفض هذا الاستدعاء: لا يملك حسابه أو مشروعه حق الوصول إلى هذا النموذج في هذه المنطقة، أو تنقصه صلاحية. امنح الوصول من لوحة تحكم المزوّد، أو اختر نموذجًا آخر — استبدال المفتاح لن يفيد.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل

### `provider_key_unusable`

- **ما يعنيه**: النص المُدخل ليس مفتاح API يقبله المزوّد لاستدعاء النماذج، لذا لم يُحفظ.
- **السبب الأكثر شيوعًا**: مفتاح إدارة، أو رمز تسجيل دخول لاشتراك (تطبيق محادثة، أداة برمجة)، بدلًا من مفتاح API عادي — أو مفتاح منسوخ يحتوي في داخله على مسافة أو سطر جديد أو حرف آخر.
- **ما يجب فعله**: هذا ليس مفتاح API يمكنه إجراء استدعاءات للنماذج، لذا لم يُحفظ — مفتاح إدارة، أو رمز تسجيل دخول، أو نسخة تحتوي على مسافة أو سطر جديد أو حرف دخيل. أنشئ مفتاح API عاديًا من لوحة تحكم المزوّد والصقه وحده.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_key_storage_unavailable`

- **ما يعنيه**: تعذّر على Azoth تشفير المفتاح، لذا لم يخزّنه: لا يستطيع هذا النشر تخزين مفاتيح المزوّدين حاليًا.
- **السبب الأكثر شيوعًا**: مشكلة في إعدادات النشر — إعداد تشفير المفاتيح المخزّنة مفقود أو غير صالح — وليست مشكلة في المفتاح. خارج SaaS، يصلحها مشغّل النشر.
- **ما يجب فعله**: لم يُحفظ المفتاح: لا يستطيع هذا النشر تخزين مفاتيح المزوّدين حاليًا. مفتاحك سليم — تواصل مع الدعم لإصلاح ذلك، ثم احفظه مجددًا.
- **من يستطيع فعله**: Azoth، أو مشغّل هذا النشر

### `provider_not_connected`

- **ما يعنيه**: يتجه الاستدعاء إلى مزوّد ليس لمساحة العمل مفتاح API لديه.
- **السبب الأكثر شيوعًا**: لم يُربط المزوّد قط، أو أُزيل مفتاحه.
- **ما يجب فعله**: لا يوجد مفتاح API لهذا المزوّد متصل بالمساحة. أضفه في الإعدادات › المزوّدون والنماذج.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_model_not_found`

- **ما يعنيه**: لا يقدّم المزوّد هذا النموذج، أو لا يستطيع مفتاحك استخدامه.
- **السبب الأكثر شيوعًا**: اسم نموذج مكتوب خطأً أو موقوف، أو نموذج لا يصل إليه حسابك لدى المزوّد.
- **ما يجب فعله**: لا يقدّم المزوّد هذا النموذج، أو لا يمكن لمفتاحك استخدامه. تحقّق من اسم النموذج أو اختر نموذجًا آخر.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `azure_config_required`

- **ما يعنيه**: لا يسمّي الاستدعاء الموجّه إلى Azure OpenAI المورد أو النشر المقصود، فلا يمكن إرساله.
- **السبب الأكثر شيوعًا**: الحقل `azureEndpoint` أو `azureDeployment` غائب عن الطلب، أو أنّ قاعدةً توجّه الاستدعاء إلى Azure OpenAI دون أن يرسلهما المستدعي.
- **ما يجب فعله**: يجب أن يسمّي الاستدعاء الموجّه إلى Azure OpenAI موردَه ونشرَه: أرسلوا azureEndpoint وazureDeployment معه.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `azure_endpoint_not_allowed`

- **ما يعنيه**: ليس `azureEndpoint` الخاص باستدعاء Azure OpenAI مضيفًا من مضيفات Azure OpenAI، فلا يُرسل إليه مفتاح مساحة العمل.
- **السبب الأكثر شيوعًا**: تسمّي نقطة الوصول مضيفًا آخر أو منفذًا أو اسم مستخدم أو http عاديًا — أو وكيلًا أمام Azure.
- **ما يجب فعله**: لا يُتّصل بـ Azure OpenAI إلا عبر مضيفاته الخاصة: اجعلوا azureEndpoint ‏https://<resource>.openai.azure.com (أو مضيف Azure AI services لديكم).
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `invalid_azure_deployment`

- **ما يعنيه**: ليس `azureDeployment` الخاص باستدعاء Azure OpenAI اسم نشر يستطيع Azoth وضعه في الطلب.
- **السبب الأكثر شيوعًا**: يحوي الاسم `/` أو `?` أو `..` أو مسافة، أو يتجاوز 64 حرفًا.
- **ما يجب فعله**: لا يحوي اسم نشر Azure إلا حروفًا وأرقامًا ونقاطًا وشرطات وشرطات سفلية، 64 على الأكثر: أرسلوا اسم النشر كما يعرضه Azure.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `endpoint_url_not_allowed`

- **ما يعنيه**: عنوان طُلب من Azoth الاتصال به — عنوان Ollama الأساسي، أو وجهة تصدير التدقيق، أو نقطة وصول S3 — يُرفض قبل أي طلب: ليس عنوانًا عامًّا.
- **السبب الأكثر شيوعًا**: العنوان على شبكة خاصة أو الحلقة المحلية أو نطاق link-local، أو يُحلّ إلى أحدها، أو يستخدم مخططًا غير http(s)؛ ويذكر الحقل `reason` في الإجابة أيّها.
- **ما يجب فعله**: لا يتّصل Azoth بهذا العنوان: أعطوا عنوان https عامًّا — لا شبكة خاصة ولا حلقة محلية ولا مضيف link-local، ولا اسم مستخدم فيه. يذكر الحقل reason في الإجابة ما رُفض.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `ollama_endpoint_missing`

- **ما يعنيه**: تم حظر هذا الطلب: ليس لمساحة العمل هذه عنوان Ollama.
- **السبب الأكثر شيوعًا**: لا تستدعي البوابة Ollama إلا على العنوان الذي حفظته مساحة العمل في الإعدادات › المزوّدون والنماذج، ولم يُحفظ أي عنوان.
- **ما يجب فعله**: اطلبوا من مالك أو مسؤول حفظ عنوان خادم Ollama الخاص بكم في الإعدادات › المزوّدون والنماذج، ثم أرسلوا الطلب مجددًا.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `ollama_endpoint_not_declared`

- **ما يعنيه**: تم حظر هذا الطلب: يذكر عنوان Ollama لم تحفظه مساحة العمل هذه.
- **السبب الأكثر شيوعًا**: لا تستدعي البوابة Ollama إلا على العنوان المحفوظ في الإعدادات › المزوّدون والنماذج، وقيمة ollamaBaseUrl في الطلب عنوان آخر.
- **ما يجب فعله**: احذفوا ollamaBaseUrl من الطلب، أو أرسلوا العنوان المحفوظ بالضبط. لاستخدام خادم آخر، يحفظ المالك أو المسؤول عنوانه هناك.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `provider_rate_limited`

- **ما يعنيه**: رفض المزوّد الاستدعاء بسبب حدّ للمعدل أو حدّ للرصيد في حسابك لديه.
- **السبب الأكثر شيوعًا**: استدعاءات كثيرة جدًا في وقت قصير، أو نفاد الرصيد لدى المزوّد.
- **ما يجب فعله**: رفض المزوّد الاستدعاء: تم بلوغ حد المعدل أو نفد الرصيد في حسابك لديه. تحقّق من خطتك وفوترتك لدى المزوّد ثم أعد المحاولة.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل

### `provider_payment_required`

- **ما يعنيه**: رفض مزوّد النماذج الاستدعاء لسبب يتعلق بالفوترة (HTTP 402، أو رفض يصفه خطؤه بذلك).
- **السبب الأكثر شيوعًا**: حساب المزوّد المرتبط بمفتاح API الخاص بمساحة العمل نفد رصيده، أو فشلت وسيلة الدفع أو انتهت صلاحيتها، أو بلغ حدًّا للإنفاق، أو أُلغيت خطته.
- **ما يجب فعله**: رفض المزوّد الاستدعاء لسبب يتعلق بالفوترة: حسابه المرتبط بمفتاح مساحة العمل هذه لم يعد فيه رصيد أو لا يملك وسيلة دفع صالحة، أو بلغ حدًّا للإنفاق. أضف رصيدًا أو سوِّ الفوترة أو ارفع الحد من لوحة تحكم المزوّد، ثم أعد إرسال الاستدعاء.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل

### `provider_request_too_large`

- **ما يعنيه**: رفض مزوّد النماذج الاستدعاء لأن الطلب أكبر مما يقبله للنموذج (HTTP 413).
- **السبب الأكثر شيوعًا**: رسائل كثيرة جدًا أو طويلة جدًا، أو مرفق كبير، في استدعاء واحد.
- **ما يجب فعله**: رفض المزوّد الاستدعاء: الطلب أكبر مما يقبله لهذا النموذج. أرسل رسائل أو مرفقات أقل، أو رسائل أقصر، ثم أعد إرسال الاستدعاء.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `provider_request_rejected`

- **ما يعنيه**: رفض مزوّد النماذج الاستدعاء دون أن يخدمه (HTTP 400 أو 422 أو رمز 4xx آخر)، لسبب لا تصلحه إعادة المحاولة.
- **السبب الأكثر شيوعًا**: في الغالب حساب لدى المزوّد نفد رصيده — فبعض المزوّدين يرفضون حينها كل استدعاء برمز 400 — وإلا فمعامل لا يقبله النموذج: خيار، أو صيغة رسالة، أو رسائل أطول من سياق النموذج.
- **ما يجب فعله**: رفض المزوّد الاستدعاء، ولن تفيد إعادة المحاولة ما لم يُصحَّح السبب. تحقّق أولًا من رصيد حسابه المرتبط بمفتاح مساحة العمل هذه وفوترته، من لوحة تحكم المزوّد — فبعض المزوّدين يرفضون كل استدعاء بهذه الطريقة حين ينفد رصيد الحساب — ثم من معاملات الاستدعاء: خيارات النموذج وصيغة الرسائل وطولها.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل

### `provider_not_supported`

- **ما يعنيه**: تم حظر هذا الطلب: ترسله قاعدة إلى مزوّد لا تستطيع نقطة الوصول هذه الوصول إليه.
- **السبب الأكثر شيوعًا**: تعيد قاعدة في مساحة العمل الخاصة بك توجيه هذا الطلب إلى ‹المزوّد›، الذي لا تدعمه نقطة الوصول هذه.
- **ما يجب فعله**: استخدم نقطة الوصول ‎/api/v1/chat، أو اطلب من مالك القاعدة تغيير وجهة إعادة التوجيه.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/regles?tab=rules)

### `provider_failure`

- **ما يعنيه**: لم يستجب المزوّد.
- **السبب الأكثر شيوعًا**: أعاد مزوّد النموذج خطأً. لم يفرض Azoth أي رسوم.
- **ما يجب فعله**: أعد المحاولة، أو اختر نموذجًا آخر.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `onboarding_no_provider`

- **ما يعنيه**: لم يُرسَل هذا الطلب الأول: لا يوجد مزوّد نماذج متصل بمساحة العمل.
- **السبب الأكثر شيوعًا**: يذهب الطلب الأول إلى مزوّدك أنت، بمفتاحك أنت — ولا يرسل Azoth أي طلب من دونه.
- **ما يجب فعله**: اربط مزوّدًا في الإعدادات › المزوّدون والنماذج (أو في النموذج الموجود في هذه الصفحة)، ثم أرسله مجددًا.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_exhausted`

- **ما يعنيه**: لم يعد مفتاح Azoth التجريبي يجيب عن استدعاءات مساحة العمل هذه.
- **السبب الأكثر شيوعًا**: نفدت استدعاءاته التجريبية: المفتاح التجريبي مخصّص لتجربة أولى، لا للاستخدام المنتظم.
- **ما يجب فعله**: اربطوا مفتاح المزوّد الخاص بكم في الإعدادات › المزوّدون والنماذج: تمرّ استدعاءاتكم بعدها عبر Azoth تمامًا كما من قبل.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_unavailable`

- **ما يعنيه**: لا يستطيع مفتاح Azoth التجريبي الإجابة عن هذا الاستدعاء.
- **السبب الأكثر شيوعًا**: لا يخدم المفتاح التجريبي إلا مساحات العمل على خطة Free أو في فترة تجريبية، ضمن حدّ يومي تتقاسمه جميعها، وفقط ما دام الذكاء الاصطناعي الخاص بـ Azoth يعمل.
- **ما يجب فعله**: اربطوا مفتاح المزوّد الخاص بكم في الإعدادات › المزوّدون والنماذج، أو أعيدوا المحاولة لاحقًا.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_limits_exceeded`

- **ما يعنيه**: يتجاوز هذا الاستدعاء ما يجيب عنه مفتاح Azoth التجريبي.
- **السبب الأكثر شيوعًا**: لا يجيب المفتاح التجريبي إلا عن استدعاءات قصيرة، دون بثّ متدفّق، موجّهة إلى نموذجه الوحيد.
- **ما يجب فعله**: أرسلوا استدعاءً أقصر، دون بثّ متدفّق، إلى نموذج التجربة، أو اربطوا مفتاح المزوّد الخاص بكم في الإعدادات › المزوّدون والنماذج.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_not_eligible`

- **ما يعنيه**: لا يُقدَّم مفتاح Azoth التجريبي إلا لمساحات العمل على خطة Free أو في فترتها التجريبية.
- **السبب الأكثر شيوعًا**: مساحة العمل على خطة مدفوعة.
- **ما يجب فعله**: مفتاح Azoth التجريبي مخصّص لمساحات العمل على خطة Free أو في فترة تجريبية.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `trial_already_used`

- **ما يعنيه**: يُقدَّم مفتاح Azoth التجريبي مرة واحدة لكل شخص.
- **السبب الأكثر شيوعًا**: سبق أن فعّلته في مساحة عمل أخرى.
- **ما يجب فعله**: سبق أن استخدمتم مفتاح Azoth التجريبي في مساحة عمل أخرى. اربطوا مفتاح المزوّد الخاص بكم في الإعدادات › المزوّدون والنماذج.
- **من يستطيع فعله**: مالك أو مسؤول في مساحة العمل · [افتح الشاشة](https://www.azothos.ai/dashboard/settings?section=providers)

### `egress_blocked`

- **ما يعنيه**: تم حظر هذا الطلب: لا يمكن لهذا النشر الوصول إلى ‹المزوّد›.
- **السبب الأكثر شيوعًا**: يعمل Azoth هذا دون اتصال بالإنترنت ولا يصل إلا إلى المضيفين الذين سمح بهم المشغّل، و‹المزوّد› ليس منهم.
- **ما يجب فعله**: استخدم نموذجًا يستضيفه النشر داخليًا، أو اسأل المشغّل عمّا إذا كان ينبغي السماح بـ‹المزوّد›. هذا الإعداد يخص النشر وليس قاعدة.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية

### `secnumcloud_blocked`

- **ما يعنيه**: تم حظر هذا الطلب: المزوّد غير حاصل على اعتماد SecNumCloud.
- **السبب الأكثر شيوعًا**: لا يسمح هذا النشر إلا بمزوّدين معتمدين وفق SecNumCloud، و‹المزوّد› ليس منهم.
- **ما يجب فعله**: استخدم مزوّدًا معتمدًا معروضًا أدناه. هذا الإعداد يخص النشر وليس قاعدة.
- **من يستطيع فعله**: مطوّر الشيفرة المستدعية
