ThunderPhone v3 اب لائیو ہے۔سیلف سرو، قیمت 2¢ فی منٹ سے شروع۔اعلان پڑھیں

Connect tools & data

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 ہو جو آپ کے استعمال کردہ ورک اسپیس کا احاطہ کرتا ہو:

  1. تنظیم کا ایک منتظم ThunderPhone میں تنظیم → عمومی → AI معاون کی رسائی کھولتا ہے اور اس احاطے کی تصدیق کرتا ہے۔
  2. اس کے بجائے معاون کو اس 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 (ویب، ڈیسک ٹاپ، اور موبائل)

  1. حسب ضرورت بنائیں → کنیکٹرز کھولیں (پرانے ورژنز میں ترتیبات → کنیکٹرز)۔ اگر ThunderPhone کنیکٹر ڈائریکٹری میں نظر آئے تو اسے منتخب کریں۔ بصورت دیگر حسب ضرورت کنیکٹر شامل کریں منتخب کریں، اس کا نام ThunderPhone رکھیں، اور https://api.thunderphone.com/v1/mcp درج کریں۔
  2. رابطہ کریں منتخب کریں، ThunderPhone میں سائن ان کریں، تنظیم منتخب کریں، اور اجازتوں کی منظوری دیں۔
  3. چیٹ میں، ٹولز مینو سے 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

  1. اگر ThunderPhone ChatGPT ایپ ڈائریکٹری میں نظر آئے، تو اسے منتخب کریں اور منسلک کریں۔
  2. بصورت دیگر ترتیبات → ایپس اور کنیکٹرز → جدید ترتیبات کھولیں، ڈیولپر موڈ آن کریں، اور URL https://api.thunderphone.com/v1/mcp اور OAuth توثیق کے ساتھ ایک کنیکٹر بنائیں۔
  3. 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_agentagent_idR, Iایک ایجنٹ حاصل کرتا ہے۔
create_agentایجنٹ کنفیگریشن—ایک ایجنٹ بناتا ہے۔ update_agent جیسی ہی سیٹنگز لیتا ہے، بشمول steps، handoffs، intro_clip اور intro_ring_count۔
update_agentagent_id، تبدیل شدہ فیلڈز، اختیاری prompt_edits، expected_prompt_sha256Dایجنٹ کے ڈرافٹ میں فیلڈز کو اس مواد کی جگہ مرحلہ وار شامل کرتا ہے جو ڈرافٹ میں پہلے موجود تھا۔ تصدیقی مرحلے کے بغیر چلتا ہے: تعینات کردہ ایجنٹ deploy_agent تک تبدیل نہیں ہوتا، اور discard_agent_draft ڈرافٹ کو واپس کر دیتا ہے۔ آپ max_hold_seconds، system_tool_settings اور words بھی سیٹ کر سکتے ہیں۔ پرامپٹ کا کوئی حصہ تبدیل کرنے کے لیے prompt_edits بھیجیں (پرامپٹ کو اسی جگہ ایڈٹ کرنا دیکھیں)۔
deploy_agentagent_id، اختیاری if_updated_atD, Iڈرافٹ کو پروڈکشن میں منتقل کرتا ہے۔
discard_agent_draftagent_id، اختیاری if_updated_at، دوسری درخواست پر confirmation_tokenD, Iمرحلہ وار کی گئی تبدیلیاں مسترد کرتا ہے۔ دو مرحلوں پر مشتمل ہے، تباہ کن کارروائیوں کی تصدیق دیکھیں۔
duplicate_agentagent_id، اختیاری name—تنظیم کے اندر ایک ایجنٹ کی کاپی بناتا ہے۔
delete_agentagent_id، دوسری درخواست پر confirmation_tokenD, Iایک ایجنٹ کو مستقل طور پر حذف کرتا ہے۔ دو مرحلوں پر مشتمل ہے۔
list_agent_versionsagent_idR, Iتعینات کردہ کنفیگریشن ورژنز کی فہرست دیتا ہے۔
list_prompt_revisionsagent_id، اختیاری source، limit، offsetR, Iایجنٹ کے پرامپٹ متن میں ہونے والی ہر تبدیلی کی فہرست دیتا ہے، بشمول ڈرافٹس، اور ہر تبدیلی کے ساتھ اس ریویژن کے مقابلے میں فرق بھی دیتا ہے جسے اس نے تبدیل کیا۔ جب ایجنٹ اٹریشن ٹول کٹ آپ کے کنکشن کے لیے دستیاب ہو تو دستیاب ہے (نیچے دیکھیں)۔
review_promptagent_id، اختیاری prompt، previous_prompt، quote_id، max_cost_cents—ڈرافٹ پرامپٹ (یا آپ کے بھیجے ہوئے متن) کا پرامپٹ اسٹائل گائیڈ کے مطابق جائزہ لیتا ہے۔ ہر نتیجہ متعلقہ عبارت کا حوالہ دیتا ہے، رہنما اصول کا نام بتاتا ہے، اور تلاش کر کے تبدیل کرنے کی ایڈٹ پیش کرتا ہے؛ نتیجہ ان رویوں کی فہرست بھی دیتا ہے جو پرامپٹ طلب کرتا ہے، مستحکم ids کے ساتھ، آیا ری فیکٹر درکار ہے، اور ایجنٹ کے اپنے پرامپٹ کے لیے آیا اس کی ٹیسٹ گفتگوؤں کو تازہ کرنے کی ضرورت ہے۔ ایجنٹ میں کوئی تبدیلی نہیں کرتا؛ انوینٹری اس کے پرامپٹ ریویژن کے ساتھ محفوظ ہو جاتی ہے۔ یہ بامعاوضہ ہے، اس لیے اسے صرف پڑھنے کے لیے نشان زد نہیں کیا گیا: پہلے dry_run کے ساتھ اس کا کوٹ حاصل کریں، پھر dry_run کے بغیر، اس کے واپس کردہ quote_id اور max_cost_cents کے ساتھ دوبارہ چلائیں۔ یہ بامعاوضہ رنز اب دیگر ٹول کٹ رنز جیسی تنظیمی ٹول کٹ الاؤنس میں شمار ہوتے ہیں۔ جب ایجنٹ اٹریشن ٹول کٹ آپ کے کنکشن کے لیے دستیاب ہو تو دستیاب ہے (نیچے دیکھیں)۔
refactor_promptagent_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_instructionname، content—غیر منسلک دوبارہ استعمال کے قابل ہدایت بناتا ہے۔ صرف ایڈمنز کے لیے۔

فون نمبرز اور کیریئرز

ٹولبنیادی آرگیومینٹستشریحاتیہ کیا کرتا ہے
list_phone_numbers—R, Iتنظیم کے نمبرز اور روٹنگ کی فہرست دکھاتا ہے۔
get_phone_number_limits—R, Iمنظم نمبرز کے استعمال اور حدود حاصل کرتا ہے۔
provision_phone_numberاختیاری area_code، city، state، idempotency_keyD, OThunderPhone کے زیرِ انتظام آنے والا نمبر خریدتا ہے۔
list_voip_connections—R, Iمنسلک کسٹمر کیریئرز کی فہرست دکھاتا ہے۔
search_voip_numbersconnection_id، country، type، اختیاری area_codeR, I, Oکیریئر انوینٹری میں تلاش کرتا ہے۔
import_voip_numbersconnection_id، numbersD, Oکیریئر پر پہلے سے ملکیت میں موجود نمبرز درآمد کرتا ہے۔
update_phone_numberphone_number_id، روٹنگ/لیبل/webhook فیلڈزDایجنٹ کی تفویض سمیت نمبر کی روٹنگ اپ ڈیٹ کرتا ہے۔
delete_phone_numberphone_number_id، confirm، اختیاری release_at_provider، دوسری درخواست پر confirmation_tokenD, I, Oنمبر جاری کرتا ہے۔ دو مراحل۔
get_voip_setup_sessionاختیاری session_idR, Iرہنمائی شدہ کیریئر سیٹ اپ پڑھتا ہے (اسٹیٹس، چیک لسٹ، اور وہ سوال جس کا یہ انتظار کر رہا ہے)، یا کھلے سیٹ اپس کی فہرست دکھاتا ہے۔ سیٹ اپ ڈیش بورڈ میں شروع ہوتا ہے کیونکہ اسے کیریئر پاس ورڈ درکار ہوتا ہے۔ صرف ایڈمنز کے لیے۔
answer_voip_setup_questionsession_id، question_id، answerOصارف کا جواب سیٹ اپ کو بھیجتا ہے۔ پاس ورڈز، ٹیسٹ کال کی رضامندی، سرور کا پتہ، صارف نام، اور ThunderPhone کو پرووائیڈر اکاؤنٹ میں سائن اِن کرنے کی اجازت کا جواب صرف سیٹ اپ وزرڈ میں دیا جاتا ہے؛ ان کے لیے یہ وزرڈ لنک واپس کرتا ہے اور کچھ نہیں بھیجتا۔
save_voip_setupsession_id، اختیاری name، دوسری درخواست پر confirmation_tokenD, I, Oمنسلک ڈرافٹ کنکشن محفوظ کرتا ہے تاکہ اسے استعمال کیا جا سکے۔ دو مراحل۔
check_phone_numberphone_number یا phone_number_idR, I, Oشواہد کی بنیاد پر تنظیم کے اپنے نمبرز میں سے ایک کی تشخیص کرتا ہے: روٹنگ، کنکشن، تصدیق، حالیہ کیریئر اور ٹیسٹ کالز، اور کیریئر اسے کہاں بھیجتا ہے۔

SMS

ٹولمرکزی آرگیومنٹستشریحاتیہ کیا کرتا ہے
send_smsfrom_number, to, body, idempotency_keyD, I, Oمنسلک Twilio یا Telnyx نمبر کے ذریعے ایک سادہ متنی SMS بھیجتا ہے۔

کالز

ٹولبنیادی آرگیومنٹسحواشییہ کیا کرتا ہے
list_callsاختیاری فلٹرز، limit، offsetR, Iexclude_test_calls سمیت REST کال ہسٹری فلٹرز کے ساتھ کالز کی فہرست دیتا ہے۔
get_callcall_idR, Iکال کی حیثیت اور میٹاڈیٹا حاصل کرتا ہے۔
get_call_transcriptcall_id، اختیاری liveR, Iکال کا ٹرانسکرپٹ حاصل کرتا ہے۔
get_call_audio_urlcall_id، اختیاری downloadR, I, Oدستخط شدہ آڈیو URL واپس کرتا ہے؛ یہ کبھی بھی MCP کے ذریعے آڈیو اسٹریم نہیں کرتا۔
get_call_gradecall_idR, Iکال کا تازہ ترین گریڈ حاصل کرتا ہے۔
place_callagent_id، from_number، to_numberD, Oایک ایسی آؤٹ باؤنڈ کال کرتا ہے جو دہرائے جانے پر یکساں نتیجہ نہیں دیتی۔
export_callsکال فلٹرز، export_formatR, IREST اینڈپوائنٹ کی حد تک JSON یا CSV میں ایکسپورٹ کرتا ہے۔
get_call_analyticsاختیاری since_days، agent_idR, Iحقیقی کالز کو حیثیت، سمت، نتیجے، گریڈ اور مسئلے کے لحاظ سے جمع کرتا ہے، جبکہ ٹیسٹ کالز الگ شمار ہوتی ہیں۔
get_call_insightscall_ids (10 تک)R, Iمتعدد کالز کا گریڈ، نتیجہ، خلاصہ اور شناخت شدہ مسائل ایک ساتھ حاصل کرتا ہے۔

ٹیسٹنگ اور توثیق

ٹولبنیادی آرگومنٹستشریحاتیہ کیا کرتا ہے
list_test_scenariosagent_idR, Iٹیسٹ منظرناموں کی فہرست دیتا ہے۔
create_test_scenarioagent_id, title, scenario_prompt, اختیاری شرائط—ایک منظرنامہ بناتا ہے۔
generate_test_scenariosagent_id, اختیاری count, include_edge_cases, localeOایجنٹ کے prompt سے منظرنامے تیار کرتا ہے۔
run_agent_testsagent_id, channel, consent_to_charge, اختیاری انتخاب/میٹرکسD, Oویب یا ٹیلی فونی کے ذریعے منظرنامے چلاتا ہے۔
get_test_runagent_id, batch_idR, Iبیچ کی حیثیت اور ہر منظرنامے کے نتائج حاصل کرتا ہے۔
test_my_agentagent_id, consent_to_charge, اختیاری scenario_ids, count, wait_secondsD, Oایک کال میں ایجنٹ کی جانچ کرتا ہے: اس کے محفوظ کردہ منظرنامے چلاتا ہے، یا اگر کوئی نہ ہو تو کچھ تیار کرتا ہے، اور فیصلوں کے لیے ایک منٹ تک انتظار کرتا ہے، یا get_test_run کے لیے batch_id واپس کرتا ہے۔ چارجنگ run_agent_tests جیسی ہوتی ہے۔
test_in_textagent_id, callers ‏(1 سے 3 تفصیلات)، اختیاری version, directionOمفت ٹیکسٹ ٹیسٹ: مصنوعی کالرز حقیقی پائپ لائن کے ذریعے ٹیکسٹ میں ایجنٹ کے ڈرافٹ، یا لائیو ورژن، سے بات کرتے ہیں، اور ٹرانسکرپٹس تقریباً ایک منٹ میں واپس آ جاتے ہیں۔ ٹول کے نتائج مصنوعی ہوتے ہیں۔
run_simulationagent_id, consent_to_charge, اختیاری scenario_prompt, direction, languageD, OAI کالر اور ایجنٹ کے ڈرافٹ کے درمیان ایک مصنوعی فون کال شروع کرتا ہے تاکہ کوئی شخص تبدیلی سن سکے۔ رن کو in_progress حالت میں واپس کرتا ہے۔ جب ایجنٹ کالز ریکارڈ کرتا ہے تو یہ ریکارڈ ہوتی ہے، اور ختم ہونے کے بعد گریڈ کی جاتی ہے۔ ٹیسٹ کال کی طرح چارج ہوتا ہے، پہلے مفت ٹیسٹ بجٹ سے۔
get_simulationsimulation_idR, Iمصنوعی کال کی حیثیت اور، ختم ہونے پر، اس کی پیداوار حاصل کرتا ہے: مختصر مدت کے لیے دستیاب ریکارڈنگ URL اور، جب ایجنٹ کالز ریکارڈ کرتا ہے، ٹرانسکرپٹ؛ نیز گریڈنگ مکمل ہونے پر گریڈ (null اس سے پہلے)۔
list_validation_runsagent_idR, Iحالیہ ڈرافٹ ویلیڈیشن رنز کی فہرست دیتا ہے۔
get_validation_statusagent_idR, Iتازہ ترین ویلیڈیشن حالت اور ڈرافٹ میچ حاصل کرتا ہے۔
list_conversationsagent_id, اختیاری split, sourceR, Iان گفتگوؤں کی فہرست دیتا ہے جن کے خلاف ایجنٹ کی جانچ ہوتی ہے۔ ایجنٹ iteration toolkit درکار ہے۔
get_conversationconversation_idR, Iایک ٹیسٹ گفتگو کو اس کے موجودہ ٹرنز کے ساتھ حاصل کرتا ہے۔ ایجنٹ iteration toolkit درکار ہے۔
get_conversation_revisionsconversation_id, اختیاری limit, offsetR, Iٹیسٹ گفتگو کی ہر ترمیم کی فہرست دیتا ہے: یہ کیسے اور کیوں بدلی، مثلاً prompt کی تبدیلی پر ریفریش ہوئی یا پچھلی ترمیم سے بحال ہوئی، شامل، حذف اور تبدیل شدہ رویے، منتقل یا ریٹائر کیے گئے مثالیں، اور قطار کا فرق۔ ایجنٹ iteration toolkit درکار ہے۔
generate_conversationsagent_id, اختیاری count, styleOایجنٹ کے ڈرافٹ کے خلاف مصنوعی ٹیسٹ گفتگوئیں لکھتا ہے اور ان کے مشکل ترین لمحات کو جواب کی کلیدوں کے ساتھ ویلیڈیشن مثالوں میں بدلتا ہے۔ پہلے dry_run کے ذریعے تخمینہ لیں؛ حقیقی رن کے لیے اس کا quote_id اور max_cost_cents درکار ہے۔ ایجنٹ iteration toolkit درکار ہے۔
import_conversationsagent_id, اختیاری since_days, max_callsOایجنٹ کی حالیہ کالز کو ٹیسٹ گفتگوؤں میں بدلتا ہے، ہر کالر کے لیے زیادہ سے زیادہ دو، اور ریکارڈنگ بند والی کالز کو چھوڑ دیتا ہے، پھر ان کے مشکل ترین لمحات کو مثالوں میں بدلتا ہے۔ پہلے dry_run کے ذریعے تخمینہ لیں؛ حقیقی رن کے لیے اس کا quote_id اور max_cost_cents درکار ہے۔ ایجنٹ iteration toolkit درکار ہے۔
refresh_conversationsagent_id, اختیاری conversation_ids, from_prompt_revision_idOرویے شامل، حذف یا تبدیل ہونے کے بعد ایجنٹ کی ٹیسٹ گفتگوؤں کو اس کے موجودہ prompt کے مطابق کرتا ہے: دوبارہ منسلک کرتا ہے، پچھلی ترمیم کو، حقیقی آڈیو سمیت، بحال کرتا ہے یا پرانے ٹرنز دوبارہ لکھتا ہے، اور ان مثالوں کو ریٹائر کرتا ہے جن کا کالر ٹرن ختم ہو چکا ہو۔ پہلے dry_run کے ذریعے تخمینہ لیں؛ حقیقی رن کے لیے اس کا quote_id اور max_cost_cents درکار ہے۔ ایجنٹ iteration toolkit درکار ہے۔
get_conversation_jobjob_idR, Igenerate، import یا refresh جاب حاصل کرتا ہے: حیثیت، اب تک کی لاگت بمقابلہ اس کی حد، اور اس نے کیا لکھا یا ریفریش کیا۔ ایجنٹ iteration toolkit درکار ہے۔
run_replaysagent_id, اختیاری overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, 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_configsagent_id, configs ‏(2 سے 4، پہلا baseline ہے)، اختیاری sample_size, sample_seed, max_cost_cents, quote_id, dry_runOہر کنفیگریشن کے تحت انہی مثالوں کو دوبارہ چلاتا ہے اور پاس کی شرح، baseline کے مقابل درست اور خراب ہونے والی مثالیں، پہلی آڈیو تک تاخیر، کالر کے acknowledgement، ٹکس یا خاموشی کے لیے انتظار کی تعداد، اور ہر انجن کے لحاظ سے فی ٹرن لاگت رپورٹ کرتا ہے۔ run_replays کی طرح dry_run کے ذریعے تخمینہ لیں۔ صرف dev اسپلٹ کے لیے: ٹیسٹ اسپلٹ پر یہ مسترد ہوتا ہے (comparison_dev_only)؛ dev پر موازنہ کریں، پھر منتخب کنفیگریشن کو run_replays سے ناپیں۔ ایجنٹ iteration toolkit درکار ہے۔
get_replay_runrun_id, اختیاری include_traceR, Iری پلے رن کے کل، تبدیلیاں اور ہر مثال کے نتائج، نیز اس کا موازنہ گروپ حاصل کرتا ہے۔ وہ عین ری پلے جنہیں اپنے بجٹ سے زیادہ درکار تھا، budget_exhausted کے طور پر الگ، پاس کی شرح سے باہر، شمار ہوتے ہیں۔ ایجنٹ iteration toolkit درکار ہے۔
create_talk_linkagent_id, اختیاری variant_id, language, expires_in_minutesOایک بار استعمال ہونے والا لنک بناتا ہے جسے کوئی شخص براؤزر میں کھول کر ایجنٹ کے موجودہ ڈرافٹ سے بات کر سکتا ہے، بالکل ڈیش بورڈ کے 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_basename, اختیاری description—ایک نالج بیس بناتا ہے۔
add_knowledge_documentknowledge_base_id, name, content—متن یا Markdown شامل کرتا ہے۔
import_knowledge_urlurl, اختیاری nameOمحفوظ ادخال کے لیے ایک عوامی صفحہ قطار میں شامل کرتا ہے۔
search_knowledgeknowledge_base_id, queryR, Iپروڈکشن ریٹریول میں تلاش کرتا ہے۔

انٹیگریشنز، webhooks، اور ریموٹ MCP سرورز

ٹولاہم آرگیومنٹستشریحاتیہ کیا کرتا ہے
list_integrations—R, IHTTP فنکشن انٹیگریشنز کی فہرست دکھاتا ہے۔
create_integrationdisplay_name، فنکشن spec، اختیاری اینڈپوائنٹ فیلڈز—ایک HTTP ٹول بناتا ہے۔ ڈیش بورڈ میں تصدیقی ہیڈرز شامل کریں۔
test_integrationurl، اختیاری طریقہ/باڈی/ٹائم آؤٹ، header_names کے ساتھ integration_id، دوسری درخواست پر confirmation_tokenD, Oایک محدود، SSRF سے محفوظ ٹیسٹ درخواست بھیجتا ہے۔ محفوظ کردہ ہیڈر ویلیوز انٹیگریشن سے بھری جاتی ہیں اور صرف اس کے اپنے ہوسٹ کو بھیجی جاتی ہیں۔ POST (ڈیفالٹ)، PUT، PATCH اور DELETE دو مرحلوں پر مشتمل ہیں؛ GET فوراً چلتا ہے۔
list_webhook_endpoints—R, Iدستخط شدہ ویب ہک اینڈپوائنٹس کی فہرست دکھاتا ہے۔
list_webhook_deliveriesاختیاری agent_id، اختیاری endpoint_idR, Iپےلوڈ کے بغیر حالیہ ویب ہک ڈیلیوری نتائج کی فہرست دکھاتا ہے۔
create_webhook_endpointlabel، url، اختیاری ایونٹس/اسٹیٹسOایک دستخط شدہ ویب ہک اینڈپوائنٹ بناتا ہے۔
copy_webhook_endpointendpoint_id، target_agent_idIایک ایجنٹ کا ویب ہک، دستخطی راز سمیت، سرور پر موجود دوسرے ایجنٹ میں کاپی کرتا ہے۔ صرف منتظمین کے لیے۔
test_webhook_endpointendpoint_idOعام ڈیلیوری کے ذریعے ایک مصنوعی ایونٹ بھیجتا ہے۔
list_mcp_servers—R, Iوائس ایجنٹس کے ذریعے قابلِ کال ریموٹ سرورز کی فہرست دکھاتا ہے۔
create_mcp_serverdisplay_name، urlOایک ریموٹ سرور رجسٹر اور ہم آہنگ کرتا ہے۔ جن سرورز کو تصدیقی ہیڈرز درکار ہوں، انہیں ڈیش بورڈ میں شامل کیا جاتا ہے۔
sync_mcp_server_toolsserver_idD, Oایک ریموٹ سرور کے ٹول کیٹلاگ کو تازہ کرتا ہے۔

مہمات

ٹولبنیادی آرگومنٹستشریحاتیہ کیا کرتا ہے
list_campaigns—R, Iآؤٹ باؤنڈ مہمات کی فہرست دیتا ہے۔
create_campaignمہم کے فیلڈز—ایک ڈرافٹ مہم بناتا ہے۔
add_campaign_contactscampaign_id, contacts—5,000 تک JSON رابطے شامل کرتا ہے۔
campaign_actioncampaign_id, action، اختیاری consent_to_charge، دوسری درخواست پر confirmation_tokenD, Ostart، pause، resume، یا stop چلاتا ہے۔ start اور resume دو مرحلوں پر مشتمل ہیں؛ pause اور stop فوراً چلتے ہیں۔
get_campaign_statscampaign_idR, Iکاؤنٹرز اور حالیہ نتائج حاصل کرتا ہے۔
check_campaignاختیاری campaign_id، contact_phone_number، contact_statusR, Iوضاحت کرتا ہے کہ مہم کال کیوں نہیں کر رہی: اس کے اپنے ٹائم زون میں کال کرنے کی ونڈو، اس وقت واجب الادا رابطے، اور ڈائلنگ کو کیا روک رہا ہے۔

تنظیم کی ترتیبات اور بلاک کیے گئے کالرز

ٹولبنیادی آرگیومنٹستشریحاتیہ کیا کرتا ہے
get_org_settings—R, Iٹائم زون، کاروباری اوقات، ٹیسٹ نمبرز، کال نتیجے کے لیبلز، اسٹیٹس کے نام اور کون سے الرٹس بند ہیں، updated_at کے ساتھ پڑھتا ہے۔
update_org_settingsتبدیل شدہ ترتیبات، if_updated_at، طلب کیے جانے پر confirmation_tokenD, Iانہیں تبدیل کرتا ہے (صرف منتظمین)۔ فہرستیں اور آبجیکٹس محفوظ شدہ قدر کی جگہ لے لیتے ہیں۔ کسی الرٹ کو بند کرنا یا ٹیسٹ نمبر شامل کرنا دو مرحلوں کا عمل ہے۔ نتیجے میں واپس کرنے کے لیے سابقہ قدریں ہوتی ہیں۔
get_account_limits—R, Iپلیٹ فارم کی حدود اس تنظیم کی اپنی قدروں کے ساتھ حاصل کرتا ہے۔
list_blocked_callersاختیاری number، searchR, Iبلاک کیے گئے کالر نمبرز کی فہرست دیتا ہے۔
block_callersnumbers، اختیاری note، دوسری درخواست پر confirmation_tokenD, Iکسی بھی ایجنٹ کے جواب دینے سے پہلے ان نمبرز سے کالز مسترد کرتا ہے۔ دو مرحلوں کا عمل، صرف منتظمین۔
unblock_callersnumbers، دوسری درخواست پر confirmation_tokenD, 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_humansummaryOThunderPhone ٹیم سے مدد مانگتا ہے۔ وہ ThunderPhone میں جواب دیتے ہیں۔ ایسی تنظیموں کے لیے جو PHI ہینڈل کر سکتی ہیں، صرف ایک غیر جانبدار نوٹ ThunderPhone سے باہر جاتا ہے۔
request_featuretitle، request، detailsOThunderPhone ٹیم کے ساتھ فیچر کی درخواست درج کرتا ہے۔ ایک تنظیم کے لیے روزانہ زیادہ سے زیادہ تین۔
start_agent_importplatformR, Iڈیش بورڈ کا وہ لنک واپس کرتا ہے جہاں آپ اپنی Vapi، Retell، ElevenLabs یا Bland کلید درج کرتے اور ایجنٹس منتخب کرتے ہیں۔ کوئی ٹول کلید قبول نہیں کرتا۔
get_agent_importاختیاری import_idR, Iحالیہ امپورٹس، یا ایک امپورٹ کی اسٹیٹس اور میپ کیے گئے ایجنٹس کی فہرست دیتا ہے۔
commit_agent_importimport_id، اختیاری item_idsOتیار امپورٹ سے ایجنٹس کو پس منظر میں بناتا ہے۔ صرف منتظمین۔

آوازیں، بلنگ، اور دستاویزات

ٹولبنیادی آرگیومنٹستشریحاتیہ کیا کرتا ہے
list_voices—R, Iآوازوں اور معاون زبانوں کی فہرست دیتا ہے۔
preview_voicevoice, language, textOایک نمونہ تیار کرتا ہے اور دستخط شدہ URL واپس کرتا ہے۔
list_voice_clones—R, Iحسبِ ضرورت وائس کلونز کی فہرست دیتا ہے۔
get_billing_summary—R, Iبیلنس اور مستند ٹئیر قیمتیں حاصل کرتا ہے؛ ادائیگی میں کوئی تبدیلی دستیاب نہیں ہے۔
search_docsquery، اختیاری limitR, I, Oعوامی دستاویزات کے انڈیکس میں تلاش کرتا ہے۔
get_doc_pagepathR, 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_foundfind متن موجودہ ڈرافٹ prompt میں نہیں ہے۔ edit_index بتاتا ہے کہ کون سی ترمیم ہے۔ایجنٹ کو دوبارہ پڑھیں اور عبارت کو بالکل اسی طرح نقل کریں۔
prompt_edit_ambiguousfind متن ایک سے زیادہ بار ظاہر ہوتا ہے۔ occurrences بتاتا ہے کہ کتنی بار۔اردگرد کے متن کا مزید حصہ شامل کریں۔
stale_promptexpected_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_receptionist
  • run_agent_tests
  • buy_and_attach_number
  • review_low_grade_calls
  • add_url_to_agent_knowledge
  • improve_agent_from_calls
  • check_change_before_deploy
  • test_my_agent
  • diagnose_phone_number
  • why_campaign_not_calling
  • call_report
  • import_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 غلط درخواست کی خرابی واپس کرتے ہیں۔