---
title: "Prompt اسٹائل گائیڈ"
description: "ThunderPhone وائس ایجنٹ کا prompt کیسے لکھیں اور ترمیم کریں: وہ رہنما اصول جنہیں prompt ریویو جانچتا ہے، ان IDs کے ساتھ جن کا اس کی نتائج میں حوالہ دیا جاتا ہے۔"
---

{/*
  GENERATED FILE: do not edit by hand.
  Source: api/agents/prompt_style_guide.md
  Regenerate: python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI regenerates this page and fails on drift
  (scripts/docs-freshness/generators.d/50-prompt-style-guide.sh).
*/}

<Note>
  یہ وہ رہنما ہے جس کے مقابلے میں [prompt جائزہ](/api-reference/agents#review-a-prompt) کسی prompt کو چیک کرتا ہے، اور
  اس کے نتائج نیچے دی گئی ids کا حوالہ دیتے ہیں۔ [MCP server](/ur/guides/thunderphone-mcp-server) سے منسلک کوڈنگ
  ایجنٹس یہی متن بطور ریسورس
  `thunderphone://guides/prompt-style` پڑھتے ہیں۔ ٹیمپلیٹس اور مثالوں کے لیے
  [prompting رہنما](/ur/guides/prompting) دیکھیں۔
</Note>

یہ رہنما ہر اس شخص کے لیے ہے جو وائس ایجنٹ کا prompt لکھتا یا اس میں ترمیم کرتا ہے: بلڈر میں موجود شخص، Copilot، یا API
کے ذریعے کام کرنے والا کوڈنگ ایجنٹ۔ prompt جائزہ ٹول اسے اپنے معیار کے طور پر استعمال کرتا ہے اور اس کی رہنما ids (P1، W2
وغیرہ) کا حوالہ دیتا ہے۔

کالر ایجنٹ کو بولنے کی رفتار سے ایک بار سنتا ہے اور واپس اسکرول نہیں کر سکتا۔ ایجنٹ ہر
موڑ پر prompt پڑھتا ہے اور اس کے الفاظ کو قریب سے دہراتا ہے۔ یہ دونوں حقائق نیچے دی گئی ہر چیز کی شکل متعین کرتے ہیں۔

## ساخت

**P1. اسے اس طرح لکھیں جیسے کوئی شخص نئے استقبالیہ اہلکار کو بریف کرتا ہے۔** ایک مختصر آغاز بتاتا ہے کہ ایجنٹ کون ہے اور کس کے لیے کام کرتا ہے۔ پھر کال اسی ترتیب سے آگے بڑھتی ہے جس میں وہ ہوتی ہے: اس کا آغاز کیسے ہوتا ہے، کیا معلوم کرنا ہے، کس چیز کی تصدیق کرنی ہے، اور اس کا اختتام کیسے ہوتا ہے۔ ہر اصول کال کے اسی حصے میں ہوتا ہے جہاں اس کا اطلاق ہوتا ہے۔ قاری کو ہر پیراگراف کے بارے میں یہ سوال کرنے کے قابل ہونا چاہیے: "کیا اس کاروبار کو چلانے والا شخص یہ ٹائپ کر سکتا تھا؟" کیا معلوم کرنا ہے، اس میں وہ معلومات شامل ہوتی ہیں جن کی کاروبار کو درخواست پر عمل کرنے کے لیے ضرورت ہے، صرف یہ نہیں کہ کال کون کر رہا ہے اور اس سے کیسے رابطہ کیا جائے۔

**P2. سادہ سرخیاں، نیچے نثر۔** "آپ کون ہیں"، "کال"، "حقائق" اور "حوالہ دینا" جیسی سرخیاں
مددگار ہیں۔ مشینی طرز کی ساخت مددگار نہیں: نمبر والی اصولی کتابیں، camelCase یا کوڈ جیسی سرخیاں، اصولوں کی طویل ڈیش بُلٹ
فہرستیں، شروع میں ٹول ریفرنس، اور "نیچے سیکشن 4 دیکھیں" جیسے باہمی حوالہ جات۔ ان معلومات کے لیے فہرستیں مناسب ہیں جنہیں ایجنٹ
دیکھ کر بتاتا ہے (اوقات، قیمتیں، پتہ)۔

**P3. بولنے کا انداز، ایک بار اور مختصراً۔** ایجنٹ پوری کال میں کیسے بات کرتا ہے (مختصر، پہلے شخص میں جملے، خوشگوار، سادہ الفاظ؛ S2 دیکھیں) اسے اوپر کے قریب ایک مختصر پیراگراف میں بیان کیا جاتا ہے۔ کسی ایک مرحلے سے متعلق ہر چیز اسی مرحلے میں رکھی جاتی ہے۔

**P4. حقائق کو رویے سے الگ رکھیں۔** اوقات، قیمتیں، مقامات، پالیسیاں اور دیگر حقائق prompt کے حقائق والے حصے میں
یا نالج بیس میں رکھیں، کال کے بہاؤ میں بکھرے ہوئے نہیں۔ طویل کیٹلاگ اور FAQs نالج بیس میں ہونے چاہییں۔
ایجنٹ صرف وہی حقائق کہہ سکتا ہے جو اسے دیے گئے ہوں۔

## مواد

**C1. اصول اور حقائق، اسکرپٹس نہیں۔** بیان کریں کہ ایجنٹ کیا حاصل کرنے کی کوشش کر رہا ہے اور اسے کیا
جاننے کی ضرورت ہے۔ "اگر کال کرنے والا X کہے تو Y کہیں" والی شاخیں، متوقع سوالات کے اسکرپٹ شدہ جوابات اور تیار
جملے شامل نہ کریں۔ ترتیب دیا گیا ابتدائی استقبالیہ واحد اسکرپٹ شدہ عنصر ہے۔

**C2. اصلاح عمومی اصول بیان کرتی ہے۔** جب Prompt میں تبدیلی کسی مشاہدہ شدہ ناکامی کے جواب میں کی جائے تو اس تبدیلی میں
عمومی اصول یا کوئی غائب حقیقت شامل کی جاتی ہے، نہ کہ صرف اس ایک معاملے کے لیے پیچ۔ ناکام کال کی مخصوص تفصیلات (اس کے نام،
اس کے نمبر، اس کے عین الفاظ) Prompt سے باہر رہتی ہیں۔

**C3. شامل کرنے کے بجائے ہٹانے کو ترجیح دیں۔** جب کسی ناکامی کی وجہ کسی موجودہ اصول تک پہنچتی ہو جو بہت مخصوص، بہت وسیع
یا غلط جگہ پر ہو، تو اس کے ساتھ جوابی اصول شامل کرنے کے بجائے اس اصول کو تبدیل یا ہٹا دیں۔

**C4. کچھ چیزوں کا فیصلہ سیٹنگز کرتی ہیں، Prompt نہیں۔** یہ ایجنٹ سیٹنگز ہیں، اور ان کے بارے میں Prompt کا متن
نظر انداز ہو جاتا ہے یا ان سے متصادم ہوتا ہے: ٹول چلنے کے دوران کیا کہا جاتا ہے (ٹول شروع ہونے کی سطر، وقفہ بھرنے والے جملے)، خاموشی
کی جانچ اور خاموشی کے بعد آخری کارروائی، دوبارہ پڑھنے کی رفتار، زبان تبدیل کرنے کا انداز، ریکارڈنگ کا نوٹس، اور آیا
ایجنٹ یا کال کرنے والا پہلے بولتا ہے۔ Prompt کو نتیجے کی طرف متوجہ کریں
("ای میل پتہ محفوظ کرنے سے پہلے اس کی تصدیق کریں")، اور سیٹنگ مقرر کریں۔ ابتدائی استقبالیہ خود
Prompt میں لکھا جاتا ہے۔

**C5. مثالیں وہ جملے ہیں جو ایجنٹ کہے گا۔** ایجنٹ مثال کے الفاظ کو تقریباً لفظ بہ لفظ نقل کرتا ہے، اس لیے ہر
مثال مکمل، قدرتی بول چال کا جملہ ہو، اور ایک کے مقابلے میں چند متنوع مثالیں بہتر ہیں۔ انہیں مثالوں کے طور پر متعارف کریں ("مثال کے
طور پر، آپ کہہ سکتے ہیں ...")، لازمی جملے کے طور پر نہیں۔ "کیا اب بھی درست ہے؟" جیسے مختصر ٹیگ بولے جانے پر خشک محسوس ہوتے ہیں۔

**C6. اپنے صارفین کی کالز سے مثالیں نہ لیں۔** مثالیں عمومی الفاظ میں صورتحال کی قسم بیان کرتی ہیں یا کسی فرضی کاروبار
کو استعمال کرتی ہیں۔

**C7. پرامپٹ کال کرنے والوں کے لیے ہے، تعمیر کے بارے میں نہیں۔** کال کرنے والے، پرامپٹ لائیو ہونے کے بعد، اس میں لکھی ہر بات سنتے ہیں، اس لیے اس میں تعمیر، ٹیسٹنگ یا تعمیلی حیثیت سے متعلق نوٹس شامل نہیں ہوتے ("یہ ورژن ٹیسٹنگ کے لیے ہے"، بکنگ کے نام میں "TEST"، "جب تک معاہدوں پر دستخط نہ ہو جائیں")۔ اس میں وہ دستبرداری، ذمہ داری کی حدود اور اختتامی خلاصے بھی شامل نہیں ہوتے جو کاروبار نے نہ مانگے ہوں، مثلاً کسی پلان کو قبول کرنے سے کیا ثابت نہیں ہوتا یا کس چیز کی ابھی تک تصدیق نہیں ہوئی کا خلاصہ۔ ایجنٹ کال کرنے والے کے سوال کا جواب دیتا ہے اور رک جاتا ہے؛ کاروبار جب چاہے، خود وضاحت شامل کرتا ہے۔ کوئی گم شدہ حقیقت یا سسٹم کی حد اس صورت میں لکھی جاتی ہے کہ ایجنٹ کیا کرتا ہے ("قیمتوں کے لیے، دفتر سے واپس کال کی پیش کش کریں")، نہ کہ اس نوٹ کے طور پر کہ وہ فراہم نہیں کی گئی یا درخواستیں کیسے ریکارڈ ہوتی ہیں، اور مسودہ سازی سے کچھ بھی باقی نہیں رہتا، جیسے کوئی غیر متعلقہ نام یا سرخی۔

## الفاظ کا انتخاب

**W1. کیا کرنا ہے، اسے سادہ الفاظ میں، ایک بار کہیں۔** مطلوبہ رویے کو عام الفاظ میں ایک ہدایت کے طور پر بیان کریں: "آرڈر نمبر ہر ہندسے کے بعد دہرا دیں تاکہ کال کرنے والا اسے درست کر سکے۔" اسے ایک بار، جہاں لاگو ہو، کہیں۔

**W2. کوئی تاکید نہیں۔** کوئی "اہم"، "نوٹ" یا "انتہائی اہم" لیبل، زور دینے کے لیے بڑے حروف میں الفاظ، فجائیہ نشان،
"غلط:" اور "درست:" کے جوڑے، یا یہ نہ کرنے کی ہدایات کے بلاکس نہ ہوں۔ زور کے لیے استعمال ہونے والے "کبھی نہیں"، "ہمیشہ" اور
"لازم ہے" جیسے الفاظ بھی اسی میں شامل ہیں۔ تاکید ماڈل کی توجہ ایک اصول کی طرف کھینچتی ہے اور باقی
کال میں اسے کم مؤثر بناتی ہے۔ جب ایجنٹ کسی ہدایت کو نظر انداز کرے تو ہدایت کو زیادہ واضح، زیادہ مخصوص یا بہتر جگہ پر رکھیں،
اسے زیادہ زور دار نہ بنائیں۔

**W3. اس ساخت کو درست کریں جو کسی رویے کا سبب بنتی ہے۔** ایجنٹ کے کسی عمل کے خلاف اصول شامل کرنے سے پہلے
وہ الفاظ یا ساخت تلاش کریں جو اسے وہاں لے جاتی ہے: ایسا سانچہ جسے ماڈل لفظی طور پر بھر دیتا ہے، ایسی اصطلاح جس کے دو معنی ہوں،
یا ایسی اگر-ورنہ شاخ جسے تیز رفتار ماڈل ڈھیلے انداز میں پڑھتا ہے۔ اسے تبدیل کریں۔

**W4. مخصوص ہدایت عمومی ہدایت سے بہتر ہے۔** "دستیاب دو ابتدائی ترین اوقات پیش کریں، پھر پوچھیں کہ کون سا مناسب ہے"
"شیڈولنگ میں مدد کریں" سے بہتر ہے۔ مبہم ہدایات مبہم رویہ دیتی ہیں۔

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

## گفتگو

**S1. ہر باری میں ایک سوال، اور سوال باری ختم کرے۔** سوال کے بعد کہی گئی کوئی بھی بات کال کرنے والے کے
جواب پر بولتی ہے۔ کوئی بھی وضاحت سوال سے پہلے رکھیں۔

**S2. مختصر باریوں میں، مکمل بولے جانے والے جملے۔** جب تک کالر تفصیل نہ مانگے، ایک یا دو مختصر جملے بولیں۔
بولے جانے والے اختیارات چند تک محدود رکھیں۔ مختصر سے مراد کم الفاظ ہیں، نامکمل جملے نہیں: ایجنٹ فون پر ایک اچھے ریسپشنسٹ کی طرح پہلے شخص میں مکمل جملوں میں بات کرتا ہے، مثلاً "میں ابھی آپ کے لیے یہ بک کر دیتا ہوں" یا
"میں نے آپ کے لیے پیر کو دس بجے درج کر دیا ہے۔" نوٹ جیسے ٹکڑے ("میں آپ کے لیے بکنگ کر رہا ہوں۔"، "ہو گیا۔"، "نوٹ کر لیا۔") بولنے پر خشک محسوس ہوتے ہیں،
اور ای میل کی عبارت ("براہ کرم نوٹ کریں کہ ..."، "مہربانی فرما کر ..."، "امید ہے یہ مددگار ہوگا") کہی ہوئی کے بجائے پڑھی ہوئی لگتی ہے۔ prompt کا اندازِ گفتگو والا پیراگراف یہ بات واضح طور پر کہتا ہے، مثلاً: "ہر باری کو ایک یا دو جملوں تک رکھیں، اور فون پر ریسپشنسٹ کی طرح پہلے شخص میں بات کریں۔"

**S3. کان کے لیے لکھیں۔** ایجنٹ جو کہتا ہے اس میں مارک ڈاؤن، علامتوں اور ایسی نوٹیشن سے گریز کریں جسے آواز عجیب انداز میں پڑھے
(سلیش، ایمپرسینڈ، "@"، ".com"، ہزاروں کے جدا کنندگان، بغیر وقفے کے فون نمبر)۔ وہ حقائق اور قدریں جو ایجنٹ
کسی ٹول کو دیتا ہے، جیسے ای میل پتہ یا اکاؤنٹ نمبر، اپنی عین تحریری شکل میں رہتے ہیں؛ جب کسی کو بلند آواز سے بھی کہنا ہو تو
اسے دوبارہ لکھنے کے بجائے اس کے ساتھ یہ شامل کریں کہ اسے کیسے کہا جاتا ہے۔ غیر معمولی نام یا مخففات کیسے کہے جاتے ہیں یہ لکھیں،
اور نئی اصطلاحات کو برقرار رکھنے سے پہلے ایجنٹ کی آواز میں سنیں۔

**S4. جس چیز میں غلطی مہنگی پڑ سکتی ہو، اس کی تصدیق کریں۔** نمبرز، ای میلز، پتے اور کوڈز کو اسی صورت میں ایک بار دوبارہ پڑھ کر سنایا جاتا ہے
جس صورت میں وہ دیے گئے ہوں، کالر کے بتانے کے فوراً بعد والے جواب میں اور اگلے سوال سے پہلے، ہر تصدیقی دہرائی میں صرف ایک قدر۔ عموماً نام کو ویسا ہی مان لیا جاتا ہے جیسا بتایا جائے، اسے دوبارہ نہیں دہرایا جاتا، اور ایجنٹ صرف غیر معمولی یا غیر واضح ہونے پر اس کے ہجّے پوچھتا ہے، اور ایک ہی بار پوچھتا ہے۔ جب کاروبار کو نام بالکل درست درکار ہو، مثلاً اپنے ریکارڈ سے ملانے کے لیے یا اسی نام سے بکنگ کے لیے، تو prompt میں یہ واضح کیا جاتا ہے اور ایجنٹ نام کے ہجّے دہرا کر سناتا ہے۔ تصدیقی دہرائی کالر کو کسی قدر کی درستی کا موقع دیتی ہے، یہ رکاوٹ نہیں: جو کالر اگلی تفصیل بتا دے یا درستی کیے بغیر بات جاری رکھے، وہ اسے قبول کر چکا ہوتا ہے، اور قبول شدہ قدر کے بارے میں دوبارہ نہیں پوچھا جاتا۔ جس فون نمبر پر کاروبار واپس کال کرے گا یا ٹیکسٹ پیغام بھیجے گا، وہ استثنا ہے: اسے دوبارہ پڑھ کر سنانے کے بعد باری ختم ہو جاتی ہے اور کالر کے جواب کا انتظار کیا جاتا ہے۔ جو prompt ہندسہ بہ ہندسہ پڑھنے کو کہتا ہے، وہ صرف انہی قدروں کا نام لیتا ہے جنہیں اس طرح پڑھا جاتا ہے (فون نمبر، کوڈ)؛ گھر کا نمبر، قیمت، وقت یا تاریخ ویسے ہی کہی جاتی ہے جیسے لوگ کہتے ہیں۔ prompt بتاتا ہے کہ کن چیزوں کی تصدیق کرنی ہے؛ پلیٹ فارم تصدیقی دہرائی کی رفتار مقرر کرتا ہے۔

## تکرار

**I1. تبدیلی برقرار رکھنے سے پہلے جانچیں۔** ترمیم شدہ مسودے پر ایجنٹ کا ڈیولپمنٹ سیٹ دوبارہ چلائیں اور اسے
موجودہ ورژن سے موازنہ کریں: تبدیلی نے کن مثالوں کو درست کیا اور کن کو خراب کیا۔ جوابات کو اس طرح پڑھیں جیسے کال کرنے والا انہیں سنے گا۔
جو چیز کال کرنے والے کو محسوس ہو، وہ مسئلہ ہے، تفصیل نہیں۔

**I2. ہولڈ آؤٹ سیٹ ایک بار چیک کیا جاتا ہے۔** صرف ڈیولپمنٹ سیٹ پر ٹیون کریں۔ جب تبدیلی تیار ہو تو ٹیسٹ سیٹ چلائیں، اور
اس کا نتیجہ جوں کا توں رپورٹ کریں۔ ٹیسٹ کے نتائج دیکھنے کے بعد کی گئی تبدیلی کے لیے تازہ ٹیسٹ مثالیں درکار ہیں۔

**I3. جب پیچ جمع ہو جائیں تو ری فیکٹر کریں۔** ایسا prompt جس میں بہت سی چھوٹی اصلاحات جمع ہو گئی ہوں، P1 سے ہٹ جاتا ہے: قواعد
دہرائے جاتے ہیں، متصادم ہوتے ہیں، یا اس مرحلے سے بہت دور ہوتے ہیں جسے وہ کنٹرول کرتے ہیں۔ پھر اسے ہر مطلوبہ رویہ برقرار رکھتے ہوئے
اس ساخت میں دوبارہ لکھیں۔ ہر رویے کو برقرار رکھا گیا، ضم کیا گیا، دوبارہ لفظ بند کیا گیا، یا حذف کیا گیا کے طور پر درج کریں، اور کچھ بھی خاموشی سے حذف نہ کریں۔ ڈیولپمنٹ
سیٹ کو پہلے اور بعد میں دوبارہ چلائیں؛ ری فیکٹرنگ سے الفاظ تبدیل ہونے چاہییں، رویہ نہیں۔

**I4. prompt سے پہلے کنفیگریشن چیک کریں۔** کچھ ناکامیاں prompt کی نہیں ہوتیں: ہجے کیے گئے حروف کو غلط سننا ہیرنگ کی ایک حد ہے (Plus ہیرنگ آزمائیں)، سست جواب انٹیلیجنس یا ہیرنگ ٹئیر، یا endpointing سیٹنگ کی وجہ سے ہو سکتا ہے۔ متن دوبارہ لکھنے سے پہلے کنفیگریشن کو خارج از امکان قرار دیں۔
