Open in
செயல்பாட்டு கருவிகள்
உங்கள் AI ஏஜென்ட்களுக்கு உரையாடலின் நடுவில் வெளிப்புற API-களை அழைக்கும் செயல்பாட்டு கருவிகளை வழங்குங்கள் — வாடிக்கையாளர் தரவைப் பெறுங்கள், சந்திப்புகளைப் பதிவு செய்யுங்கள், பதிவுகளைப் புதுப்பியுங்கள் — வகை குறிப்பிடப்பட்ட அளவுருக்களுடன்.
செயல்பாட்டு கருவிகள், தொலைபேசி அழைப்புகளின் போது உங்கள் AI ஏஜென்ட்கள் வெளிப்புற API-களை அழைக்க அனுமதிக்கின்றன. வாடிக்கையாளர் தரவைத் தேட, கிடைப்பைச் சரிபார்க்க, சந்திப்புகளை முன்பதிவு செய்ய அல்லது உங்கள் backend ஆதரிக்கும் எந்தச் செயலையும் செய்ய அவற்றைப் பயன்படுத்தவும்.
இது எவ்வாறு செயல்படுகிறது
- நீங்கள் ஒரு schema-வுடன் கருவிகளை வரையறுக்கிறீர்கள் (கருவி ஏற்கும் arguments என்ன)
- நீங்கள்
endpointஉள்ளமைவை வழங்குகிறீர்கள் (ThunderPhone உங்கள் API-ஐ எங்கு அழைக்கும்) — அல்லது உங்கள் நிறுவன webhook-இல் கருவி அழைப்புகளைப் பெற அதை விடலாம் - அழைப்பின் போது, உரையாடலின் அடிப்படையில் கருவியை எப்போது பயன்படுத்த வேண்டும் என்பதை AI தீர்மானிக்கிறது
- ThunderPhone கருவி arguments-உடன் உங்கள் endpoint-ஐ அழைக்கிறது
- உரையாடலைத் தொடர உங்கள் API பதில் மீண்டும் AI-க்கு வழங்கப்படுகிறது
| திறன் | இது இயங்கும் இடம் | அமைப்பு |
|---|---|---|
| உள்ளமைக்கப்பட்ட கருவிகள் | ThunderPhone | Prompt வழிமுறைகள்; சில கருவிகளுக்கு ஏஜென்ட் அமைப்பும் தேவைப்படும் |
| செயலி இணைப்புகள் | ThunderPhone மற்றும் இணைக்கப்பட்ட வழங்குநர் | கணக்கை இணைத்து, அங்கீகரிக்கப்பட்ட செயல்களை இணைக்கவும் |
| API இணைப்புகள் மற்றும் செயல்பாட்டு கருவிகள் | உங்கள் HTTP API | Endpoint மற்றும் schema-வை வரையறுக்கவும் அல்லது webhook மூலம் செயல்பாட்டு அழைப்புகளைப் பெறவும் |
| MCP சேவையகங்கள் | தொலைநிலை MCP சேவையகம் | சேவையகத்தைச் சேர்த்து, அதன் கருவிகளைக் கண்டறிந்து, அதை ஏஜென்ட்டுடன் இணைக்கவும் |
கருவி Schema
ஒவ்வொரு கருவியும் இந்த அமைப்பைப் பின்பற்றுகிறது:
{
"type": "function",
"function": {
"name": "search_appointments",
"description": "Find available appointment slots for a given date",
"parameters": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date in YYYY-MM-DD format"
},
"service": {
"type": "string",
"description": "Type of service (e.g., 'consultation', 'follow-up')"
}
},
"required": ["date"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/search",
"method": "POST",
"headers": {
"X-Api-Key": "your-api-key"
}
},
"timeout": 120
}கருவி உள்ளமைவு
| புலம் | வகை | அவசியம் | விளக்கம் |
|---|---|---|---|
timeout | எண் | இல்லை | வினாடிகளில் அதிகபட்ச செயல்பாட்டு நேரம் (இயல்புநிலை: 20, அதிகபட்சம்: 180, அல்லது wait_mode: "hold" உடன் 600) |
wait_mode | சரம் | இல்லை | கருவி இயங்கும் போது அழைப்பாளர் கேட்பது: updates (இயல்புநிலை), சுருக்கமான பேச்சு புதுப்பிப்புகள்; அல்லது hold, காத்திருப்பு இசை. நீண்ட காத்திருப்புகள்: hold பயன்முறை மற்றும் பின்னர் பதிலளித்தல் பார்க்கவும் |
call_start | பொருள் | இல்லை | ஒவ்வொரு தொலைபேசி அழைப்பின் தொடக்கத்திலும், வாழ்த்துக்கு முன், கருவியை தானாக இயக்கவும். அழைப்பின் தொடக்கத்தில் ஒரு கருவியை இயக்குதல் பார்க்கவும் |
செயல்பாட்டு வரையறை
| புலம் | வகை | அவசியம் | விளக்கம் |
|---|---|---|---|
name | சரம் | ஆம் | ஒரு அழைப்பின் கருவிகளில் தனித்துவமான கருவி அடையாளங்காட்டி. வெவ்வேறு ஏஜென்ட்கள் ஒரே பெயருடன் தங்களுக்கான கருவியைக் கொண்டிருக்கலாம் |
description | சரம் | ஆம் | இந்தக் கருவியை எப்போது பயன்படுத்த வேண்டும் என்பதை AI-க்கு விளக்குகிறது |
parameters | பொருள் | ஆம் | கருவி வாதங்களுக்கான JSON Schema |
Endpoint உள்ளமைவு
| புலம் | வகை | அவசியம் | விளக்கம் |
|---|---|---|---|
url | சரம் | ஆம் | உங்கள் API endpoint URL |
method | சரம் | இல்லை | HTTP முறை (இயல்புநிலை: POST) |
headers | பொருள் | இல்லை | சேர்க்க வேண்டிய தனிப்பயன் headers |
இரண்டு அழைப்பு பாதைகள்
உங்கள் சேவையகம் பெறும் கோரிக்கை, கருவியில்
endpoint உள்ளதா என்பதைப் பொறுத்தது:
endpoint உள்ள கருவி | endpoint இல்லாத கருவி | |
|---|---|---|
| கோரிக்கை செல்லும் இடம் | நேரடியாக endpoint.url க்கு | உங்கள் நிறுவனத்தின் பழைய webhook URL |
| உட்பொருள் | தேர்ந்தெடுக்கப்பட்ட கோரிக்கை வடிவம் (இயல்பாக வெற்று arguments) | telephony.tool / web.tool உறை |
| தலைப்புகள் | உங்கள் endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, மேலும் தொலைபேசி அழைப்புகளில் அழைப்பின் எண்கள் | Content-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature |
| கையொப்ப விசை | நிறுவன webhook ரகசியம் | நிறுவன webhook ரகசியம் |
இரண்டு பாதைகளும் தடுப்பானவை — முடிவுக்காக AI ஒரு வாக்கியத்தின் நடுவில் காத்திருக்கிறது. இயல்புநிலை நேரவரம்பு 20 s; 180 s என்ற தளத்தின் அதிகபட்ச வரம்பு வரை நீண்ட செயல்பாட்டை அனுமதிக்க, கருவியின் மேல்-நிலை timeout ஐ அமைக்கவும். ஹேண்ட்லர்களை வேகமாக வைத்திருக்கவும். ஒருவருக்காக அல்லது மெதுவான பணிக்காகக் காத்திருக்கும்போது, காத்திருப்பு பயன்முறையை பயன்படுத்தவும். இரண்டையும் கலந்தும் பயன்படுத்தலாம்: webhook URL கொண்ட நிறுவனத்தின் அழைப்பில், endpoint உள்ள கருவிகள் நேரடியாக அழைக்கப்படும்; மற்றவை webhook-க்கு மாறும்.
நேரடி endpoint அழைப்புகள்
AI, endpoint உள்ள ஒரு கருவியை அழைக்கும்போது, ThunderPhone உங்கள் URL-க்கு
ஒரு கோரிக்கையை அனுப்பும்:
கோரிக்கை தலைப்புகள்
POST /appointments/search HTTP/1.1
Host: api.example.com
Content-Type: application/json
X-ThunderPhone-Signature-V2: t=1767225600,v1=5f2c...
X-ThunderPhone-Signature: abc123...
X-ThunderPhone-Call-ID: 987654321
X-ThunderPhone-From-Number: +14155550199
X-ThunderPhone-To-Number: +14155550100
X-ThunderPhone-Call-Direction: inbound
X-Api-Key: your-api-keyஉங்கள் endpoint.headers-இலிருந்து தனிப்பயன் ஹெடர்கள் எப்போதும் அப்படியே சேர்க்கப்படும்,
மேலும் இந்த ThunderPhone நேம்ஸ்பேஸ் ஹெடர்களும் சேர்க்கப்படும்:
X-ThunderPhone-Signature-V2— முறை, பாதை, வினவல் மற்றும் உடலுக்கான நேரமுத்திரையிடப்பட்ட HMAC-SHA256; உங்கள் நிறுவன வெப்ஹுக் ரகசியம் மூலம் விசையிடப்பட்டது. இதைச் சரிபார்த்து, 5 நிமிடங்களுக்கு மேல் பழைய கோரிக்கைகளை நிராகரிக்கவும்; பார்க்கவும் வெப்ஹுக் கையொப்பங்களைச் சரிபார்த்தல்X-ThunderPhone-Signature— துல்லியமான கோரிக்கை-உடல் பைட்டுகளின் பழைய HMAC-SHA256, அதே விசையுடன்; ஏற்கனவே உள்ள சரிபார்ப்பிகளுக்காக இன்னும் அனுப்பப்படுகிறதுX-ThunderPhone-Call-ID— தற்போதைய அழைப்பு IDX-ThunderPhone-From-Numberமற்றும்X-ThunderPhone-To-Number— அழைப்பின் E.164 வடிவிலான From மற்றும் To எண்கள். இவைtelephony.completeஇல் உள்ளfrom_numberமற்றும்to_numberபோலவே பொருள்படும்: வெளிச்செல்லும் அழைப்பில், From என்பது உங்கள் ஏஜென்டின் எண்; To என்பது அழைக்கப்பட்ட நபர். அழைப்பாளர் ID மறைக்கப்பட்டிருந்தால் அல்லது அது தொலைபேசி எண் இல்லையெனில் எண் விடப்படும்X-ThunderPhone-Call-Direction—inboundஅல்லதுoutbound; இதன் மூலம் எந்த எண் வாடிக்கையாளருடையது என்பதை அறியலாம்
அழைப்பு-எண் ஹெடர்கள் தொலைபேசி அழைப்புகளில் மட்டுமே அனுப்பப்படுகின்றன. வலை, விட்ஜெட், நிகழ்நேர மற்றும் உலாவி Talk சோதனைகளில் தொலைபேசி எண் இல்லாததால் அவை விடப்படுகின்றன. ஏஜென்ட் எடிட்டர் மற்றும் AI சிமுலேஷன்களிலிருந்து வரும் சோதனை அழைப்புகள் சிமுலேட் செய்யப்பட்ட அழைப்பாளரின் எண்ணைக் கொண்டிருக்கும். கையொப்பங்கள் ஹெடர்களைக் கையாளாது: V2 நேரமுத்திரை, முறை, பாதை, வினவல் மற்றும் உடலைக் கையொப்பமிடுகிறது. எண்களுக்கும் கையொப்பம் தேவைப்பட்டால், அவற்றை உடலிலிருந்து படிக்கவும்: retell கோரிக்கை வடிவம் மூன்றையும் கொண்டுள்ளது; vapi வாடிக்கையாளரின் எண்ணைக் கொண்டுள்ளது.
உங்கள் endpoint.headers அதை மேலெழுதாத வரை Content-Type: application/json
அமைக்கப்படும் — தனிப்பயன் Content-Type முன்னுரிமை பெறும்.
கோரிக்கை வடிவம்
ஒவ்வொரு API இணைப்பிலும் request_format அமைப்பு உள்ளது. இறக்குமதி செய்யப்பட்ட கருவி அந்தத் தளத்திற்காக உருவாக்கப்பட்ட endpoint-ஐத் தொடர்ந்து அழைக்க வேண்டுமெனில் vapi அல்லது
retell என்பதைத் தேர்ந்தெடுக்கவும். புதிய மற்றும் ஏற்கனவே உள்ள இணைப்புகளுக்கு இயல்புநிலையாக standard இருக்கும்.
POST / PUT / PATCH களுக்கு, ThunderPhone தேர்ந்தெடுக்கப்பட்ட
envelope-ஐ நியமமான முறையில் வரிசைப்படுத்துகிறது (வரிசைப்படுத்தப்பட்ட விசைகள், சுருக்கமான பிரிப்பான்கள்). இரண்டு கையொப்பங்களும் இந்தத் துல்லியமான bytes-ஐ உள்ளடக்கும்.
நிலையானது
standard எந்த ரேப்பரும் இல்லாமல், டூல் arguments மட்டும் அனுப்புகிறது. இது இயல்புநிலை அமைப்பாகும் மற்றும் ThunderPhone-இன் அசல் கோரிக்கை body-யை பைட்-பைட்டாக அப்படியே பாதுகாக்கிறது:
{"date":"2025-01-02","service":"consultation"}Vapi
vapi, Vapi ஆவணப்படுத்திய வடிவில் Vapi-இன் tool-calls சர்வர் செய்தியை
அனுப்புகிறது. call.id என்பது ThunderPhone அழைப்பு ID ஆகும்.
தொலைபேசி அழைப்புகளில், Vapi-இன் அழைப்பு பொருளில் இருப்பதைப் போல, call.customer.number என்பது
மற்ற தரப்பினரின் எண் ஆகும்: உள்வரும் அழைப்பில் அழைப்பாளரின் எண், வெளிச்செல்லும் அழைப்பில்
அழைக்கப்படும் நபரின் எண். அந்த எண் மறைக்கப்பட்டிருந்தாலோ அல்லது தொலைபேசி எண்ணாக இல்லாவிட்டாலோ
அது சேர்க்கப்படாது. கருவி அழைப்பின் id, அந்தச் செயல்படுத்தலுக்கே தனித்துவமானது மற்றும்
எண்ட்பாயிண்ட்டின் முடிவைப் பொருத்துவதற்கு மீண்டும் பயன்படுத்தப்படுகிறது. கருவி அழைப்பு toolCallList மற்றும்
toolWithToolCallList இரண்டிலும் தோன்றும்; function.arguments ஒரு JSON பொருளாக இருக்கும்:
{
"message": {
"type": "tool-calls",
"timestamp": 1725000000123,
"call": { "id": "987654321" },
"toolCallList": [
{
"id": "call_00112233445566778899aabbccddeeff",
"type": "function",
"function": {
"name": "search_appointments",
"arguments": { "date": "2025-01-02", "service": "consultation" }
}
}
],
"toolWithToolCallList": [
{
"type": "function",
"function": { "name": "search_appointments" },
"toolCall": {
"id": "call_00112233445566778899aabbccddeeff",
"type": "function",
"function": {
"name": "search_appointments",
"arguments": { "date": "2025-01-02", "service": "consultation" }
}
}
}
]
}
}assistant, artifact, மற்றும் முழு call பொருள் போன்ற Vapi-க்கு மட்டுமான புலங்கள்
அனுப்பப்படாது.
பொருந்தும் கருவி-அழைப்பு ID உடன் Vapi-யின் பதில் envelope-ஐத் திருப்பியனுப்பவும்:
{
"results": [
{
"toolCallId": "call_00112233445566778899aabbccddeeff",
"result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
}
]
}ThunderPhone, wrapper நீக்கப்பட்ட result string-ஐ AI-க்கு வழங்குகிறது. ஏற்கனவே JSON மதிப்பைத் திருப்பும் endpoint-களுடன் இணக்கத்தன்மைக்காக JSON மதிப்பையும் இது ஏற்கிறது. result-க்குப் பதிலாக வரும் error, கருவிப் பிழையாக AI-க்கு அனுப்பப்படும். endpoint தவறான வடிவிலான அல்லது பொருந்தாத Vapi envelope-ஐத் திருப்பினால், அழைப்பைத் தோல்வியடையச் செய்வதற்குப் பதிலாக ThunderPhone எச்சரிக்கையைப் பதிவு செய்து அதன் நிலையான பதில் parsing-க்கு மாறும்.
Retell
retell, ஒரு Retell தனிப்பயன்
செயல்பாட்டிற்காக ஆவணப்படுத்தப்பட்ட கோரிக்கையை அனுப்புகிறது:
{
"name": "search_appointments",
"call": {
"call_id": "987654321",
"from_number": "+14155550199",
"to_number": "+14155550100",
"direction": "inbound"
},
"args": { "date": "2025-01-02", "service": "consultation" }
}தொலைபேசி அழைப்புகளில், call ஆப்ஜெக்ட் call_id, from_number,
to_number, மற்றும் direction (inbound அல்லது outbound) ஆகியவற்றைக் கொண்டிருக்கும்; இவை
Retell-ன் தொலைபேசி அழைப்பு ஆப்ஜெக்ட் பயன்படுத்தும் புலப் பெயர்கள். அவை அழைப்பு-எண் தலைப்புகளுடன்
பொருந்துகின்றன, மேலும் தலைப்புகளைப் போலல்லாமல் இரு கையொப்பங்களாலும் பாதுகாக்கப்படுகின்றன. மறைக்கப்பட்ட
அல்லது தொலைபேசி எண்ணாக இல்லாத எண் சேர்க்கப்படாது. வெப், விட்ஜெட்,
நிகழ்நேர மற்றும் உலாவி உரையாடல் சோதனைகளில் இதில் call_id மட்டும் இருக்கும். ThunderPhone
அனுப்பும் நேரத்தில் நேர்மையாக வழங்க முடியாத Retell-குறிப்பிட்ட புலங்களைச் சேர்க்காது;
உதாரணமாக agent_id, transcript, transcript_object, metadata, அல்லது இயங்குநிலை
மாறிகள். Retell எந்தப் பதில் உடலையும் ஏற்கும்; ThunderPhone நிலையான பதில் கையாளுதலைப் பயன்படுத்தி அதை
அப்படியே அனுப்பும்.
GET / DELETE களுக்கு, arguments வினவல் அளவுருக்களாக
அனுப்பப்படும்; request_format எதுவாக இருந்தாலும் body காலியாக இருக்கும். அனுப்பப்பட்டபடியே உள்ள query string-ஐ V2 கையொப்பம் உள்ளடக்கும்; பழைய கையொப்பம் காலியான byte string மீது கணக்கிடப்படும். மேலும் அறிய
webhook கையொப்பங்களைச் சரிபார்க்கவும்.
பதில்
கருவி முடிவுடன் JSON பதிலை வழங்கவும்:
{
"available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
"timezone": "America/Los_Angeles"
}பதில் வடிவமைக்கப்பட்டு, உரையாடலைத் தொடர AI-க்கு வழங்கப்படும்.
JSON அல்லாத பதில்கள் {"data": "<text>"} எனச் சுற்றிவைக்கப்படும்;
நேரம் முடிதல் மற்றும் இணைப்புத் தோல்விகள் AI-க்கு பிழைகளாகத் தெரிவிக்கப்படும், எனவே
ஏஜென்ட் மன்னிப்பு கேட்டு நின்றுபோகாமல் தொடர முடியும்.
Webhook-முறை அனுப்புதல்
endpoint இல்லாத கருவிகள், உங்கள் நிறுவனத்தின் பழைய
webhook URL-க்கு கையொப்பமிடப்பட்ட telephony.tool (தொலைபேசி அழைப்புகள்) அல்லது web.tool
(வலை அழைப்புகள்) கோரிக்கையாக அனுப்பப்படும். செயல்படுத்தலுக்குப் பிறகு webhook endpoint-களுக்கு
வழங்கப்படும் தணிக்கை அறிவிப்புகளைப் போலல்லாமல், இந்தக் கோரிக்கையே தான்
செயல்படுத்தல் — உங்கள் HTTP பதிலே கருவி முடிவாகும்.
{
"type": "telephony.tool",
"data": {
"call_id": 987654321,
"tool_name": "search_appointments",
"arguments": { "date": "2026-04-21" },
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}web.tool, from_number / to_number என்பவற்றிற்குப் பதிலாக origin_domain ஐக் கொண்டிருக்கும். நேரடி endpoint அழைப்புகளுக்கான அதே பதில் ஒப்பந்தத்தின்படி, கருவி முடிவை JSON ஆகப் பதிலளிக்கவும். மற்ற எல்லா webhook-களைப் போலவே, இந்தக் கோரிக்கையும் இரு கையொப்பத் தலைப்புகளுடன் org webhook ரகசியத்தைப் பயன்படுத்தி கையொப்பமிடப்படுகிறது.
நீண்ட காத்திருப்புகள்: ஹோல்ட் முறை மற்றும் பிறகு பதிலளித்தல்
சில கருவிகள் ஒருவருக்காகக் காத்திருக்கும்: தள்ளுபடியை அங்கீகரிக்கும் மேலாளர், Slack-இல் கேள்விக்கு பதிலளிக்கும் உரிமையாளர். அந்தக் கருவிகளில் wait_mode-ஐ "hold" என அமைக்கவும்.
wait_mode: "updates" (இயல்புநிலை) | wait_mode: "hold" | |
|---|---|---|
| அழைப்பாளர் கேட்பது | கருவி தொடக்க வரி, பின்னர் சுமார் 12 வினாடிகளுக்குப் பிறகு ஒரு சுருக்கமான "இன்னும் செயல்படுகிறது" வரி மற்றும் சுமார் ஒவ்வொரு 15 வினாடிகளுக்கும் மற்றொன்று | கருவி தொடக்க வரி, பின்னர் முடிவு வரும் வரை காத்திருப்பு இசை |
timeout அதிகபட்சம் | 180 s | 600 s |
| நிலுவையில் உள்ள பதில்கள் | முடிவாக ஏஜென்ட்டுக்கு அனுப்பப்படும் | நீங்கள் முடிவை வழங்கும் வரை கருவி திறந்தே இருக்கும் |
ஹோல்ட் முறையில், கருவி தொடங்கும்போது ஏஜென்ட் ஒரு வரி கூறும் (அதன் சொந்த வார்த்தைகள் அல்லது ஏஜென்ட்டில் அமைக்கப்பட்ட கருவி தொடக்க வரி), பின்னர் அழைப்பாளர் காத்திருப்பு இசையைக் கேட்பார். ஏஜென்ட் முடிவைக் கூறுவதற்கு முன் இசை மெதுவாகக் குறையும். ஓரிரு வினாடிகளுக்குள் பதிலளிக்கும் கருவிக்கு இசையே இருக்காது. ஏஜென்ட் தொலைபேசி மெனு அல்லது குரலஞ்சல் பெட்டியுடன் பேசும்போது, இசை பதிலாகக் கேட்கப்படக்கூடும் என்பதால், அது பேசப்பட்ட புதுப்பிப்புகளைப் பயன்படுத்தும். ஹோல்டின் நடுவில் மெனு அல்லது அஞ்சல்பெட்டி எனக் கண்டறியப்படும் அழைப்பும் இதில் அடங்கும்: இசை நிறுத்தப்பட்டு பேசப்பட்ட புதுப்பிப்புகள் தொடரும். இசையை இயக்க முடியாத அழைப்பிலும் இதுவே நடக்கும்.
ஹோல்டின் போது அழைப்பாளர் பேசினால், இசை தொடர்ந்து இயங்கும்; ஏஜென்ட் இன்னும் பதிலளிக்காது. அழைப்பாளர் கூறியதைக் கேட்டு, முடிவுடன் சேர்த்து அதற்குப் பதிலளிக்கும். அழைப்பைத் துண்டித்தால் அழைப்பும் திறந்த கருவியும் முடிவடையும்.
பிறகு பதிலளிக்கவும்
உங்கள் எண்ட்பாயிண்ட்டின் சொந்த பதில் இன்னும் 180 s-க்குள் வர வேண்டும். அழைப்பாளரை நீண்ட நேரம் ஹோல்டில் வைத்திருக்க, நிலுவை முடிவுடன் உடனடியாகப் பதிலளிக்கவும்:
{ "status": "pending", "request_id": "ask-4471" }request_id என்பது உங்கள் தரப்பில் இந்தக் கோரிக்கையை அடையாளப்படுத்தும், 200 எழுத்துகள் வரை உள்ள எந்தச் சரமும் ஆகும். இதற்கான முடிவை
POST /v1/calls/{call_id}/tool-results மூலம் வழங்கும் வரை அழைப்பாளர் ஹோல்டில் இருப்பார்.
call_id என்பது கருவி கோரிக்கையின் X-ThunderPhone-Call-ID தலைப்பாகும்.
curl -X POST https://api.thunderphone.com/v1/calls/987654321/tool-results \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"request_id": "ask-4471",
"result": { "answer": "Yes, book Tuesday at 10." }
}'உங்கள் எண்ட்பாயிண்ட் அதைத் திருப்பியனுப்பியதைப் போலவே, ஏஜென்ட் result-ஐ கருவியின் பதிலாகப் படிக்கும். கருவி அழைக்கப்பட்ட நேரத்திலிருந்து கணக்கிடப்படும் கருவியின் timeout-க்கு முன் எந்த முடிவும் வரவில்லை என்றால், பதில் திரும்ப வரவில்லை என்று ஏஜென்ட்டுக்குத் தெரிவிக்கப்படும்; அது அழைப்பாளருக்கு அடுத்த படிகளை, எடுத்துக்காட்டாக செய்தி எடுப்பதை, வழங்கும்.
உங்கள் நிலுவை பதில் ThunderPhone-ஐ அடைவதற்கு முன்பே கூட, விரும்பியவுடன் முடிவைப் பதிவிடலாம். 202 என்பது அழைப்பு அதை ஏற்றுக்கொண்டதைக் குறிக்கிறது: திறந்த கோரிக்கை அதை ஏற்றுக்கொண்டிருக்கும், அல்லது கருவியின் சொந்த கோரிக்கை இன்னும் செயல்பாட்டில் இருக்கும் மற்றும் அதன் நிலுவை பதில் அதை ஒதுக்கிக்கொள்ளும். எந்தக் கோரிக்கையும் ஒருபோதும் ஒதுக்கிக்கொள்ளாத முடிவு (request_id-க்காக உங்கள் எண்ட்பாயிண்ட் பின்னர் நிலுவை அல்லாத வேறொன்றைப் பதிலளித்தால்) கைவிடப்படும்.
இணைப்பில் பதில் மாற்றம் இருந்தால் (ஏஜென்ட் பார்ப்பதற்கு முன் உங்கள் எண்ட்பாயிண்ட்டின் பதிலை மீண்டும் எழுதும் குறியீடு), ThunderPhone நிலுவை பதிலைச் சரிபார்ப்பதற்கு முன், அந்த மாற்றம் உங்கள் எண்ட்பாயிண்ட்டின் சொந்த பதிலில் இயங்கும்; எனவே நிலுவை பதிலில் அது status மற்றும் request_id-ஐ வைத்திருக்க வேண்டும். நீங்கள் பின்னர் பதிவிடும் முடிவில் அது இயங்காது: நீங்கள் அனுப்பும் வடிவிலேயே ஏஜென்ட் அந்த முடிவைப் பெறும்.
முழு-டூப்ளெக்ஸ் ஏஜென்ட்டில் காத்திருப்பு இசையோ புதுப்பிப்பு வரிகளோ இல்லை; எனவே அதன் அழைப்புகளில் ஹோல்ட் கருவி updates கருவியைப் போல செயல்படும்: நிலுவை பதில் கருவியின் முடிவாக ஏஜென்ட்டை அடையும்.
updates முறையில் உள்ள கருவியிலிருந்து வரும் நிலுவை பதில் திறந்த நிலையில் வைக்கப்படாது: ஏஜென்ட் அதை கருவியின் முடிவாகப் பெறும்.
கையொப்பச் சரிபார்ப்பு
நேரடி டூல் அழைப்புகள், உங்கள் நிறுவனத்தின் webhook ரகசியத்தைப் பயன்படுத்தி, webhooks போலவே கையொப்பமிடப்படுகின்றன:
X-ThunderPhone-Signature-V2, அனுப்பப்பட்டபடியே உள்ள timestamp, method, path, query மற்றும் துல்லியமான body bytes ஆகியவற்றில் கையொப்பமிடுகிறது. உங்கள் கடிகார நேரத்திலிருந்து 5 நிமிடங்களுக்கு மேல் விலகிய timestamp கொண்ட கோரிக்கைகளை நிராகரிக்கவும்.X-ThunderPhone-Signature(மரபு), body bytes-இல் மட்டுமே கையொப்பமிடுகிறது;GET/DELETEக்கு வெற்று byte string பயன்படுத்தப்படும். இது மாற்றமின்றி இன்னும் அனுப்பப்படுகிறது.
SDK உதவியாளர்கள், 5-நிமிட வரம்பையும் உள்ளடக்கி V2 header-ஐச் சரிபார்க்கின்றனர்:
import json
from fastapi import FastAPI, HTTPException, Request
from thunderphone import verify_signature
app = FastAPI()
@app.post("/appointments/search")
async def search_appointments(request: Request):
body = await request.body()
query = request.scope.get("query_string", b"").decode("latin-1")
path = request.url.path + (f"?{query}" if query else "")
if not verify_signature(
request.headers.get("X-ThunderPhone-Signature-V2"),
secret=WEBHOOK_SECRET,
method=request.method,
path=path,
body=body,
):
raise HTTPException(status_code=401)
data = json.loads(body)
date = data["date"]
# Look up availability
slots = await get_available_slots(date)
return {"available_slots": slots}import express from "express";
import { verifySignature } from "@thunderphone/sdk";
app.post('/appointments/search', express.raw({type: 'application/json'}), (req, res) => {
const ok = verifySignature({
header: req.header('X-ThunderPhone-Signature-V2'),
secret: WEBHOOK_SECRET,
method: req.method,
path: req.originalUrl,
body: req.body,
});
if (!ok) return res.status(401).send('Invalid signature');
const { date, service } = JSON.parse(req.body);
// Look up availability
const slots = getAvailableSlots(date, service);
res.json({ available_slots: slots });
});கையொப்பமிடப்பட்ட string, செயல்படுத்தப்பட்ட உதாரணம், SDK இல்லாத குறியீடு, GET / DELETE நிலை மற்றும் ரகசியம் இல்லாதபோதான எச்சரிக்கை உள்ளிட்ட முழுமையான வழிமுறைகள் webhook கையொப்பங்களைச் சரிபார்க்கவும்-இல் உள்ளன.
எடுத்துக்காட்டு: முழுமையான முன்பதிவு ஓட்டம்
முழுமையான appointment முன்பதிவு அமைப்பிற்கான tools தொகுப்பு இதோ:
{
"tools": [
{
"type": "function",
"function": {
"name": "search_appointments",
"description": "Find available appointment slots",
"parameters": {
"type": "object",
"properties": {
"date": { "type": "string", "description": "YYYY-MM-DD" },
"service": { "type": "string" }
},
"required": ["date"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/search",
"method": "POST",
"headers": { "X-Api-Key": "key" }
}
},
{
"type": "function",
"function": {
"name": "book_appointment",
"description": "Book an appointment at a specific time",
"parameters": {
"type": "object",
"properties": {
"date": { "type": "string", "description": "YYYY-MM-DD" },
"time": { "type": "string", "description": "HH:MM format" },
"customer_name": { "type": "string" },
"customer_phone": { "type": "string" }
},
"required": ["date", "time", "customer_name"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/book",
"method": "POST",
"headers": { "X-Api-Key": "key" }
}
},
{
"type": "function",
"function": {
"name": "cancel_appointment",
"description": "Cancel an existing appointment",
"parameters": {
"type": "object",
"properties": {
"confirmation_number": { "type": "string" }
},
"required": ["confirmation_number"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/cancel",
"method": "POST",
"headers": { "X-Api-Key": "key" }
}
}
]
}அழைப்பு தொடங்கும்போது ஒரு கருவியை இயக்கவும்
ஒவ்வொரு தொலைபேசி அழைப்பின் தொடக்கத்திலும், ஏஜென்ட் தனது முதல் சொல்லைச் சொல்வதற்கு முன்பே, ஒரு கருவி தானாக இயங்கலாம்; இதனால் வாழ்த்தில் அதன் முடிவைப் பயன்படுத்தலாம். வழக்கமான பயன்பாடு அழைப்பாளரின் எண்ணைப் பயன்படுத்தி செய்யப்படும் CRM தேடலாகும்: "மீண்டும் வரவேற்கிறோம், ஆர்த்தி! உங்கள் வழக்கமான ஆர்டரை விரும்புகிறீர்களா?"
டாஷ்போர்டில், API இணைப்பைத் திறந்து, இயங்கும் நேரம் என்பதை
ஒவ்வொரு தொலைபேசி அழைப்பின் தொடக்கத்தில் என அமைக்கவும்; பின்னர் ஒவ்வொரு
அளவுருவும் பெற வேண்டிய மதிப்பை நிரப்பவும். API வழியாக, ஒருங்கிணைப்பின் trigger-ஐ
call_start ஆகவும் அதன் call_start_arguments-ஐயும்
(API இணைப்புகள்) அமைக்கவும் அல்லது இன்லைன் கருவியில்
call_start தொகுதியைச் சேர்க்கவும்:
{
"type": "function",
"function": {
"name": "get_contact_by_phone",
"description": "Look up a customer by phone number.",
"parameters": {
"type": "object",
"properties": {
"business_id": {"type": "string"},
"phone_number": {"type": "string"}
},
"required": ["business_id", "phone_number"]
}
},
"endpoint": {"url": "https://crm.example.com/contacts/lookup"},
"call_start": {
"arguments": {
"business_id": "a0a81c23",
"phone_number": "{{caller_number}}"
}
}
}அழைப்பு தொடக்கத்தில் யாரும் எதையும் நிரப்புவதில்லை என்பதால், ஒவ்வொரு கட்டாய அளவுருவுக்கும் ஆர்க்யூமெண்ட்களில் ஒரு மதிப்பு தேவை. மதிப்புகள் ஸ்ட்ரிங்குகள், எண்கள் அல்லது பூலியன்களாக இருக்கலாம். அவை எளிய உரையாகச் சேமிக்கப்பட்டு திருப்பி வழங்கப்படுகின்றன; ஏஜென்டும் அவற்றைக் காணும். எனவே API கீகள் போன்ற ரகசியங்களை இங்கு வைக்காமல், இணைப்பின் ஹெடர்களில் வைக்கவும். ஸ்ட்ரிங்குகள் இந்த இடஒதுக்கிகளைப் பயன்படுத்தலாம்:
| இடஒதுக்கி | மதிப்பு |
|---|---|
{{caller_number}} | E.164 வடிவிலுள்ள அழைப்பின் மறுமுனை நபரின் எண், எடுத்துக்காட்டாக +61402122887: உள்வரும் அழைப்பில் அழைப்பாளர், வெளிச்செல்லும் அழைப்பில் அழைக்கப்படும் நபர் |
{{caller_number_national}} | இடைவெளிகள் இல்லாத, அந்த நாட்டின் தேசிய வடிவிலுள்ள அதே எண், எடுத்துக்காட்டாக 0402122887 |
{{agent_number}} | ஏஜென்டின் சொந்த எண் |
இது செயல்படும் விதம்:
- இந்தக் கோரிக்கை ஏஜென்டின் சொந்த கருவி அழைப்புகள் அனுப்பும் கோரிக்கையைப் போலவே இருக்கும் (அதே எண்ட்பாயிண்ட், ஹெடர்கள், கோரிக்கை வடிவம் மற்றும் சிக்னேச்சர்).
- அழைப்பு தொடங்கும்போது கருவி தொடங்கும்; இணைப்பு ஒலி, அறிமுகம் அல்லது பதிவு அறிவிப்பு ஒலிக்கும்போது அது இயங்கும். அந்த நேரத்திலிருந்து சுமார் 3 வினாடிகள் வரை வாழ்த்து அதன் முடிவுக்காகக் காத்திருக்கும். மெதுவான முடிவு வந்தவுடன், மீதமுள்ள அழைப்பிற்காக அது ஏஜென்டுக்கு வழங்கப்படும். வெளிச்செல்லும் அழைப்பில், அழைப்பு செய்யப்படும்போதே இது தொடங்கும்; எனவே யாரும் பதிலளிக்காத முயற்சிகள் உட்பட ஒவ்வொரு முயற்சியிலும் இது இயங்கும்.
- அழைப்பாளர் முதலில் பேசும் ஏஜென்டில், காத்திருக்க வாழ்த்து எதுவும் இருக்காது; முடிவு வந்தவுடன் ஏஜென்ட் அதைப் பெறுவார்.
- முழு அழைப்பிற்குமான சூழலாக முடிவு ஏஜென்டுக்கு வழங்கப்படும். அதை எப்படிப் பயன்படுத்துவது என்பதை உங்கள் prompt-ல் ஏஜென்டிடம் தெரிவிக்கவும்; இல்லையெனில் அது வாசித்துச் சொல்லப்படாது.
- கருவி தோல்வியடைந்தாலோ நேரம் முடிந்தாலோ, ஏஜென்ட் வழக்கம்போல் அழைப்பாளரை வாழ்த்துவார்; அதைப் பற்றி எதுவும் சொல்லமாட்டார்.
- அழைப்பின் பின்னர் ஏஜென்ட் கருவியைத் தானாகவே மீண்டும் அழைக்கலாம்.
- உங்கள் தொலைபேசிக்கான டாஷ்போர்டு சோதனை அழைப்புகள் உட்பட தொலைபேசி அழைப்புகளிலும், உருவகப்படுத்தப்பட்ட அழைப்பாளரின் எண்ணை உங்கள் எண்ட்பாயிண்டுக்கு அனுப்பும் AI சிமுலேஷன்களிலும் இது இயங்கும். அழைப்பாளர் எண் இல்லாத உலாவி பேசு சோதனைகள் அல்லது வலை விட்ஜெட் அமர்வுகளில், அழைப்பாளர் அடையாளம் மறைக்கப்பட்ட அழைப்புகளில் அல்லது படிகளைக் கொண்ட ஏஜென்டுகளில் இது இயங்காது.
- ஒரு ஏஜென்ட் ஒரே நேரத்தில் அதிகபட்சம் மூன்று அழைப்பு-தொடக்க கருவிகளை இயக்குவார்.
ஏஜென்டுக்கு முடிவை எப்படிப் பயன்படுத்துவது தெரியும் வகையில் அதை உங்கள் prompt-ல் குறிப்பிடவும்; எடுத்துக்காட்டாக: "அழைப்பு தொடக்கத் தேடல் அழைப்பாளரைக் கண்டறிந்தால், அவரை முதல் பெயரால் வாழ்த்தவும்."
சிறந்த நடைமுறைகள்
தெளிவான விளக்கங்களை எழுதுங்கள்
description புலம், கருவியை எப்போது பயன்படுத்த வேண்டும் என்பதை AI புரிந்துகொள்ள உதவுகிறது. அது என்ன செய்கிறது, எப்போது பொருத்தமானது என்பதைக் குறிப்பாக விளக்குங்கள்.
பிழைகளை நேர்த்தியாகக் கையாளுங்கள்
பொதுவான 500 பிழைகளுக்குப் பதிலாக, AI புரிந்துகொள்ளக்கூடிய பிழைச் செய்திகளைத் திருப்பியனுப்புங்கள்: {"error": "No slots available for that date"}.
பதில்களை சுருக்கமாக வைத்திருங்கள்
உரையாடலைத் தொடர AI-க்கு தேவையானவற்றை மட்டும் திருப்பியனுப்புங்கள். ஒரு கருவி முடிவு உரையாடலிலேயே இருக்கும்; பின்னர் வரும் ஒவ்வொரு முறையிலும் மீண்டும் படிக்கப்படும். எனவே, பெரிய முடிவு அழைப்பின் மீதமுள்ள பகுதிக்கு செலவையும் தாமதத்தையும் அதிகரிக்கும். 100,000 எழுத்துகளுக்கு மேற்பட்ட முடிவுகள் முழுமையற்றவை என்பதை AI அறியும் முன்னோட்டமாகக் குறைக்கப்படும்; மிக நீண்ட அழைப்பில் பழைய முடிவுகள் நீக்கப்படலாம் (AI கருவியை மீண்டும் அழைக்க முடியும்). AI ஒரு நேரத்தில் ஒரு உருப்படி அல்லது வகையைத் தேடிப் பெற ஒரு அளவுருவைச் சேர்க்கவும்; மெனுக்கள் அல்லது பட்டியல்கள் போன்ற பெரிய குறிப்புத் தகவல்களை அறிவுத் தளத்தில் வைக்கவும். டாஷ்போர்டில் உள்ள சோதனை கோரிக்கையை அனுப்பு ஒவ்வொரு முடிவின் அளவையும் காட்டி, அது பெரியதாக இருக்கும்போது எச்சரிக்கும்.
தேவையான புலங்களை விவேகமாகப் பயன்படுத்துங்கள்
உண்மையில் அவசியமானபோது மட்டுமே புலங்களை required எனக் குறிக்கவும். கருவியை அழைப்பதற்கு முன் AI, தேவையான தகவல்களை பயனரிடம் கேட்கும்.
தொடர்புடையவை
எண்ட்பாயிண்டை வரையறுக்காமல் பிளாட்ஃபார்ம் நிர்வகிக்கும் அழைப்பு செயல்களை prompt செய்யுங்கள்.
HubSpot, Salesforce, Google Calendar, Google Sheets மற்றும் Cal.com க்கான பிளாட்ஃபார்ம் நிர்வகிக்கும் கருவிகள் — எண்ட்பாயிண்ட் தேவையில்லை.
MCP சர்வரை இணைத்து, ஏஜென்ட் அதன் கருவிகளை அழைக்க அனுமதியுங்கள்.
ஏஜென்ட்களுடன் இணைக்கக்கூடிய மறுபயன்பாட்டு REST ஒருங்கிணைப்புகள்.
வெப்ஹுக்குகள் மற்றும் கருவி அழைப்புகளுக்கான ஒரு சரிபார்ப்பு உதவியாளர்.