# Settings اور فراہم کنندہ اسناد


# Settings اور فراہم کنندہ اسناد

**Settings** وہ جگہ ہے جہاں آپ اپنے AI اور انٹیگریشن فراہم کنندگان کو پورٹل میں لاتے ہیں۔ ایجنٹس کسی طے شدہ ماڈل کلید کے ساتھ نہیں آتے — LLM اور Audio ٹیبز کسی فراہم کنندہ کو صرف اسی وقت پیش کرتے ہیں جب آپ کی تنظیم کے پاس یہاں اس کے لیے ایک سند ہو۔ یہ صفحہ وہ جگہ بھی ہے جہاں آپ اکاؤنٹ کی ترجیحات، نوٹیفکیشنز، سیکیورٹی اور ظاہری شکل کا انتظام کرتے ہیں۔

**Settings** (`/settings`) کھولیں۔

## Settings صفحے پر کیا ہے

یہ صفحہ ٹیبز کا ایک سیٹ ہے۔ پہلی چار سب کے لیے دستیاب ہیں؛ باقی آپ کے کردار کی بنیاد پر ظاہر ہوتی ہیں:

- **General** — انٹرفیس کی **language** اور **timezone**۔
- **Notifications** — ای میل، پش اور مارکیٹنگ نوٹیفکیشن کی ترجیحات۔ ایڈمنز کو پش نوٹیفکیشنز بھیجنے کے لیے ایک پینل بھی ملتا ہے۔
- **Security** — اپنا پاس ورڈ تبدیل کریں اور دو-عنصری توثیق کو ٹوگل کریں۔
- **Appearance** — light/dark **theme**، **font family**، لے آؤٹ **density** اور ایک **color theme** پکر۔
- **API Credentials** — AI سروسز اور انٹیگریشنز کے لیے فراہم کنندہ اسناد (تنظیمی منتظمین)۔
- **Email Delivery** — ای میل-بھیجنے والے فراہم کنندگان (تنظیمی منتظمین)، جو API Credentials کے بجائے اپنے علیحدہ ٹیب میں منظم کیے جاتے ہیں۔

اس صفحے کا باقی حصہ **API Credentials** پر مرکوز ہے، جو وہی ہے جس پر ایجنٹ بلڈر انحصار کرتا ہے۔

## API Credentials

**API Credentials** ٹیب وہ جگہ ہے جہاں آپ ان فراہم کنندگان کو رجسٹر کرتے ہیں جنہیں کوئی ایجنٹ استعمال کر سکتا ہے۔ اسناد کو دو قطاروں میں گروپ کیا جاتا ہے:

- **AI Services** — **LLM** (زبان کا ماڈل)، **STT** (speech-to-text) اور **TTS** (text-to-speech)۔
- **Function Integrations** — **SMS**، **CRM**، **Calendar**، **Ticketing**، **Payment** اور **Identity**۔ یہ ایجنٹ کے [بلٹ-ان فنکشنز](./agents/tools-mcp) کو طاقت دیتے ہیں (مثال کے طور پر، کوئی SMS بھیجنا یا کوئی CRM رابطہ بنانا)۔

ہر ٹیب دکھاتا ہے کہ آپ نے اس قسم کے لیے کتنی اسناد ترتیب دی ہیں۔ ایک قسم منتخب کریں، پھر کسی کو رجسٹر کرنے کے لیے **Add Credential** کریں۔

:::info[AI اسناد نظام بھر میں ہیں؛ انٹیگریشن اسناد فی تنظیم ہیں]

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. **Provider fields** — پھر فارم بالکل وہی فیلڈز دکھاتا ہے جن کی اس فراہم کنندہ کو ضرورت ہوتی ہے (API key، endpoint، region، deployment، وغیرہ)۔ خفیہ فیلڈز ایک show/hide ٹوگل کے ساتھ ماسک ہوتے ہیں۔
5. **Set as default** — اختیاری طور پر اس سند کو اس فراہم کنندہ کے لیے طے شدہ کے طور پر نشان زد کریں، جو اس وقت استعمال ہوتی ہے جب کوئی زیادہ مخصوص چیز منتخب نہ کی جائے۔

اسناد خفیہ شدہ محفوظ کی جاتی ہیں۔ کسی سند کے بننے کے بعد فراہم کنندہ کی قسم اور فراہم کنندہ تبدیل نہیں کیے جا سکتے — اس کے بجائے ایک نئی شامل کریں۔

### AI فراہم کنندگان جو آپ شامل کر سکتے ہیں

- **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 key** کی ضرورت ہوتی ہے۔ **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** کے لیے، فارم OAuth **Client ID** اور **Client Secret** جمع کرتا ہے۔ انہیں اپنے OAuth ایپ میں بنائیں — Google Cloud Console یا اس کے مساوی Azure App Registration — اور وہیں رہتے ہوئے، OAuth client پر imatic کا redirect URI رجسٹر کریں (**Authorised redirect URIs** فہرست) تاکہ کنکشن مکمل ہو سکے۔

### موجودہ اسناد کا انتظام کریں

ہر محفوظ شدہ سند ایک قطار کے طور پر ظاہر ہوتی ہے جو اپنا نام، اسٹیٹس، فراہم کنندہ اور ایک ماسک شدہ کلید دکھاتی ہے۔ قطار سے آپ کر سکتے ہیں:

- ٹوگل کے ساتھ اسے **Enable / disable** کریں (ایک غیر فعال سند محفوظ رہتی ہے لیکن استعمال نہیں ہوتی)۔
- اس کی تفصیلات میں **Edit** کریں۔
- اسے **Delete** کریں۔ کسی CRM سند کو حذف کرنا متعلقہ CRM انٹیگریشن کو بھی منقطع کر دیتا ہے۔

## اسناد آپ کے ایجنٹس تک کیسے پہنچتی ہیں

ایک بار جب کوئی سند یہاں فعال ہو جاتی ہے، تو یہ ایجنٹ بلڈر میں قابلِ انتخاب بن جاتی ہے:

- [LLM ٹیب](./agents/llm) پر، **provider** فہرست صرف وہی فراہم کنندگان دکھاتی ہے جن کی آپ کی تنظیم نے اسناد فعال کر رکھی ہیں — اور Azure کے لیے، ماڈل کے اختیارات آپ کے ڈیپلائمنٹس سے آتے ہیں۔
- [Voice & audio ٹیب](./agents/voice-audio) پر، STT اور TTS فراہم کنندہ فہرستیں اسی طرح کام کرتی ہیں۔
- Function Integration اسناد ایجنٹ کے [ٹولز اور بلٹ-ان فنکشنز](./agents/tools-mcp) اور [CRM انٹیگریشنز](./integrations-crm) کو طاقت دیتی ہیں۔

اگر کوئی فراہم کنندہ جس کی آپ توقع کرتے ہیں ان ٹیبز پر ظاہر نہیں ہو رہا، تو سب سے عام وجہ یہ ہے کہ یہاں اس کے لیے کوئی فعال سند موجود نہیں ہے۔

## اگلے اقدامات

- اپنی LLM اسناد جگہ پر آ جانے کے بعد [زبان کا ماڈل سیٹ کریں](./agents/llm)۔
- اپنی STT اور TTS اسناد کا استعمال کرتے ہوئے [وائس اور آڈیو سیٹ اپ کریں](./agents/voice-audio)۔
- [ایک CRM جوڑیں](./integrations-crm) اور [ٹولز اور فنکشنز](./agents/tools-mcp) کو جوڑیں۔
- [ایک ایجنٹ کو میسجنگ چینلز سے جوڑیں](./channels)۔