---
title: "Prompt স্টাইল গাইড"
description: "কীভাবে একটি ThunderPhone ভয়েস এজেন্টের prompt লিখবেন ও সম্পাদনা করবেন: নির্দেশিকাগুলো, prompt পর্যালোচনা যা পরীক্ষা করে, এবং এর ফলাফল যে আইডিগুলো উল্লেখ করে।"
---

{/*
  জেনারেট করা ফাইল: হাতে সম্পাদনা করবেন না।
  উৎস: api/agents/prompt_style_guide.md
  পুনরায় জেনারেট করুন: python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI এই পৃষ্ঠাটি পুনরায় জেনারেট করে এবং পরিবর্তন থাকলে ব্যর্থ হয়
  (scripts/docs-freshness/generators.d/50-prompt-style-guide.sh)।
*/}

<Note>
  এটি সেই নির্দেশিকা যার বিপরীতে [prompt পর্যালোচনা](/api-reference/agents#review-a-prompt) একটি prompt যাচাই করে, এবং
  এর ফলাফলে নিচের IDs উল্লেখ করা হয়। [MCP server](/bn/guides/thunderphone-mcp-server)-এর সঙ্গে সংযুক্ত কোডিং
  এজেন্ট একই লেখা `thunderphone://guides/prompt-style` রিসোর্স হিসেবে পড়ে। টেমপ্লেট ও উদাহরণের জন্য
  [prompting নির্দেশিকা](/bn/guides/prompting) দেখুন।
</Note>

এই নির্দেশিকাটি ভয়েস এজেন্টের prompt লেখেন বা সম্পাদনা করেন এমন সবার জন্য: বিল্ডারের একজন ব্যক্তি, Copilot, অথবা API-এর মাধ্যমে কাজ করা একটি কোডিং
এজেন্ট। prompt পর্যালোচনা টুল এটিকে তার মূল্যায়নমান হিসেবে ব্যবহার করে এবং এর নির্দেশিকার IDs (P1, W2,
ইত্যাদি) উল্লেখ করে।

একজন কলার এজেন্টকে একবারই শোনেন, কথার গতিতে, এবং আগের অংশে ফিরে স্ক্রল করতে পারেন না। এজেন্ট প্রতিটি
টার্নে prompt পড়ে এবং এর ভাষা ঘনিষ্ঠভাবে অনুসরণ করে। এই দুটি বিষয়ই নিচের সবকিছুকে প্রভাবিত করে।

## কাঠামো

**P1. একজন ব্যক্তি যেভাবে নতুন রিসেপশনিস্টকে নির্দেশনা দিতেন, সেভাবে লিখুন।** সংক্ষিপ্ত শুরুর অংশে এজেন্ট কে এবং কার জন্য কাজ করে তা বলা থাকে। এরপর কলটি যে ক্রমে ঘটে সেই ক্রমেই এগোয়: কীভাবে শুরু হয়, কী জানতে হবে, কী নিশ্চিত করতে হবে, কীভাবে শেষ হয়। প্রতিটি নিয়ম কলের যে অংশে প্রযোজ্য, সেই অংশেই থাকে। পাঠক যেন প্রতিটি অনুচ্ছেদ সম্পর্কে জিজ্ঞাসা করতে পারেন, "এই ব্যবসা পরিচালনাকারী একজন ব্যক্তি কি এটি লিখতে পারতেন?" কী জানতে হবে বলতে শুধু কে কল করছেন এবং কীভাবে তাঁর সঙ্গে যোগাযোগ করা যাবে তা নয়, অনুরোধের ভিত্তিতে কাজ করতে ব্যবসার যা জানা প্রয়োজন, সেটিও বোঝায়।

**P2. সরল শিরোনাম, নিচে গদ্য।** "আপনি কে", "কল", "তথ্য" এবং "হস্তান্তর" এর মতো শিরোনাম
সহায়ক। যান্ত্রিক-ধাঁচের কাঠামো সহায়ক নয়: নম্বরযুক্ত নিয়মের ম্যানুয়াল, camelCase বা কোডের মতো শিরোনাম, নিয়মের দীর্ঘ ড্যাশ-বুলেট
তালিকা, শুরুতেই টুলের রেফারেন্স, এবং "নিচের বিভাগ 4 দেখুন"-এর মতো ক্রস-রেফারেন্স। এজেন্ট যে তথ্য দেখে খুঁজে নেয়, তার জন্য তালিকা উপযোগী
(সময়সূচি, মূল্য, ঠিকানা)।

**P3. কথা বলার ধরন একবার, সংক্ষেপে।** পুরো কলজুড়ে এজেন্ট কীভাবে কথা বলে (সংক্ষিপ্ত প্রথম-পুরুষের উত্তর, উষ্ণ ও সহজ শব্দ; S2 দেখুন) তা শুরুর দিকের একটি ছোট অনুচ্ছেদে রাখুন। একটি ধাপের জন্য নির্দিষ্ট সবকিছু সেই ধাপেই থাকে।

**P4. আচরণ থেকে তথ্য আলাদা রাখুন।** সময়সূচি, মূল্য, অবস্থান, নীতি এবং অন্যান্য তথ্য prompt-এর একটি তথ্য অংশে
অথবা জ্ঞানভান্ডারে রাখুন, কলের প্রবাহে ছড়িয়ে দেবেন না। দীর্ঘ ক্যাটালগ ও FAQ জ্ঞানভান্ডারে রাখুন।
এজেন্টকে শুধু তার দেওয়া তথ্যই বলতে দিন।

## বিষয়বস্তু

**C1. নীতি ও তথ্য, স্ক্রিপ্ট নয়।** এজেন্ট কী অর্জন করার চেষ্টা করছে এবং তার কী জানা প্রয়োজন, তা বর্ণনা করুন। "কলার X বললে, Y বলুন" ধরনের শাখা, সম্ভাব্য প্রশ্নের জন্য স্ক্রিপ্ট করা উত্তর এবং তৈরি করা বাক্য বাদ দিন। কনফিগার করা শুরুর অভিবাদনই একমাত্র স্ক্রিপ্ট করা উপাদান।

**C2. সংশোধনে সাধারণ নীতি উল্লেখ করুন।** কোনো পর্যবেক্ষিত ব্যর্থতার প্রতিক্রিয়ায় prompt পরিবর্তন করলে, পরিবর্তনটি একটি সাধারণ নীতি বা অনুপস্থিত তথ্য যোগ করে, শুধু সেই একটি ঘটনার জন্য সমাধান নয়। ব্যর্থ কলের নির্দিষ্ট বিষয়গুলো—এর নাম, সংখ্যা, সঠিক শব্দ—prompt-এর বাইরে রাখুন।

**C3. যোগ করার চেয়ে বাদ দেওয়াকে অগ্রাধিকার দিন।** কোনো ব্যর্থতা যদি এমন একটি বিদ্যমান নিয়মের কারণে হয় যা অতিরিক্ত নির্দিষ্ট, অতিরিক্ত বিস্তৃত বা ভুল জায়গায় রয়েছে, তাহলে তার পাশে পাল্টা নিয়ম যোগ করার বদলে নিয়মটি পরিবর্তন বা সরিয়ে দিন।

**C4. কিছু বিষয় সেটিংস নির্ধারণ করে, prompt নয়।** এগুলো এজেন্টের সেটিংস, এবং এগুলো নিয়ে prompt-এর লেখা উপেক্ষিত হয় বা সেটিংসের সঙ্গে বিরোধ তৈরি করে: কোনো টুল চলার সময় কী বলা হয় (টুল শুরুর বাক্য, বিরতি পূরণের বাক্য), নীরবতার সময় খোঁজ নেওয়া ও নীরবতার পরের চূড়ান্ত কাজ, পুনরুচ্চারণের গতি, ভাষা পরিবর্তনের ধরন, রেকর্ডিং বিজ্ঞপ্তি এবং এজেন্ট না কলার কে আগে কথা বলবে। এর বদলে prompt-এ ফলাফলটি নির্দেশ করুন ("ইমেল ঠিকানা সংরক্ষণ করার আগে নিশ্চিত করুন"), এবং সেটিংটি নির্ধারণ করুন। শুরুর অভিবাদনটি prompt-এই লেখা হয়।

**C5. উদাহরণ হলো এজেন্ট যে বাক্য বলবে।** এজেন্ট উদাহরণের ভাষা প্রায় শব্দে শব্দে অনুকরণ করে, তাই প্রতিটি উদাহরণ সম্পূর্ণ, স্বাভাবিক কথ্য বাক্য হওয়া উচিত, এবং একটি উদাহরণের চেয়ে কয়েকটি ভিন্ন উদাহরণ ভালো। এগুলোকে উদাহরণ হিসেবে উপস্থাপন করুন ("উদাহরণ হিসেবে, আপনি বলতে পারেন ..."), বাধ্যতামূলক বাক্য হিসেবে নয়। "এখনও সঠিক?"-এর মতো সংক্ষিপ্ত ট্যাগ উচ্চারণ করলে রূঢ় শোনায়।

**C6. আমাদের নিজস্ব গ্রাহকদের কল থেকে উদাহরণ নয়।** উদাহরণে সাধারণভাবে পরিস্থিতির ধরন বর্ণনা করুন বা একটি কাল্পনিক ব্যবসা ব্যবহার করুন।

**C7. prompt কলারদের জন্য, তৈরির বিবরণ নিয়ে নয়।** prompt লাইভ হওয়ার পর কলাররা এতে যা বলা আছে তা শুনতে পান, তাই এতে তৈরি, পরীক্ষা বা কমপ্লায়েন্স স্থিতি সম্পর্কে নোট রাখা হয় না ("এই সংস্করণটি পরীক্ষার জন্য", বুকিংয়ের নামে "TEST", "চুক্তিতে স্বাক্ষর না হওয়া পর্যন্ত")। ব্যবসা যে ডিসক্লেইমার, দায়বদ্ধতা-সংক্রান্ত সতর্কতা এবং সমাপনী সারাংশ চায়নি, সেগুলিও এতে রাখা হয় না; যেমন কোনো প্ল্যান গ্রহণ করলে কী প্রতিষ্ঠিত হয় না, বা কোন বিষয়গুলো এখনও নিশ্চিত নয় তার সারাংশ। এজেন্ট কলার যা জিজ্ঞাসা করেছেন তার উত্তর দেয় এবং থেমে যায়; ব্যবসা চাইলে একটি সতর্কতা যোগ করে। অনুপস্থিত তথ্য বা সিস্টেমের সীমাবদ্ধতা কীভাবে এজেন্ট কাজ করে তা হিসেবে লেখা হয় ("দামের জন্য, অফিস থেকে কলব্যাকের প্রস্তাব দিন"), তথ্যটি দেওয়া হয়নি বা অনুরোধ কীভাবে রেকর্ড করা হয় সে সম্পর্কে নোট হিসেবে নয়, এবং খসড়া থেকে অবশিষ্ট কিছুই রাখা হয় না, যেমন ভুল করে থেকে যাওয়া নাম বা শিরোনাম।

## বাক্যবিন্যাস

**W1. কী করতে হবে, স্পষ্টভাবে, একবার বলুন।** কাঙ্ক্ষিত আচরণটি সাধারণ ভাষায় নির্দেশনা হিসেবে লিখুন: "অর্ডার নম্বরটি অঙ্ক ধরে ধরে আবার পড়ুন, যাতে কলার এটি সংশোধন করতে পারেন।" যেখানে প্রযোজ্য, সেখানে একবারই বলুন।

**W2. কোনো জোরারোপ নয়।** কোনো "গুরুত্বপূর্ণ", "নোট" বা "জরুরি" লেবেল নয়, জোর দেওয়ার জন্য বড় হাতের অক্ষরে লেখা শব্দ নয়, বিস্ময়বোধক চিহ্ন নয়, "খারাপ:" ও "ভালো:" জোড়া নয়, কী করা যাবে না তার কোনো ব্লক নয়। জোর দেওয়ার জন্য ব্যবহৃত "কখনো নয়", "সবসময়" এবং "অবশ্যই"-এর মতো শব্দও এর অন্তর্ভুক্ত। জোরারোপ মডেলের মনোযোগ একটি নিয়মে টেনে নেয় এবং কলের বাকি অংশে তার দক্ষতা কমায়। এজেন্ট কোনো নির্দেশনা উপেক্ষা করলে, নির্দেশনাকে আরও স্পষ্ট, নির্দিষ্ট বা ভালোভাবে স্থাপন করুন, আরও জোরালো নয়।

**W3. যে কাঠামো আচরণের কারণ হয়, তা সংশোধন করুন।** এজেন্ট যা করে তার বিরুদ্ধে নিয়ম যোগ করার আগে, কোন ভাষা বা কাঠামো তাকে সেখানে নিয়ে যায় তা খুঁজে বের করুন: এমন টেমপ্লেট যা মডেল আক্ষরিকভাবে পূরণ করে, এমন একটি শব্দ যার দুটি অর্থ আছে, অথবা এমন if-else শাখা যা দ্রুত মডেল ঢিলেঢালাভাবে পড়ে। সেটি পরিবর্তন করুন।

**W4. সাধারণের চেয়ে নির্দিষ্ট ভালো।** "সবচেয়ে আগে পাওয়া যায় এমন দুটি সময় প্রস্তাব করুন, তারপর জিজ্ঞাসা করুন কোনটি সুবিধাজনক" বাক্যটি "সময়সূচি নিয়ে সহায়তা করুন"-এর চেয়ে ভালো। অস্পষ্ট নির্দেশনা অস্পষ্ট আচরণ তৈরি করে।

**W5. কিছু সম্পর্কে জিজ্ঞাসা করার আগে সেটি খুঁজে দেখুন।** কলার এমন কিছুর নাম বললে যা একটি শুধু-পঠনযোগ্য অনুসন্ধান টুল দিয়ে যাচাই করা যায় (যেমন একটি পণ্য, একটি অর্ডার বা বিদ্যমান বুকিং), এজেন্ট কলারের দেওয়া শব্দ ব্যবহার করে যাচাই করে, তারপর ফলাফলের প্রয়োজন হলে তবেই পরবর্তী প্রশ্ন করে। "কলার যে পণ্যের নাম বলেন, তার স্টক যাচাই করুন এবং যা পান তা জানান" নির্দেশনাটি "ব্র্যান্ড, আকার ও ভ্যারিয়েন্ট স্পষ্ট করুন, তারপর স্টক যাচাই করুন" নির্দেশনার চেয়ে ভালো: এজেন্টকে আগে স্পষ্ট করতে বলা হলে এজেন্ট প্রশ্ন করতেই থাকে এবং যাচাইটি আর হয় না। এটি শুধু অনুসন্ধানের ক্ষেত্রে প্রযোজ্য। এমন কোনো টুলের আগে যা কিছু বুক করে, পরিবর্তন করে, বাতিল করে বা সংরক্ষণ করে, এজেন্ট তবুও কলারের সঙ্গে বিস্তারিত নিশ্চিত করে।

## কথন

**S1. প্রতি পালায় একটি প্রশ্ন, এবং প্রশ্নেই পালা শেষ হবে।** প্রশ্নের পরে বলা যেকোনো কথা কলারের উত্তরের ওপর দিয়ে চলে যায়। প্রশ্নের আগে যেকোনো ব্যাখ্যা দিন।

**S2. সংক্ষিপ্ত পালা, সম্পূর্ণ কথ্য বাক্যে।** কলার বিস্তারিত জানতে না চাইলে এক বা দুটি ছোট বাক্য বলুন।
কথ্য বিকল্প কয়েকটির মধ্যেই সীমিত রাখুন। সংক্ষিপ্ত বলতে কম শব্দ বোঝায়, খণ্ডিত বাক্য নয়: এজেন্ট ফোনে একজন ভালো
রিসেপশনিস্টের মতো প্রথম পুরুষে সম্পূর্ণ বাক্যে কথা বলে, যেমন "আমি এখনই আপনার জন্য এটি বুক করছি" বা
"সোমবার দশটার জন্য আপনাকে তালিকাভুক্ত করেছি।" নোট-ধাঁচের খণ্ডাংশ ("আপনার জন্য বুকিং।", "হয়ে গেছে।", "নথিভুক্ত।") 
বললে রুক্ষ শোনায়, আর ইমেইলের ভাষা ("অনুগ্রহ করে মনে রাখবেন যে ...", "দয়া করে ...", "আশা করি এটি সহায়ক হবে") 
বলা কথার চেয়ে পড়ে শোনানোর মতো লাগে। prompt-এর কথা বলার ধরন-সংক্রান্ত অনুচ্ছেদে এটি সরাসরি উল্লেখ করুন, যেমন: "প্রতিটি পালা এক বা দুটি বাক্যে রাখুন এবং ফোনে একজন রিসেপশনিস্ট যেভাবে কথা বলবেন, সেভাবে প্রথম পুরুষে কথা বলুন।"

**S3. কানের জন্য লিখুন।** এজেন্ট যা বলে, সেখানে Markdown, প্রতীক এবং এমন নোটেশন এড়িয়ে চলুন যা ভয়েস অস্বাভাবিকভাবে পড়বে (স্ল্যাশ, অ্যাম্পারস্যান্ড, "@", ".com", হাজারের বিভাজক, ফাঁক ছাড়া ফোন নম্বর)। এজেন্ট যে তথ্য ও মান কোনো টুলে পাঠায়, যেমন ইমেল ঠিকানা বা অ্যাকাউন্ট নম্বর, সেগুলো তাদের সঠিক লিখিত রূপেই থাকবে; কোনোটি মুখে বলারও প্রয়োজন হলে, তা আবার লিখে দেওয়ার বদলে তার পাশে কীভাবে বলা হয় তা যোগ করুন। অস্বাভাবিক নাম বা সংক্ষিপ্ত রূপ কীভাবে বলা হয় তা লিখুন, এবং নতুন শব্দগুলো রাখার আগে এজেন্টের কণ্ঠে শুনুন।

**S4. ভুল হলে যার খরচ বেশি হতে পারে, তা নিশ্চিত করুন।** নম্বর, ইমেইল, ঠিকানা ও কোড কলার দেওয়ার পরপরই এবং পরের প্রশ্নের আগে উত্তরে, যে রূপে দেওয়া হয়েছে সেই রূপেই একবার পুনরায় পড়ে শোনানো হয়; প্রতিটি পুনরায় পড়ে শোনানোয় একটি মান থাকে। ডিফল্টভাবে নাম যেভাবে বলা হয় সেভাবেই ধরা হয়, পুনরায় পড়ে শোনানো হয় না, এবং এজেন্ট কেবল নামটি অস্বাভাবিক বা অস্পষ্ট হলে একবার তার বানান জানতে চায়। ব্যবসার জন্য নামটি হুবহু জানা প্রয়োজন হলে, যেমন রেকর্ডের সঙ্গে মেলাতে বা সেই নামে বুকিং করতে, prompt-এ তা উল্লেখ করুন এবং এজেন্ট নামটি অক্ষর ধরে পুনরায় বলে। পুনরায় পড়ে শোনানো কলারের জন্য কোনো মান সংশোধনের সুযোগ, কোনো বাধা নয়: কলার পরের তথ্য দিয়ে উত্তর দিলে বা সংশোধন না করে কথা চালিয়ে গেলে, সেটি গ্রহণ করেছে বলে ধরা হয় এবং গ্রহণ করা মানটি আর জিজ্ঞাসা করা হয় না। ব্যবসা যে ফোন নম্বরে কল করবে বা টেক্সট পাঠাবে সেটি ব্যতিক্রম: সেটি পুনরায় পড়ে শোনানোর পর পালা শেষ হয় এবং কলারের উত্তরের জন্য অপেক্ষা করে। যে prompt অঙ্ক ধরে পড়তে বলে, সেখানে শুধু সেভাবে পড়া মানগুলোর নাম উল্লেখ করুন (একটি ফোন নম্বর, একটি কোড); বাড়ির নম্বর, দাম, সময় বা তারিখ মানুষ যেভাবে বলে সেভাবেই বলা হয়। কী নিশ্চিত করতে হবে তা prompt-এ বলা থাকে; প্ল্যাটফর্ম পুনরায় পড়ে শোনানোর গতি নিয়ন্ত্রণ করে।

## পুনরাবৃত্তি

**I1. কোনো পরিবর্তন রাখার আগে পরীক্ষা করুন।** সম্পাদিত খসড়ায় এজেন্টের ডেভ সেট পুনরায় চালান এবং বর্তমান সংস্করণের সঙ্গে তুলনা করুন:
কোন উদাহরণগুলো পরিবর্তনে ঠিক হয়েছে, কোনগুলো নষ্ট হয়েছে। কলার যেভাবে উত্তরগুলো শুনবে, সেভাবে সেগুলো পড়ুন।
কলার যা লক্ষ্য করবে, তা একটি সমস্যা—খুঁটিনাটি নয়।

**I2. হোল্ড-আউট সেট একবার পরীক্ষা করা হয়।** শুধু ডেভ সেটে টিউন করুন। কোনো পরিবর্তন প্রস্তুত হলে টেস্ট সেট চালান এবং
ফলাফল যেমন আসে তেমনই রিপোর্ট করুন। টেস্টের ফল দেখার পর করা পরিবর্তনের জন্য নতুন টেস্ট উদাহরণ প্রয়োজন।

**I3. প্যাচ জমে গেলে রিফ্যাক্টর করুন।** অনেক ছোট সংশোধন জমা হওয়া একটি prompt P1 থেকে সরে যায়: নিয়মগুলো
পুনরাবৃত্ত হয়, পরস্পর বিরোধী হয়, বা যে ধাপকে নিয়ন্ত্রণ করে তার থেকে অনেক দূরে থাকে। তখন প্রতিটি চাওয়া আচরণ
রেখে এটিকে এই কাঠামোতে পুনর্লিখুন। প্রতিটি আচরণকে রাখা হয়েছে, একত্র করা হয়েছে, পুনর্লিখিত হয়েছে বা বাদ দেওয়া হয়েছে হিসেবে তালিকাভুক্ত করুন, এবং নীরবে কিছু বাদ দেবেন না। আগে ও পরে ডেভ সেট পুনরায় চালান; রিফ্যাক্টরে ভাষা বদলাবে, আচরণ নয়।

**I4. prompt-এর আগে কনফিগারেশন পরীক্ষা করুন।** কিছু ব্যর্থতা prompt-এর কারণে নয়: বানান করে বলা অক্ষর ভুল শোনা একটি শ্রবণ-সীমাবদ্ধতা (Plus hearing চেষ্টা করুন), ধীর উত্তর intelligence বা hearing tier কিংবা endpointing সেটিংয়ের কারণে হতে পারে। টেক্সট পুনর্লেখার আগে কনফিগারেশনজনিত কারণ বাদ দিন।
