Workflow Builder
Workflow Builder سکرپٹ شدہ کال فلوز کے لیے ایک بصری، نوڈ-بیسڈ ایڈیٹر ہے۔ جہاں کھلا-اختتام ایجنٹ ماڈل کو طے کرنے دیتا ہے کہ آگے کیا کہنا ہے، وہاں ایک ورک فلو ایجنٹ کو ایک متعین راستہ دیتا ہے — اقدامات کی ایک ترتیب جو بولتی ہے، پوچھتی ہے، برانچ کرتی ہے، ٹولز کال کرتی ہے اور گفتگو کو روٹ کرتی ہے۔ اسے اس وقت استعمال کریں جب کسی کال کو کسی متعین سکرپٹ کی پیروی کرنی ہو: کسی لیڈ کو کوالیفائی کرنا، اپائنٹمنٹ بُک کرنا، کسی سپورٹ مسئلے کی ٹرائیج کرنا یا کوئی سروے جمع کرنا۔ آپ اسے ایجنٹ بلڈر میں /agent/setup پر Tools ٹیب سے، Open Workflow Builder بٹن کا استعمال کرتے ہوئے کھولتے ہیں۔
ایک ورک فلو کسی ایک ایجنٹ سے تعلق رکھتا ہے۔ کال کے وقت ایک supervisor گفتگو کو دیکھتا ہے، طے کرتا ہے کہ کال کرنے والا کون سا intent ظاہر کر رہا ہے، اور اس ارادے کے steps کو ترتیب سے چلاتا ہے۔ اقدامات کے اندر ایجنٹ جو فنکشنز استعمال کر سکتا ہے وہ بالکل وہی ہیں جنہیں آپ نے Tools ٹیب پر باندھا ہے — ورک فلو کسی ایسے ٹول تک نہیں پہنچ سکتا جو آپ نے نہیں دیا۔
ورک فلو کی ساخت کیسے ہوتی ہے
Workflow Builder: n8n طرز کے نوڈ کینوس پر یقینی کال فلوز ڈیزائن کریں، ایک اختیاری سپروائزر پرامپٹ کے ساتھ۔
ایک ورک فلو میں تین نیسٹڈ سطحیں ہوتی ہیں:
- Graph — فی ایجنٹ ایک ورک فلو۔ یہ ایک اختیاری supervisor prompt رکھتا ہے (AI سُپروائزر کے لیے حسبِ ضرورت ہدایات جو ارادے روٹ کرتا ہے)۔ جب تک آپ گراف نہیں بناتے، بلڈر ایک بار کا Create Workflow Graph اسکرین دکھاتا ہے جس میں supervisor-prompt فیلڈ ہوتا ہے۔
- Intents — گفتگو کی شاخیں۔ ہر ارادے کا ایک display name، ایک internal name، ایک description (سُپروائزر ماڈل کو دکھائی جاتی ہے تاکہ یہ ارادے کو میچ کر سکے)، trigger phrases کی ایک فہرست، ایک default intent ٹوگل، اور ایک اختیاری fallback response ہوتا ہے جو اس کے تمام اقدامات ناکام ہونے پر استعمال ہوتا ہے۔ سُپروائزر وہ ارادہ منتخب کرتا ہے جس کی تفصیل اور trigger phrases کال کرنے والے کی بات سے بہترین مطابقت رکھتے ہوں۔
- Steps — کسی ارادے کے اندر ترتیب شدہ کارروائیاں۔ اقدامات طے شدہ طور پر اوپر سے نیچے چلتے ہیں، اور ہر اقدام کی ایک قسم ہوتی ہے جو طے کرتی ہے کہ یہ کیا کرتا ہے۔
کینوس پر یہ ایک سبز Start نوڈ کی شکل میں نظر آتا ہے جو فی شاخ ایک Intent نوڈ میں بہتا ہے، اور اس ارادے کے Step نوڈز اس کے نیچے جمع ہوتے ہیں۔ ایک منی میپ، زوم کنٹرولز اور ایک نقطے دار پسِ منظر آپ کو بڑے فلوز میں راستہ تلاش کرنے میں مدد دیتے ہیں۔
سُپروائزر کال کرنے والے کے کہے ہوئے جملے کا ہر ارادے کی description اور trigger phrases کے ساتھ موازنہ کرتا ہے، لہٰذا تفصیلات اس طرح لکھیں جیسے آپ کسی ساتھی کو سمجھا رہے ہوں ("User wants to book or schedule an appointment") اور چند فطری trigger phrases شامل کریں۔ کسی ایک ارادے کو default کے طور پر نشان زد کریں تاکہ وہ گفتگوئیں پکڑ لی جائیں جو واضح طور پر کسی اور چیز سے میچ نہیں کرتیں۔
اقدام کی اقسام
Add Step کے ساتھ ایک اقدام شامل کریں (کسی ارادے یا اس کے کسی اقدام کو منتخب کرنے کے بعد)، جو نوڈ پکر کھولتا ہے۔ پکر اقدام کی اقسام کو Conversation، Logic، Integrations اور Call Control میں گروپ کرتا ہے۔ تیرہ اقسام ہیں:
- Message — بوٹ کال کرنے والے سے ایک جملہ بولتا ہے۔
- Question — بوٹ کچھ پوچھتا ہے اور جواب کو ایک variable میں محفوظ کرتا ہے۔ آپ ایک validation type (Any، Number، Email، Date، Yes / No یا Phone) اور ایک re-ask message منتخب کرتے ہیں جو جواب کی توثیق ناکام ہونے پر استعمال ہوتا ہے۔
- Condition — فلو کو برانچ کرتا ہے۔ آپ ایک field (ایک سیشن ویری ایبل)، ایک operator (equals، not equals، contains، does not contain، greater than، less than، matches regex، is empty، is not empty) اور ایک value منتخب کرتے ہیں، پھر If True اور If False کو مخصوص اقدامات کی طرف روٹ کرتے ہیں۔
- Tool Call — ایجنٹ سے بندھے ہوئے کسی built-in یا custom فنکشن کو کال کرتا ہے۔ آپ ٹول کی قسم، فنکشن، اور ایک اختیاری input mapping (JSON) منتخب کرتے ہیں جو اقدام کے ان پٹس کو سیشن ویری ایبلز سے میپ کرتا ہے۔
- Appointment — کسی بُکنگ فنکشن کے ساتھ ایک اپائنٹمنٹ-بُکنگ ذیلی-فلو چلاتا ہے، اپنی ان پٹ میپنگ کے ساتھ۔
- Webhook — کسی بیرونی URL کو ایک HTTP درخواست بھیجتا ہے۔ آپ method (GET، POST، PUT، PATCH، DELETE)، URL، اختیاری headers (JSON)، ایک body template، اور ایک ویری ایبل سیٹ کرتے ہیں جس میں save the response کیا جائے۔
- Transfer — کال کو کسی اور phone number or queue کو حوالے کرتا ہے، ٹرانسفر سے پہلے اعلان کیے گئے ایک اختیاری پیغام کے ساتھ۔ یہ دیکھنے کے لیے کہ کال ٹرانسفرز ابتدا سے انتہا تک کیسے برتاؤ کرتے ہیں کالنگ اور ٹیلیفونی دیکھیں۔
- End Call — کال بند کرتا ہے، اختیاری طور پر پہلے ایک goodbye message بول کر۔
- Delay — جاری رکھنے سے پہلے ایک مقررہ تعداد سیکنڈ (1–60) کے لیے خاموشی سے انتظار کرتا ہے۔
- Set Variable — ایک قدر (سٹیٹک متن یا کسی اور ویری ایبل کا حوالہ) کو ایک سیشن ویری ایبل میں محفوظ کرتا ہے۔
- Send Notification — ایک نام والے ٹیمپلیٹ اور ایک ویری ایبل میپنگ (JSON) کا استعمال کرتے ہوئے ایک SMS، email یا WhatsApp پیغام بھیجتا ہے۔
- Static Response — متن کا ایک طے شدہ بلاک بولتا ہے۔ یہ ایک پرانا (legacy) نوڈ ہے؛ نئے فلوز کے لیے Message کو ترجیح دیں۔
- Play Audio — کال کرنے والے کو ایک آڈیو فائل (ایک عوامی WAV یا MP3 URL) چلاتا ہے۔
ہر اقدام دائیں طرف کے پینل میں ترتیب دیا جاتا ہے جو کسی نوڈ کو منتخب کرنے پر کھلتا ہے۔ پینل صرف وہی فیلڈز دکھاتا ہے جو اس اقدام کی قسم سے متعلق ہوں، نیز اقدام کا نام اور ایک قسم کا سلیکٹر۔
ایک Question یا Set Variable اقدام اپنا نتیجہ آپ کے منتخب کردہ نام کے تحت محفوظ کرتا ہے۔ بعد میں اس کا حوالہ دیں — کسی Message، کسی Condition کے فیلڈ، کسی Webhook باڈی یا کسی نوٹیفکیشن میپنگ میں — کرلی-بریس سینٹیکس جیسے {variable_name} کے ساتھ۔ یہی وہ طریقہ ہے جس سے ایک فلو یاد رکھتا ہے کہ کال کرنے والے نے کیا کہا اور اسے اقدامات کے درمیان آگے لے جاتا ہے۔
برانچنگ اور روٹنگ
اقدامات کا سیدھی لائن میں چلنا ضروری نہیں:
- ایک Condition اقدام True اور False آؤٹ پٹس ظاہر کرتا ہے۔ کسی ویری ایبل کی قدر پر برانچ کرنے کے لیے ہر ایک کو کسی ہدف اقدام سے جوڑیں (یا اسے Continue in order پر چھوڑ دیں)۔
- باقی ہر اقدام کی قسم میں On Success اور On Failure روٹنگ ہوتی ہے۔ طے شدہ طور پر ایک اقدام ترتیب میں اگلے کی طرف جاری رہتا ہے؛ کہیں اور چھلانگ لگانے کے لیے انہیں سیٹ کریں — مثال کے طور پر، کسی ناکام Tool Call کو کسی ریکوری پیغام کی طرف روٹ کریں۔
آپ روٹنگ دو طریقوں سے سیٹ کر سکتے ہیں: کنفگ پینل میں ہدف اقدام منتخب کریں، یا کینوس پر کسی اقدام کے آؤٹ پٹ ہینڈل (سبز OK / TRUE ہینڈل یا سرخ FAIL / FALSE ہینڈل) سے کسی اور اقدام تک ایک کنکشن گھسیٹیں۔ کینوس پر کھینچے گئے کنکشنز فوراً ورک فلو میں محفوظ ہو جاتے ہیں۔
بنانا اور محفوظ کرنا
بلڈر تبدیلیوں کو ایک بڑے سیو کے بجائے جیسے جیسے آپ انہیں کرتے ہیں محفوظ کرتا ہے:
- Add Intent ایک نئی شاخ بناتا ہے؛ اس کا نام، تفصیل اور trigger phrases بھرنے کے لیے اس پر کلک کریں، پھر پینل میں Save Changes کریں۔
- Add Step آپ کی منتخب کردہ قسم کا ایک اقدام داخل کرتا ہے؛ اسے پینل میں ترتیب دیں اور Save Changes کریں۔
- کسی نوڈ پر اوپر / نیچے شیورونز ارادوں اور اقدامات کو دوبارہ ترتیب دیتے ہیں؛ کسی نوڈ کو حذف کرنا (اس کے ٹریش آئیکن یا Delete کلید کے ذریعے) پہلے تصدیق طلب کرتا ہے۔
- ٹول بار کا Save بٹن supervisor prompt محفوظ کرتا ہے؛ ایک عنبری نقطہ غیر محفوظ پرامپٹ ترامیم کو ظاہر کرتا ہے۔
ایک ٹیمپلیٹ سے شروع کریں
شروع سے بنانے کے بجائے، Templates بٹن تیار-شدہ فلوز پیش کرتا ہے جنہیں آپ لوڈ کر کے پھر ترمیم کر سکتے ہیں: Lead Qualification، Appointment Booking، Customer Support، NPS Survey، Payment Reminder اور Customer Onboarding۔ ہر ایک اپنے اقدامات کے ساتھ ایک مکمل ارادہ شامل کرتا ہے، بشمول سوالات، شرائط اور الوداعی پیغامات۔ کسی ٹیمپلیٹ کو لاگو کرنا آپ کے موجودہ ورک فلو میں شامل کرتا ہے بجائے اسے بدلنے کے، لہٰذا آپ کئی کو ملا سکتے ہیں یا جو آپ کو نہیں چاہیے اسے کاٹ سکتے ہیں۔
OpenAPI سپیک سے فنکشنز امپورٹ کریں
Import API بٹن کسی موجودہ API کو ایجنٹ فنکشنز میں بدل دیتا ہے جنہیں آپ Tool Call اقدامات سے کال کر سکتے ہیں۔ ایک OpenAPI / Swagger سپیک فراہم کریں — URL کے ذریعے یا اسے پیسٹ کر کے (OpenAPI 2.0 یا 3.x، JSON یا YAML) — اور امپورٹر آپریشنز کو پارس کرتا ہے۔ وہ آپریشنز منتخب کریں جو آپ چاہتے ہیں، بنیادی URL کی تصدیق کریں، اور یہ ان کے لیے custom functions تیار کرتا ہے۔ پھر وہ فنکشنز Tool Call اقدامات کے لیے فنکشن فہرست میں اور Tools ٹیب پر ظاہر ہوتے ہیں۔
ایک Tool Call اقدام صرف ان فنکشنز کا استعمال کر سکتا ہے جو ایجنٹ کو پہلے سے دستیاب ہوں — بلٹ-ان فنکشنز اور Tools ٹیب پر بندھے ہوئے کوئی بھی custom functions، بشمول وہ جو OpenAPI امپورٹر نے تیار کیے۔ اگر جو فنکشن آپ چاہتے ہیں وہ فہرست میں نہیں ہے، تو پہلے اسے Tools ٹیب پر شامل کریں۔