AI
Antimatter کے AI فیچرز آپ کے منتخب ماڈلز استعمال کرتے ہیں: ایک کلاؤڈ پرووائیڈر، یا آپ کے اپنے نیٹ ورک پر سرور۔ جب تک آپ ماڈل کی ترتیب نہیں دیتے، کچھ بھی کہیں بھی نہیں بھیجا جاتا۔ یہ صفحہ ماڈل کنکشنز، ہر فیچر، اس ڈیٹا کو جو بھی بھیجا جاتا ہے اور اسے کیسے بند کریں، پر روشنی ڈالتا ہے۔
AI فیچرز
| فیچر | کنفیگریشن کا مقام | ماڈل کی قسم | ڈیفالٹ طور پر فعال |
|---|---|---|---|
| کمپوزر میں ری رائٹ: پیغام بھیجنے سے پہلے اسے بہتر بنائیں، مختصر کریں، درست کریں یا ترجمہ کریں | AI › درجہ بندی شدہ فیچرز، ماڈل کنکشن کے ساتھ | ایک چیٹ ماڈل (LLM) | نہیں |
| ریکپس: لوگوں کے منتخب چینلز کا خلاصہ | AI › درجہ بندی شدہ فیچرز، ماڈل کنکشن کے ساتھ | ایک چیٹ ماڈل (LLM) | نہیں |
| چینلز کا خودکار ترجمہ | سائٹ کی ترتیبات › مقامی زبان | ماڈل کنکشن، LibreTranslate یا OpenAI-compatib API | نہیں |
| پڑھ کر سنائیں | انضمامات › متن کو آواز میں، اختیاری طور پر ماڈل کنکشن کے ساتھ | Text-to-speech، OpenAI-compatib | نہیں |
| AI ایجنٹس: بوٹ کے ساتھ چیٹ، سلسلوں کا خلاصہ، کالز کا خلاصہ | Agents ایپ | کوئی بھی بڑا لینگویج ماڈل (LLM) سروس | ایپ فعال ہے، لیکن جب تک آپ کوئی سروس شامل نہیں کرتے، کچھ نہیں کرتی |
| کالز کے ٹرانسکرپٹ اور لائیو کیپشنز | Calls ایپ | Speech-to-text، OpenAI-compatib | نہیں |
"OpenAI-compatib" کا مطلب ہے ایک سرور جو OpenAI جیسا ہی HTTP API فراہم کرتا ہے۔ زیادہ تر ماڈل سرورز جو آپ خود چلا سکتے ہیں ایسے ہی ہیں (مثلاً Ollama, vLLM, llama.cpp کا سرور، یا Whisper اور text-to-speech سرورز)، اور کئی کلاؤڈ پرووائیڈرز اور گیٹ ویز جیسے LiteLLM یا OpenRouter بھی۔ ان فیچرز کے لیے کوئی لائسنس درکار نہیں۔
درجہ بندی شدہ فیچرز (ری رائٹ، ریکپس، ترجمہ اور ریڈ aloud) کے لیے Agents ایپ کی ضرورت نہیں ہے: یہ ماڈل کنکشنز استعمال کرتے ہیں جو آپ System Console میں شامل کرتے ہیں۔
ماڈل کنکشنز
ماڈل کنکشن ایک AI پرووائیڈر ہے جسے Antimatter کال کر سکتا ہے: اس کا پتہ، اس کی کلید اور اس کے ماڈلز۔ آپ اسے ایک بار شامل کرتے ہیں، پھر ہر فیچر کے لیے اسے منتخب کرتے ہیں جو اسے استعمال کرنا چاہے۔ دو اقسام ہیں:
- سرور-وائیڈ کنکشنز، جو سسٹم ایڈمنز سسٹم کنسول › AI › ماڈل کنکشنز میں مینیج کرتے ہیں۔ صرف یہ ہی درجہ بندی شدہ فیچرز کو سروس دے سکتے ہیں۔ ایپس بھی انہیں استعمال کر سکتی ہیں، ان لوگوں کے لیے جنہیں اجازت ہے۔
- کمیونٹی کنکشنز، جو کمیونٹی کے ایڈمنز اپنی کمیونٹی کے لیے کمیونٹی کی ترتیبات میں شامل کرتے ہیں (دیکھیں نیچے)۔ ایپس انہیں کمیونٹی کے لوگوں کے لیے استعمال کرتی ہیں۔ یہ کبھی درجہ بندی شدہ فیچرز کو سروس نہیں دیتے۔
سسٹم کنسول کا AI سیکشن ان لوگوں کو دکھایا جاتا ہے جو سرور-وائیڈ کنکشنز مینیج کر سکتے ہیں: سسٹم ایڈمنز، ڈیفالٹ طور پر۔ اس کا ماڈل کنکشنز صفحہ سرور-وائیڈ کنکشنز اور ہر کمیونٹی کے کنکشنز کی فہرست دیتا ہے۔
کنکشن شامل کریں
سسٹم کنسول › AI › ماڈل کنکشنز میں، کنکشن شامل کریں پر کلک کریں، پھر فارم بھریں:
| فیلڈ | کیا درج کریں |
|---|---|
| پری سیٹس | ایک معروف سروس کے پرووائڈر اور پتے کو درج کرتا ہے: OpenAI، Mistral، Gemini، OpenRouter، یا سرور پر موجود Ollama اور LiteLLM۔ اختیاری ہے۔ |
| نام | وہ نام جو ایڈمنز اسے منتخب کرتے وقت دیکھتے ہیں، مثلاً "Company OpenAI"۔ |
| پرووائڈر | OpenAI-compatible (زیادہ تر پرووائڈرز، گیٹ وےز اور وہ ماڈل سرورز جو آپ خود چلاتے ہیں) یا Anthropic۔ اپنے ذاتی سائن ان والے کلاؤڈ سروسز، جیسے AWS Bedrock، Google Vertex AI یا Azure with Entra ID، اپنے OpenAI-compatible endpoint یا LiteLLM جیسے گیٹ وے کے ذریعے جاتے ہیں۔ |
| Base URL | API کا پتہ، /v1 سمیت، مثلاً http://ollama:11434/v1۔ اگر خالی چھوڑا جائے تو یہ پرووائڈر کا اپنا ہوگا (https://api.openai.com/v1 یا https://api.anthropic.com/v1)۔ |
| API کلید | پرووائڈر کی کلید۔ اگر endpoint کی کوئی کلید درکار نہ ہو تو اسے خالی چھوڑ دیں۔ یہ انکرپٹڈ طور پر محفوظ کی جاتی ہے اور کبھی دوبارہ دکھائی نہیں جاتی: فارم صرف اس کے آخری چار حروف دکھاتا ہے، اور اسے برقرار رکھنے، تبدیل کرنے یا ہٹانے کا آپشن دیتا ہے۔ |
| Extra headers | ہر درخواست کے ساتھ بھیجنے کے لیے ہیڈرز، کسی ایسے گیٹ وے کے لیے جو ان کی ضرورت ہو۔ ان کی قدریں کلید کی طرح انکرپٹڈ طور پر محفوظ کی جاتی ہیں اور کبھی دوبارہ دکھائی نہیں جاتی: انہیں تبدیل کرنے کے لیے انہیں دوبارہ ٹائپ کریں۔ |
| Models | ہر صلاحیت کے لیے استعمال ہونے والا ماڈل، جب کوئی فیچر یا ایپ اس کا نام نہ لے: چیٹ، Embeddings، ٹرانسکرپشن اور Decisions۔ Load models ان ماڈلز کی فہرست دیتا ہے جو endpoint پیش کرتا ہے۔ اگر endpoint کوئی صلاحیت پیش نہ کرے تو اسے خالی چھوڑ دیں۔ Anthropic کنکشنز صرف چیٹ کرتے ہیں۔ |
| Decisions API | فیصلوں کے ماڈل کو کیسے کال کیا جائے: OpenAI decisions یا SystemOne۔ یہ صرف ان ایپس کے لیے اہم ہے جو فیصلوں کی درخواست کرتی ہیں۔ |
| Limits | Limits and budgets دیکھیں۔ |
| کمیونٹیز | صرف سرور-وائیڈ کنکشنز۔ سب کمیونٹیز: ہر کمیونٹی میں، اور براہِ راست اور گروپ پیغامات میں استعمال ہونے کے قابل۔ ورنہ، صرف ان کمیونٹیز میں جو آپ منتخب کریں۔ |
| کون استعمال کر سکتا ہے | جہاں یہ استعمال ہونے کے قابل ہو سب، یا صرف وہ ٹیمز (کمیونٹی کے اندر لوگوں کے گروپ) اور رولز (سسٹم ایڈمنز، کمیونٹی ایڈمنز) جو آپ منتخب کریں۔ مہمان بھی مہمانوں کو اسے استعمال کرنے کی اجازت دیتا ہے؛ اس کے بغیر، مہمان اسے استعمال نہیں کر سکتے، حتیٰ کہ سب کے ساتھ بھی۔ |
کنکشن ٹیسٹ کریں پتے اور کلید کی جانچ کرتا ہے: سرور endpoint سے اس کے ماڈلز مانگتا ہے، یا ایک ٹوکن کی چیٹ بھیجتا ہے۔ تبدیلی والا پتہ صرف اس وقت محفوظ شدہ کلید کے ساتھ ٹیسٹ ہوتا ہے جب آپ محفوظ کریں، یا اگر آپ کلید دوبارہ ٹائپ کریں۔ محفوظ کرنے کے لیے Add connection پر کلک کریں۔
سرور خود درخواستیں بھیجتا ہے، اس لیے اسے API تک رسائی ہونی چاہیے: اسی compose پروجیکٹ میں موجود ماڈل سرور، آپ کے نیٹ ورک پر موجود سرور، یا انٹرنیٹ پر موجود سرور۔ باہر کی درخواستیں HTTP_PROXY اور HTTPS_PROXY متغیرات کی پابند ہوتی ہیں۔
کسی کنکشن کو حذف کرنے سے اس کا کلڈ حذف ہو جاتا ہے۔ وہ خصوصیات جو اس کا استعمال کر رہی تھیں، جب تک آپ کوئی اور کنکشن منتخب نہ کریں، AI کا استعمال بند کر دیتی ہیں۔
حدیں اور بجٹ
ہر کنکشن کی چار حدیں ہیں۔ خالی یا 0 کا مطلب ہے کوئی حد نہیں۔
- فی منٹ درخواستیں اور فی شخص، فی منٹ درخواستیں۔ ہر سرور انہیں الگ الگ گنتی کرتا ہے: تین سروروں کا کلسٹر شرح کے تین گنا تک کی درخواستیں گزرنے دے سکتا ہے۔
- فی مہینہ ٹوکنز اور فی شخص، فی مہینہ ٹوکنز: ٹوکنز کا بجٹ، ہر کیلنڈر مہینے (UTC) کے حساب سے، پورے کلسٹر کے لیے ڈیٹا بیس میں گنتی کی جاتی ہے۔ ایک ہی وقت میں چل رہی کئی درخواستیں بجٹ سے تھوڑا آگے جا سکتی ہیں۔
فی شخص کی حدیں دوبارہ لکھنے اور خلاصوں پر بھی لاگو ہوتی ہیں: یہ اس شخص کے حساب سے گنتی ہوتی ہیں جو دوبارہ لکھتا ہے، یا جس کے پاس خلاصہ ہے۔
استعمال
فہرست میں ہر کنکشن کا اس مہینے کا استعمال دکھایا گیا ہے۔ استعمال تفصیلات کھولتا ہے: اندر اور باہر ٹوکنز، درخواستیں، ماہانہ بجٹ، روزانہ (UTC) اور استعمال کے لحاظ سے (دوبارہ لکھیں، خلاصے، خودکار ترجمہ، متن کو آواز میں، لوگ، ایپس کے ذریعے، یا کوئی ایپ) استعمال۔
کسی شخص یا ایپ کا کنکشن کے ذریعے ہر کال ایک آڈٹ ریکارڈ بھی لکھتا ہے: کون، کنکشن، استعمال، ماڈل، ٹوکنز کی تعداد اور کامیابی، کبھی بات کا مواد نہیں۔ درجہ بند خصوصیات صرف استعمال میں گنتی ہوتی ہیں: صرف ترجمہ ہر پیغام اور زبان کے لیے ایک کال بناتا ہے۔
کمیونٹی کنکشنز
کمیونٹی ایڈمنز اپنے کمیونٹی کے کنکشنز کمیونٹی کی ترتیبات میں، ماڈل کنکشنز ٹیب میں شامل کرتے ہیں۔ فارم وہی ہے، کمیونٹیز کے بغیر: کمیونٹی کا کنکشن صرف اپنے چینلز میں، اپنے ارکان کے لیے، اور اس کی آڈینس صرف اپنے ٹیمز کا نام لے سکتی ہے۔ ماڈل کنکشنز کا انتظام اجازت والے کردار بھی ان کا انتظام کر سکتے ہیں۔ پہلے سے کمیونٹی ایڈمنز کے پاس یہ اجازت ہوتی ہے۔
کمیونٹی کا کنکشن پرائیویٹ یا لوپ بیک ایڈریسز تک رسائی نہیں کر سکتا (مثلاً آپ کے نیٹ ورک پر موجود Ollama سرور)، جب تک کہ سسٹم کنسول › ماحول › ڈویلپر › غیر مستند اندرونی کنکشنز کی اجازت دیں (ServiceSettings.AllowedUntrustedInternalConnections) میں ان کی فہرست نہ ہو۔ سرور بھر کے کنکشنز یہ کر سکتے ہیں۔
کمیونٹی ایڈمنز کے حصے کے لیے کمیونٹی ترتیبات دیکھیں۔
انکرپشن کلڈ
ماڈل کنکشنز کے کیز اور اضافی ہیڈرز ڈیٹا بیس میں ایک انکرپشن کی کے ذریعے انکرپٹ (AES-256-GCM) کیے جاتے ہیں۔ صرف ڈیٹا بیس بیک اپ سے یہ ظاہر نہیں ہوتے۔ سرور اس کی کو درج ذیل ترتیب سے تلاش کرتا ہے:
AM_AI_ENCRYPTION_KEYویری ایبل: 32 رینڈم بائٹس، base64 میں۔ اسے بنانے کے لیےopenssl rand -base64 32استعمال کریں۔- اگر نہیں، تو سرور کے ڈیٹا ڈائریکٹری (
FileSettings.Directory, پہلے سے طے شدہ./data/) کے رُٹ پر موجود فائلai-encryption.key۔ سرور اسے پہلی بار بناتا ہے جب کوئی کنکشن اس کی ضرورت محسوس کرتا ہے، اور یہ صرف خود سرور کے لیے قابلِ مطالعہ ہوتی ہے۔ ایپس، ایکسپورٹس اور فائل آرکائیوز اسے نہیں پڑھ سکتے۔
ویری ایبل کب سیٹ کریں:
- سائٹ کے compose فائل کے ساتھ۔
compose.yaml.envسےAM_AI_ENCRYPTION_KEYکو پاس کرتا ہے، اور جب ویری ایبل خالی ہو تو کی فائل کوdataوولوم میں رکھتا ہے۔ ویری ایبل سیٹ کرنا بہتر ہے: اس صورت میں.envکا بیک اپ کی کو ڈیٹا بیس سے الگ رکھتا ہے۔ اسے.envمیں شامل کریں اورdocker compose up -dچلائیں:
اگر سرور نے پہلے سے اپنی کی فائل بنا دی ہو، تو محفوظ شدہ کیز کو قابلِ مطالعہ رکھنے کے لیے اس میں موجود کی کوecho "AM_AI_ENCRYPTION_KEY=$(openssl rand -base64 32)" >> .env.envمیں درج کریں:docker compose exec antimatter cat /antimatter/data/ai-encryption.keyاسے پرنٹ کرتا ہے۔ - ایک کلسٹر جس کی فائلیں S3 میں ہیں۔ اس کے سرورز کوئی ڈائریکٹری شیئر نہیں کرتے، اس لیے سرور فائل نہیں بناتا: ہر سرور پر ایک ہی ویری ایبل سیٹ کریں۔ جب تک یہ سیٹ نہیں ہو، کنکشنز کیز محفوظ نہیں کر سکتے۔
- ریلیس آرکائیو یا پیکیجز کے ساتھ، فائل
data/میں ہوتی ہے (پیکیجز کے لیے/var/lib/antimatter/data)۔ آپ اسے وہیں رکھ سکتے ہیں، یا اپنے ماحول فائل میں ویری ایبل سیٹ کر سکتے ہیں۔
کی تبدیل کرنے کے لیے، نئی کو AM_AI_ENCRYPTION_KEY میں اور پرانی کو AM_AI_ENCRYPTION_PREVIOUS_KEYS میں سیٹ کریں (کئی کیز کوما سے الگ): پرانی کے ساتھ محفوظ شدہ کیز اب بھی پڑھی جا سکتی ہیں۔ کنکشن کی کی نئی کے ساتھ انکرپٹ ہو جاتی ہے جب آپ اسے دوبارہ ٹائپ کرتے ہیں۔ تک کہ ہر کنکشن کی کی دوبارہ ٹائپ نہ ہو جائے، پرانی کی کو فہرست میں رکھیں۔
موجودہ فیچرز
سسٹم کنسول › AI › Built-in features میں، ہر فیچر کے لیے سرور-وائیڈ کنکشن اور اس کا ماڈل منتخب کریں، یا آف۔ کنکشن کے بغیر فیچر کوئی AI استعمال نہیں کرتا۔ Load models کنکشن کے تمام ماڈلز کی فہرست پیش کرتا ہے؛ پہلے سے طے شدہ طور پر ہر فیچر کنکشن کے چٹ ماڈل کو استعمال کرتا ہے۔
| فیچر | ترتیب | اس کے لیے کیا اور ضروری ہے |
|---|---|---|
| Rewrite in the composer: پیغام باکس کے AI مینیو (بہتر بنائیں، مختصر کریں، درست کریں، ترجمہ کریں) | AISettings.Rewrite | کچھ نہیں: مینیو تب ظاہر ہوتا ہے جب کوئی کنکشن منتخب کیا جائے۔ |
| خلاصے: لوگوں کے منتخب کردہ چینلز کے خلاصے، درخواست پر یا طے شدہ شیڈول پر | AISettings.Recaps | سسٹم کنسول › سائٹ کی ترتیبات › خلاصے میں AI ری کاپس فعال کریں (پہلے سے فعال)، جو یہ بھی طے کرتا ہے کہ لوگ کتنے خلاصے بنا سکتے ہیں۔ |
| خودکار ترجمہ | AISettings.AutoTranslation | ترجمہ فراہم کنندہ Model connection (recommended)، خودکار ترجمہ میں۔ |
| متن کو آواز میں | AISettings.TextToSpeech | متن کو آواز میں میں پیغامات آواز میں پڑھیں کو آن کریں۔ کنکشن کا /audio/speech اینڈ پوائنٹ وہاں سیٹ کردہ ایڈریس اور کلید کی جگہ لے لیتا ہے۔ |
ہر ترتیب کے پاس ایک ConnectionId اور ایک Model کلید ہوتی ہے، مثال کے طور پر AISettings.Rewrite.ConnectionId (AM_AISETTINGS_REWRITE_CONNECTIONID)۔ خالی Model کنکشن کے پہلے سے طے شدہ ماڈل کو استعمال کرتا ہے۔
بنیادی فیچرز کنکشن کی حدوں کو استعمال کرتے ہیں، لیکن اس کے سامعین کو نہیں: جو بھی شخص فیچر استعمال کر سکتا ہے، اس کا کنکشن استعمال کر سکتا ہے۔ ایسا کنکشن جس کی توجہ درکار ہو، یا جو حذف کر دیا گیا ہو، فیچر کو ناکام بنا دیتا ہے جب تک آپ کوئی اور منتخب نہ کریں: صفحہ اس بات کا ذکر کرتا ہے۔
AI ایجنٹس
Agents ایپ (id mattermost-ai) ڈیفالٹ طور پر فعال ہے۔ اسے سیٹ اپ کرنے کے لیے دو مراحل ہیں: پہلے ایک سروس شامل کریں (ماڈل پرووائیڈر سے کنکشن)، پھر ایجنٹس بنائیں (بوٹس جو سروس استعمال کرتے ہیں)۔

1. سروس شامل کریں
سسٹم کنسول › پلگ انز › ایجنٹس پر جائیں اور AI Services کے نیچے Add an AI Service پر کلک کریں۔ Service type منتخب کریں:
- OpenAI Compatible: خود چلائے گئے ماڈل سرور کے لیے، یا کسی بھی پرووائیڈر کے لیے جس کے پاس OpenAI-سٹائل API ہو۔ API URL (مثلاً
http://ollama:11434/v1یاhttp://vllm.internal:8000/v1) اور صرف اس صورت میں API Key درج کریں اگر سرور کو اس کی ضرورت ہو۔ اگر سرور صرف Chat Completions API کو سپورٹ کرتا ہے، تو Use Responses API کو بند کر دیں۔ - OpenAI، Anthropic، Google Gemini، Google Vertex AI، AWS Bedrock، Azure، Cohere، Mistral: ہوسٹ شدہ پرووائیڈرز۔ ہر ایک کے لیے API Key درکار ہے (Bedrock کے لیے: AWS region اور credentials یا IAM role؛ Vertex AI کے لیے: project، region اور service account؛ Azure کے لیے: API URL بھی)۔
پھر Default model (اگر پرووائیڈر اپنے ماڈلز رپورٹ کر سکے تو فہرست، ورنہ نام لکھیں) اور اگر پرووائیڈر انہیں رپورٹ نہ کرے تو Input token limit اور Output token limit مقرر کریں۔ Fallback Service اس وقت کام کر سکتا ہے جب یہ ناکام ہو۔ محفوظ کریں۔
سرور خود یہ درخواستیں بھیجتا ہے، اس لیے اسے API تک رسائی ہونی چاہیے: ایک ماڈل سرور جو اسی compose project میں ہو، آپ کے نیٹ ورک پر ہو، یا انٹرنیٹ پر ہو۔ خارجہ درخواستیں HTTP_PROXY اور HTTPS_PROXY متغیرات کی پابند ہوتی ہیں۔
2. ایجنٹس بنائیں
ایجنٹس ویب ایپ کے ایجنٹس صفحے پر بنائے جاتے ہیں: ایجنٹس پینل کے ایجنٹ سلیکٹر میں منیج کریں پر کلک کر کے اسے کھولیں (کلاسیک انٹرفیس میں پروڈکٹ مینیو سے بھی)۔ اس کا پتہ https://chat.example.com/plug/mattermost-ai/agents ہے۔ ہر ایجنٹ کے پاس ڈسپلے نام، ایجنٹ یوزر نیم (جس کے ذریعے لوگ اس کا تذکرہ کرتے ہیں)، سروس اور اختیاری طور پر ماڈل، کسٹم انسٹرکشنز، اور Enable Vision (تصاویر) اور Enable Tools کے سوئچز ہوتے ہیں۔ اس کا رسائی ٹیب اس بات کو محدود کرتا ہے کہ اسے کون سے چینلز میں استعمال کیا جا سکتا ہے اور کون سے صارفین اسے استعمال کر سکتے ہیں۔ سسٹم کنسول کے AI Functions میں، Default bot وہ ایجنٹ منتخب کرتا ہے جو استعمال ہوتا ہے جب کوئی ایجنٹ منتخب نہ کیا جائے، مثلاً کال سماریز کے لیے۔
ایجنٹس ایپ کے اختیاری فیچرز
- Embedding search (تجرباتی، بند): پیغامات پر سیمینٹک سرچ۔ اس کے لیے pgvector ایکسٹینشن کے ساتھ PostgreSQL اور ایک embedding ماڈل (OpenAI یا OpenAI-compatible) درکار ہے۔ یہ ہر پیغام کو embedding ماڈل کو بھیجتا ہے، بشمول ذاتی چینلز اور براہِ راست پیغامات۔
- Web search (بند): ایجنٹس کو Google، Brave یا آپ کے چلائے ہوئے SearXNG سرور کے ذریعے ویب پر تلاش کرنے کی اجازت دیتا ہے۔
- Native tools: ایسے پرووائیڈرز کے ساتھ جو انہیں فراہم کرتے ہیں، ایجنٹس پرووائیڈر کی اپنی ویب سرچ (نئے ایجنٹس کے لیے پہلے سے طے شدہ طور پر آن، جہاں سپورٹ ہو)، ویب فیچ اور کوڈ ایکسیکوشن استعمال کر سکتے ہیں۔ یہ پرووائیڈر پر چلتے ہیں۔ انہیں ہر ایجنٹ کے لیے الگ الگ بند کریں۔
- Model Context Protocol (MCP): ایجنٹس کو آپ کے قابلِ اعتماد MCP سرورز سے جوڑیں، اضافی ٹولز کے لیے۔
- ڈیبگ: Trace Output (بند، سرور لاگز یا OpenTelemetry endpoint) اور Enable Token Usage Logging، جو ٹوکن کاؤنٹس کو
logs/agents/token_usage.logمیں لکھتا ہے۔
بول چال سے متن: کال ٹرانسکرپٹس اور کیپشنز
کالز کو ایک سپیچ ٹو ٹیکسٹ سرور کے ذریعے ٹرانسکرپٹ کیا جا سکتا ہے، جس میں لائیو کیپشنز شامل ہیں، جو کہ ایک OpenAI-compatibile /v1/audio/transcriptions endpoint فراہم کرتا ہے۔ اس کی ترتیبات کالز اور وائس میں موجود ہیں۔ جب Summarize transcriptions فعال ہو، تو ڈیفالٹ ایجنٹ ہر ٹرانسکرپٹ کا خلاصہ بھی پوسٹ کرتا ہے۔
ٹیکسٹ ٹو سپیچ: بلند آواز میں پڑھیں
متن کو آواز میں (text-to-speech) آن کرنے پر، ہر پیغام کے مینیو میں آواز میں پڑھیں ہوتا ہے: سرور پیغام کے متن کو text-to-speech API کو بھیجتا ہے اور آڈیو چلاتا ہے۔ ترتیبات، سسٹم کنسول › انضمامات › متن کو آواز میں میں:
| ترتیب | کلید اور متغیر | کیا درج کریں |
|---|---|---|
| پیغامات آواز میں پڑھیں | TextToSpeechSettings.Enable, AM_TEXTTOSPEECHSETTINGS_ENABLE | true (ڈیفالٹ طور پر غیر فعال) |
| API بیس URL | TextToSpeechSettings.URL, AM_TEXTTOSPEECHSETTINGS_URL | بیس URL، /v1 سمیت، مثال کے طور پر http://tts.internal:8000/v1۔ سرور اس کے /audio/speech endpoint کو کال کرتا ہے۔ |
| ماڈل | TextToSpeechSettings.Model, AM_TEXTTOSPEECHSETTINGS_MODEL | API کے نام سے ماڈل، مثال کے طور پر tts-1۔ ضروری ہے۔ |
| آواز | TextToSpeechSettings.Voice, AM_TEXTTOSPEECHSETTINGS_VOICE | ماڈل کی آوازوں میں سے ایک، یا ڈیفالٹ کے لیے خالی چھوڑیں۔ |
| API کلید | TextToSpeechSettings.APIKey, AM_TEXTTOSPEECHSETTINGS_APIKEY | بیرر ٹوکن کے طور پر بھیجا جاتا ہے۔ اگر API کو کوئی کلید درکار نہ ہو تو خالی چھوڑیں۔ |
اگر آپ اوپر دیے گئے پتے اور کلید کے بجائے ماڈل کنکشن استعمال کرنا چاہتے ہیں، تو AI › Built-in features میں متن کو آواز میں کے لیے اسے منتخب کریں۔ اس صفحے پر بتایا جاتا ہے کہ پیغامات اس کنکشن کے ذریعے آواز میں پڑھے جائیں گے: API بیس URL اور API کلید استعمال نہیں ہوں گی، آواز اب بھی استعمال ہوگی، اور اگر کنکشن میں کوئی ماڈل نامزد نہ کیا گیا ہو تو ماڈل بھی استعمال ہوگا۔ پیغامات آواز میں پڑھیں کو اب بھی آن ہونا ضروری ہے۔
بھیجنے سے پہلے، سرور کوڈ بلاکس، لنکس، ایموجی کوڈز اور فارمیٹنگ کو ہٹا دیتا ہے، اور زیادہ سے زیادہ 4000 حروف کو برقرار رکھتا ہے۔ یہ MP3 آڈیو کی درخواست کرتا ہے اور میموری میں آخری 64 نتائج کو برقرار رکھتا ہے، تاکہ دو بار پڑھا گیا پیغام صرف ایک بار بھیجا جائے۔
خودکار ترجمہ
خودکار ترجمہ چینل کے پیغامات کو ہر قاری کی اپنی زبان میں دکھاتا ہے۔ اسے سسٹم کنسول › سائٹ کی ترتیبات › مقامی زبان میں، خودکار ترجمہ کے تحت ترتیب دیں:
| ترتیب | کلید | ڈیفالٹ |
|---|---|---|
| فعال کریں | AutoTranslationSettings.Enable | غیر فعال |
| ترجمہ پرووائیڈر | AutoTranslationSettings.Provider | connection (جو "Model connection (recommended)" کے طور پر دکھایا جاتا ہے، اور جب کوئی چیز سیٹ نہ ہو تو یہی منتخب ہوتا ہے)، libretranslate، openai ("OpenAI-compatible API, set up here") یا agents ("AI chat app's service (older)") |
| مجازی زبانیں | AutoTranslationSettings.TargetLanguages | en: وہ زبانیں جن میں پیغامات کا ترجمہ کیا جا سکتا ہے |
| ترجمہ ٹائم آؤٹ (ms) | AutoTranslationSettings.TimeoutMs | 5000 |
| براہِ راست پیغامات اور گروپ پیغامات پر خودکار ترجمے کو محدود کریں | AutoTranslationSettings.RestrictDMAndGM | غیر فعال |
ہر فراہم کنندہ کے اپنے فیلڈز ہیں:
- Model connection: سرور-وائیڈ کنکشن اور اس کا ماڈل، جو AI › Built-in features میں خودکار ترجمہ کے ساتھ وہی ترتیب ہے (
AISettings.AutoTranslation)۔ ایک مخصوص ترجمہ ماڈل تیز اور درست ہوتا ہے؛ ایک عمومی LLM بھی کام کرتا ہے۔ - LibreTranslate: LibreTranslate API Endpoint اور LibreTranslate API Key (
AutoTranslationSettings.LibreTranslate.URL،.APIKey)۔ ایک LibreTranslate سرور آپ کے اپنے نیٹ ورک پر چلا سکتا ہے۔ - OpenAI-compatible API: API بیس URL (
/v1سمیت؛ سرور اس کے چٹ کمپلیشنز endpoint کو استعمال کرتا ہے)، ماڈل اور API کلید (AutoTranslationSettings.OpenAI.URL،.Model،.APIKey)۔ مقامی طور پر چلایا گیا ایک چھوٹا سا ترجمہ ماڈل اچھی طرح کام کرتا ہے۔ - AI chat app's service (older): 0.9.0 سے پہلے سیٹ اپ کیے گئے سرورز کے فراہم کنندہ، جو ایجنٹس ایپ کی ایک سروس استعمال کرتے تھے۔ اب اسے ایپ کی ضرورت نہیں ہے: یہ AI › Built-in features میں خودکار ترجمے کے لیے منتخب کردہ کنکشن کے ذریعے ترجمہ کرتا ہے، یا پھر اپ گریڈ کے وقت ایپ کی سروس سے کاپی شدہ کنکشن کے ذریعے۔ Switch to Model connection ترتیب کو سفارش کردہ فراہم کنندہ پر منتقل کرتا ہے۔
جب یہ فعال ہو جائے، تو چینل ایڈمنز چینل کی ترتیبات (خودکار ترجمہ) میں چینل کے لیے ترجمہ فعال کرتے ہیں، اور ہر رکن چینل کے مینیو (پیغامات کا ترجمہ کریں) سے اس سے خارج ہو سکتا ہے۔ براہِ راست اور گروپ پیغامات میں کوئی بھی رکن اسے فعال کر سکتا ہے؛ تاہم، پابندی کے ساتھ وہاں ترجمہ دستیاب نہیں ہوتا۔ ترجمہ شدہ پیغامات پر «ترجمہ کیا گیا … سے» کے ساتھ اصل پیغام کے لیے لنک دکھائی جاتی ہے۔
ٹیکسٹ بھیجے جانے سے پہلے کوڈ، لنکس، تذکرے اور ایموجی کو پلیس ہولڈرز سے تبدیل کر دیا جاتا ہے، اور بعد میں واپس رکھا جاتا ہے۔
کون سا ڈیٹا کہاں جاتا ہے
| فیچر | کیا بھیجا جاتا ہے | کس کو |
|---|---|---|
| دوبارہ لکھیں | جس پیغام کو لکھا جا رہا ہے، اور منتخب کردہ ہدایت | اس کے لیے منتخب کردہ کنکشن |
| خلاصے | ری کیپ میں شامل چینلز کے پیغامات، اور شخص کی ہدایات | اس کے لیے منتخب کردہ کنکشن |
| ماڈل کنکشنز استعمال کرنے والی ایپس | ہر ایپ کس چیز کو بھیجتی ہے، اس شخص کے لیے جو اسے استعمال کر رہا ہے | وہ کنکشنز جو اس شخص استعمال کر سکتا ہے |
| ایجنٹس | درخواست، جس سلسلے یا چینل کے بارے میں یہ ہے اس کے پیغامات، ایجنٹ کے احکامات، ٹولز کے نتائج، جب وژن چالو ہو تو تصاویر، اور پوچھنے والے صارف کا نام، یوزر نیم، عہدہ اور زبان | سروس کا API |
| ایمبیڈنگ تلاش | ہر پیغام (بوٹس اور سسٹم پیغامات کے سوا) | ایمبیڈنگ API |
| نیٹو ٹولز اور ویب تلاش | تلاش کے کوئریز، حاصل کرنے کے لیے صفحات، کوڈ | پرووائڈر، یا آپ نے منتخب کردہ سرچ انجن |
| کال ٹرانسکرپشن | جب یہ چالو ہو تو ہر اس شخص کی آواز جو بولتا ہے | speech-to-text API |
| پڑھ کر سنائیں | پڑھا جانے والے پیغام کا متن | متن کو آواز میں API، یا اس کے لیے منتخب کردہ کنکشن |
| ترجمہ | ترجمہ شدہ چینلز میں پیغامات کا متن | ماڈل کنکشن، LibreTranslate یا OpenAI-compatible API |
سب کچھ اپنے نیٹ ورک پر رکھنے کے لیے، ہر فیچر کو اسے اپنے خود چلائے ہوئے سرورز کی طرف اشارہ کریں۔ کلاؤڈ پرووائڈر کے ساتھ، اس کے ڈیٹا ریٹینشن شرائط کو چیک کریں، اور اپنے صارفین کو بتائیں کہ کون سے فیچرز ان کے پیغامات باہر بھیجتے ہیں۔
AI کو بند کرنا
کوئی واحد سوئچ نہیں ہے: ہر فیچر کا اپنا ہے۔
- دوبارہ لکھنے اور خلاصے: انہیں سسٹم کنسول › AI › Built-in features میں آف پر سیٹ کریں۔ لوگ ان خلاصوں کو بار بار پڑھتے رہتے ہیں جو پہلے سے موجود ہیں۔
- ماڈل کنکشنز: کسی کنکشن کو حذف کریں تاکہ اس کا ہر استعمال بند ہو جائے۔ اگر کوئی کنکشن موجود نہ ہو، تو نہ تو سرور کے ذریعے Built-in features اور نہ ہی ایپس AI استعمال کر سکیں گی۔
- ایجنٹس: سسٹم کنسول › پلگ انز › پلگ ان مینجمنٹ میں ایجنٹس ایپ کو غیر فعال کریں۔ اس سے کال کے خلاصے بھی حذف ہو جائیں گے۔
- ٹرانسکرپشن اور کیپشنز:
AM_CALLS_ENABLE_TRANSCRIPTIONS=falseاورAM_CALLS_ENABLE_LIVE_CAPTIONS=false(ڈیفالٹ)۔ - آواز میں پڑھیں: پیغامات آواز میں پڑھیں کو آف رکھیں (
AM_TEXTTOSPEECHSETTINGS_ENABLE=false، جو ڈیفالٹ ہے)، چاہے وہ کنکشن استعمال کرے یا نہ کرے۔ - ترجمہ: خودکار ترجمہ بند کریں (
AM_AUTOTRANSLATIONSETTINGS_ENABLE=false، ڈیفالٹ)۔
ایجنٹس ایپ کو غیر فعال کرنا دیگر فیچرز کو آف نہیں کرتا؛ وہ ماڈل کنکشنز یا اپنے APIs استعمال کرتے ہیں۔