Open in
ThunderPhone کو MCP سرور کے طور پر استعمال کریں
Claude، ChatGPT، Claude Code، Codex، Cursor، VS Code، یا کسی دوسرے Streamable HTTP MCP کلائنٹ سے ThunderPhone وائس ایجنٹس بنائیں، ٹیسٹ کریں، توثیق کریں، اور چلائیں۔
ThunderPhone یہاں ایک Streamable HTTP Model Context Protocol سرور فراہم کرتا ہے:
https://api.thunderphone.com/v1/mcpیہ ریموٹ MCP سرور کو وائس ایجنٹ سے منسلک کرنے کی مخالف سمت ہے:
| سمت | نتیجہ |
|---|---|
| ریموٹ MCP سرور → ThunderPhone ایجنٹ | ایک وائس ایجنٹ ریموٹ سرور کے ٹولز کو کال کر سکتا ہے۔ |
| ThunderPhone → آپ کا MCP کلائنٹ | آپ کا کوڈنگ ایجنٹ ThunderPhone کو بنا، جانچ اور چلا سکتا ہے۔ |
توثیق کریں
ڈائریکٹری کلائنٹس کے لیے بطور ڈیفالٹ OAuth استعمال کریں: سائن اِن کریں، ایک تنظیم منتخب کریں، اور مطلوبہ اجازتوں کی منظوری دیں۔ اسے ترتیبات → سیکیورٹی → آپ کے منسلک کردہ ایپس کے تحت منقطع کریں۔ اپنا پاس ورڈ تبدیل یا ری سیٹ کرنے، یا اکاؤنٹ کا ای میل تبدیل کرنے سے بھی کنکشن منسوخ ہو جاتا ہے، اس لیے بعد میں کلائنٹ کو دوبارہ منسلک کریں۔
API کلید کے ساتھ تشکیل شدہ کلائنٹس کے لیے، انٹیگریشنز → API کلیدیں کے تحت ایک sk_live_ کلید بنائیں اور اسے اپنے MCP کلائنٹ کے لیے THUNDERPHONE_API_KEY کے طور پر ظاہر کریں۔ یہ کلید ایک تنظیم سے منسلک ہوتی ہے؛ کسی دوسری تنظیم کی ملکیت والا id موجود نہ ہونے کے طور پر برتاؤ کرتا ہے۔
وہ تنظیمیں جو PHI ہینڈل کرتی ہیں
اگر آپ کی تنظیم کی کالز میں محفوظ شدہ صحت کی معلومات (PHI) شامل ہو سکتی ہیں،
کیونکہ آپ کا ThunderPhone کے ساتھ BAA ہے یا آپ کے ایجنٹس کو
PHI پراسیس کرنے کے لیے نامزد کیا گیا ہے، تو اوپر دیا گیا URL کبھی بھی کال کا مواد واپس نہیں کرتا:
ٹرانسکرپٹس، ریکارڈنگز، درجات، کال فہرستیں، ایکسپورٹس، مہم کے نتائج، کال تجزیات اور
بصیرتیں، حقیقی کالز سے بنائی گئی گفتگوئیں اور ری پلے کے نتائج۔ یہ ٹولز
code: "phi_content_unavailable" کے ساتھ خرابی واپس کرتے ہیں۔ ایجنٹس بنانا، جانچنا اور کنفیگر کرنا
معمول کے مطابق کام کرتا ہے۔
یہ URL عوامی معاون ڈائریکٹریز میں درج ہوتا ہے، جو ممکنہ طور پر PHI نہیں رکھ سکتیں۔ اگر آپ کی تنظیم کا کسی معاون کے فراہم کنندہ کے ساتھ اپنا BAA ہو جو آپ کے استعمال کردہ ورک اسپیس کا احاطہ کرتا ہو:
- تنظیم کا ایک منتظم ThunderPhone میں تنظیم → عمومی → AI معاون کی رسائی کھولتا ہے اور اس احاطے کی تصدیق کرتا ہے۔
- اس کے بجائے معاون کو اس URL کے ساتھ ایک حسب ضرورت کنیکٹر کے طور پر مربوط کریں:
https://api.thunderphone.com/v1/mcp/baaاس کے بعد وہاں کال کا مواد دستیاب ہوتا ہے، بشمول وہ کالز جن میں PHI شامل ہو سکتا ہے۔ تصدیق واپس لینے سے معاون کی اگلی درخواست پر یہ بند ہو جاتا ہے۔ جس کال کو آپ کی تنظیم نے PHI پر مشتمل نہ ہونے کے طور پر ہینڈل کیا ہو، وہ دونوں URLs پر دستیاب ہوتی ہے۔
CLI اور stdio کے متبادل
ThunderPhone CLI غیر متعلقہ سرورز کو برقرار رکھتے ہوئے کلائنٹ کی ترتیب لکھ سکتا ہے:
npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user@thunderphone/mcp کی عالمی تنصیب کے بعد، انہی اختیارات کے ساتھ thunderphone-mcp setup استعمال کریں۔ سیٹ اپ Claude Code، Codex، Cursor، VS Code، Gemini، Claude Desktop اور Windsurf کو سپورٹ کرتا ہے۔ براہ راست HTTP کو ترجیح دی جاتی ہے؛ Desktop stdio استعمال کرتا ہے۔
کسی بھی stdio کی صلاحیت رکھنے والے کلائنٹ کے لیے، command: "npx" کو
args: ["-y", "@thunderphone/mcp"] کے ساتھ ترتیب دیں۔ ریپر پہلے THUNDERPHONE_API_KEY استعمال کرتا ہے، پھر thunderphone login کی اسناد استعمال کرتا ہے، میعاد ختم شدہ ٹوکنز کو تازہ کرتا ہے، اور پھر mcp-remote کے ذریعے OAuth استعمال کرتا ہے۔ ڈیوائس لاگ ان اور OAuth کے لیے متعلقہ API OAuth رول آؤٹ درکار ہے۔ API کلید کے راستے کے لیے نہیں۔ براہ راست HTTP ترتیبات CLI اسناد کے ذخیرے کو نہیں پڑھتیں؛ ڈیوائس لاگ ان دوبارہ استعمال کرنے کے لیے stdio ریپر استعمال کریں۔
یہ ذیل میں دی گئی دستی کلائنٹ ترتیبات کے متبادل ہیں۔
کلائنٹ کنفیگریشن
Claude اور ChatGPT OAuth کے ساتھ سائن ان کرتے ہیں؛ اس میں کوئی API کلید شامل نہیں ہوتی۔ اگر آپ کے پاس ابھی ThunderPhone اکاؤنٹ نہیں ہے، تو سائن ان صفحے پر اکاؤنٹ بنائیں منتخب کریں، اور اپنی ای میل کی تصدیق کے بعد آپ منظوری کی اسکرین پر واپس آ جائیں گے۔
Claude (ویب، ڈیسک ٹاپ، اور موبائل)
- حسب ضرورت بنائیں → کنیکٹرز کھولیں (پرانے ورژنز میں ترتیبات → کنیکٹرز)۔ اگر ThunderPhone کنیکٹر ڈائریکٹری میں نظر آئے تو اسے منتخب کریں۔ بصورت دیگر حسب ضرورت کنیکٹر شامل کریں منتخب کریں، اس کا نام
ThunderPhoneرکھیں، اورhttps://api.thunderphone.com/v1/mcpدرج کریں۔ - رابطہ کریں منتخب کریں، ThunderPhone میں سائن ان کریں، تنظیم منتخب کریں، اور اجازتوں کی منظوری دیں۔
- چیٹ میں، ٹولز مینو سے ThunderPhone فعال کریں اور اپنی ضرورت کے مطابق سوال کریں، مثلاً "میرے ایجنٹس کی فہرست بنائیں"۔
Claude ہر ٹول کو پہلی بار استعمال کرنے سے پہلے پوچھتا ہے۔ ان میں سے زیادہ تر پرامپٹس چھوڑنے کے لیے، حسب ضرورت بنائیں → کنیکٹرز → ThunderPhone کھولیں اور صرف پڑھنے کے ٹولز کو ہمیشہ اجازت دینے پر سیٹ کریں۔ یہ ٹولز صرف معلومات تلاش کرتے ہیں: ایجنٹس، کالز، ٹرانسکرپٹس، بیلنس، دستاویزات۔ اگر آپ ہر تبدیلی ہونے سے پہلے دیکھنا چاہتے ہیں تو لکھنے اور حذف کرنے والے ٹولز کو منظوری پر رہنے دیں۔
حسب ضرورت کنیکٹرز کے لیے Claude کا بامعاوضہ پلان درکار ہے۔ Team اور Enterprise پلانز میں، تنظیم کا مالک پہلے تنظیم کی کنیکٹر ترتیبات کے تحت کنیکٹر شامل کرتا ہے، پھر ہر رکن اپنا ThunderPhone اکاؤنٹ منسلک کرتا ہے۔
Claude میں کیا مختلف ہے
Claude (کنیکٹر اور Claude Code پلگ اِن) کو Claude کنیکٹر ڈائریکٹری کی پالیسی کے مطابق محدود ٹول سیٹ ملتا ہے:
- ہر کال اور ٹیکسٹ کی ایک ایک کر کے تصدیق کی جاتی ہے۔
place_callاورsend_smsپہلے ایک پیش نظارہ واپس کرتے ہیں (ایجنٹ، بھیجنے اور وصول کرنے کے نمبرز، اور ٹیکسٹ کے لیے پیغام) اور ایکconfirmation_token؛ آپ کی ہاں کے بعد Claude ٹوکن کے ساتھ درخواست دہرانے تک کوئی کال نہیں کی جاتی اور نہ ہی کوئی پیغام بھیجا جاتا ہے۔ - مہم کا انتظام نہیں۔
create_campaign،add_campaign_contactsاورcampaign_actionدستیاب نہیں ہیں؛ مہمات ڈیش بورڈ میں بنائیں، لوڈ کریں اور شروع کریں۔list_campaigns،get_campaign_statsاورcheck_campaignپھر بھی کام کرتے ہیں۔ test_integrationنہیں۔ ڈیش بورڈ میں انضمام کے صفحے سے اس کی درخواست کی جانچ کریں۔preview_voiceایک مقررہ نمونہ سلام چلاتا ہے آپ کی منتخب کردہ آواز اور زبان میں؛ یہ حسبِ ضرورت متن نہیں بولتا۔list_voicesاورlist_agentsایک خلاصہ واپس کرتے ہیں؛get_agentمیں ایجنٹ کی مکمل کنفیگریشن ہوتی ہے۔
AI کی اطلاع
ThunderPhone ایجنٹ کی کی گئی یا وصول کی گئی ہر کال ایک بولی جانے والی AI اطلاع سے شروع ہوتی ہے۔ بطور ڈیفالٹ یہ کہتا ہے، "یہ کال ایک AI معاون کے ساتھ ہے اور اسے ریکارڈ اور نقل تحریر کیا جائے گا۔" اسے بند کرنے کی درخواست (consent_announcement_enabled false، یا ai_live_processing_disclosure_override off) مسترد کر دی جاتی ہے، جب تک تنظیم کا ایڈمن پہلے ڈیش بورڈ میں کسی بھی کلائنٹ، بشمول Claude، سے ایک دستخط شدہ تصدیق ریکارڈ نہ کر دے۔
ChatGPT
- اگر ThunderPhone ChatGPT ایپ ڈائریکٹری میں نظر آئے، تو اسے منتخب کریں اور منسلک کریں۔
- بصورت دیگر ترتیبات → ایپس اور کنیکٹرز → جدید ترتیبات کھولیں، ڈیولپر موڈ آن کریں، اور URL
https://api.thunderphone.com/v1/mcpاور OAuth توثیق کے ساتھ ایک کنیکٹر بنائیں۔ - ThunderPhone میں سائن ان کریں، تنظیم منتخب کریں، اور اجازتوں کی منظوری دیں۔ ٹولز مینو سے ThunderPhone کو چیٹ میں شامل کریں۔
ایجنٹ یا فون نمبر حذف کرنے، ڈرافٹ مسترد کرنے، مہم شروع کرنے، اور بیرونی سسٹم میں لکھ سکنے والی ٹیسٹ درخواست بھیجنے کے لیے دونوں میں سے کسی بھی ایپ میں دوسری تصدیق درکار ہوتی ہے؛ تباہ کن اقدامات کی تصدیق دیکھیں۔
Claude Code
claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
--header "Authorization: Bearer $THUNDERPHONE_API_KEY"Codex
اسے ~/.codex/config.toml میں شامل کریں:
[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"Cursor
.cursor/mcp.json بنائیں:
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Claude Desktop
Claude Desktop کنفیگریشن میں mcp-remote برج شامل کریں:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.thunderphone.com/v1/mcp",
"--header",
"Authorization: Bearer ${THUNDERPHONE_API_KEY}"
],
"env": {
"THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
}
}
}
}VS Code
.vscode/mcp.json بنائیں اور VS Code کے ان پٹ پرامپٹ کے ذریعے کلید درج کریں:
{
"inputs": [
{
"type": "promptString",
"id": "thunderphone-api-key",
"description": "ThunderPhone organization API key",
"password": true
}
],
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${input:thunderphone-api-key}"
}
}
}
}ٹولز
ہر ٹول MCP تشریحات رکھتا ہے۔ جدولوں میں، R کا مطلب صرف پڑھنے کے لیے، D کا مطلب تخریبی، I کا مطلب یکساں نتیجہ دینے والا، اور O کا مطلب اوپن ورلڈ یا نیٹ ورک تعامل ہے۔ ڈیش کا مطلب ہے کہ کوئی اشارہ مقرر نہیں ہے۔
کنکشن
| ٹول | بنیادی آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
get_connection_identity | — | R, I | اسناد کی توثیق کرتا ہے اور اس کی تنظیم اور محفوظ اسناد کا میٹا ڈیٹا واپس کرتا ہے۔ |
ایجنٹس
| ٹول | بنیادی آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
list_agents | — | R, I | ایجنٹس کی فہرست دیتا ہے۔ |
get_agent | agent_id | R, I | ایک ایجنٹ حاصل کرتا ہے۔ |
create_agent | ایجنٹ کنفیگریشن | — | ایک ایجنٹ بناتا ہے۔ update_agent جیسی ہی سیٹنگز لیتا ہے، بشمول steps، handoffs، intro_clip اور intro_ring_count۔ |
update_agent | agent_id، تبدیل شدہ فیلڈز، اختیاری prompt_edits، expected_prompt_sha256 | D | ایجنٹ کے ڈرافٹ میں فیلڈز کو اس مواد کی جگہ مرحلہ وار شامل کرتا ہے جو ڈرافٹ میں پہلے موجود تھا۔ تصدیقی مرحلے کے بغیر چلتا ہے: تعینات کردہ ایجنٹ deploy_agent تک تبدیل نہیں ہوتا، اور discard_agent_draft ڈرافٹ کو واپس کر دیتا ہے۔ آپ max_hold_seconds، system_tool_settings اور words بھی سیٹ کر سکتے ہیں۔ پرامپٹ کا کوئی حصہ تبدیل کرنے کے لیے prompt_edits بھیجیں (پرامپٹ کو اسی جگہ ایڈٹ کرنا دیکھیں)۔ |
deploy_agent | agent_id، اختیاری if_updated_at | D, I | ڈرافٹ کو پروڈکشن میں منتقل کرتا ہے۔ |
discard_agent_draft | agent_id، اختیاری if_updated_at، دوسری درخواست پر confirmation_token | D, I | مرحلہ وار کی گئی تبدیلیاں مسترد کرتا ہے۔ دو مرحلوں پر مشتمل ہے، تباہ کن کارروائیوں کی تصدیق دیکھیں۔ |
duplicate_agent | agent_id، اختیاری name | — | تنظیم کے اندر ایک ایجنٹ کی کاپی بناتا ہے۔ |
delete_agent | agent_id، دوسری درخواست پر confirmation_token | D, I | ایک ایجنٹ کو مستقل طور پر حذف کرتا ہے۔ دو مرحلوں پر مشتمل ہے۔ |
list_agent_versions | agent_id | R, I | تعینات کردہ کنفیگریشن ورژنز کی فہرست دیتا ہے۔ |
list_prompt_revisions | agent_id، اختیاری source، limit، offset | R, I | ایجنٹ کے پرامپٹ متن میں ہونے والی ہر تبدیلی کی فہرست دیتا ہے، بشمول ڈرافٹس، اور ہر تبدیلی کے ساتھ اس ریویژن کے مقابلے میں فرق بھی دیتا ہے جسے اس نے تبدیل کیا۔ جب ایجنٹ اٹریشن ٹول کٹ آپ کے کنکشن کے لیے دستیاب ہو تو دستیاب ہے (نیچے دیکھیں)۔ |
review_prompt | agent_id، اختیاری prompt، previous_prompt، quote_id، max_cost_cents | — | ڈرافٹ پرامپٹ (یا آپ کے بھیجے ہوئے متن) کا پرامپٹ اسٹائل گائیڈ کے مطابق جائزہ لیتا ہے۔ ہر نتیجہ متعلقہ عبارت کا حوالہ دیتا ہے، رہنما اصول کا نام بتاتا ہے، اور تلاش کر کے تبدیل کرنے کی ایڈٹ پیش کرتا ہے؛ نتیجہ ان رویوں کی فہرست بھی دیتا ہے جو پرامپٹ طلب کرتا ہے، مستحکم ids کے ساتھ، آیا ری فیکٹر درکار ہے، اور ایجنٹ کے اپنے پرامپٹ کے لیے آیا اس کی ٹیسٹ گفتگوؤں کو تازہ کرنے کی ضرورت ہے۔ ایجنٹ میں کوئی تبدیلی نہیں کرتا؛ انوینٹری اس کے پرامپٹ ریویژن کے ساتھ محفوظ ہو جاتی ہے۔ یہ بامعاوضہ ہے، اس لیے اسے صرف پڑھنے کے لیے نشان زد نہیں کیا گیا: پہلے dry_run کے ساتھ اس کا کوٹ حاصل کریں، پھر dry_run کے بغیر، اس کے واپس کردہ quote_id اور max_cost_cents کے ساتھ دوبارہ چلائیں۔ یہ بامعاوضہ رنز اب دیگر ٹول کٹ رنز جیسی تنظیمی ٹول کٹ الاؤنس میں شمار ہوتے ہیں۔ جب ایجنٹ اٹریشن ٹول کٹ آپ کے کنکشن کے لیے دستیاب ہو تو دستیاب ہے (نیچے دیکھیں)۔ |
refactor_prompt | agent_id، اختیاری prompt، inventory، instructions، quote_id، max_cost_cents | — | پرامپٹ کو اسٹائل گائیڈ کی ساخت میں دوبارہ لکھتا ہے اور ہر رویے کو برقرار رکھا گیا، ضم کیا گیا، دوبارہ لکھا گیا یا ہٹا دیا گیا کے طور پر نقشہ بناتا ہے۔ نیا متن اور فرق واپس کرتا ہے، اور بطور ڈیفالٹ behavior_changes (شامل کیے گئے، ہٹائے گئے یا تبدیل کیے گئے) اور behavior_preserved کی رپورٹ کے لیے اسے دوبارہ پڑھتا ہے؛ اسے update_agent کے ذریعے لاگو کریں۔ بامعاوضہ: dry_run کے ساتھ اس کا کوٹ حاصل کریں، پھر اس کے واپس کردہ quote_id اور max_cost_cents کے ساتھ ایک بار چلائیں۔ جب ایجنٹ اٹریشن ٹول کٹ آپ کے کنکشن کے لیے دستیاب ہو تو دستیاب ہے (نیچے دیکھیں)۔ |
list_reusable_instructions | — | R, I | دوبارہ استعمال کے قابل ہدایات کی فہرست دیتا ہے: مشترکہ پرامپٹ قواعد جو update_agent کے reusable_instruction_ids کے ذریعے متعدد ایجنٹس کے ساتھ منسلک ہوتے ہیں۔ |
create_reusable_instruction | name، content | — | غیر منسلک دوبارہ استعمال کے قابل ہدایت بناتا ہے۔ صرف ایڈمنز کے لیے۔ |
فون نمبرز اور کیریئرز
| ٹول | بنیادی آرگیومینٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
list_phone_numbers | — | R, I | تنظیم کے نمبرز اور روٹنگ کی فہرست دکھاتا ہے۔ |
get_phone_number_limits | — | R, I | منظم نمبرز کے استعمال اور حدود حاصل کرتا ہے۔ |
provision_phone_number | اختیاری area_code، city، state، idempotency_key | D, O | ThunderPhone کے زیرِ انتظام آنے والا نمبر خریدتا ہے۔ |
list_voip_connections | — | R, I | منسلک کسٹمر کیریئرز کی فہرست دکھاتا ہے۔ |
search_voip_numbers | connection_id، country، type، اختیاری area_code | R, I, O | کیریئر انوینٹری میں تلاش کرتا ہے۔ |
import_voip_numbers | connection_id، numbers | D, O | کیریئر پر پہلے سے ملکیت میں موجود نمبرز درآمد کرتا ہے۔ |
update_phone_number | phone_number_id، روٹنگ/لیبل/webhook فیلڈز | D | ایجنٹ کی تفویض سمیت نمبر کی روٹنگ اپ ڈیٹ کرتا ہے۔ |
delete_phone_number | phone_number_id، confirm، اختیاری release_at_provider، دوسری درخواست پر confirmation_token | D, I, O | نمبر جاری کرتا ہے۔ دو مراحل۔ |
get_voip_setup_session | اختیاری session_id | R, I | رہنمائی شدہ کیریئر سیٹ اپ پڑھتا ہے (اسٹیٹس، چیک لسٹ، اور وہ سوال جس کا یہ انتظار کر رہا ہے)، یا کھلے سیٹ اپس کی فہرست دکھاتا ہے۔ سیٹ اپ ڈیش بورڈ میں شروع ہوتا ہے کیونکہ اسے کیریئر پاس ورڈ درکار ہوتا ہے۔ صرف ایڈمنز کے لیے۔ |
answer_voip_setup_question | session_id، question_id، answer | O | صارف کا جواب سیٹ اپ کو بھیجتا ہے۔ پاس ورڈز، ٹیسٹ کال کی رضامندی، سرور کا پتہ، صارف نام، اور ThunderPhone کو پرووائیڈر اکاؤنٹ میں سائن اِن کرنے کی اجازت کا جواب صرف سیٹ اپ وزرڈ میں دیا جاتا ہے؛ ان کے لیے یہ وزرڈ لنک واپس کرتا ہے اور کچھ نہیں بھیجتا۔ |
save_voip_setup | session_id، اختیاری name، دوسری درخواست پر confirmation_token | D, I, O | منسلک ڈرافٹ کنکشن محفوظ کرتا ہے تاکہ اسے استعمال کیا جا سکے۔ دو مراحل۔ |
check_phone_number | phone_number یا phone_number_id | R, I, O | شواہد کی بنیاد پر تنظیم کے اپنے نمبرز میں سے ایک کی تشخیص کرتا ہے: روٹنگ، کنکشن، تصدیق، حالیہ کیریئر اور ٹیسٹ کالز، اور کیریئر اسے کہاں بھیجتا ہے۔ |
SMS
| ٹول | مرکزی آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
send_sms | from_number, to, body, idempotency_key | D, I, O | منسلک Twilio یا Telnyx نمبر کے ذریعے ایک سادہ متنی SMS بھیجتا ہے۔ |
کالز
| ٹول | بنیادی آرگیومنٹس | حواشی | یہ کیا کرتا ہے |
|---|---|---|---|
list_calls | اختیاری فلٹرز، limit، offset | R, I | exclude_test_calls سمیت REST کال ہسٹری فلٹرز کے ساتھ کالز کی فہرست دیتا ہے۔ |
get_call | call_id | R, I | کال کی حیثیت اور میٹاڈیٹا حاصل کرتا ہے۔ |
get_call_transcript | call_id، اختیاری live | R, I | کال کا ٹرانسکرپٹ حاصل کرتا ہے۔ |
get_call_audio_url | call_id، اختیاری download | R, I, O | دستخط شدہ آڈیو URL واپس کرتا ہے؛ یہ کبھی بھی MCP کے ذریعے آڈیو اسٹریم نہیں کرتا۔ |
get_call_grade | call_id | R, I | کال کا تازہ ترین گریڈ حاصل کرتا ہے۔ |
place_call | agent_id، from_number، to_number | D, O | ایک ایسی آؤٹ باؤنڈ کال کرتا ہے جو دہرائے جانے پر یکساں نتیجہ نہیں دیتی۔ |
export_calls | کال فلٹرز، export_format | R, I | REST اینڈپوائنٹ کی حد تک JSON یا CSV میں ایکسپورٹ کرتا ہے۔ |
get_call_analytics | اختیاری since_days، agent_id | R, I | حقیقی کالز کو حیثیت، سمت، نتیجے، گریڈ اور مسئلے کے لحاظ سے جمع کرتا ہے، جبکہ ٹیسٹ کالز الگ شمار ہوتی ہیں۔ |
get_call_insights | call_ids (10 تک) | R, I | متعدد کالز کا گریڈ، نتیجہ، خلاصہ اور شناخت شدہ مسائل ایک ساتھ حاصل کرتا ہے۔ |
ٹیسٹنگ اور توثیق
| ٹول | بنیادی آرگومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
list_test_scenarios | agent_id | R, I | ٹیسٹ منظرناموں کی فہرست دیتا ہے۔ |
create_test_scenario | agent_id, title, scenario_prompt, اختیاری شرائط | — | ایک منظرنامہ بناتا ہے۔ |
generate_test_scenarios | agent_id, اختیاری count, include_edge_cases, locale | O | ایجنٹ کے prompt سے منظرنامے تیار کرتا ہے۔ |
run_agent_tests | agent_id, channel, consent_to_charge, اختیاری انتخاب/میٹرکس | D, O | ویب یا ٹیلی فونی کے ذریعے منظرنامے چلاتا ہے۔ |
get_test_run | agent_id, batch_id | R, I | بیچ کی حیثیت اور ہر منظرنامے کے نتائج حاصل کرتا ہے۔ |
test_my_agent | agent_id, consent_to_charge, اختیاری scenario_ids, count, wait_seconds | D, O | ایک کال میں ایجنٹ کی جانچ کرتا ہے: اس کے محفوظ کردہ منظرنامے چلاتا ہے، یا اگر کوئی نہ ہو تو کچھ تیار کرتا ہے، اور فیصلوں کے لیے ایک منٹ تک انتظار کرتا ہے، یا get_test_run کے لیے batch_id واپس کرتا ہے۔ چارجنگ run_agent_tests جیسی ہوتی ہے۔ |
test_in_text | agent_id, callers (1 سے 3 تفصیلات)، اختیاری version, direction | O | مفت ٹیکسٹ ٹیسٹ: مصنوعی کالرز حقیقی پائپ لائن کے ذریعے ٹیکسٹ میں ایجنٹ کے ڈرافٹ، یا لائیو ورژن، سے بات کرتے ہیں، اور ٹرانسکرپٹس تقریباً ایک منٹ میں واپس آ جاتے ہیں۔ ٹول کے نتائج مصنوعی ہوتے ہیں۔ |
run_simulation | agent_id, consent_to_charge, اختیاری scenario_prompt, direction, language | D, O | AI کالر اور ایجنٹ کے ڈرافٹ کے درمیان ایک مصنوعی فون کال شروع کرتا ہے تاکہ کوئی شخص تبدیلی سن سکے۔ رن کو in_progress حالت میں واپس کرتا ہے۔ جب ایجنٹ کالز ریکارڈ کرتا ہے تو یہ ریکارڈ ہوتی ہے، اور ختم ہونے کے بعد گریڈ کی جاتی ہے۔ ٹیسٹ کال کی طرح چارج ہوتا ہے، پہلے مفت ٹیسٹ بجٹ سے۔ |
get_simulation | simulation_id | R, I | مصنوعی کال کی حیثیت اور، ختم ہونے پر، اس کی پیداوار حاصل کرتا ہے: مختصر مدت کے لیے دستیاب ریکارڈنگ URL اور، جب ایجنٹ کالز ریکارڈ کرتا ہے، ٹرانسکرپٹ؛ نیز گریڈنگ مکمل ہونے پر گریڈ (null اس سے پہلے)۔ |
list_validation_runs | agent_id | R, I | حالیہ ڈرافٹ ویلیڈیشن رنز کی فہرست دیتا ہے۔ |
get_validation_status | agent_id | R, I | تازہ ترین ویلیڈیشن حالت اور ڈرافٹ میچ حاصل کرتا ہے۔ |
list_conversations | agent_id, اختیاری split, source | R, I | ان گفتگوؤں کی فہرست دیتا ہے جن کے خلاف ایجنٹ کی جانچ ہوتی ہے۔ ایجنٹ iteration toolkit درکار ہے۔ |
get_conversation | conversation_id | R, I | ایک ٹیسٹ گفتگو کو اس کے موجودہ ٹرنز کے ساتھ حاصل کرتا ہے۔ ایجنٹ iteration toolkit درکار ہے۔ |
get_conversation_revisions | conversation_id, اختیاری limit, offset | R, I | ٹیسٹ گفتگو کی ہر ترمیم کی فہرست دیتا ہے: یہ کیسے اور کیوں بدلی، مثلاً prompt کی تبدیلی پر ریفریش ہوئی یا پچھلی ترمیم سے بحال ہوئی، شامل، حذف اور تبدیل شدہ رویے، منتقل یا ریٹائر کیے گئے مثالیں، اور قطار کا فرق۔ ایجنٹ iteration toolkit درکار ہے۔ |
generate_conversations | agent_id, اختیاری count, style | O | ایجنٹ کے ڈرافٹ کے خلاف مصنوعی ٹیسٹ گفتگوئیں لکھتا ہے اور ان کے مشکل ترین لمحات کو جواب کی کلیدوں کے ساتھ ویلیڈیشن مثالوں میں بدلتا ہے۔ پہلے dry_run کے ذریعے تخمینہ لیں؛ حقیقی رن کے لیے اس کا quote_id اور max_cost_cents درکار ہے۔ ایجنٹ iteration toolkit درکار ہے۔ |
import_conversations | agent_id, اختیاری since_days, max_calls | O | ایجنٹ کی حالیہ کالز کو ٹیسٹ گفتگوؤں میں بدلتا ہے، ہر کالر کے لیے زیادہ سے زیادہ دو، اور ریکارڈنگ بند والی کالز کو چھوڑ دیتا ہے، پھر ان کے مشکل ترین لمحات کو مثالوں میں بدلتا ہے۔ پہلے dry_run کے ذریعے تخمینہ لیں؛ حقیقی رن کے لیے اس کا quote_id اور max_cost_cents درکار ہے۔ ایجنٹ iteration toolkit درکار ہے۔ |
refresh_conversations | agent_id, اختیاری conversation_ids, from_prompt_revision_id | O | رویے شامل، حذف یا تبدیل ہونے کے بعد ایجنٹ کی ٹیسٹ گفتگوؤں کو اس کے موجودہ prompt کے مطابق کرتا ہے: دوبارہ منسلک کرتا ہے، پچھلی ترمیم کو، حقیقی آڈیو سمیت، بحال کرتا ہے یا پرانے ٹرنز دوبارہ لکھتا ہے، اور ان مثالوں کو ریٹائر کرتا ہے جن کا کالر ٹرن ختم ہو چکا ہو۔ پہلے dry_run کے ذریعے تخمینہ لیں؛ حقیقی رن کے لیے اس کا quote_id اور max_cost_cents درکار ہے۔ ایجنٹ iteration toolkit درکار ہے۔ |
get_conversation_job | job_id | R, I | generate، import یا refresh جاب حاصل کرتا ہے: حیثیت، اب تک کی لاگت بمقابلہ اس کی حد، اور اس نے کیا لکھا یا ریفریش کیا۔ ایجنٹ iteration toolkit درکار ہے۔ |
run_replays | agent_id, اختیاری overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, O | ایجنٹ کی مثالوں کے ایک نمونے کو اس کے ڈرافٹ کے تحت، یا امیدوار prompt، آواز یا ٹئیر جیسے overrides کے تحت دوبارہ چلاتا ہے، اور ہر جواب کو مثال کی جواب کلید کے مقابل جانچتا ہے۔ عین ری پلے ٹرن کی ریکارڈ شدہ آڈیو کو ویسے چلاتے ہیں جیسے لائیو کال چلتی ہے؛ پاس کی شرحیں ہر انجن کے لحاظ سے رپورٹ ہوتی ہیں۔ PHI کالز کے ری پلے PHI کے طور پر چلتے ہیں، اور ایسی کنفیگریشن جس پر وہ نہیں چل سکتے، جیسے ElevenLabs کی آواز یا تجرباتی پروڈکٹ، مسترد کر دی جاتی ہے۔ dry_run ایک تخمینہ، اس کا منتخب کردہ sample_seed اور quote_id واپس کرتا ہے؛ حقیقی رن اسی quote_id اور sample_seed کے ساتھ وہی درخواست، اور سخت حد max_cost_cents، بھیجتا ہے: ہر درخواست بھیجنے سے پہلے اپنی بالائی حد محفوظ رکھتی ہے، اور رن کسی ناموزوں درخواست کو بھیجنے کے بجائے رک جاتا ہے، اس لیے ہر ورکر کے لیے تخمینے کے largest_reservation_cents جتنی گنجائش رکھیں۔ ایک عین ری پلے اپنے بدترین ممکنہ خرچ کے لیے، عام ٹرن میں بیک وقت چلنے والے ہر ری پلے کے لیے تقریباً 85 سینٹ سے 1.25 ڈالر تک، دو ایک ساتھ چلتے ہیں، محفوظ رکھتا ہے، جبکہ حقیقی لاگت چند سینٹ ہوتی ہے؛ رن سے ری پلے کی اصل لاگت وصول کی جاتی ہے، اس لیے max_cost_cents میں گنجائش رکھیں۔ عین ری پلے ایک ایسے بجٹ کے تحت چلتا ہے جو عام ٹرن اور پروڈکشن میں ہونے والی قسم کے ایک دوبارہ رن، جواب کی دوبارہ ریس اور watchdog retry، کے لیے مقرر ہو؛ جس ٹرن کو اس سے زیادہ درکار ہو اسے replay_budget_exhausted خرابی کے طور پر ریکارڈ کیا جاتا ہے، budget_exhausted کے طور پر الگ شمار کیا جاتا ہے، پاس کی شرح میں شامل نہیں کیا جاتا اور ٹیسٹ اسپلٹ پر کوئی cohort خرچ نہیں کرتا۔ ٹیسٹ اسپلٹ پر Bolt v2 کے علاوہ کسی کنفیگریشن کے تحت ریکارڈ شدہ کالر آڈیو والا cohort مسترد ہو جاتا ہے (test_needs_exact_replay) اور غیر استعمال شدہ رہتا ہے: اس کنفیگریشن کو dev اسپلٹ پر ناپیں۔ ایجنٹ iteration toolkit درکار ہے۔ |
compare_configs | agent_id, configs (2 سے 4، پہلا baseline ہے)، اختیاری sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | ہر کنفیگریشن کے تحت انہی مثالوں کو دوبارہ چلاتا ہے اور پاس کی شرح، baseline کے مقابل درست اور خراب ہونے والی مثالیں، پہلی آڈیو تک تاخیر، کالر کے acknowledgement، ٹکس یا خاموشی کے لیے انتظار کی تعداد، اور ہر انجن کے لحاظ سے فی ٹرن لاگت رپورٹ کرتا ہے۔ run_replays کی طرح dry_run کے ذریعے تخمینہ لیں۔ صرف dev اسپلٹ کے لیے: ٹیسٹ اسپلٹ پر یہ مسترد ہوتا ہے (comparison_dev_only)؛ dev پر موازنہ کریں، پھر منتخب کنفیگریشن کو run_replays سے ناپیں۔ ایجنٹ iteration toolkit درکار ہے۔ |
get_replay_run | run_id, اختیاری include_trace | R, I | ری پلے رن کے کل، تبدیلیاں اور ہر مثال کے نتائج، نیز اس کا موازنہ گروپ حاصل کرتا ہے۔ وہ عین ری پلے جنہیں اپنے بجٹ سے زیادہ درکار تھا، budget_exhausted کے طور پر الگ، پاس کی شرح سے باہر، شمار ہوتے ہیں۔ ایجنٹ iteration toolkit درکار ہے۔ |
create_talk_link | agent_id, اختیاری variant_id, language, expires_in_minutes | O | ایک بار استعمال ہونے والا لنک بناتا ہے جسے کوئی شخص براؤزر میں کھول کر ایجنٹ کے موجودہ ڈرافٹ سے بات کر سکتا ہے، بالکل ڈیش بورڈ کے Talk بٹن کی طرح۔ لنک بطور ڈیفالٹ 30 منٹ بعد، زیادہ سے زیادہ 120 منٹ میں، ختم ہو جاتا ہے؛ گفتگو پر Talk ٹیسٹ کال کی طرح چارج ہوتا ہے۔ Talk لنکس دیکھیں۔ |
جن ٹولز کے لیے ایجنٹ اٹریشن ٹول کٹ درکار ہونے کی نشان دہی کی گئی ہے، وہ اسی کا حصہ ہیں؛ یہ ٹول کٹ بیٹا مرحلے میں ہر تنظیم کے لیے الگ سے فعال کی جاتی ہے، اور اس کے بغیر یہ اگلے اقدامات کی معلومات کے ساتھ feature_not_enabled واپس کرتے ہیں۔ ایجنٹ کی ہر گفتگو اس کے ڈیویلپمنٹ اسپلٹ یا ٹیسٹ اسپلٹ میں ہوتی ہے۔ ٹیسٹ اسپلٹ تبدیلی کی پیمائش کے لیے ہے، اسے بہتر بنانے کے لیے نہیں، اس لیے گفتگو کے ٹولز ٹیسٹ اسپلٹ کی گفتگو کو صرف اس کی آئی ڈی، اسپلٹ، ماخذ، حالت اور گنتیوں کے ساتھ واپس کرتے ہیں۔ ٹیسٹ اسپلٹ پر ری پلے رن ایک مکمل ٹیسٹ کوہورٹ کو ری پلے کرتا ہے (sample_size اور sample_seed نظر انداز کیے جاتے ہیں)، ہر مثال کو اس انجن پر جس کی اس کا ڈیٹا اجازت دیتا ہے، جو رن سے پہلے مثال کی بنیاد پر مقرر ہوتا ہے (ریکارڈ شدہ کالر آڈیو کے لیے عین، صرف متن والی مثال کے لیے متن؛ Bolt v2 کے علاوہ کسی کنفیگریشن کے لیے عین راستہ موجود نہیں، اس لیے ریکارڈ شدہ آڈیو والے کوہورٹ کو اس کے لیے test_needs_exact_replay کے ساتھ مسترد کر دیا جاتا ہے اور وہ غیر استعمال شدہ رہتا ہے؛ engine کو چھوڑ دیا جاتا ہے یا auto رکھا جاتا ہے، کیونکہ exact یا text کو test_engine_per_example کے ساتھ مسترد کیا جاتا ہے، اور کچھ بھی متن پر واپس نہیں جاتا)، اور ہر انجن کے لیے صرف مجموعے واپس کرتا ہے: پاس ہونے کی شرح، شدت اور قسم کے لحاظ سے ناکامیاں، تاخیر اور لاگت۔ اس کا پہلا نتیجہ جو ری پلے محفوظ کرتا ہے کوہورٹ کو استعمال کر دیتا ہے، اس لیے اگلا ٹیسٹ رن، کسی بھی پرامپٹ کے لیے، دوسرا کوہورٹ لیتا ہے، اور کوئی باقی نہ ہو تو اسے no_test_cohort کے ساتھ مسترد کر دیا جاتا ہے (کالز درآمد کرنے یا گفتگوئیں بنانے سے نئے کوہورٹس بھر جاتے ہیں)؛ ایسا رن جو ایک ری پلے محفوظ کرنے سے پہلے ختم ہو جائے (Core اپنے آڈیو مثالوں کو عین طور پر ری پلے نہیں کر سکتا، exact_replay_unavailable، اس کی ری پلے صلاحیت مصروف رہتی ہے، core_busy، یا ہر ٹرن کا بجٹ ختم ہو جاتا ہے، replay_budget_exhausted) کوہورٹ کو غیر استعمال شدہ چھوڑ دیتا ہے۔ ڈیویلپمنٹ اسپلٹ پر، وہ عین ری پلے جسے Core نہیں چلا سکتا متن پر واپس آ جاتا ہے اور رن کو degraded کے طور پر نشان زد کیا جاتا ہے۔ موازنات صرف ڈیویلپمنٹ اسپلٹ پر چلتے ہیں۔ ہر بامعاوضہ ٹول اپنے ڈرائی رن کا quote_id لیتا ہے، جو ایک رن کے لیے کارآمد ہوتا ہے: رن شروع ہوتے ہی اسے مستقل طور پر ایک بار استعمال کر لیا جاتا ہے، اور ایسا آغاز جو مسترد ہو یا اس سے پہلے ناکام ہو جائے اسے قابل استعمال چھوڑ دیتا ہے؛ ایسا رن جو اس کے بعد ناکام ہو، اسے نئے quote_id کے لیے نئے ڈرائی رن کے ساتھ دہرایا جاتا ہے۔ OAuth کے ساتھ، review_prompt اور refactor_prompt کو، ڈرائی رنز سمیت، agents:write اسکوپ درکار ہوتا ہے، اور گفتگو اور ری پلے ٹولز کو چلانے کے لیے testing:write درکار ہوتا ہے۔ لوگ ڈیش بورڈ میں مکمل ٹیسٹ اسپلٹ دیکھتے ہیں۔ وہ کال جس کا کالر کسی ایجنٹ کے ٹیسٹ اسپلٹ میں ہو، علیحدہ رکھی جاتی ہے کیونکہ وہ ٹیسٹ سیٹ کا حصہ ہوتی ہے۔ ٹول کٹ والی تنظیم میں، list_calls، get_call، get_call_transcript، get_call_audio_url، get_call_grade اور export_calls اسے اس کے ٹرانسکرپٹ، ریکارڈنگ، ہسٹری، گریڈ یا رپورٹ کے بغیر عین {"call_id", "start_time", "held_out": true} کے طور پر واپس کرتے ہیں (ایکسپورٹ کی قطاروں میں start_time کی جگہ started_at)؛ کال کا ہر دوسرا فیلڈ موجود نہیں ہوتا، اس لیے کسی روکی گئی قطار کو کسی بھی دوسری چیز سے پہلے اس کے held_out سے پڑھیں۔ REST API، API کیز اور OAuth ٹوکنز کے لیے بھی یہی کرتا ہے، اور متعدد کالز پر اس کے ویوز (رپورٹ خلاصے، مسئلے کے کلسٹرز، تحقیقات، پائپ لائن رپورٹس) روکی گئی کالز کو اپنی گنتیوں، کلسٹرز اور نمونوں سے خارج رکھتے ہیں، اور ماڈل کے ان سے لکھے گئے کسی بھی متن کو روک لیتے ہیں۔ روکی گئی کال پر لکھنے کی کارروائی (گریڈنگ، اسے ٹیسٹ منظرنامے میں ترقی دینا، ٹرن دوبارہ بنانا) کو held_out_call کے ساتھ مسترد کر دیا جاتا ہے۔ روکی گئی کال سے کسی کے ترقی دیے ہوئے ٹیسٹ منظرنامے کو list_test_scenarios اور ٹیسٹ رنز میں عین {"id", "held_out": true} کے طور پر واپس کیا جاتا ہے، اور اس سے بننے والے سمولیشن رن کو get_test_run اور سمولیشن ٹولز سے عین {"id", "scenario_id", "held_out": true} کے طور پر واپس کیا جاتا ہے؛ اس کی سمولیٹڈ کالز بھی علیحدہ رکھی جاتی ہیں، اور ٹیسٹ رنز پھر بھی اسے چلاتے ہیں۔ روکی گئی کالر کال سے نقل کی گئی ڈیویلپمنٹ گفتگو، مثال یا ری پلے نتیجہ (اسپلٹس ہر ایجنٹ کے لیے ہوتے ہیں، اس لیے وہ کالر کسی دوسرے ایجنٹ کے ٹیسٹ اسپلٹ میں ہو سکتا ہے) ٹیسٹ اسپلٹ والے کی طرح پڑھا جاتا ہے۔ لوگ ڈیش بورڈ میں روکی گئی کالز مکمل طور پر دیکھتے ہیں، اور ایک منتظم کسی ایک API کی کو انہیں مکمل طور پر دیکھنے کی اجازت دے سکتا ہے (include_held_out_calls، بطور ڈیفالٹ بند، صرف ڈیش بورڈ میں مقرر کیا جاتا ہے)، اس انضمام کے لیے جسے ہر کال درکار ہو؛ MCP اسے کبھی استعمال نہیں کرتا۔ ویب ہکس میں کوئی تبدیلی نہیں ہے۔ ٹول کٹ کے بغیر تنظیموں کو کوئی held_out فیلڈ نظر نہیں آتا اور کوئی تبدیلی نہیں ہوتی۔
generate_conversations، import_conversations اور refresh_conversations ماڈل کریڈٹس خرچ کرتے ہیں۔ پہلے انہیں dry_run: true کے ساتھ کال کریں: جواب میں مرحلہ وار لاگت کا کوٹ، ایک quote_id ہوتا ہے، اور کچھ نہیں چلتا۔ کوٹ عام سائز پر ان تمام درخواستوں کو شمار کرتا ہے جو رن کر سکتا ہے۔ حقیقی رن کے لیے وہ quote_id درکار ہے (یہ 15 منٹ بعد ختم ہو جاتا ہے اور صرف انہی آرگومنٹس کے ساتھ کام کرتا ہے) اور max_cost_cents، جو ایک سخت حد ہے: ہر درخواست سے پہلے جاب اس درخواست کی ممکنہ زیادہ سے زیادہ لاگت مختص کرتا ہے، اور جو درخواست اس حد میں پوری نہ اترے اسے بھیجنے کے بجائے رک جاتا ہے، جبکہ جو لکھا جا چکا ہو اسے محفوظ رکھتا ہے۔ اس مختص کرنے کی وجہ سے، رن اپنی حد میں سے کچھ حصہ خرچ کیے بغیر رک سکتا ہے؛ کوٹ کا largest_reservation_cents بتاتا ہے کہ کتنی اضافی گنجائش چھوڑنی ہے۔ نقلی کالرز ایجنٹ کے prompt سے بنائے جاتے ہیں؛ style: "adversarial" ایسے مشکل کالرز لکھتا ہے جو prompt کے کمزور پہلوؤں پر دباؤ ڈالتے ہیں، اور یہ گفتگوئیں ہمیشہ ڈیولپمنٹ اسپلٹ میں جاتی ہیں۔ target: "changed_behaviors" کالرز کو آخری prompt ترمیم میں تبدیل ہونے والی چیزوں کی طرف مرکوز کرتا ہے۔ ہر ایجنٹ ایک وقت میں ان جابز میں سے ایک یا ایک ری پلے رن چلاتا ہے، اس لیے ریفریش کبھی ان مثالوں کو تبدیل نہیں کرتا جن پر ری پلے چل رہا ہو؛ جب دوسرا چل رہا ہو تو شروع کرنے پر job_active، replay_run_active یا conversation_job_active واپس ملتا ہے، ساتھ ہی یہ بھی کہ کس چیز کا انتظار کرنا ہے۔
ایسی prompt ترمیم کے بعد جو کسی رویے کو شامل، حذف یا تبدیل کرے، ایجنٹ کے ڈرافٹ پر review_prompt رپورٹ کرتا ہے کہ کتنی ٹیسٹ گفتگوئیں دوسرے رویوں والے prompt کے لیے لکھی گئی تھیں (conversations.refresh_suggested)۔ پھر refresh_conversations انہیں ڈرافٹ کے مطابق کر دیتا ہے، تاکہ ڈیولپمنٹ اور ٹیسٹ سیٹس نئی prompt کو ان ہسٹریز پر ناپیں جو اس سے پیدا ہو سکتی تھیں۔ ریفریش کبھی کچھ کھوتا نہیں: ہر گفتگو اپنی ہر سابقہ ترمیم برقرار رکھتی ہے، اور جب حذف کیا گیا کوئی اصول واپس آتا ہے تو جس ترمیم میں وہ موجود تھا اسے اس کے اصل کالر آڈیو کے ساتھ بحال کر دیا جاتا ہے۔ کوڈنگ ایجنٹ کے شروع کردہ ریفریش میں ٹیسٹ اسپلٹ کی گفتگوئیں، اور روکے گئے کالز سے نقل کی گئی گفتگوئیں، انتخاب، کوٹ، پیش رفت اور لاگت سے خارج رہتی ہیں؛ conversation_ids میں ان میں سے کسی کا نام دینے پر 403 test_conversation واپس ملتا ہے۔ ایک شخص انہیں ڈیش بورڈ سے ریفریش کرتا ہے، اور کوڈنگ ایجنٹس کو اس جاب کے نتائج میں وہ صرف شناخت کنندگان اور گنتیوں کے طور پر دکھائی دیتی ہیں۔ active مثال جس کی ہسٹری، جواب یا جوابی کلید کو ریفریش دوبارہ لکھے، pending_review پر واپس چلی جاتی ہے اور اسے refreshed_needs_review کا لیبل دیا جاتا ہے۔ ریفریش کا کوٹ ہر اس گفتگو کی قیمت ایسے لگاتا ہے جیسے اسے دوبارہ لکھا جا رہا ہو، ہر ماڈل کال کی اس کی آؤٹ پٹ حد پر، اور یہ اس prompt اور ان گفتگوؤں کے لیے برقرار رہتا ہے جن پر اس کا کوٹ دیا گیا تھا: رن سے پہلے ان میں سے کوئی بھی تبدیل ہو تو دوبارہ کوٹ کریں؛ جب رن کے دوران prompt تبدیل ہو تو جاب failed کے طور پر رک جاتی ہے، جبکہ جو کچھ اس نے ریفریش کیا ہو اسے محفوظ رکھتی ہے۔
نالج
| ٹول | بنیادی آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
list_knowledge_bases | — | R, I | نالج بیسز کی فہرست دیتا ہے۔ |
create_knowledge_base | name, اختیاری description | — | ایک نالج بیس بناتا ہے۔ |
add_knowledge_document | knowledge_base_id, name, content | — | متن یا Markdown شامل کرتا ہے۔ |
import_knowledge_url | url, اختیاری name | O | محفوظ ادخال کے لیے ایک عوامی صفحہ قطار میں شامل کرتا ہے۔ |
search_knowledge | knowledge_base_id, query | R, I | پروڈکشن ریٹریول میں تلاش کرتا ہے۔ |
انٹیگریشنز، webhooks، اور ریموٹ MCP سرورز
| ٹول | اہم آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
list_integrations | — | R, I | HTTP فنکشن انٹیگریشنز کی فہرست دکھاتا ہے۔ |
create_integration | display_name، فنکشن spec، اختیاری اینڈپوائنٹ فیلڈز | — | ایک HTTP ٹول بناتا ہے۔ ڈیش بورڈ میں تصدیقی ہیڈرز شامل کریں۔ |
test_integration | url، اختیاری طریقہ/باڈی/ٹائم آؤٹ، header_names کے ساتھ integration_id، دوسری درخواست پر confirmation_token | D, O | ایک محدود، SSRF سے محفوظ ٹیسٹ درخواست بھیجتا ہے۔ محفوظ کردہ ہیڈر ویلیوز انٹیگریشن سے بھری جاتی ہیں اور صرف اس کے اپنے ہوسٹ کو بھیجی جاتی ہیں۔ POST (ڈیفالٹ)، PUT، PATCH اور DELETE دو مرحلوں پر مشتمل ہیں؛ GET فوراً چلتا ہے۔ |
list_webhook_endpoints | — | R, I | دستخط شدہ ویب ہک اینڈپوائنٹس کی فہرست دکھاتا ہے۔ |
list_webhook_deliveries | اختیاری agent_id، اختیاری endpoint_id | R, I | پےلوڈ کے بغیر حالیہ ویب ہک ڈیلیوری نتائج کی فہرست دکھاتا ہے۔ |
create_webhook_endpoint | label، url، اختیاری ایونٹس/اسٹیٹس | O | ایک دستخط شدہ ویب ہک اینڈپوائنٹ بناتا ہے۔ |
copy_webhook_endpoint | endpoint_id، target_agent_id | I | ایک ایجنٹ کا ویب ہک، دستخطی راز سمیت، سرور پر موجود دوسرے ایجنٹ میں کاپی کرتا ہے۔ صرف منتظمین کے لیے۔ |
test_webhook_endpoint | endpoint_id | O | عام ڈیلیوری کے ذریعے ایک مصنوعی ایونٹ بھیجتا ہے۔ |
list_mcp_servers | — | R, I | وائس ایجنٹس کے ذریعے قابلِ کال ریموٹ سرورز کی فہرست دکھاتا ہے۔ |
create_mcp_server | display_name، url | O | ایک ریموٹ سرور رجسٹر اور ہم آہنگ کرتا ہے۔ جن سرورز کو تصدیقی ہیڈرز درکار ہوں، انہیں ڈیش بورڈ میں شامل کیا جاتا ہے۔ |
sync_mcp_server_tools | server_id | D, O | ایک ریموٹ سرور کے ٹول کیٹلاگ کو تازہ کرتا ہے۔ |
مہمات
| ٹول | بنیادی آرگومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
list_campaigns | — | R, I | آؤٹ باؤنڈ مہمات کی فہرست دیتا ہے۔ |
create_campaign | مہم کے فیلڈز | — | ایک ڈرافٹ مہم بناتا ہے۔ |
add_campaign_contacts | campaign_id, contacts | — | 5,000 تک JSON رابطے شامل کرتا ہے۔ |
campaign_action | campaign_id, action، اختیاری consent_to_charge، دوسری درخواست پر confirmation_token | D, O | start، pause، resume، یا stop چلاتا ہے۔ start اور resume دو مرحلوں پر مشتمل ہیں؛ pause اور stop فوراً چلتے ہیں۔ |
get_campaign_stats | campaign_id | R, I | کاؤنٹرز اور حالیہ نتائج حاصل کرتا ہے۔ |
check_campaign | اختیاری campaign_id، contact_phone_number، contact_status | R, I | وضاحت کرتا ہے کہ مہم کال کیوں نہیں کر رہی: اس کے اپنے ٹائم زون میں کال کرنے کی ونڈو، اس وقت واجب الادا رابطے، اور ڈائلنگ کو کیا روک رہا ہے۔ |
تنظیم کی ترتیبات اور بلاک کیے گئے کالرز
| ٹول | بنیادی آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
get_org_settings | — | R, I | ٹائم زون، کاروباری اوقات، ٹیسٹ نمبرز، کال نتیجے کے لیبلز، اسٹیٹس کے نام اور کون سے الرٹس بند ہیں، updated_at کے ساتھ پڑھتا ہے۔ |
update_org_settings | تبدیل شدہ ترتیبات، if_updated_at، طلب کیے جانے پر confirmation_token | D, I | انہیں تبدیل کرتا ہے (صرف منتظمین)۔ فہرستیں اور آبجیکٹس محفوظ شدہ قدر کی جگہ لے لیتے ہیں۔ کسی الرٹ کو بند کرنا یا ٹیسٹ نمبر شامل کرنا دو مرحلوں کا عمل ہے۔ نتیجے میں واپس کرنے کے لیے سابقہ قدریں ہوتی ہیں۔ |
get_account_limits | — | R, I | پلیٹ فارم کی حدود اس تنظیم کی اپنی قدروں کے ساتھ حاصل کرتا ہے۔ |
list_blocked_callers | اختیاری number، search | R, I | بلاک کیے گئے کالر نمبرز کی فہرست دیتا ہے۔ |
block_callers | numbers، اختیاری note، دوسری درخواست پر confirmation_token | D, I | کسی بھی ایجنٹ کے جواب دینے سے پہلے ان نمبرز سے کالز مسترد کرتا ہے۔ دو مرحلوں کا عمل، صرف منتظمین۔ |
unblock_callers | numbers، دوسری درخواست پر confirmation_token | D, I | نمبرز کو بلاک فہرست سے ہٹاتا ہے۔ دو مرحلوں کا عمل، صرف منتظمین۔ |
get_org_settings، update_org_settings اور get_account_limits کو org:read یا org:write OAuth اسکوپ درکار ہوتا ہے؛ ان کے موجود ہونے سے پہلے بنایا گیا کنکشن پہلی بار استعمال پر اسے منظور کرنے کے لیے کہا جاتا ہے۔
صلاحیتیں، مدد اور امپورٹس
| ٹول | بنیادی آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
get_supported_languages | — | R, I | ایجنٹس جن زبانوں میں بات کرتے ہیں، ان کی فہرست کوڈز کے ساتھ دیتا ہے۔ |
get_agent_capabilities | — | R, I | بتاتا ہے کہ ایجنٹ کال پر کیا کر سکتا ہے اور کون سی ترتیبات اور انضمامات موجود ہیں۔ |
escalate_to_human | summary | O | ThunderPhone ٹیم سے مدد مانگتا ہے۔ وہ ThunderPhone میں جواب دیتے ہیں۔ ایسی تنظیموں کے لیے جو PHI ہینڈل کر سکتی ہیں، صرف ایک غیر جانبدار نوٹ ThunderPhone سے باہر جاتا ہے۔ |
request_feature | title، request، details | O | ThunderPhone ٹیم کے ساتھ فیچر کی درخواست درج کرتا ہے۔ ایک تنظیم کے لیے روزانہ زیادہ سے زیادہ تین۔ |
start_agent_import | platform | R, I | ڈیش بورڈ کا وہ لنک واپس کرتا ہے جہاں آپ اپنی Vapi، Retell، ElevenLabs یا Bland کلید درج کرتے اور ایجنٹس منتخب کرتے ہیں۔ کوئی ٹول کلید قبول نہیں کرتا۔ |
get_agent_import | اختیاری import_id | R, I | حالیہ امپورٹس، یا ایک امپورٹ کی اسٹیٹس اور میپ کیے گئے ایجنٹس کی فہرست دیتا ہے۔ |
commit_agent_import | import_id، اختیاری item_ids | O | تیار امپورٹ سے ایجنٹس کو پس منظر میں بناتا ہے۔ صرف منتظمین۔ |
آوازیں، بلنگ، اور دستاویزات
| ٹول | بنیادی آرگیومنٹس | تشریحات | یہ کیا کرتا ہے |
|---|---|---|---|
list_voices | — | R, I | آوازوں اور معاون زبانوں کی فہرست دیتا ہے۔ |
preview_voice | voice, language, text | O | ایک نمونہ تیار کرتا ہے اور دستخط شدہ URL واپس کرتا ہے۔ |
list_voice_clones | — | R, I | حسبِ ضرورت وائس کلونز کی فہرست دیتا ہے۔ |
get_billing_summary | — | R, I | بیلنس اور مستند ٹئیر قیمتیں حاصل کرتا ہے؛ ادائیگی میں کوئی تبدیلی دستیاب نہیں ہے۔ |
search_docs | query، اختیاری limit | R, I, O | عوامی دستاویزات کے انڈیکس میں تلاش کرتا ہے۔ |
get_doc_page | path | R, I, O | ایک عوامی Markdown دستاویزات کا صفحہ حاصل کرتا ہے۔ |
ایجنٹ، کال، نمبر، مہم یا ترتیب سے متعلق نتائج میں web_url شامل ہوتا ہے، جو متعلقہ ڈیش بورڈ صفحہ ہے، تاکہ آپ اسے ThunderPhone میں کھول سکیں یا وہاں Zeus کے ساتھ جاری رکھ سکیں۔
تمام پروڈکٹ ٹولز عوامی API جیسے ہی REST کوڈ پاتھز استعمال کرتے ہیں۔ لہٰذا REST توثیق، تنظیمی اسکوپنگ، کردار، بلنگ داخلہ، کوٹے، TCPA تصدیق، فراہم کنندہ کی حفاظت، اور آڈٹ رویہ بغیر تبدیلی کے لاگو ہوتے ہیں۔
prompt کو اسی جگہ ترمیم کرنا
update_agent پورا متن واپس بھیجے بغیر ڈرافٹ prompt کے کسی حصے کو تبدیل کر سکتا ہے۔ prompt_edits تلاش اور تبدیلی کے جوڑوں کی ایک ترتیبی فہرست ہے، وہی فارمیٹ جو review_prompt اور refactor_prompt واپس کرتے ہیں:
{
"agent_id": 123,
"expected_prompt_sha256": "9c1f…",
"prompt_edits": [
{
"find": "Ask for their name and their phone number, then tell them we will call back.",
"replace": "Tell them we will call back, then ask for their name. Once they answer, ask for their phone number."
}
]
}سرور ایجنٹ کے موجودہ ڈرافٹ prompt پر ترمیمات کو ترتیب سے لاگو کرتا ہے (اگر ڈرافٹ موجود نہ ہو تو تعینات prompt پر) اور نتیجہ پورے prompt کے update_agent والے ہی راستے سے ڈرافٹ میں لکھتا ہے۔ ہر find اس وقت prompt میں عین ایک بار موجود ہونا چاہیے جب اس ترمیم کی باری آئے۔ اگر ایسا نہ ہو تو کچھ بھی نہیں لکھا جاتا اور خرابی ترمیم کا نام بتاتی ہے:
| کوڈ | مطلب | کیا کریں |
|---|---|---|
prompt_edit_not_found | find متن موجودہ ڈرافٹ prompt میں نہیں ہے۔ edit_index بتاتا ہے کہ کون سی ترمیم ہے۔ | ایجنٹ کو دوبارہ پڑھیں اور عبارت کو بالکل اسی طرح نقل کریں۔ |
prompt_edit_ambiguous | find متن ایک سے زیادہ بار ظاہر ہوتا ہے۔ occurrences بتاتا ہے کہ کتنی بار۔ | اردگرد کے متن کا مزید حصہ شامل کریں۔ |
stale_prompt | expected_prompt_sha256 موجودہ ڈرافٹ prompt کا SHA-256 نہیں ہے: آپ کے اسے پڑھنے کے بعد یہ تبدیل ہو گیا۔ | ایجنٹ کو دوبارہ پڑھیں، موجودہ متن کے مطابق تبدیلی دوبارہ لکھیں، اور اس کا SHA-256 بھیجیں۔ |
conflict | سرور کے ڈرافٹ پڑھنے اور اسے لکھنے کے درمیان ایک اور تحریر آ گئی۔ | دوبارہ کوشش کریں؛ اس کال نے ڈرافٹ تبدیل نہیں کیا۔ |
expected_prompt_sha256 اختیاری ہے اور پورے prompt کی تحریر کی بھی حفاظت کرتا ہے۔ review_prompt سے prompt_sha256 یا refactor_prompt سے source_prompt_sha256 استعمال کریں۔ prompt تبدیل کرنے والی کوئی بھی کال نئے متن کے لیے prompt_sha256، جب سرور نے پہلے ڈرافٹ پڑھا ہو تو previous_prompt_sha256، اور تبدیلی سے پہلے کے متن پر previous_prompt سیٹ کر کے review_prompt کی تجویز دینے والا next_step واپس کرتی ہے۔ REST API صرف پورا prompt لیتی ہے: PATCH /v1/agents/{agent_id} جس میں prompt اور if_updated_at ہوں۔
ناقابلِ واپسی اقدامات کی تصدیق
D سے نشان زد ٹولز کسی چیز کو تبدیل یا حذف کرتے ہیں، یا حقیقی افراد کو کال ملانا شروع کرتے ہیں۔ جن اقدامات کو واپس نہیں لیا جا سکتا، ان کے لیے دو درخواستیں درکار ہوتی ہیں۔ پہلی درخواست میں کچھ تبدیل نہیں ہوتا اور یہ واپس آتا ہے:
{
"status": "confirmation_required",
"action": "Delete agent",
"target": { "id": 195, "name": "Front Desk Receptionist" },
"confirmation_token": "…",
"expires_in_seconds": 600,
"next_step": "…"
}اسسٹنٹ صارف کو دکھاتا ہے کہ کس چیز پر اثر پڑے گا اور ہاں میں جواب طلب کرتا ہے۔ پھر وہ انہی آرگیومنٹس کے ساتھ، confirmation_token شامل کر کے، درخواست دہراتا ہے۔ ٹوکن 10 منٹ کے لیے درست ہوتا ہے، ایک بار کام کرتا ہے (چاہے وہ کال ناکام ہو جائے)، اور ایک تنظیم، ایک فرد، ایک ٹول اور آرگیومنٹس کے ایک عین مجموعے کے لیے ہوتا ہے، اس لیے تین ایجنٹس حذف کرنے کے لیے تین تصدیقات درکار ہوتی ہیں۔ pause یا stop کے ساتھ campaign_action یہ مرحلہ چھوڑ دیتا ہے تاکہ جاری مہم کو ہمیشہ فوراً روکا جا سکے، اور GET کے ساتھ test_integration بھی ایسا ہی کرتا ہے۔ کچھ D ٹولز ایک ہی درخواست میں چلتے ہیں کیونکہ D ان کے اثر کو ظاہر کرتا ہے، نہ کہ سرور کی جانب سے تصدیق کو: update_agent ڈرافٹ میں موجود مواد کو بدل دیتا ہے (discard_agent_draft اسے واپس بحال کرتا ہے)، deploy_agent فعال کنفیگریشن کو بدل دیتا ہے، update_phone_number فعال کالز کا راستہ تبدیل کرتا ہے، sync_mcp_server_tools ریموٹ سرور کے ٹول کیٹلاگ کو بدل دیتا ہے، import_voip_numbers نمبروں کو آپ کے کیریئر کی طرف دوبارہ موڑ دیتا ہے، run_agent_tests اور run_simulation کریڈٹ خرچ کر سکتے ہیں، send_sms اور place_call کسی حقیقی فرد تک پہنچتے ہیں (place_call اپنی رضامندی کی تصدیق برقرار رکھتا ہے)، اور provision_phone_number ایک نمبر خریدتا ہے۔ test_my_agent ٹیسٹ کریڈٹ خرچ کرتا ہے اور اسے consent_to_charge درکار ہوتا ہے۔ run_replays بھی رقم خرچ کرتا ہے؛ اس کا dry_run تخمینہ اور max_cost_cents کی حد تصدیق کی جگہ کام کرتے ہیں۔ آپ کا MCP کلائنٹ پھر بھی آپ سے ان کی منظوری مانگ سکتا ہے۔
کچھ تبدیلیاں جو واپس کی جا سکتی ہیں، پھر بھی ہاں کا انتظار کرتی ہیں: block_callers، unblock_callers اور save_voip_setup ہمیشہ؛ update_org_settings جب وہ کسی الرٹ کو بند کرے یا آزمائشی نمبر شامل کرے؛ اور update_agent جب اس کے attention_reasons ایجنٹ کے کسی ایک الرٹ کو بند کریں۔ ان کا next_step آپ سے عین تبدیلی کی تصدیق کرنے کو کہتا ہے، یہ خبردار کرنے کے بجائے کہ اسے واپس نہیں کیا جا سکتا۔
ابتدائی prompts
prompts/list بارہ دوبارہ قابلِ استعمال ورک فلوز فراہم کرتا ہے:
create_inbound_receptionistrun_agent_testsbuy_and_attach_numberreview_low_grade_callsadd_url_to_agent_knowledgeimprove_agent_from_callscheck_change_before_deploytest_my_agentdiagnose_phone_numberwhy_campaign_not_callingcall_reportimport_agents
فوری استعمال کے لیے تیار صارف پیغام حاصل کرنے کے لیے فہرست میں موجود prompt نام اور اس کے بیان کردہ دلائل کے ساتھ prompts/get استعمال کریں۔
وسائل
resources/list عوامی، کیش شدہ حوالہ جات فراہم کرتا ہے:
| URI | مواد |
|---|---|
thunderphone://docs/llms.txt | عوامی دستاویزات کا اشاریہ۔ |
thunderphone://docs/quickstart | فوری آغاز کی Markdown۔ |
thunderphone://pricing | موجودہ عوامی قیمتوں کی Markdown۔ |
thunderphone://guides/prompt-style | وائس ایجنٹ کے prompt طرز کی رہنما دستاویز، جس کے مقابلے میں review_prompt جانچ کرتا ہے۔ اس کے رہنما شناخت کنندگان (P1، W2 وغیرہ) ہی وہ ہیں جنہیں نتائج حوالہ دیتے ہیں۔ |
thunderphone://guides/working-with-thunderphone | معاون کو ان ٹولز کے ساتھ کیسے کام کرنا چاہیے: مسودے پر چھوٹے مراحل میں کام کریں، ہر deploy سے پہلے جانچ کریں، کسی بھی لائیو یا قابلِ بلنگ عمل کے لیے صارف کی ہاں لیں، اور راز کبھی نہ مانگیں۔ |
ایک حوالہ resources/read کے ذریعے پڑھیں۔ عوامی fetches ایک مختصر ٹائم آؤٹ، 2 MiB کی حد، اور عمل کے اندر 10 منٹ کی کیش استعمال کرتے ہیں۔
پروٹوکول اور خرابیاں
سرور پروٹوکول ورژنز 2025-06-18 اور 2025-03-26 کو سپورٹ کرتا ہے؛ یہ معاونت یافتہ کلائنٹ ورژن واپس بھیجتا ہے اور بصورتِ دیگر 2025-06-18 منتخب کرتا ہے۔ یہ initialize، ping، ٹولز، prompts، وسائل، اور اطلاعات نافذ کرتا ہے۔ اطلاعات 202 Accepted واپس کرتی ہیں۔ یہ اسٹیٹ لیس سرور SSE listener یا سیشن حذف کرنے کی سہولت نہیں دیتا، اس لیے GET اور DELETE، Allow: POST کے ساتھ 405 Method Not Allowed واپس کرتے ہیں۔
ٹول کی ناکامیاں isError: true کے ساتھ کامیاب JSON-RPC جوابات ہی رہتی ہیں۔ ان کے متن میں ایک مختصر جملے کے بعد JSON بلاک شامل ہوتا ہے:
{
"code": "insufficient_balance",
"detail": "There is not enough prepaid balance.",
"next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}place_call کے لیے منفرد outbound_tcpa_confirmation_required: سابقہ برقرار رکھا جاتا ہے۔ نامعلوم JSON-RPC طریقے HTTP 200 جواب میں -32601 واپس کرتے ہیں۔ JSON-RPC بیچز کو MCP 2025-06-18 سپورٹ نہیں کرتا اور وہ صاف -32600 غلط درخواست کی خرابی واپس کرتے ہیں۔