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

Getting Started

Claude Code، Codex یا Cursor کے ساتھ بنائیں

ThunderPhone Agent Skills انسٹال کریں، ThunderPhone MCP سرور منسلک کریں، اور کوڈنگ ایجنٹ کو موجودہ پروڈکٹ دستاویزات فراہم کریں۔

ThunderPhone کوڈنگ ایجنٹس کے لیے تین پرتیں فراہم کرتا ہے:

پرتیہ ایجنٹ کو کیا فراہم کرتی ہے
Agent Skillsایجنٹس، prompts، نمبرز، کالز، ٹولز، webhooks، نالج، ٹیسٹنگ، بند چکر میں ایجنٹ کو بہتر بنانے، مہمات، widgets، realtime frameworks اور migrations کے لیے مرکوز طریقۂ کار۔
MCPتصدیق شدہ ٹولز ایجنٹس، نمبرز، کالز، ٹیسٹنگ، نالج، ٹولز/webhooks، مہمات، آوازوں، imports اور docs کا احاطہ کرتے ہیں؛ لائیو کیٹلاگ کے لیے tools/list کال کریں۔
Raw documentationپروڈکٹ کے رویّے اور API کی تفصیلات کے لیے موجودہ Markdown ذرائع۔

Skills کام کرنے کا طریقہ بتاتی ہیں۔ MCP کوڈنگ ایجنٹ کو آپ کی organization کا معائنہ کرنے اور اس پر کارروائی کرنے دیتا ہے۔ Raw docs کسی لوڈ شدہ skill سے باہر کے سوالات کے لیے ماخذی مواد فراہم کرتی ہیں۔

کسی پروجیکٹ میں انسٹال کریں

یہ بلاک skills انسٹال کرتا ہے، موجودہ shell کے لیے key دستیاب کرتا ہے، اور Claude Code میں project-scoped MCP server شامل کرتا ہے۔ placeholder کو اپنے secret manager سے اصل قدر پڑھ کر تبدیل کریں؛ repository یا chat میں key پیسٹ نہ کریں۔

npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp

Codex کے لیے، آخری کمانڈ کو درج ذیل سے تبدیل کریں:

codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY

Cursor .cursor/mcp.json سے project configuration پڑھتا ہے:

{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

VS Code .vscode/mcp.json میں servers key کے تحت وہی server استعمال کرتا ہے:

{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

مثالی سیشن: دو لسانی ڈینٹل ریسپشنسٹ

  1. کوڈنگ ایجنٹ سے create-agent، thunderphone-prompt-builder، build-tool-integration، add-knowledge، اور test-agent لوڈ کرنے کو کہیں۔ اسے پہلے منصوبہ بنانے اور ابھی وسائل نہ بنانے کی ہدایت دیں۔
  2. اسے تصدیق شدہ پریکٹس حقائق، معاونت یافتہ کام، ایسکلیشن کے قواعد، اور دو مطلوبہ لوکیلز دیں۔ اسے وائس یا لوکیل ایجاد کرنے کے بجائے لائیو وائس کیٹلاگ اور معاونت یافتہ زبانیں چیک کرنے کو کہیں۔
  3. عمومی اصولوں اور حقائق سے تیار کردہ ایک پروڈکشن prompt مانگیں۔ ایجنٹ کو کالر کی معاونت یافتہ زبان میں تبدیل ہونا چاہیے، گفتگو مختصر رکھنی چاہیے، ایک وقت میں ایک سوال پوچھنا چاہیے، اور کالر کے جواب کے اسکرپٹس سے گریز کرنا چاہیے۔
  4. اس سے ایک محدود شیڈولنگ ٹول متعین کروائیں اور صرف وہ نالج منسلک کریں جس کی ریسپشنسٹ کو ضرورت ہو۔ ڈیپلائے کرنے سے پہلے ٹول کی کامیابی، دستیابی نہ ہونے، غلط ان پٹ، ٹائم آؤٹ، اور انسانی نمائندے کو ہینڈ آف کی جانچ کریں۔
  5. دونوں زبانوں، مداخلتوں، تصحیحات، نامکمل معلومات، نالج کے سوالات، شیڈولنگ کی ناکامیوں، اور ایسکلیشن کے لیے منظرنامے بنوائیں۔ انہیں چلائیں، ٹرانسکرپٹس اور ٹول کے شواہد کا جائزہ لیں، سب سے چھوٹے عمومی قاعدے کو درست کریں، اور پھر وہی سیٹ دوبارہ چلائیں۔
  6. درست ڈرافٹ اور ٹیسٹ کے شواہد کا جائزہ لیں، پھر ڈیپلائے اور نمبر منسلک کرنے کی واضح اجازت دیں۔ حقیقی ٹریفک منتقل کرنے سے پہلے ہر زبان میں ایک کنٹرول شدہ آڈیو کال کریں۔

بند لوپ میں ایجنٹ کو بہتر بنائیں

جب ایجنٹ کالز لینے لگے، تو کوڈ لکھنے والے ایجنٹ سے iterate-on-agent لوڈ کرنے کو کہیں۔ یہ مہارت وہی لوپ چلاتی ہے جو ThunderPhone اپنے ایجنٹس پر استعمال کرتا ہے، اس لیے ہر تبدیلی کو جاری کرنے سے پہلے ناپا جاتا ہے:

  1. پڑھیں ایجنٹ، اس کی پرومپٹ نظرثانیاں اور پرومپٹ اسٹائل گائیڈ۔ پرومپٹ نظرثانیاں REST اور MCP پر دستیاب ہیں، اس لیے کوڈنگ ایجنٹ حالیہ پرومپٹ تبدیلیوں کا براہِ راست جائزہ لے سکتا ہے۔
  2. ٹیسٹ سیٹس بنائیں۔ import_conversations حالیہ کالز، یا call_ids کے ذریعے منتخب کالز، کو ٹیسٹ گفتگوؤں اور ان کے مشکل ترین لمحات کو جوابی کلیدوں کے ساتھ مثالوں میں تبدیل کرتا ہے۔ اگر کچھ درآمد شدہ گفتگوؤں کے لیے مثال کی تخلیق ناکام ہو جائے تو، کسی کال کو درآمد کیے بغیر ان ایجنٹ گفتگوؤں کے لیے دوبارہ مثالیں بنانے کے لیے redo_failed: true کے ساتھ import_conversations چلائیں۔ generate_conversations انہیں ایک نئے ایجنٹ کے لیے لکھتا ہے، جس میں پرومپٹ کے کمزور پہلوؤں کو ہدف بنانے والے مشکل کالرز بھی شامل ہوتے ہیں (یہ ہمیشہ dev اسپلٹ میں جاتے ہیں)۔ ہر گفتگو ٹیوننگ کے لیے dev اسپلٹ، یا ایک بار پیمائش کے لیے ٹیسٹ اسپلٹ میں ہوتی ہے۔ وہ کال جس کا کالر ٹیسٹ اسپلٹ میں ہو، الگ رکھی جاتی ہے: API کلید یا OAuth ٹوکن کے لیے، REST اور MCP دونوں پر، یہ صرف اپنی شناخت، آغاز کے وقت اور held_out: true کے ساتھ واپس آتی ہے، اس پر تحریری تبدیلیاں مسترد کر دی جاتی ہیں (held_out_call)، اور اس سے آگے بڑھائے گئے ٹیسٹ منظرنامے بھی مسترد ہوتے ہیں؛ ٹیوننگ کے وقت اسے شامل نہ کریں۔
  3. dev اسپلٹ پر run_replays کے ساتھ بنیادی معیار حاصل کریں۔ Bolt v2 کے ساتھ، ریکارڈ شدہ آڈیو والا ٹرن دوبارہ چلایا جاتا ہے جیسے لائیو کال اسے چلاتی۔
  4. مسودے میں ترمیم کریں۔ review_prompt پرومپٹ کو اسٹائل گائیڈ کے مقابلے میں جانچتا ہے اور تلاش کر کے تبدیل کرنے کی ترامیم پیش کرتا ہے؛ update_agent انہیں prompt_edits کے ذریعے مسودے پر لاگو کرتا ہے؛ previous_prompt کے ساتھ دوسری جانچ تبدیل ہونے والی چیزوں کو جانچتی ہے۔ refactor_prompt ایسے پرومپٹ کو دوبارہ لکھتا ہے جس میں بہت زیادہ پیچز جمع ہو چکے ہوں، اور اپنے تبدیل کردہ کسی بھی رویّے کی اطلاع دیتا ہے۔ جب کوئی ترمیم کسی رویّے کو شامل یا حذف کرتی ہے، تو refresh_conversations ٹیسٹ گفتگوؤں کو نئے پرومپٹ کے مطابق لاتا ہے، اور کسی اصول کے واپس آنے پر پہلے کے ورژنز بحال کرتا ہے۔
  5. بنیادی معیار کے مقابلے میں run_replays کے ساتھ تصدیق کریں، اور ناکامیوں کو اس طرح پڑھیں جیسے کالر انہیں سنتا۔ compare_configs انہی dev مثالوں پر مختلف سماعت درجۂ کار، آواز، اینڈ پوائنٹنگ یا ذہانت درجۂ کار آزماتا ہے؛ تقابل صرف dev کے لیے ہوتے ہیں۔
  6. ٹیسٹ اسپلٹ پر ایک بار پیمائش کریں۔ ایک ٹیسٹ رن پورے ٹیسٹ گروہ کو دوبارہ چلاتا ہے اور اس کا پہلا نتیجہ اسے استعمال کر لیتا ہے، اس لیے کسی بھی پرومپٹ کے لیے ہر بعد کے ٹیسٹ رن کو درآمد شدہ کالز یا تیار کردہ گفتگوؤں سے تازہ ٹیسٹ ڈیٹا درکار ہوتا ہے۔ ہر مثال کا انجن رن سے پہلے اس کے ڈیٹا سے متعین ہوتا ہے (ریکارڈ شدہ آڈیو بالکل اسی طرح دوبارہ چلتا ہے، صرف متن والی مثالیں متن کے طور پر)۔ مجموعے ہر انجن کے لیے آتے ہیں، اور کوئی چیز متن پر واپس نہیں جاتی: Bolt v2 کے علاوہ کسی کنفیگریشن کے تحت ریکارڈ شدہ آڈیو والا گروہ مسترد کر دیا جاتا ہے (test_needs_exact_replay) اور غیر استعمال شدہ رہتا ہے، اس لیے اس کنفیگریشن کو dev پر ناپیں۔ کوڈنگ ایجنٹس کو صرف مجموعے ملتے ہیں، نیز dev رنز پر سادہ زبان میں تقابلی تشریح، تاکہ وہ ٹیسٹ اسپلٹ پر ٹیوننگ نہ کر سکیں۔
  7. run_simulation کی ریکارڈنگ سنیں، یا ایک ٹاک لنک کھولیں اور خود مسودے سے بات کریں۔
  8. جب آپ کہیں تو تعینات کریں۔

جو بھی کریڈٹس خرچ کرتا ہے، وہ پہلے قیمت کا کوٹ لیتا ہے: تخمینہ حاصل کرنے کے لیے dry_run: true بھیجیں، پھر اس کے quote_id اور ایک سخت حد max_cost_cents کے ساتھ چلائیں۔ ایک کوٹ ایک رن کی ادائیگی کرتا ہے: گفتگو جابز، ری پلے رنز، اور ماڈل کو کال کرنے والے prompt ریویوز اور ری فیکٹرز شروع ہوتے ہی اسے مستقل طور پر استعمال کر دیتے ہیں۔ آپ کی API کلید، OAuth ایپ، یا MCP سے شروع کیے گئے بامعاوضہ رنز بھی آپ کی تنظیم کے فعال کردہ اسی ٹول کٹ الاؤنس میں شمار ہوتے ہیں، اور اگر کوئی آغاز مسترد ہو یا پہلے ناکام ہو جائے تو کوٹ قابل استعمال رہتا ہے؛ استعمال ہونے کے بعد، ناکام رن کو نئے ڈرائی رن کے ساتھ دہرائیں۔ ہر درخواست بھیجے جانے سے پہلے اپنی ممکنہ زیادہ سے زیادہ لاگت مختص کرتی ہے، اور رن سے اس کی حقیقی لاگت وصول کی جاتی ہے، اس لیے تخمینے میں گنجائش رکھیں۔ ایک عام ٹرن کے لیے عین ری پلے دورانِ عمل ہر ری پلے کے لیے تقریباً 85 سینٹ سے $1.25 تک مختص کرتا ہے (ایک معمول کا ٹرن اور ایک پروڈکشن دوبارہ رن)، جبکہ اصل لاگت چند سینٹ ہوتی ہے: ری پلے رنز کے لیے گنجائش والی حد دیں۔ جو ٹرن پھر بھی بجٹ سے باہر ہو جائے اسے الگ شمار کیا جاتا ہے اور وہ کوئی ٹیسٹ گروہ خرچ نہیں کرتا۔ ایک ایجنٹ ایک وقت میں صرف ایک گفتگو جاب یا ری پلے رن چلاتا ہے۔ OAuth کے ساتھ، prompt ٹولز کو agents:write اسکوپ درکار ہوتا ہے۔ جب کسی کال کی ریکارڈنگ بند کر دی جائے یا کال حذف کر دی جائے، تو اس سے لی گئی ٹیسٹ گفتگوئیں اور مثالیں بھی ہٹا دی جاتی ہیں۔ ٹیسٹ گفتگو، ری پلے، اور prompt ریویو ٹولز ایجنٹ اٹریشن ٹول کٹ کا حصہ ہیں، جو بیٹا میں ہونے کے دوران ہر تنظیم کے لیے فعال کی جاتی ہے (ٹاک لنکس ہر تنظیم کے لیے فعال ہیں)؛ اسے فعال کرنے کے لیے سپورٹ سے رابطہ کریں۔

ٹائپ شدہ REST درخواستوں کے لیے Python یا TypeScript SDK استعمال کریں۔

جب کسی بلڈ کے لیے متعین payloads، ورژن شدہ fixtures، بلک آرکیسٹریشن، یا موجودہ MCP ٹول فہرست میں شامل نہ ہونے والا آپریشن درکار ہو تو MCP کے بجائے REST استعمال کریں۔ API کا آغاز https://api.thunderphone.com/v1 سے ہوتا ہے؛ API تعارف اور MCP گائیڈ دیکھیں۔