---
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 तपासते आणि
  त्याचे निष्कर्ष खालील id चा संदर्भ देतात. [MCP सर्व्हर](/mr/guides/thunderphone-mcp-server) शी जोडलेले कोडिंग
  एजंट हाच मजकूर `thunderphone://guides/prompt-style` या संसाधनात वाचतात. टेम्पलेट्स आणि उदाहरणांसाठी,
  [prompting मार्गदर्शक](/mr/guides/prompting) पहा.
</Note>

हा मार्गदर्शक व्हॉइस एजंटचा prompt लिहिणाऱ्या किंवा संपादित करणाऱ्या प्रत्येकासाठी आहे: बिल्डरमधील व्यक्ती, Copilot किंवा API द्वारे काम करणारा कोडिंग
एजंट. prompt पुनरावलोकन साधन हा मार्गदर्शक त्याचा निकष म्हणून वापरते आणि त्याच्या मार्गदर्शक id चा संदर्भ देते (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. कानासाठी लिहा.** एजंट जे बोलतो त्यात मार्कडाउन, चिन्हे आणि आवाज विचित्रपणे वाचेल अशी चिन्हांकन पद्धती
टाळा (स्लॅश, अँपरसँड, "@", ".com", हजारांच्या विभाजक खुणा, मध्ये जागा नसलेले फोन क्रमांक). एजंट टूलकडे पाठवत असलेली
तथ्ये आणि मूल्ये, जसे ईमेल पत्ता किंवा खाते क्रमांक, त्यांच्या नेमक्या लिखित स्वरूपातच ठेवा; त्यांपैकी एखादी गोष्ट
मोठ्यानेही सांगायची असल्यास, ती पुन्हा लिहिण्याऐवजी तिच्या शेजारी ती कशी उच्चारायची ते जोडा. असामान्य नावे किंवा
संक्षिप्त रूपे कशी उच्चारायची ते लिहा आणि नवीन संज्ञा ठेवण्यापूर्वी एजंटच्या आवाजात ऐका.

**S4. चुकीचे झाल्यास महाग पडेल अशा गोष्टींची पुष्टी करा.** क्रमांक, ईमेल पत्ते, पत्ते आणि कोड
ज्या स्वरूपात दिले जातात त्याच स्वरूपात, कॉल करणाऱ्याने ते दिल्यानंतर लगेचच्या उत्तरात आणि पुढील प्रश्नापूर्वी, एकदाच
पुन्हा वाचून सांगितले जातात; प्रत्येक वेळी एकच मूल्य पुन्हा सांगावे. डीफॉल्टनुसार नाव जसे सांगितले जाते तसेच घेतले जाते,
पुन्हा वाचून न सांगता, आणि एजंट फक्त नाव असामान्य किंवा अस्पष्ट असल्यास त्याचे स्पेलिंग विचारतो, तेही एकदाच. व्यवसायाला
नाव अचूक हवे असल्यास, उदाहरणार्थ त्याच्या नोंदींशी जुळवण्यासाठी किंवा त्या नावाने बुकिंग करण्यासाठी, prompt मध्ये ते नमूद केले जाते
आणि एजंट नावातील अक्षरे पुन्हा सांगतो. पुन्हा वाचून सांगणे म्हणजे कॉल करणाऱ्याला मूल्य दुरुस्त करण्याची संधी आहे,
अडथळा नाही: कॉल करणाऱ्याने पुढचा तपशील सांगितला किंवा दुरुस्ती न करता संभाषण पुढे चालू ठेवले, तर त्याने ते स्वीकारले आहे,
आणि स्वीकारलेले मूल्य पुन्हा विचारले जात नाही. व्यवसाय ज्या फोन क्रमांकावर परत कॉल किंवा संदेश पाठवणार आहे तो अपवाद आहे:
तो पुन्हा वाचून सांगितल्यावर टर्न संपतो आणि कॉल करणाऱ्याच्या उत्तराची प्रतीक्षा केली जाते. अंकानुसार वाचण्यास सांगणारा prompt
फक्त अशा प्रकारे वाचल्या जाणाऱ्या मूल्यांची नावे घेतो (फोन क्रमांक, कोड); घर क्रमांक, किंमत, वेळ किंवा तारीख
लोक जशी बोलतात तशीच सांगितली जाते. काय पुष्टी करायची ते prompt सांगतो; पुन्हा वाचून सांगण्याची गती प्लॅटफॉर्म ठरवतो.

## पुनरावृत्ती

**I1. बदल कायम ठेवण्यापूर्वी चाचणी करा.** संपादित मसुद्यावर एजंटचा dev संच पुन्हा चालवा आणि त्याची
सध्याच्या आवृत्तीशी तुलना करा: बदलाने कोणती उदाहरणे दुरुस्त केली आणि कोणती बिघडवली. कॉलरला जसे ऐकू येईल तसे प्रतिसाद वाचा.
कॉलरला जाणवेल अशी कोणतीही गोष्ट तपशील नसून समस्या असते.

**I2. होल्ड-आउट संच एकदाच तपासला जातो.** फक्त dev संचावर ट्यून करा. बदल तयार झाल्यावर test संच चालवा आणि
त्याचा निकाल जसा आहे तसा नोंदवा. चाचणीचे निकाल पाहिल्यानंतर केलेल्या बदलासाठी नवीन चाचणी उदाहरणे आवश्यक असतात.

**I3. पॅच साचल्यावर पुनर्रचना करा.** अनेक लहान दुरुस्त्या जमा झालेला prompt P1 पासून भरकटतो: नियम
पुनरावृत्त होतात, परस्परविरोधी ठरतात किंवा ते नियंत्रित करत असलेल्या पायरीपासून दूर असतात. मग, त्याने अपेक्षित असलेले प्रत्येक वर्तन कायम ठेवून, ते या रचनेत पुन्हा लिहा.
प्रत्येक वर्तन कायम ठेवले, विलीन केले, पुनर्लेखन केले किंवा वगळले असे सूचीबद्ध करा आणि काहीही न सांगता काहीही वगळू नका. dev
संच आधी आणि नंतर पुन्हा चालवा; पुनर्रचनेने शब्दरचना बदलली पाहिजे, वर्तन नाही.

**I4. promptच्या आधी कॉन्फिगरेशन तपासा.** काही अयशस्वी परिणाम promptमुळे नसतात: अक्षरांचे चुकीचे ऐकू येणे ही ऐकण्याची मर्यादा आहे (Plus hearing वापरून पाहा), मंद उत्तराचे कारण intelligence किंवा hearing टियर किंवा endpointing सेटिंग असू शकते. मजकूर पुन्हा लिहिण्यापूर्वी कॉन्फिगरेशनमधील कारणे वगळा.
