استعمال کی گائیڈ

شروع کرنے کے لیے آپ کو API کلید کی ضرورت نہیں ہے: ایک ہوسٹڈ ماڈل پہلے سے شامل ہے، اور فری-ٹیر ایجنٹس پلیٹ فارم کے شیئرڈ پول پر خود بخود چلتے ہیں۔ اگر آپ کا پلان آپ کے اپنے پرووائیڈر کی اجازت دیتا ہے، تو Connect → Providers پر جائیں، Anthropic، OpenAI، یا کسی دوسرے معاون پرووائیڈر کا انتخاب کریں، اور اس پرووائیڈر کے ڈیش بورڈ سے اپنی API کلید پیسٹ کریں۔ کلید کو محفوظ کرنے سے پہلے ایک حقیقی (نان-بلڈ) کال کے ذریعے توثیق کی جاتی ہے، اور اسے انکرپٹ کیا جاتا ہے - جب یہ ACTIVE دکھاتا ہے، تو آپ کے ایجنٹس ہوسٹڈ پول کے بجائے اسے استعمال کرتے ہیں۔

اس کے بعد، بنانے کی فطری ترتیب یہ ہے: ایک Agent بنائیں (بنائیں → ایجنٹس)، اسے Playground میں نجی طور پر آزمائیں (ٹیسٹ → پلے گراؤنڈ)، پھر یا تو اسے ملٹی سٹیپ آٹومیشن کے لیے Workflow میں جوڑیں، یا اسے براہ راست کسی چینل (واٹس ایپ، ٹیلیگرام، ای میل) سے جوڑیں تاکہ حقیقی لوگ اس سے بات کر سکیں۔

کوئی بھی فیلڈ جو سسٹم پرامپٹ یا تفصیل طلب کرتا ہے - جیسے ایجنٹ کا سسٹم پرامپٹ، نالج کلیکشن کی تفصیل، اور وقت کے ساتھ مزید - اس کے لیبل کے ساتھ ایک چھوٹا ✨ Ask AI بٹن ہوتا ہے۔ اس پر کلک کریں، ایک جملے میں بیان کریں کہ آپ کیا چاہتے ہیں (مثلاً 'ایک سپورٹ ایجنٹ جو ریفنڈز اور آرڈر کی حیثیت کو سنبھالتا ہے')، اور یہ آپ کے پہلے سے فعال کردہ کسی بھی LLM پرووائیڈر کا استعمال کرتے ہوئے متن کا مسودہ تیار کرتا ہے۔ کچھ بھی خود بخود لاگو نہیں ہوتا - آپ ہمیشہ تجویز کا جائزہ لیتے ہیں اور خود Use this پر کلک کرتے ہیں، یا دوسری کوشش کے لیے Regenerate پر کلک کرتے ہیں۔

ایک ایجنٹ ایک AI شخصیت ہے: ایک سسٹم پرامپٹ، ایک LLM پرووائیڈر/ماڈل، اور اختیاری طور پر ایک نالج بیس اور ٹولز کا ایک محدود سیٹ۔ ایک مناسب سسٹم پرامپٹ پہلے سے بھرنے کے لیے ٹیمپلیٹ (سپورٹ ٹرائج، ریسرچ اسسٹنٹ، وغیرہ) سے شروع کریں، یا شروع سے آغاز کریں اور ایک ڈرافٹ تیار کرنے کے لیے Ask AI کا استعمال کریں۔

ٹول تک رسائی اور نالج تک رسائی دونوں اجازت کی فہرستیں ہیں: انہیں 'غیر محدود' کے لیے خالی چھوڑ دیں (ایجنٹ آپ کے ٹیننٹ کے لیے دستیاب ہر چیز استعمال کر سکتا ہے)، یا ایجنٹ کو صرف مخصوص آئٹمز تک محدود کرنے کے لیے انہیں منتخب کریں۔ یہ کسٹمر کے سامنے آنے والی کسی بھی چیز کے لیے اہم ہے - عام طور پر آپ نہیں چاہیں گے کہ ایک پبلک سپورٹ بوٹ کو ہر اندرونی ٹول تک رسائی حاصل ہو۔

.md، PDF، Word، تصاویر (OCR)، یا آڈیو/ویڈیو (ٹرانسکرائب شدہ) فائلیں اپ لوڈ کریں اور وہ ایک قابلِ تلاش ویکٹر اسٹور میں چنک اور ایمبیڈ ہو جاتی ہیں۔ کلیکشنز وہ فولڈرز ہیں جنہیں آپ نیسٹ کر سکتے ہیں اور ایجنٹس کو ان تک محدود کر سکتے ہیں - جیسے کہ 'ریٹرنز پالیسی' کلیکشن جسے صرف کچھ ایجنٹس تلاش کر سکتے ہیں، جبکہ 'پبلک FAQ' کلیکشن ہر ایجنٹ استعمال کر سکتا ہے۔

ایک ایجنٹ اپنے نالج بیس کو صرف تب تلاش کرتا ہے جب اسے بناتے وقت 'نالج بیس منسلک کریں' کو چیک کیا گیا ہو (یا بعد میں ایجنٹس کے صفحے سے ٹوگل کیا گیا ہو)، اور صرف ان کلیکشنز کے اندر جن کی اس کی نالج تک رسائی کی اجازت کی فہرست اجازت دیتی ہے۔

ملٹی سٹیپ آٹومیشن کے لیے ویژول کینوس: نوڈز (ٹرگر، ایجنٹ، نالج سرچ، کنڈیشن، آؤٹ پٹ، ڈیوائس کنٹرول، اور مزید) کو ڈریگ کریں اور انہیں جوڑیں۔ ہر نوڈ اس کے پیچھے موجود اصلی سروس کو کال کرتا ہے - ایک ورک فلو رن واقعی آپ کے ایجنٹ کو کال کرتا ہے، واقعی آپ کے نالج بیس کو تلاش کرتا ہے، واقعی واٹس ایپ پیغام بھیجتا ہے۔

ورک فلوز تین طریقوں سے شروع ہو سکتے ہیں: دستی طور پر ('رن' بٹن)، ایک شیڈول پر (کرون ایکسپریشن، جیسے 'ہر صبح 8 بجے')، یا ایک ویب ہک URL کے ذریعے جسے آپ کسی بھی بیرونی سسٹم سے کال کر سکتے ہیں۔ ہر رن اس ورک فلو کے 'رنز' ٹیب کے تحت مرحلہ وار لاگ ہوتا ہے، بشمول راستے میں ایجنٹ نوڈ کی طرف سے کی گئی ہر انفرادی ٹول کال۔

ماڈل کانٹیکسٹ پروٹوکول سرورز اور بلٹ ان ٹولز کا ایک بازار جسے ایک ایجنٹ گفتگو کے دوران کال کر سکتا ہے (ویب سرچ، ڈیٹا بیس، فائل سسٹم، آپ کے اپنے کسٹم اسکرپٹس...)۔ جنہیں آپ دستیاب کرنا چاہتے ہیں انہیں فعال کریں، پھر ہر ایجنٹ کے ٹول-ایکسیس ایڈیٹر سے یہ متعین کریں کہ کون سے ایجنٹس انہیں استعمال کر سکتے ہیں۔ یہاں ایک سرور کو غیر فعال کرنے سے یہ فوری طور پر ہر ایجنٹ کے دستیاب ٹولز سے ہٹ جاتا ہے، یہاں تک کہ ان سے بھی جن میں پہلے یہ منتخب تھا۔

ایڈمن → چینلز کے تحت: واٹس ایپ کو یا تو Twilio کے ذریعے (تیز سینڈ باکس سیٹ اپ، فی پیغام چھوٹی سی فیس) یا براہ راست میٹا کے اپنے واٹس ایپ بزنس پلیٹ فارم کے ذریعے (کوئی درمیانی فیس نہیں، زیادہ سیٹ اپ - آپ کی اپنی میٹا ایپ، سسٹم یوزر ٹوکن، اور ایپ سیکرٹ) جوڑیں۔ اگر دونوں کنفیگر ہوں تو، براہ راست میٹا کنکشن خود بخود استعمال ہوتا ہے۔

جب کوئی نیا فون نمبر پہلی بار پیغام بھیجتا ہے، تو وہ زیر التواء بھیجنے والے جوڑوں کے تحت ظاہر ہوتا ہے اور آپ کے ایجنٹس کے اس کے ساتھ لائیو گفتگو کرنے سے پہلے اسے منظور کرنے کی ضرورت ہوتی ہے - یہ کسی اجنبی کو آپ کے نمبر پر پیغام بھیجنے سے روکتا ہے تاکہ وہ پہلے سے طے شدہ طور پر بغیر نگرانی کے AI گفتگو نہ کر سکے۔

ڈیوائسز کے صفحے سے اپنے ٹیننٹ کے ساتھ ایک فون (اینڈرائیڈ یا iOS) جوڑیں، اور ایک ورک فلو کا ڈیوائس کنٹرول نوڈ اس پر ٹیپ، ٹائپ، ایپس کھول، یا اسکرین شاٹ لے سکتا ہے۔ اینڈرائیڈ، اینڈرائیڈ کی ایکسیسبیلٹی سروس کے ذریعے مکمل آٹومیشن کو سپورٹ کرتا ہے؛ iOS ایپل کی اپنی سینڈ باکسنگ کی وجہ سے صرف ایپس کھولنے تک محدود ہے - ہر پلیٹ فارم کیا کر سکتا ہے اور کیا نہیں، اس کی مکمل اور ایماندارانہ تفصیل کے لیے موبائل SDK کی CONSTRAINTS.md دیکھیں۔

صارفین: ٹیم کے ساتھیوں کو مدعو کریں اور رول تفویض کریں (صرف ایک ٹیننٹ-ایڈمن رول یا اسناد تبدیل کر سکتا ہے)۔ منظوریاں ہیومن-ان-دی-لوپ ان باکس ہے - کوئی بھی کارروائی جسے آپ کی گارڈریل پالیسی منظوری کے لیے فلیگ کرتی ہے (جیسے کہ ایک ایجنٹ واٹس ایپ پیغام بھیجنے والا ہے) یہاں منظور یا مسترد ہونے تک انتظار کرتی ہے۔ آڈٹ لاگ آپ کے ٹیننٹ میں کسی شخص یا ایجنٹ کی طرف سے کی گئی ہر اہم کارروائی کا ایک مکمل، صرف شامل کرنے والا ریکارڈ ہے۔

"No active providers yet" when creating an agent - you should not see this on a new account: every new account runs on the platform's hosted pool for its first 3 months, and the Free plan does after that. It appears once you are on a paid plan using your own provider - activate one under Connect → Providers.

Ask AI بٹن ایک خرابی دیتا ہے - وجہ وہی ہے جو اوپر بیان کی گئی ہے۔ یہ صرف اس وقت ناکام ہوتا ہے جب آپ کا اکاؤنٹ ہوسٹڈ پول سے باہر ہو اور اس کا اپنا کوئی فعال پرووائیڈر نہ ہو۔

ایک زیر التواء واٹس ایپ/ٹیلیگرام بھیجنے والے کو کبھی جواب نہیں ملتا - اپنی منظوری کے منتظر جوڑے کے لیے Admin → Channels چیک کریں۔

ایک ٹول ایجنٹ کے لیے ظاہر نہیں ہوتا - تصدیق کریں کہ یہ MCP ٹولز کے تحت فعال ہے، اور یہ کہ ایجنٹ کی ٹول-ایکسیس فہرست میں یا تو یہ شامل ہے یا خالی چھوڑی گئی ہے (غیر محدود)۔