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) എന്നിവ ഒഴികെയുള്ള Unicode നിയന്ത്രണ (Cc) പ്രതീകങ്ങൾ,
സീറോ-വിഡ്ത്ത് നോൺ-ജോയിനറും ജോയിനറും (ഇന്ത്യൻ, അറബി ലിപിയിലുള്ള ഭാഷകളിൽ വാക്കുകൾ
എഴുതാൻ ഉപയോഗിക്കുന്ന U+200C, U+200D) ഒഴികെയുള്ള ഫോർമാറ്റ് (Cf) പ്രതീകങ്ങൾ, കൂടാതെ
സറോഗേറ്റ് (Cs) കോഡ് പോയിന്റുകൾ നീക്കംചെയ്യപ്പെടും; \r\n
എന്നത് \n ആയി നോർമലൈസ് ചെയ്യപ്പെടും. റെൻഡർ ചെയ്യുമ്പോൾ ഓരോ മൂല്യവും
2,000 പ്രതീകങ്ങളായി പരിമിതപ്പെടുത്തുന്നു. നൽകിയ സ്ട്രിംഗുകളും സംഭരിക്കുന്നതിന് മുമ്പ്
ശുദ്ധീകരിച്ച് ട്രങ്കേറ്റ് ചെയ്യപ്പെടും. യഥാർത്ഥ ഒബ്ജക്റ്റ് UTF-8 JSON-ന്റെ 32 KB
എന്ന പരിധിയിൽ ഒതുങ്ങണം; വലുതായ ഒബ്ജക്റ്റുകൾക്ക് കോൾ/സെഷൻ അഭ്യർത്ഥനകളിൽ 400
ലഭിക്കും, അതേസമയം ക്യാമ്പെയ്ൻ ഇംപോർട്ടുകൾ അസാധുവായ വരികൾ ഓരോന്നായി റിപ്പോർട്ട് ചെയ്യും.
അറേകളും നെസ്റ്റഡ് ഒബ്ജക്റ്റുകളും മൂല്യങ്ങളായി സ്വീകരിക്കില്ല. പൊരുത്തപ്പെടാത്ത മെറ്റാഡാറ്റ
കീകൾ (ഉദാഹരണത്തിന്, സ്പേസുള്ള ഒരു CSV ഹെഡർ) നിലനിർത്തുകയും തിരികെ നൽകുകയും ചെയ്യും,
എന്നാൽ പ്ലേസ്ഹോൾഡർ ഉപയോഗിച്ച് അവയെ റഫറൻസ് ചെയ്യാനാകില്ല.
സന്ദർഭം
context പരമാവധി 20,000 പ്രതീകങ്ങൾ ഉള്ള ഒരു സ്ട്രിംഗാണ്. പ്രോംപ്റ്റിലെ
വേരിയബിളുകൾ പൂരിപ്പിച്ചതിന് ശേഷം, ThunderPhone അതിനെ ഒരു ഡിലിമിറ്റഡ് ബ്ലോക്കായി
പ്രോംപ്റ്റിന് ശേഷം ചേർക്കുന്നു:
<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, ശൂന്യ സ്ട്രിംഗ്, അല്ലെങ്കിൽ വെറും ശൂന്യസ്ഥലം മാത്രമാണെങ്കിൽ കോൺടെക്സ്റ്റ് ഇല്ലെന്ന് അർത്ഥമാക്കുന്നു.- സ്ട്രിംഗ് അല്ലാത്തതോ 20,000 പ്രതീകങ്ങളേക്കാൾ ദൈർഘ്യമുള്ളതോ ആയ മൂല്യം കോൾ, സെഷൻ അഭ്യർത്ഥനകളിൽ
400ഉപയോഗിച്ച് നിരസിക്കും; കോൺഫിഗറേഷൻ വെബ്ഹുക്കിൽ നിന്ന് വരുമ്പോൾ അസാധുവായvariablesപോലെയാണ് എക്സ്ചേഞ്ച് പരാജയപ്പെടുക (താഴെ കാണുക). - തുടക്കത്തിലെയും അവസാനത്തിലെയും ശൂന്യസ്ഥലം നീക്കും, കൂടാതെ വേരിയബിൾ മൂല്യങ്ങളിലുള്ളതുപോലെ തന്നെയുള്ള നിയന്ത്രണ, ഫോർമാറ്റ് പ്രതീകങ്ങളും നീക്കും.
- കോൺടെക്സ്റ്റ് കോളിന്റെ prompt-ന്റെ ഭാഗമാണ്; അതിനാൽ അത് കോളിന്റെ prompt വലുപ്പത്തിൽ ഉൾപ്പെടും.
ഒരു steps ഏജന്റിൽ, കോളിലുള്ള ഓരോ ഏജന്റിന്റെയും പ്രോംപ്റ്റിന് ശേഷമാണ് സന്ദർഭം വരുന്നത്, ഓരോ ഘട്ടത്തിന്റെയും നിർദേശങ്ങൾക്ക് ശേഷമല്ല.
മൂല്യങ്ങൾ എവിടെ നിന്നാണ് വരുന്നത്
ഔട്ട്ബൗണ്ട് 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 ഉപയോഗിക്കുമ്പോൾ, കോൺഫിഗറേഷൻ webhook തിരികെ നൽകുന്ന അതേ ഫീൽഡായ config-നുള്ളിലും context ഉൾപ്പെടുത്താം; രണ്ടും അയയ്ക്കുകയാണെങ്കിൽ, അവ ഒരേ ടെക്സ്റ്റായിരിക്കണം. വ്യത്യസ്ത variables-കളോ വ്യത്യസ്ത context-ഓ ഉപയോഗിച്ച് ഒരു idempotency key വീണ്ടും ഉപയോഗിക്കാൻ കഴിയില്ല.
കാമ്പെയ്ൻ CSV
ഫോൺ ഇതര CSV കോളങ്ങൾ ഇതിനകം കോൺടാക്റ്റ് വേരിയബിളുകളായി സംഭരിച്ചിരിക്കുന്നു. ഓരോ ഡയലും ഇപ്പോൾ അവ സ്വയമേവ ഉപയോഗിക്കുന്നു. നിങ്ങളുടെ പ്ലേസ്ഹോൾഡറുകളുമായി പൊരുത്തപ്പെടുത്താൻ name, account_id, appointment_slot പോലുള്ള ഹെഡറുകൾ ഉപയോഗിക്കുക. നിലവിലുള്ള പേര് മാപ്പിംഗ് ആദ്യനാമവും അവസാനനാമവും ഉള്ള കോളങ്ങൾ name വേരിയബിളിലേക്ക് സംയോജിപ്പിക്കാൻ കഴിയും. ക്യാമ്പെയ്ൻ കോൺടാക്റ്റുകൾക്ക് ഓരോ കോൺടാക്റ്റിനുമുള്ള കോൺടെക്സ്റ്റ് ഇല്ല.
ഡൈനാമിക് കോൺഫിഗറേഷൻ വെബ്ഹുക്ക്
തടയുന്ന കോൺഫിഗറേഷൻ webhook പാതയിൽ, നിങ്ങളുടെ ഓർഗനൈസേഷനിലെ സേവ് ചെയ്ത ഏജന്റും ഓരോ കോളിനുമുള്ള മൂല്യങ്ങളും മടക്കി നൽകുക. Full duplex ഏജന്റിനായി, കോൾ മറ്റൊരു പിന്തുണയുള്ള ഭാഷയിൽ ആരംഭിച്ചാലും ഏജന്റിന്റെ ശബ്ദം നിലനിർത്തും: ഓരോ ഭാഷയ്ക്കുമുള്ള ശബ്ദ മാപ്പിംഗുകളും നേറ്റീവ് ശബ്ദ സ്വിച്ചിംഗും ആ കോളിൽ ബാധകമല്ല.
{
"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 അല്ലെങ്കിൽ മറ്റ് ക്രമീകരണങ്ങൾ മാറ്റേണ്ടിവരുമ്പോൾ ഇൻലൈൻ കോൺഫിഗറേഷൻ മടക്കിനൽകുക. സംരക്ഷിച്ച-ഏജന്റ് വെബ്ഹുക്ക്
പ്രതികരണങ്ങൾ ഫോൺ, വിജറ്റ് കോളുകൾ രണ്ടിലും ഏജന്റിന്റെ വിന്യസിച്ച A/B വിഭജനം ഉപയോഗിക്കും;
വേരിയബിളുകൾ വേരിയന്റ് തിരഞ്ഞെടുപ്പിന് ശേഷം റെൻഡർ ചെയ്യും. പ്രതികരണം ഫുൾ ഡ്യൂപ്ലക്സ് അല്ലാത്ത ഒരു
ഏജന്റിനായി language സജ്ജമാക്കുമ്പോൾ, ഏജന്റിന് ആ ഭാഷയ്ക്കായി ശബ്ദം സജ്ജീകരിച്ചിട്ടുണ്ടെങ്കിൽ കോൾ ആ ഭാഷയുടെ സ്വന്തം ശബ്ദവും ഉപയോഗിക്കും. prompt ഉൾക്കൊള്ളുന്ന ഒരു പ്രതികരണം എല്ലായ്പ്പോഴും ഇൻലൈൻ
കോൺഫിഗറേഷൻ ഉപയോഗിക്കും: ആ പ്രതികരണത്തിലുള്ള ഏത് agent_id-യും, null അല്ലെങ്കിൽ പൂർണസംഖ്യയല്ലാത്ത
മെറ്റാഡാറ്റ ഉൾപ്പെടെ, അവഗണിക്കപ്പെടും. ഇൻലൈൻ prompt സാധാരണ പരിശോധന വിജയിക്കണം.
ഇൻലൈൻ വെബ്ഹുക്ക് പ്രതികരണങ്ങളിൽ variables, context എന്നിവയും ഉൾപ്പെടുത്താം. സ്ട്രിംഗ് അല്ലാത്തതോ
വളരെ ദൈർഘ്യമേറിയതോ ആയ context എക്സ്ചേഞ്ച് പരാജയപ്പെടുത്തും: ഒരു ഫോൺ കോൾ
നിരസിക്കപ്പെടും, വിജറ്റ് സെഷൻ അഭ്യർത്ഥന 400 ഉപയോഗിച്ച് പരാജയപ്പെടും. സംരക്ഷിച്ച-ഏജന്റ് വെബ്ഹുക്ക്
പ്രതികരണങ്ങൾ ഫോൺ, വിജറ്റ് കോളുകൾ രണ്ടിലും ഏജന്റിന്റെ വിന്യസിച്ച A/B വിഭജനം ഉപയോഗിക്കും;
വേരിയബിളുകൾ വേരിയന്റ് തിരഞ്ഞെടുപ്പിന് ശേഷം റെൻഡർ ചെയ്യും. ഇൻബൗണ്ട് ഫോൺ കോളുകൾക്കായി, നിയോഗിച്ച ഇൻബൗണ്ട്
ഏജന്റ് ഇല്ലാത്ത ഒരു നമ്പർ ഉപയോഗിച്ച് അതിന്റെ ഫോൺ-നമ്പർ അല്ലെങ്കിൽ ഓർഗനൈസേഷൻ വെബ്ഹുക്ക് ക്രമീകരിക്കുക; വിജറ്റ് കീകൾ
mode="webhook" ഉപയോഗിക്കും. എൻഡ്പോയിന്റ്-സിസ്റ്റം ഇൻകമിംഗ് അറിയിപ്പുകൾ ബ്ലോക്കിംഗ്
കോൺഫിഗറേഷൻ പ്രതികരണങ്ങൾ നൽകുന്നില്ല.
ഏജന്റ് കോൾ സജ്ജീകരണ വെബ്ഹുക്ക്
ഒരു നമ്പർ അതിന്റെ ഏജന്റിന് നിയോഗിച്ച നിലയിൽ നിലനിർത്താനും കോളിന്റെ മൂല്യങ്ങൾ മാത്രം പൂരിപ്പിക്കാനും,
ഏജന്റിന് ഒരു കോൾ സജ്ജീകരണ webhook നൽകുക.
ഓരോ ഇൻബൗണ്ട് കോളിനും മുമ്പ് ഏജന്റ് ഒരു നമ്പറിൽ ഉത്തരം നൽകുമ്പോൾ, webhook കോളും ഏജന്റിന്റെ id, പേരും പതിപ്പും സ്വീകരിച്ച്,
agent_id ആവശ്യമില്ലാതെ മുകളിലുള്ള അതേ variables, context, language, ഓരോ കോളിനുമുള്ള timezone എന്നിവയോടെ പ്രതികരിക്കുന്നു. ഡിഫോൾട്ട് ഇല്ലാത്ത ഒരു പ്ലേസ്ഹോൾഡർ ഉപയോഗിക്കുന്ന ക്രമീകരണങ്ങളുള്ള ഏജന്റിന്
ഒരു ഫോൺ നമ്പറിന് ഉത്തരം നൽകാൻ ഈ webhook ആവശ്യമാണ്: webhook പരാജയപ്പെട്ടാൽ കോൾ ആരംഭിക്കില്ല. {{name|there}} പോലുള്ള ഡിഫോൾട്ടുള്ള പ്ലേസ്ഹോൾഡറുകൾ ഉപയോഗിച്ച്, അതില്ലാതെയും ഏജന്റിന് ഉത്തരം നൽകാൻ കഴിയും.
SIP ഹെഡറുകൾ
SIP വഴി (ഒരു SIP വിലാസം, അല്ലെങ്കിൽ മാനുവൽ SIP കണക്ഷനിലെ
ഒരു നമ്പർ) ഏജന്റിലേക്ക് എത്തുന്ന കോളുകൾക്ക് X-*, User-to-User ഹെഡറുകളിൽ
കോൺടെക്സ്റ്റ് ഉൾക്കൊള്ളാം. ഓരോന്നും {{sip_x_amzn_connectcontactid}} അല്ലെങ്കിൽ
{{sip_uui}} പോലുള്ള sip_ വേരിയബിളാകുന്നു; ഇവയ്ക്കാണ് ഏറ്റവും കുറഞ്ഞ
മുൻഗണന: API-യിൽ നിന്നോ വെബ്ഹുക്കിൽ നിന്നോ അതേ പേരിലുള്ള മൂല്യം ലഭിച്ചാൽ അതിനാണ്
മുൻഗണന. SIP ഹെഡറുകളിൽ കോൾ കോൺടെക്സ്റ്റ് കൈമാറുക കാണുക.
ഹെഡർ മൂല്യങ്ങൾ അയയ്ക്കുന്നയാളാണ് സജ്ജീകരിക്കുന്നത്; അതിനാൽ ബ്രൗസർ നൽകുന്ന ഏത്
മൂല്യത്തെയും പോലെ അവയും വിശ്വസനീയമല്ലാത്തതായി കണക്കാക്കുക.
വിജറ്റ് സെഷൻ API
POST /v1/widget/session മുകളിലത്തെ നിലയിലെ variables, language എന്നിവ സ്വീകരിക്കുന്നു. അതിന്റെ പ്രസിദ്ധീകരിക്കാവുന്ന
കീ സംരക്ഷിച്ച ഏജന്റിനെ തിരഞ്ഞെടുക്കുന്നു. Webhook-മോഡ് കീകൾ ഈ മൂല്യങ്ങൾ
കോൺഫിഗറേഷൻ webhook-ലേക്ക് അയയ്ക്കുകയും മുകളിൽ വിവരിച്ചതുപോലെ പ്രതികരണം ലയിപ്പിക്കുകയും ചെയ്യുന്നു.
ബ്രൗസർ നൽകുന്ന widget variables ക്ലയന്റ് നിയന്ത്രിക്കുന്നവയാണ്; മുകളിൽ വിവരിച്ച
സാധൂകരണത്തിനും സ്ട്രിംഗ് ശുദ്ധീകരണത്തിനും ശേഷം അവ web.incoming-ൽ മാറ്റമില്ലാതെ അയയ്ക്കപ്പെടുകയും
പൂർത്തീകരണ webhook-കളിലും കോൾ ചരിത്രത്തിലും പ്രതിഫലിപ്പിക്കപ്പെടുകയും ചെയ്യുന്നു. അവയെ
വിശ്വസനീയമായ ഐഡന്റിറ്റി അല്ലെങ്കിൽ അംഗീകാര ഡാറ്റയായി കണക്കാക്കരുത്.
വിജറ്റിന്റെ സ്വന്തം ബ്രൗസർ context ഫീൽഡ് വ്യത്യസ്തമാണ്: സന്ദർശകൻ നിലവിലുള്ള
പേജിൽ നിന്നുള്ള ടെക്സ്റ്റാണ് അതിലുള്ളത്, ഏജന്റ് അതിനെ വെബ്സൈറ്റ് ഉള്ളടക്കമായി
പരിഗണിക്കുന്നു (വെബ് വിജറ്റ് എംബെഡ് ചെയ്യുക കാണുക).
ഒരു വിജറ്റ് കോളിന്റെ ഓരോ-കോൾ സന്ദർഭം, മുകളിൽ പറഞ്ഞതുപോലെ, വെബ്ഹുക്ക്-മോഡ് കീയുടെ
കോൺഫിഗറേഷൻ വെബ്ഹുക്കിൽ നിന്നാണ് വരുന്നത്. ഒരു കോളിൽ രണ്ടും ഉണ്ടായാൽ, ഓരോ-കോൾ
സന്ദർഭം ആദ്യം വരും, തുടർന്ന് പേജ് ഉള്ളടക്കം വരും.
റിയൽടൈം സെഷൻ API
POST /v1/realtime/sessions, agent_id അല്ലെങ്കിൽ ഇൻലൈൻ config എന്നിവയ്ക്കൊപ്പം ടോപ്പ്-ലെവൽ variables, context, language എന്നിവ സ്വീകരിക്കുന്നു:
{
"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, socket കണക്റ്റ് ചെയ്യുന്നതുമുതൽ, ഏതെങ്കിലും
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-ൽ അതിന്റെ വേരിയബിളുകൾ പൂരിപ്പിച്ചിരിക്കുന്നതും കോൺടെക്സ്റ്റ് ബ്ലോക്ക് ചേർത്തിരിക്കുന്നതും കാണിക്കുന്നു.
പൂർത്തിയായ കോളിനെ അതിന്റെ ഉറവിട റെക്കോർഡുമായി ബന്ധിപ്പിക്കാൻ നിങ്ങളുടെ CRM അല്ലെങ്കിൽ ടാസ്ക് ഐഡന്റിഫയർ വേരിയബിളുകൾ ഒബ്ജക്റ്റിൽ സംഭരിക്കുക. വേരിയബിളുകളും കോൺടെക്സ്റ്റും കോൾ റെക്കോർഡിനൊപ്പം നിലനിർത്തപ്പെടും; കോൾ ചരിത്രത്തിലും വെബ്ഹുക്കുകളിലും നിലനിർത്താൻ അനുയോജ്യമായ വിവരങ്ങൾ മാത്രം അയയ്ക്കുക.
ഒരു കോളിന്റെ റീപ്ലേകൾ, വാലിഡേഷൻ സെറ്റുകളിൽ, റീപ്ലേ റണ്ണുകളിൽ, കൂടാതെ ഇൻവെസ്റ്റിഗേഷനുകളിൽ, പരീക്ഷണത്തിലുള്ള prompt-നൊപ്പം ആ കോളിന്റെ വേരിയബിളുകളും കോൺടെക്സ്റ്റും ഉപയോഗിക്കുന്നു. അതിനാൽ ആ കോളിലെ ഏജന്റിനോട് എന്ത് പറഞ്ഞിരിക്കുമായിരുന്നുവോ അതാണ് റീപ്ലേ പരിശോധിക്കുന്നത്.
നിലവിലുള്ള prompt അനുയോജ്യത
റണ്ടറിംഗ് നിലവിലുള്ള സേവ് ചെയ്ത ഏജന്റ്, A/B വേരിയന്റ് prompt-ുകളിലും ഇൻലൈൻ
ഔട്ട്ബൗണ്ട്, റിയൽടൈം കോൺഫിഗറേഷനുകളിലും കോൺഫിഗറേഷൻ webhook-ുകൾ വഴി ലഭിക്കുന്ന prompt-ുകളിലും ബാധകമാണ്. variables നൽകിയിട്ടില്ലെങ്കിലും, അറിയാത്ത {{name}} പ്ലേസ്ഹോൾഡറുകൾ ശൂന്യ വാചകമായി മാറും. ThunderPhone-ന് ഇൻവെന്ററി ചെയ്യാനാകാത്ത, ബാഹ്യമായി നൽകുന്ന ഇൻലൈൻ/webhook prompt-ുകൾ ഉൾപ്പെടെ, റോൾഔട്ടിന് മുമ്പ് നിലവിലുള്ള prompt-ുകൾ പരിശോധിക്കുക. Builder mic, സിമുലേഷൻ കോളുകൾക്കും ഇതേ ഡിഫോൾട്ട്/ശൂന്യ സ്വഭാവം ബാധകമാണ്.