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 URLAPI کا پتہ، /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۔ یہ صرف ان ایپس کے لیے اہم ہے جو فیصلوں کی درخواست کرتی ہیں۔
LimitsLimits and budgets دیکھیں۔
کمیونٹیزصرف سرور-وائیڈ کنکشنز۔ سب کمیونٹیز: ہر کمیونٹی میں، اور براہِ راست اور گروپ پیغامات میں استعمال ہونے کے قابل۔ ورنہ، صرف ان کمیونٹیز میں جو آپ منتخب کریں۔
کون استعمال کر سکتا ہےجہاں یہ استعمال ہونے کے قابل ہو سب، یا صرف وہ ٹیمز (کمیونٹی کے اندر لوگوں کے گروپ) اور رولز (سسٹم ایڈمنز، کمیونٹی ایڈمنز) جو آپ منتخب کریں۔ مہمان بھی مہمانوں کو اسے استعمال کرنے کی اجازت دیتا ہے؛ اس کے بغیر، مہمان اسے استعمال نہیں کر سکتے، حتیٰ کہ سب کے ساتھ بھی۔

کنکشن ٹیسٹ کریں پتے اور کلید کی جانچ کرتا ہے: سرور endpoint سے اس کے ماڈلز مانگتا ہے، یا ایک ٹوکن کی چیٹ بھیجتا ہے۔ تبدیلی والا پتہ صرف اس وقت محفوظ شدہ کلید کے ساتھ ٹیسٹ ہوتا ہے جب آپ محفوظ کریں، یا اگر آپ کلید دوبارہ ٹائپ کریں۔ محفوظ کرنے کے لیے Add connection پر کلک کریں۔

سرور خود درخواستیں بھیجتا ہے، اس لیے اسے API تک رسائی ہونی چاہیے: اسی compose پروجیکٹ میں موجود ماڈل سرور، آپ کے نیٹ ورک پر موجود سرور، یا انٹرنیٹ پر موجود سرور۔ باہر کی درخواستیں HTTP_PROXY اور HTTPS_PROXY متغیرات کی پابند ہوتی ہیں۔

کسی کنکشن کو حذف کرنے سے اس کا کلڈ حذف ہو جاتا ہے۔ وہ خصوصیات جو اس کا استعمال کر رہی تھیں، جب تک آپ کوئی اور کنکشن منتخب نہ کریں، AI کا استعمال بند کر دیتی ہیں۔

حدیں اور بجٹ

ہر کنکشن کی چار حدیں ہیں۔ خالی یا 0 کا مطلب ہے کوئی حد نہیں۔

  • فی منٹ درخواستیں اور فی شخص، فی منٹ درخواستیں۔ ہر سرور انہیں الگ الگ گنتی کرتا ہے: تین سروروں کا کلسٹر شرح کے تین گنا تک کی درخواستیں گزرنے دے سکتا ہے۔
  • فی مہینہ ٹوکنز اور فی شخص، فی مہینہ ٹوکنز: ٹوکنز کا بجٹ، ہر کیلنڈر مہینے (UTC) کے حساب سے، پورے کلسٹر کے لیے ڈیٹا بیس میں گنتی کی جاتی ہے۔ ایک ہی وقت میں چل رہی کئی درخواستیں بجٹ سے تھوڑا آگے جا سکتی ہیں۔

فی شخص کی حدیں دوبارہ لکھنے اور خلاصوں پر بھی لاگو ہوتی ہیں: یہ اس شخص کے حساب سے گنتی ہوتی ہیں جو دوبارہ لکھتا ہے، یا جس کے پاس خلاصہ ہے۔

استعمال

فہرست میں ہر کنکشن کا اس مہینے کا استعمال دکھایا گیا ہے۔ استعمال تفصیلات کھولتا ہے: اندر اور باہر ٹوکنز، درخواستیں، ماہانہ بجٹ، روزانہ (UTC) اور استعمال کے لحاظ سے (دوبارہ لکھیں، خلاصے، خودکار ترجمہ، متن کو آواز میں، لوگ، ایپس کے ذریعے، یا کوئی ایپ) استعمال۔

کسی شخص یا ایپ کا کنکشن کے ذریعے ہر کال ایک آڈٹ ریکارڈ بھی لکھتا ہے: کون، کنکشن، استعمال، ماڈل، ٹوکنز کی تعداد اور کامیابی، کبھی بات کا مواد نہیں۔ درجہ بند خصوصیات صرف استعمال میں گنتی ہوتی ہیں: صرف ترجمہ ہر پیغام اور زبان کے لیے ایک کال بناتا ہے۔

کمیونٹی کنکشنز

کمیونٹی ایڈمنز اپنے کمیونٹی کے کنکشنز کمیونٹی کی ترتیبات میں، ماڈل کنکشنز ٹیب میں شامل کرتے ہیں۔ فارم وہی ہے، کمیونٹیز کے بغیر: کمیونٹی کا کنکشن صرف اپنے چینلز میں، اپنے ارکان کے لیے، اور اس کی آڈینس صرف اپنے ٹیمز کا نام لے سکتی ہے۔ ماڈل کنکشنز کا انتظام اجازت والے کردار بھی ان کا انتظام کر سکتے ہیں۔ پہلے سے کمیونٹی ایڈمنز کے پاس یہ اجازت ہوتی ہے۔

کمیونٹی کا کنکشن پرائیویٹ یا لوپ بیک ایڈریسز تک رسائی نہیں کر سکتا (مثلاً آپ کے نیٹ ورک پر موجود Ollama سرور)، جب تک کہ سسٹم کنسول › ماحول › ڈویلپر › غیر مستند اندرونی کنکشنز کی اجازت دیں (ServiceSettings.AllowedUntrustedInternalConnections) میں ان کی فہرست نہ ہو۔ سرور بھر کے کنکشنز یہ کر سکتے ہیں۔

کمیونٹی ایڈمنز کے حصے کے لیے کمیونٹی ترتیبات دیکھیں۔

انکرپشن کلڈ

ماڈل کنکشنز کے کیز اور اضافی ہیڈرز ڈیٹا بیس میں ایک انکرپشن کی کے ذریعے انکرپٹ (AES-256-GCM) کیے جاتے ہیں۔ صرف ڈیٹا بیس بیک اپ سے یہ ظاہر نہیں ہوتے۔ سرور اس کی کو درج ذیل ترتیب سے تلاش کرتا ہے:

  1. AM_AI_ENCRYPTION_KEY ویری ایبل: 32 رینڈم بائٹس، base64 میں۔ اسے بنانے کے لیے openssl rand -base64 32 استعمال کریں۔
  2. اگر نہیں، تو سرور کے ڈیٹا ڈائریکٹری (FileSettings.Directory, پہلے سے طے شدہ ./data/) کے رُٹ پر موجود فائل ai-encryption.key۔ سرور اسے پہلی بار بناتا ہے جب کوئی کنکشن اس کی ضرورت محسوس کرتا ہے، اور یہ صرف خود سرور کے لیے قابلِ مطالعہ ہوتی ہے۔ ایپس، ایکسپورٹس اور فائل آرکائیوز اسے نہیں پڑھ سکتے۔
کی کے بغیر، محفوظ شدہ API کیز کو پڑھا نہیں جا سکتا، اور ہر کنکشن کو اپنی کی دوبارہ دینی پڑتی ہے۔ کی کو ڈیٹا بیس کے ساتھ بیک اپ کریں (دیکھیں بیک اپس اور اپ گریڈز)، اور اسے ڈیٹا بیس بیک اپس سے الگ رکھیں۔

ویری ایبل کب سیٹ کریں:

  • سائٹ کے 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) ڈیفالٹ طور پر فعال ہے۔ اسے سیٹ اپ کرنے کے لیے دو مراحل ہیں: پہلے ایک سروس شامل کریں (ماڈل پرووائیڈر سے کنکشن)، پھر ایجنٹس بنائیں (بوٹس جو سروس استعمال کرتے ہیں)۔

The Agents panel on the right of a channel: a user asked about an incident and the agent answered with a summary of the related threads.
ایجنٹ Agents پینل میں جواب دیتا ہے۔
ایجنٹس ایپ کے ایجنٹ اب بھی ایپ کے اپنے AI Services استعمال کرتے ہیں، ماڈل کنکشنز نہیں۔ بنیادی فیچرز اب ایپ کے ذریعے نہیں جاتے۔ 0.9.0 پر اپ گریڈ شدہ سرور پر، ایپ کے سروسز کو بھی ایک بار سرور-وائیڈ ماڈل کنکشنز میں کاپی کیا گیا تھا (دیکھیں 0.9.0 میں اپ گریڈ)۔

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 وہ ایجنٹ منتخب کرتا ہے جو استعمال ہوتا ہے جب کوئی ایجنٹ منتخب نہ کیا جائے، مثلاً کال سماریز کے لیے۔

ڈیفالٹ طور پر، ہر صارف اپنے اپنے ایجنٹس بنانے کی اجازت رکھتا ہے، آپ کی ترتیب شدہ سروسز کے ساتھ۔ اسے صرف ایڈمنسٹریٹرز کے لیے رکھنے کے لیے، سسٹم کنسول › صارفین کا انتظام › اجازتیں میں ممبرز کے رول سے اپنے AI ایجنٹس کو منظم کریں کی اجازت ہٹا دیں۔

ایجنٹس ایپ کے اختیاری فیچرز

  • 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_ENABLEtrue (ڈیفالٹ طور پر غیر فعال)
API بیس URLTextToSpeechSettings.URL, AM_TEXTTOSPEECHSETTINGS_URLبیس URL، /v1 سمیت، مثال کے طور پر http://tts.internal:8000/v1۔ سرور اس کے /audio/speech endpoint کو کال کرتا ہے۔
ماڈلTextToSpeechSettings.Model, AM_TEXTTOSPEECHSETTINGS_MODELAPI کے نام سے ماڈل، مثال کے طور پر 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.Providerconnection (جو "Model connection (recommended)" کے طور پر دکھایا جاتا ہے، اور جب کوئی چیز سیٹ نہ ہو تو یہی منتخب ہوتا ہے)، libretranslate، openai ("OpenAI-compatible API, set up here") یا agents ("AI chat app's service (older)")
مجازی زبانیںAutoTranslationSettings.TargetLanguagesen: وہ زبانیں جن میں پیغامات کا ترجمہ کیا جا سکتا ہے
ترجمہ ٹائم آؤٹ (ms)AutoTranslationSettings.TimeoutMs5000
براہِ راست پیغامات اور گروپ پیغامات پر خودکار ترجمے کو محدود کریں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 استعمال کرتے ہیں۔