Open in
প্রতি-কল ভেরিয়েবল ও প্রসঙ্গ
এজেন্ট পরিবর্তন না করেই প্রতিটি কলে নিজস্ব তথ্য দিন—prompt-এর জন্য নামযুক্ত ভেরিয়েবল হিসেবে বা মুক্ত-রূপের সংক্ষিপ্ত বিবরণ হিসেবে।
প্রতিটি কলে দুই ধরনের কল-ভিত্তিক ইনপুট থাকতে পারে। একটি ব্যবহার করুন, অথবা দুটিই একসঙ্গে ব্যবহার করুন:
variables: নামযুক্ত মান, যা prompt-এ থাকা{{placeholders}}পূরণ করে। কলারের নাম, অ্যাকাউন্ট নম্বর বা অ্যাপয়েন্টমেন্টের সময়সীমার মতো prompt যে ফিল্ডগুলোকে নাম ধরে উল্লেখ করে, সেগুলোর জন্য ব্যবহার করুন।context: prompt-এর পরে যোগ করা মুক্ত-রূপের টেক্সট। এমন সংক্ষিপ্ত বিবরণের জন্য ব্যবহার করুন যা কোনো টেমপ্লেটে মানায় না, যেমন এই কলের কাজের বিবরণ বা আগে সংগ্রহ করা নোট।
নিচে বর্ণিত কল শুরু করার প্রতিটি পদ্ধতিতে, সংরক্ষিত এজেন্ট এবং ইনলাইন কনফিগারেশন—উভয়ের সঙ্গেই এগুলো কাজ করে। কোনোটিই সংরক্ষিত এজেন্ট, এর সংস্করণ ইতিহাস বা অন্যান্য সেটিংস পরিবর্তন করে না।
{
"agent_id": 12,
"variables": {"name": "Ada", "appointment_slot": "Tuesday at 10 AM"},
"context": "Ada rescheduled twice last month. She prefers mornings and asked us not to call her work number."
}ভেরিয়েবল
আপনার সংরক্ষিত এজেন্টের prompt-এ প্লেসহোল্ডার রাখুন, তারপর কল শুরু করার সময় একটি variables
object সরবরাহ করুন। ThunderPhone ভয়েস রানটাইমে কল কনফিগারেশন পাঠানোর আগে টেক্সট রেন্ডার করে।
কোনো মানের প্রয়োজন না হলে variables বাদ দিন, null পাঠাবেন না (400 দিয়ে প্রত্যাখ্যাত হবে)।
প্লেসহোল্ডার এবং ডিফল্ট মান
You are calling {{name|Friend}} about account {{account_id}}.
The available appointment is {{ appointment_slot }}.নামগুলো কেস-সেনসিটিভ এবং [A-Za-z_][A-Za-z0-9_]* অনুসরণ করে। নামের চারপাশে
হোয়াইটস্পেস অনুমোদিত; |-এর পরের হোয়াইটস্পেস ডিফল্টের অংশ এবং সংরক্ষিত
থাকে। name অনুপস্থিত বা null হলে {{name|Friend}} Friend ব্যবহার করে;
একটি খালি স্ট্রিং স্পষ্টভাবে দেওয়া মান হিসেবে বিবেচিত হয়। ডিফল্ট ছাড়া অনুপস্থিত মান
খালি স্ট্রিং হয়ে যায় এবং তাদের নাম unresolved_variables-এ প্রদর্শিত হয়।
ডাবল ব্রেসের মধ্যে থাকা টেক্সট বৈধ প্লেসহোল্ডার না হলে তা সরিয়ে ফেলা হয়। প্রতিটি
সরবরাহ করা মানের ভেতরের ডাবল-ব্রেসযুক্ত টেক্সট আলাদাভাবে সরিয়ে ফেলা হয়; একটি মান
আশপাশের prompt টেক্সট বা অন্য কোনো মান সরাতে পারে না। অমিল ডাবল-ব্রেস ডিলিমিটারও
সরিয়ে ফেলা হয়। prompt-এ JSON উদাহরণে {{ ব্যবহার করা যাবে না।
মানগুলো সাধারণ টেক্সট; এগুলোকে কখনো কোড হিসেবে মূল্যায়ন করা হয় না
বা টেমপ্লেট হিসেবে পুনরাবৃত্তভাবে প্রসারিত করা হয় না।
স্বীকৃতি prompt, আউটবাউন্ড ভয়েসমেইল বার্তা এবং ফোন কলের জন্য সেই ফিল্ড পাঠানো হলে
সম্মতি ঘোষণার টেক্সটেও ভেরিয়েবল থাকতে পারে। এজেন্টের আলাদা কোনো first_message
ফিল্ড নেই: prompt-এ এর প্রাথমিক নির্দেশনা দিন। বিদ্যমান ভয়েসমেইল {agent_name} এবং
{org_name} প্লেসহোল্ডার কাজ করতে থাকবে।
মান এবং সীমা
মান স্ট্রিং, সংখ্যা, বুলিয়ান বা null হতে পারে; বুলিয়ান true
এবং false হিসেবে রেন্ডার হয়। নিউলাইন (\n), ট্যাব (\t),
এবং ক্যারেজ রিটার্ন (\r) ছাড়া ইউনিকোড নিয়ন্ত্রণ (Cc) অক্ষর, শূন্য-প্রস্থ
নন-জয়নার ও জয়নার ছাড়া ফরম্যাট (Cf) অক্ষর (U+200C, U+200D, যা ইন্ডিক ও
আরবি-লিপির ভাষায় শব্দের বানান তৈরি করে), এবং সারোগেট (Cs) কোড পয়েন্ট সরিয়ে
ফেলা হয়; \r\n স্বাভাবিকীকরণ করে \n করা হয়। রেন্ডার করার সময় প্রতিটি মান
2,000 অক্ষরের মধ্যে সীমাবদ্ধ থাকে। সরবরাহ করা স্ট্রিংগুলিও সংরক্ষণের আগে পরিষ্কার
ও সংক্ষিপ্ত করা হয়। মূল অবজেক্টটি অবশ্যই UTF-8 JSON-এর 32 KB-এর মধ্যে
হতে হবে; বড় অবজেক্ট কল/সেশন রিকোয়েস্টে 400 পায়, আর ক্যাম্পেইন ইমপোর্টে
অবৈধ সারিগুলো আলাদাভাবে রিপোর্ট করা হয়। অ্যারে এবং নেস্টেড অবজেক্ট মান হিসেবে
গ্রহণ করা হয় না। অমিল মেটাডেটা কী (উদাহরণস্বরূপ, স্পেসসহ একটি CSV হেডার)
রাখা ও প্রতিধ্বনিত হয়, তবে প্লেসহোল্ডার দ্বারা উল্লেখ করা যায় না।
প্রসঙ্গ
context হলো সর্বোচ্চ 20,000 অক্ষরের একটি স্ট্রিং। ThunderPhone prompt-এর
ভেরিয়েবল পূরণ হওয়ার পর, সীমাবদ্ধ ব্লক হিসেবে এটি prompt-এর পরে যোগ করে:
<your prompt, with its variables filled in>
Details for this call:
<call_context>
Ada rescheduled twice last month. She prefers mornings and asked us not to call her work number.
</call_context>এজেন্ট তার নির্দেশনার সঙ্গে এটি পড়ে, তাই কলের আগে সহকর্মীকে যেভাবে ব্রিফ
করতেন সেভাবে লিখুন। প্রসঙ্গ কোনো টেমপ্লেট নয়:
এর ভেতরের {{name}} যেমন লেখা আছে তেমনই থাকে। লেখাটির কোনো মান প্রয়োজন হলে,
পাঠানোর আগে নিজেই মানটি যুক্ত করুন।
null, একটি খালি স্ট্রিং, বা শুধু ফাঁকা স্থান থাকলে কোনো context নেই।- কোনো মান স্ট্রিং না হলে, অথবা 20,000 অক্ষরের বেশি হলে, কল ও সেশন অনুরোধে
400সহ প্রত্যাখ্যাত হয়; কনফিগারেশন webhook থেকে হলে, অবৈধvariables-এর মতো এক্সচেঞ্জ ব্যর্থ হয় (নিচে দেখুন)। - শুরু ও শেষের ফাঁকা স্থান ছেঁটে ফেলা হয়, এবং ভেরিয়েবল মানের মতো একই নিয়ন্ত্রণ ও ফরম্যাট অক্ষর সরিয়ে ফেলা হয়।
- Context কলের prompt-এর অংশ, তাই এটি কলের prompt আকার-এ গণনা করা হয়।
একটি ধাপ এজেন্টে, প্রসঙ্গটি কলের প্রতিটি এজেন্টের prompt-এর পরে থাকে, প্রতিটি ধাপের নির্দেশনার পরে নয়।
মানগুলো কোথা থেকে আসে
আউটবাউন্ড API
POST /v1/call-এ variables এবং context পাঠান:
{
"from_number": "+15551234567",
"to_number": "+14155552671",
"agent_id": 12,
"variables": {
"name": "Ada",
"account_id": "A-17",
"appointment_slot": "Tuesday at 10 AM"
},
"context": "Ada asked to be called back about the late fee on her March invoice."
}দুটিই ফোন নম্বরের ডিফল্ট আউটবাউন্ড এজেন্টের সঙ্গে অথবা ইনলাইন
config.prompt-এর সঙ্গে কাজ করে। ইনলাইন config ব্যবহার করলে context config-এর ভেতরেও রাখা যায়,
যে একই ফিল্ড একটি configuration webhook ফেরত দেয়; উভয়টি পাঠালে, সেগুলো অবশ্যই একই টেক্সট হতে হবে। ভিন্ন variables বা ভিন্ন context-এর সঙ্গে একটি idempotency key পুনরায় ব্যবহার করা যাবে না।
ক্যাম্পেইন CSV
ফোন-বহির্ভূত CSV কলামগুলো ইতিমধ্যেই কনট্যাক্ট ভেরিয়েবল হিসেবে সংরক্ষিত আছে। প্রতিটি ডায়াল এখন স্বয়ংক্রিয়ভাবে সেগুলো ব্যবহার করে। আপনার প্লেসহোল্ডারের সঙ্গে মিলাতে name, account_id, এবং appointment_slot-এর মতো হেডার ব্যবহার করুন। বিদ্যমান নাম ম্যাপিং প্রথম ও শেষ নামের কলামগুলোকে একত্র করে name ভেরিয়েবলে রাখতে পারে। ক্যাম্পেইন কনট্যাক্টের জন্য কোনো প্রতি-কনট্যাক্ট কনটেক্সট নেই।
ডায়নামিক কনফিগারেশন ওয়েবহুক
ব্লকিং কনফিগারেশন webhook পাথে, আপনার প্রতিষ্ঠানের একটি সংরক্ষিত এজেন্ট এবং কল-প্রতি যেকোনো মান রিটার্ন করুন। ফুল ডুপ্লেক্স এজেন্টের ক্ষেত্রে, কল অন্য সমর্থিত ভাষায় শুরু হলেও কলটি এজেন্টের ভয়েস বজায় রাখে: ভাষা-ভিত্তিক ভয়েস ম্যাপিং এবং নেটিভ ভয়েস স্যুইচিং সেই কলে প্রযোজ্য নয়।
{
"agent_id": 12,
"variables": {"name": "Ada", "account_id": "A-17"},
"context": "[REDACTED_LITERAL]"
}{
"agent_id": 12,
"variables": {"name": "Ada", "account_id": "A-17"},
"context": "Ada called yesterday about a leak in unit 4B; a plumber is booked for Friday."
}প্রতিক্রিয়ার ভেরিয়েবল রিকোয়েস্ট-স্তরের ভেরিয়েবলকে ওভাররাইট করে, তবে অন্যান্য রিকোয়েস্ট
কী অপরিবর্তিত থাকে। null প্রতিক্রিয়া মান প্লেসহোল্ডারের ডিফল্ট নির্বাচন করে।
মার্জ করা অবজেক্টটিকেও 32 KB-এর মধ্যে থাকতে হবে। সংরক্ষিত এজেন্টের প্রতিক্রিয়া কেবল
agent_id, variables, context, language এবং প্রতি-কলে
timezone গ্রহণ করে; আপনাকে
prompt বা অন্যান্য সেটিংস প্রতিস্থাপন করতে হলে একটি ইনলাইন কনফিগারেশন ফেরত দিন। সংরক্ষিত এজেন্টের webhook
প্রতিক্রিয়া ফোন ও উইজেট কল উভয় ক্ষেত্রেই এজেন্টের ডিপ্লয় করা A/B বিভাজন ব্যবহার করে;
ভেরিয়েবল ভ্যারিয়েন্ট নির্বাচনের পরে রেন্ডার হয়। প্রতিক্রিয়া যখন একটি
নন-Full duplex এজেন্টের জন্য language সেট করে, এজেন্টের সেই ভাষার জন্য ভয়েস সেট করা থাকলে
কলটি সেই ভাষার নিজস্ব ভয়েসও ব্যবহার করে। prompt-যুক্ত প্রতিক্রিয়া সবসময় ইনলাইন
কনফিগারেশন ব্যবহার করে: সেই প্রতিক্রিয়ার যেকোনো agent_id উপেক্ষা করা হয়, যার মধ্যে null বা
অপূর্ণসংখ্যা মেটাডেটাও অন্তর্ভুক্ত। ইনলাইন prompt-কে এখনও স্বাভাবিক ভ্যালিডেশন পাস করতে হবে।
ইনলাইন webhook প্রতিক্রিয়ায় variables এবং context-ও অন্তর্ভুক্ত থাকতে পারে। একটি context
স্ট্রিং না হলে বা অতিরিক্ত দীর্ঘ হলে এক্সচেঞ্জ ব্যর্থ হয়: একটি ফোন কল
প্রত্যাখ্যাত হয় এবং একটি উইজেট সেশন রিকোয়েস্ট 400 সহ ব্যর্থ হয়। সংরক্ষিত এজেন্টের webhook
প্রতিক্রিয়া ফোন ও উইজেট কল উভয় ক্ষেত্রেই এজেন্টের ডিপ্লয় করা A/B বিভাজন ব্যবহার করে;
ভেরিয়েবল ভ্যারিয়েন্ট নির্বাচনের পরে রেন্ডার হয়। ইনবাউন্ড ফোন কলে, কোনো ইনবাউন্ড
এজেন্ট বরাদ্দ নেই এমন একটি নম্বর ব্যবহার করুন এবং তার ফোন-নম্বর বা সংস্থার webhook কনফিগার করুন; উইজেট কী mode="webhook" ব্যবহার করে। এন্ডপয়েন্ট-সিস্টেমের আগত বিজ্ঞপ্তি ব্লকিং
কনফিগারেশন প্রতিক্রিয়া সরবরাহ করে না।
এজেন্ট কল সেটআপ webhook
একটি নম্বরকে তার এজেন্টের জন্য নির্ধারিত রাখতে এবং শুধু কলের মানগুলো পূরণ করতে,
এজেন্টকে একটি কল সেটআপ webhook দিন।
প্রতিটি ইনবাউন্ড কলে এজেন্ট কোনো নম্বরে উত্তর দেওয়ার আগে, webhook কলটি এবং এজেন্টের id, নাম ও সংস্করণ পায়, এবং agent_id ছাড়াই উপরের মতো একই
variables, context, language এবং প্রতি-কলের timezone সহ উত্তর দেয়। যেসব এজেন্টের
সেটিংসে ডিফল্ট ছাড়া placeholder ব্যবহার করা হয়, ফোন নম্বরে উত্তর দেওয়ার জন্য তাদের এই webhook প্রয়োজন: webhook ব্যর্থ হলে কল শুরু হয় না। {{name|there}}-এর মতো ডিফল্টসহ placeholder এজেন্টকে এটি ছাড়াই উত্তর দিতে দেয়।
SIP হেডার
SIP-এর মাধ্যমে এজেন্টে পৌঁছানো কলগুলো (SIP ঠিকানা, অথবা ম্যানুয়াল SIP সংযোগের একটি নম্বর) X-* এবং
User-to-User হেডারে কনটেক্সট বহন করতে পারে। প্রতিটি একটি sip_ ভেরিয়েবলে পরিণত হয়, যেমন
{{sip_x_amzn_connectcontactid}} বা {{sip_uui}}, যার অগ্রাধিকার সবচেয়ে কম:
API বা webhook থেকে একই নামের কোনো মান থাকলে সেটিই প্রাধান্য পায়। দেখুন
SIP হেডারে কল কনটেক্সট পাঠান।
হেডারের মান প্রেরক সেট করে, তাই ব্রাউজার-প্রদত্ত যেকোনো মানের মতো এগুলোকেও অবিশ্বস্ত হিসেবে বিবেচনা করুন।
Widget সেশন API
POST /v1/widget/session শীর্ষ-স্তরের variables এবং language গ্রহণ করে। এর publishable
key সংরক্ষিত এজেন্ট নির্বাচন করে। Webhook-মোডের key এই মানগুলো
configuration webhook-এ পাঠায় এবং উপরে বর্ণিতভাবে প্রতিক্রিয়া মার্জ করে।
ব্রাউজার থেকে সরবরাহ করা widget variables ক্লায়েন্ট-নিয়ন্ত্রিত, উপরে বর্ণিত
যাচাই ও স্ট্রিং পরিষ্কারের পরে হুবহু web.incoming-এ পাঠানো হয় এবং completion
webhook ও কল ইতিহাসে প্রতিধ্বনিত হয়। এগুলোকে বিশ্বস্ত পরিচয় বা অনুমোদন ডেটা হিসেবে বিবেচনা করবেন না।
Widget-এর নিজস্ব ব্রাউজার context ফিল্ড আলাদা: এটি ভিজিটর যে পেজে আছেন সেই
পেজের লেখা বহন করে, যেটিকে এজেন্ট ওয়েবসাইটের কনটেন্ট হিসেবে বিবেচনা করে
(ওয়েব widget এমবেড করুন দেখুন)। Widget কলের
প্রতি-কল প্রসঙ্গ উপরের মতো একটি webhook-মোড কী-এর কনফিগারেশন webhook থেকে
আসে। কোনো কলে উভয়টি থাকলে, প্রতি-কল প্রসঙ্গ আগে আসে, তারপর পেজের কনটেন্ট।
Realtime সেশন API
POST /v1/realtime/sessions শীর্ষ-স্তরের variables, context এবং language গ্রহণ করে
agent_id বা একটি ইনলাইন config-এর সঙ্গে:
{
"agent_id": 12,
"variables": {"name": "Ada"},
"context": "Ada is calling from the front desk about a guest's lost key card."
}context শুধুমাত্র শীর্ষ স্তরে থাকে; একটি ইনলাইন config এটিকে অজানা ফিল্ড
হিসেবে প্রত্যাখ্যান করে।
রিয়েলটাইম WebSocket
সংরক্ষিত এজেন্ট ব্যবহার করলে, সেই এজেন্টের ডিপ্লয় করা prompt-ই তার prompt হিসেবে থাকে।
session.instructions কলের কনটেক্সট হয়ে যায়, session.prompt.variables
(অথবা session.config.variables) তার ভেরিয়েবল হয়ে যায়, এবং session.language
তার প্রতি-কল ভাষা হয়ে যায়। প্রথম session.update-এ session.prompt.id দিয়ে
এজেন্ট নির্বাচন করুন; আপডেটটি আসার পর সেটিই সেশন শুরু করে:
{
"type": "session.update",
"session": {
"type": "realtime",
"prompt": {"id": "12", "variables": {"name": "Ada"}},
"instructions": "Ada asked for a callback about her delivery window."
}
}সংযোগের URL-এ থাকা ?agent_id=12 সকেট সংযুক্ত হওয়ার সঙ্গে সঙ্গেই, কোনো
session.update-এর আগে এজেন্ট শুরু করে; তাই এতে প্রতি-কল ইনপুট থাকে না। প্রথম
session.update-এর জন্য অপেক্ষা করতে এবং তার নির্দেশনা ও ভেরিয়েবল ব্যবহার করতে
&wait_for_session_update=1 যোগ করুন।
ইনলাইন সেশনে (কোনো সংরক্ষিত এজেন্ট নেই), আগের মতো session.instructions-ই
prompt। Builder মাইক এবং সিমুলেটেড পরীক্ষামূলক কল ডিফল্ট ও অনুপস্থিত প্লেসহোল্ডার
সমাধান করে, কিন্তু প্রতি-কল ভেরিয়েবল বা প্রসঙ্গ ইনপুট থাকে না।
কলের পরে
GET /v1/calls, GET /v1/calls/{call_id}, telephony.complete, এবং web.complete চূড়ান্ত মার্জ করা
variables এবং unresolved_variables অন্তর্ভুক্ত করে। data.history অন্তর্ভুক্ত করা লিগ্যাসি কমপ্লিশন পেলোডেও এগুলো থাকে:
{
"variables": {"name": "Ada", "account_id": "A-17"},
"unresolved_variables": ["appointment_slot"]
}কলের prompt_snapshot (GET /v1/calls/{call_id})-এ এজেন্টের prompt দেখা যায়,
যেখানে এর variables পূরণ করা থাকে এবং context ব্লক যোগ করা থাকে।
সম্পন্ন কলটিকে তার উৎস রেকর্ডের সঙ্গে যুক্ত করতে variables অবজেক্টে আপনার CRM বা টাস্ক আইডেন্টিফায়ার সংরক্ষণ করুন। Variables এবং context কল রেকর্ডের সঙ্গে সংরক্ষিত থাকে; কলের ইতিহাস ও webhooks-এ রাখার উপযোগী তথ্যই শুধু পাঠান।
একটি কলের রিপ্লে, ভ্যালিডেশন সেটে, রিপ্লে রানে এবং তদন্তে, পরীক্ষাধীন prompt-এর সঙ্গে সেই কলের variables ও context ব্যবহার করে, ফলে রিপ্লে পরীক্ষা করে যে ওই কলে এজেন্টকে কী বলা হয়েছিল।
বিদ্যমান prompt সামঞ্জস্যতা
রেন্ডারিং বিদ্যমান সংরক্ষিত-এজেন্ট এবং A/B ভ্যারিয়েন্ট prompt, ইনলাইন
আউটবাউন্ড ও রিয়েলটাইম কনফিগারেশন, এবং কনফিগারেশন ওয়েবহুক থেকে ফেরত আসা
prompt-গুলিতেও প্রযোজ্য। অজানা {{name}} প্লেসহোল্ডার ফাঁকা টেক্সটে পরিণত হয়, এমনকি কোনো
variables সরবরাহ না করা হলেও। রোলআউটের আগে বিদ্যমান prompt পরীক্ষা করুন, যার মধ্যে
বাহ্যিকভাবে সরবরাহ করা ইনলাইন/ওয়েবহুক prompt অন্তর্ভুক্ত, যেগুলোর তালিকা ThunderPhone তৈরি করতে পারে না।
Builder মাইক এবং সিমুলেশন কলেও একই ডিফল্ট/ফাঁকা আচরণ প্রযোজ্য।