# الإعدادات وبيانات اعتماد المزوّد


# الإعدادات وبيانات اعتماد المزوّد

**الإعدادات** هي حيث تجلب مزوّدي الذكاء الاصطناعي والتكامل الخاصين بك إلى البوابة. لا يأتي الوكلاء بمفاتيح نماذج مثبّتة مسبقًا — لا تعرض علامتا تبويب LLM والصوت مزوّدًا إلا بمجرد أن يكون لمؤسستك بيانات اعتماد له هنا. هذه الصفحة هي أيضًا حيث تدير تفضيلات الحساب والإشعارات والأمان والمظهر.

افتح **الإعدادات** (`/settings`).

## ما الموجود على صفحة الإعدادات

الصفحة مجموعة من علامات التبويب. العلامات الأربع الأولى متاحة للجميع؛ وتظهر البقية بناءً على دورك:

- **General** — **language** و**timezone** الواجهة.
- **Notifications** — تفضيلات إشعارات البريد الإلكتروني والدفع والتسويق. يحصل المسؤولون أيضًا على لوحة لإرسال إشعارات الدفع.
- **Security** — غيّر كلمة مرورك وبدّل المصادقة الثنائية.
- **Appearance** — **theme** فاتح/داكن، و**font family**، و**density** التخطيط، ومُنتقي **color theme**.
- **API Credentials** — بيانات اعتماد المزوّد لخدمات الذكاء الاصطناعي والتكاملات (مسؤولو المؤسسة).
- **Email Delivery** — مزوّدو إرسال البريد الإلكتروني (مسؤولو المؤسسة)، يُدارون في علامة تبويب خاصة بهم بدلًا من ضمن API Credentials.

تركّز بقية هذه الصفحة على **API Credentials**، وهي ما يستند إليه منشئ الوكلاء.

## API Credentials

علامة تبويب **API Credentials** هي حيث تسجّل المزوّدين الذين يمكن للوكيل استخدامهم. تُجمَّع بيانات الاعتماد في صفّين:

- **AI Services** — **LLM** (نموذج اللغة)، و**STT** (تحويل الكلام إلى نص)، و**TTS** (تحويل النص إلى كلام).
- **Function Integrations** — **SMS** و**CRM** و**Calendar** و**Ticketing** و**Payment** و**Identity**. تشغّل هذه [الوظائف المدمجة](./agents/tools-mcp) للوكيل (على سبيل المثال، إرسال SMS أو إنشاء جهة اتصال CRM).

تعرض كل علامة تبويب عدد بيانات الاعتماد التي هيّأتها لذلك النوع. اختر نوعًا، ثم **Add Credential** لتسجيل واحد.

:::info[بيانات اعتماد الذكاء الاصطناعي على مستوى النظام؛ بيانات اعتماد التكامل لكل مؤسسة]

بيانات اعتماد LLM وSTT وTTS هي **على مستوى النظام**، مشتركة عبر كل مؤسسة، ويديرها فريق imatic — لا يوجد مُنتقي مؤسسة لها. أنواع التكامل (SMS وCRM والتقويم وما إلى ذلك) **محصورة بمؤسسة**: اختر المؤسسة في أعلى علامة التبويب، وتنطبق بيانات الاعتماد التي تضيفها عليها.

:::

### إضافة بيانات اعتماد

يفتح **Add Credential** نموذجًا:

1. **Name** — تسمية وصفية، مثل *"Azure GPT-4o (India)"* أو *"Deepgram Nova-3"*. التسمية بالنموذج والمنطقة تجعل قائمة بيانات الاعتماد سهلة التصفّح.
2. **Provider Type** — LLM أو STT أو TTS أو نوع تكامل.
3. **Provider** — المزوّد المحدّد لذلك النوع (انظر القوائم أدناه).
4. **حقول المزوّد** — يعرض النموذج بعد ذلك بالضبط الحقول التي يحتاجها ذلك المزوّد (مفتاح API، نقطة النهاية، المنطقة، النشر، إلخ). تُحجَب الحقول السرّية بمفتاح إظهار/إخفاء.
5. **Set as default** — اختياريًا عيّن بيانات الاعتماد هذه افتراضية لذلك المزوّد، تُستخدَم عندما لا يُختار شيء أكثر تحديدًا.

تُخزَّن بيانات الاعتماد مشفّرة. لا يمكن تغيير نوع المزوّد والمزوّد بعد إنشاء بيانات الاعتماد — أضِف واحدًا جديدًا بدلًا من ذلك.

### مزوّدو الذكاء الاصطناعي الذين يمكنك إضافتهم

- **LLM** — Azure OpenAI، وGoogle Gemini، وGroq، وOpenRouter، وSarvam AI (اللغات الهندية).
- **STT** — Deepgram، وAzure Speech، وGroq (Whisper)، وSarvam Saarika (الهندية).
- **TTS** — ElevenLabs، وAzure Speech، وGroq (Orpheus)، وCartesia، وGoogle Gemini TTS، وSarvam Bulbul (الهندية).

تعتمد الحقول على المزوّد. المزوّدون أُحادِيُّو المفتاح (Deepgram وElevenLabs وGroq وما شابه) يحتاجون فقط إلى **مفتاح API**. يحتاج **Azure OpenAI** إلى **API Key** و**Endpoint URL** و**Deployment Name** و**API Version** — لذا تمثّل كل بيانات اعتماد Azure نشرًا واحدًا. يحتاج **Azure Speech** إلى **Speech Key** و**Region**.

:::tip

أضِف **بيانات اعتماد Azure OpenAI واحدة لكل نشر**. على [علامة تبويب LLM](./agents/llm) للوكيل، تُبنى قائمة نماذج Azure من عمليات النشر المهيّأة لديك — بيانات اعتماد واحدة، ونموذج واحد قابل للاختيار — لذا أنشئ بيانات اعتماد لكل نشر تريد أن يختار منه الوكلاء.

:::

### مزوّدو التكامل الذين يمكنك إضافتهم

يزوّدون المفاتيح التي تستخدمها الوظائف المدمجة للوكيل للتصرّف في العالم الخارجي:

- **SMS** — Twilio، وExotel، وMeta WhatsApp Business.
- **CRM** — HubSpot، وSalesforce، وZoho CRM.
- **Calendar** — Google Calendar، وMicrosoft Outlook، وCalendly.
- **Ticketing** — Zendesk، وFreshdesk.
- **Payment** — Stripe، وRazorpay.
- **Identity** — مزوّد مخصّص.

بالنسبة لـ **Google Calendar** و**Outlook**، يجمع النموذج **Client ID** و**Client Secret** الخاصين بـ OAuth. أنشئهما في تطبيق OAuth الخاص بك — Google Cloud Console أو ما يعادله في Azure App Registration — وأثناء وجودك هناك، سجّل عنوان إعادة التوجيه (redirect URI) الخاص بـ imatic على عميل OAuth (قائمة **Authorised redirect URIs**) حتى يكتمل الاتصال.

### إدارة بيانات الاعتماد الموجودة

تظهر كل بيانات اعتماد محفوظة كصفّ يعرض اسمها وحالتها ومزوّدها ومفتاحًا محجوبًا. من الصفّ يمكنك:

- **تمكينها / تعطيلها** بالمفتاح (بيانات اعتماد معطّلة تبقى محفوظة لكنها لا تُستخدَم).
- **تحرير** تفاصيلها.
- **حذفها**. حذف بيانات اعتماد CRM يفصل أيضًا تكامل CRM المطابق.

## كيف تصل بيانات الاعتماد إلى وكلائك

بمجرد تمكين بيانات اعتماد هنا، تصبح قابلة للاختيار في منشئ الوكلاء:

- على [علامة تبويب LLM](./agents/llm)، تعرض قائمة **المزوّد** فقط المزوّدين الذين مكّنت مؤسستك بيانات اعتمادهم — وبالنسبة لـ Azure، تأتي خيارات النموذج من عمليات النشر لديك.
- على [علامة تبويب الصوت والسمع](./agents/voice-audio)، تعمل قائمتا مزوّدي STT وTTS بالطريقة نفسها.
- تشغّل بيانات اعتماد Function Integration [أدوات الوكيل ووظائفه المدمجة](./agents/tools-mcp) و[تكاملات CRM](./integrations-crm).

إذا لم يكن مزوّد تتوقّعه يظهر على تلك العلامات، فالسبب الأكثر شيوعًا هو عدم وجود بيانات اعتماد مُمكَّنة له هنا.

## الخطوات التالية

- [اضبط نموذج اللغة](./agents/llm) بمجرد أن تكون بيانات اعتماد LLM لديك جاهزة.
- [أعِدّ الصوت والسمع](./agents/voice-audio) باستخدام بيانات اعتماد STT وTTS لديك.
- [صِل CRM](./integrations-crm) واربط [الأدوات والوظائف](./agents/tools-mcp).
- [صِل وكيلًا بقنوات المراسلة](./channels).