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 key দিয়ে কনফিগার করা ক্লায়েন্টের জন্য ইন্টিগ্রেশন → API keys-এর অধীনে একটি sk_live_ key তৈরি করুন এবং সেটি আপনার MCP ক্লায়েন্টে THUNDERPHONE_API_KEY হিসেবে প্রকাশ করুন। 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-হীন হিসেবে পরিচালনা করেছে, সেটি উভয় URL-এই পাওয়া যায়।

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. ChatGPT অ্যাপ ডিরেক্টরিতে ThunderPhone দেখা গেলে সেটি নির্বাচন করুন এবং সংযুক্ত করুন।
  2. অন্যথায় সেটিংস → অ্যাপস ও কানেক্টরসমূহ → উন্নত সেটিংস খুলুন, ডেভেলপার মোড চালু করুন এবং https://api.thunderphone.com/v1/mcp URL ও 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এজেন্ট কনফিগারেশন—একটি এজেন্ট তৈরি করে। steps, handoffs, intro_clip এবং intro_ring_count-সহ update_agent-এর মতো একই সেটিংস নেয়।
update_agentagent_id, পরিবর্তিত ফিল্ড, ঐচ্ছিক prompt_edits, expected_prompt_sha256Dএজেন্ট ড্রাফটে ফিল্ড স্টেজ করে, ড্রাফটে থাকা মান প্রতিস্থাপন করে। নিশ্চিতকরণ ধাপ ছাড়াই চলে: deploy_agent না করা পর্যন্ত ডিপ্লয় করা এজেন্ট অপরিবর্তিত থাকে, এবং discard_agent_draft ড্রাফট ফিরিয়ে দেয়। আপনি max_hold_seconds, system_tool_settings এবং words-ও সেট করতে পারেন। prompt-এর কোনো অংশ পরিবর্তন করতে prompt_edits পাঠান (জায়গাতেই prompt সম্পাদনা দেখুন)।
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এজেন্টের prompt টেক্সটে হওয়া প্রতিটি পরিবর্তনের তালিকা দেয়, ড্রাফটসহ; প্রতিটির সঙ্গে এটি যে রিভিশন প্রতিস্থাপন করেছে তার বিপরীতে একটি diff থাকে। আপনার সংযোগে এজেন্ট ইটারেশন টুলকিট উপলভ্য থাকলে এটি পাওয়া যায় (নিচে দেখুন)।
review_promptagent_id, ঐচ্ছিক prompt, previous_prompt, quote_id, max_cost_cents—prompt স্টাইল গাইড-এর বিপরীতে ড্রাফট prompt (অথবা আপনার পাঠানো টেক্সট) পর্যালোচনা করে। প্রতিটি ফলাফল অংশটি উদ্ধৃত করে, নির্দেশিকার নাম দেয় এবং একটি খুঁজে-প্রতিস্থাপন সম্পাদনা প্রস্তাব করে; ফলাফলে prompt যে আচরণগুলো চায় সেগুলোরও তালিকা থাকে, স্থিতিশীল id-সহ, রিফ্যাক্টর প্রয়োজন কি না এবং এজেন্টের নিজস্ব prompt-এর ক্ষেত্রে এর পরীক্ষার কথোপকথনগুলো রিফ্রেশ করা দরকার কি না। এজেন্টে কোনো পরিবর্তন করে না; ইনভেন্টরিটি তার prompt রিভিশনের সঙ্গে সংরক্ষিত হয়। এটি অর্থপ্রদেয়, তাই শুধু-পঠন হিসেবে চিহ্নিত নয়: প্রথমে dry_run দিয়ে এর মূল্য কোট করুন, তারপর dry_run ছাড়া আবার চালান এবং এটি যে quote_id ফেরত দেয় ও max_cost_cents ব্যবহার করুন। এই অর্থপ্রদেয় রানগুলো এখন অন্যান্য টুলকিট রানের মতো একই সংস্থার টুলকিট বরাদ্দের মধ্যে গণনা হয়। আপনার সংযোগে এজেন্ট ইটারেশন টুলকিট উপলভ্য থাকলে এটি পাওয়া যায় (নিচে দেখুন)।
refactor_promptagent_id, ঐচ্ছিক prompt, inventory, instructions, quote_id, max_cost_cents—prompt-কে স্টাইল গাইডের কাঠামোয় পুনর্লিখন করে এবং প্রতিটি আচরণকে রাখা, একীভূত করা, পুনর্বাক্যায়ন করা বা বাদ দেওয়া হিসেবে ম্যাপ করে। নতুন টেক্সট ও একটি diff ফেরত দেয়, এবং ডিফল্টভাবে behavior_changes (যোগ করা, সরানো বা পরিবর্তিত) ও behavior_preserved জানাতে এটি আবার পড়ে; update_agent দিয়ে এটি প্রয়োগ করুন। অর্থপ্রদেয়: dry_run দিয়ে এর মূল্য কোট করুন, তারপর এটি যে quote_id ফেরত দেয় ও max_cost_cents ব্যবহার করে একবার চালান। আপনার সংযোগে এজেন্ট ইটারেশন টুলকিট উপলভ্য থাকলে এটি পাওয়া যায় (নিচে দেখুন)।
list_reusable_instructions—R, Iপুনর্ব্যবহারযোগ্য নির্দেশনাগুলোর তালিকা দেয়: update_agent-এর reusable_instruction_ids দিয়ে অনেক এজেন্টে সংযুক্ত শেয়ার করা prompt নিয়ম।
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, রাউটিং/লেবেল/ওয়েবহুক ফিল্ড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, Oএকটি AI কলার ও এজেন্টের খসড়ার মধ্যে একটি সিমুলেটেড ফোন কল শুরু করে, যাতে একজন ব্যক্তি পরিবর্তনটি শুনতে পারেন। রানটি in_progress অবস্থায় ফেরত দেয়। এজেন্ট কল রেকর্ড করলে এটিও রেকর্ড করা হয় এবং শেষ হওয়ার পরে গ্রেড করা হয়। আগে বিনামূল্যের টেস্ট বাজেট থেকে, টেস্ট কলের মতো বিল করা হয়।
get_simulationsimulation_idR, Iএকটি সিমুলেটেড কলের স্ট্যাটাস এবং শেষ হলে সেটি কী তৈরি করেছে তা পায়: এজেন্ট কল রেকর্ড করলে স্বল্পমেয়াদি রেকর্ডিং URL ও ট্রান্সক্রিপ্ট, এবং গ্রেডিং শেষ হলে গ্রেড (null তার আগে)।
list_validation_runsagent_idR, Iসাম্প্রতিক খসড়া ভ্যালিডেশন রান তালিকাভুক্ত করে।
get_validation_statusagent_idR, Iসর্বশেষ ভ্যালিডেশন অবস্থা এবং খসড়া ম্যাচ পায়।
list_conversationsagent_id, ঐচ্ছিক split, sourceR, Iএজেন্টকে যেসব কথোপকথনের বিপরীতে পরীক্ষা করা হয়, সেগুলি তালিকাভুক্ত করে। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
get_conversationconversation_idR, Iবর্তমান টার্নসহ একটি টেস্ট কথোপকথন পায়। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
get_conversation_revisionsconversation_id, ঐচ্ছিক limit, offsetR, Iএকটি টেস্ট কথোপকথনের প্রতিটি রিভিশন তালিকাভুক্ত করে: কীভাবে এবং কেন সেটি পরিবর্তিত হয়েছে (prompt পরিবর্তনের জন্য রিফ্রেশ করা হয়েছে, আগের রিভিশন থেকে পুনরুদ্ধার করা হয়েছে), যোগ, অপসারণ ও পরিবর্তন করা আচরণ, সরানো বা বাতিল করা উদাহরণ এবং সারির ডিফ। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
generate_conversationsagent_id, ঐচ্ছিক count, styleOএজেন্টের খসড়ার বিপরীতে সিমুলেটেড টেস্ট কথোপকথন লেখে এবং তাদের সবচেয়ে কঠিন মুহূর্তকে উত্তর-কীসহ ভ্যালিডেশন উদাহরণে পরিণত করে। আগে dry_run দিয়ে কোট নিন; বাস্তব রানের জন্য এর quote_id এবং max_cost_cents প্রয়োজন। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
import_conversationsagent_id, ঐচ্ছিক since_days, max_callsOএজেন্টের সাম্প্রতিক কলকে টেস্ট কথোপকথনে রূপান্তর করে (প্রতি কলারের জন্য সর্বোচ্চ দুটি, রেকর্ডিং-বন্ধ কল এড়িয়ে যায়) এবং তাদের সবচেয়ে কঠিন মুহূর্তকে উদাহরণে পরিণত করে। আগে dry_run দিয়ে কোট নিন; বাস্তব রানের জন্য এর quote_id এবং max_cost_cents প্রয়োজন। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
refresh_conversationsagent_id, ঐচ্ছিক conversation_ids, from_prompt_revision_idOআচরণ যোগ, অপসারণ বা পরিবর্তনের পর এজেন্টের টেস্ট কথোপকথনকে এর বর্তমান prompt-এর সঙ্গে সামঞ্জস্যপূর্ণ করে: পুনর্নির্দেশ করে, আগের রিভিশন পুনরুদ্ধার করে (বাস্তব অডিওসহ) অথবা পুরোনো টার্ন পুনর্লিখন করে এবং যেসব উদাহরণের কলার টার্ন আর নেই সেগুলি বাতিল করে। আগে dry_run দিয়ে কোট নিন; বাস্তব রানের জন্য এর quote_id এবং max_cost_cents প্রয়োজন। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
get_conversation_jobjob_idR, Iএকটি জেনারেট, ইমপোর্ট বা রিফ্রেশ জব পায়: স্ট্যাটাস, এর সীমার বিপরীতে এখন পর্যন্ত খরচ এবং এটি কী লিখেছে বা রিফ্রেশ করেছে। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
run_replaysagent_id, ঐচ্ছিক overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_runD, Oএজেন্টের খসড়ার অধীনে, অথবা প্রার্থী prompt, ভয়েস বা টিয়ারের মতো ওভাররাইডের অধীনে এজেন্টের উদাহরণের একটি নমুনা পুনরায় চালায় এবং প্রতিটি উত্তরকে উদাহরণের উত্তর-কীর বিপরীতে বিচার করে। সঠিক রিপ্লে টার্নের রেকর্ড করা অডিও এমনভাবে চালায় যেমন লাইভ কল চালাত; প্রতিটি ইঞ্জিনের জন্য পাসের হার জানানো হয়। 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 পর্যাপ্ত জায়গা রেখে নির্ধারণ করুন। একটি সঠিক রিপ্লে স্বাভাবিক টার্ন এবং প্রোডাকশনে প্রয়োজনীয় ধরনের একটি পুনঃরানের জন্য নির্ধারিত বাজেটে চলে (উত্তরটি আবার রেস করে এবং একটি ওয়াচডগ পুনরায় চেষ্টা করে); আরও বেশি প্রয়োজন এমন টার্নকে ত্রুটি replay_budget_exhausted হিসেবে রেকর্ড করা হয়, budget_exhausted হিসেবে আলাদাভাবে গণনা করা হয়, পাসের হার থেকে বাদ দেওয়া হয় এবং টেস্ট স্প্লিটে কোনো কোহর্ট ব্যয় করে না। টেস্ট স্প্লিটে Bolt v2 ছাড়া অন্য কনফিগারেশনের অধীনে রেকর্ড করা কলার অডিওসহ একটি কোহর্ট প্রত্যাখ্যান করা হয় (test_needs_exact_replay) এবং অব্যবহৃত থাকে: সেই কনফিগারেশন dev স্প্লিটে পরিমাপ করুন। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
compare_configsagent_id, configs (2 থেকে 4, প্রথমটি বেসলাইন), ঐচ্ছিক sample_size, sample_seed, max_cost_cents, quote_id, dry_runOপ্রতিটি কনফিগারেশনের অধীনে একই উদাহরণ পুনরায় চালায় এবং পাসের হার, বেসলাইনের তুলনায় ঠিক ও নষ্ট হওয়া উদাহরণ, প্রথম অডিও পর্যন্ত লেটেন্সি, কলার কতবার স্বীকৃতি, টিক বা নীরবতার জন্য অপেক্ষা করেছে এবং প্রতি ইঞ্জিনে প্রতি টার্নের খরচ জানায়। run_replays-এর মতো dry_run দিয়ে কোট নিন। শুধু dev স্প্লিটে: টেস্ট স্প্লিটে এটি প্রত্যাখ্যান করা হয় (comparison_dev_only); dev-এ তুলনা করুন, তারপর নির্বাচিতটি run_replays দিয়ে পরিমাপ করুন। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
get_replay_runrun_id, ঐচ্ছিক include_traceR, Iএকটি রিপ্লে রানের মোট ফলাফল, পরিবর্তন এবং প্রতি-উদাহরণ ফলাফল, পাশাপাশি এর তুলনা গ্রুপ পায়। যেসব সঠিক রিপ্লের বাজেটের চেয়ে বেশি প্রয়োজন হয়েছে সেগুলি পাসের হারের বাইরে আলাদাভাবে (budget_exhausted) গণনা করা হয়। এজেন্ট ইটারেশন টুলকিট প্রয়োজন।
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 দিয়ে প্রত্যাখ্যান করা হয় এবং কিছুই টেক্সটে ফলব্যাক করে না), এবং শুধু ইঞ্জিনভিত্তিক মোট ফলাফল ফেরত দেয়: পাস রেট, তীব্রতা ও ধরন অনুসারে ব্যর্থতা, লেটেন্সি এবং খরচ। রিপ্লে সংরক্ষণ করা এর প্রথম ফলাফল কোহর্টটি ব্যবহার করে ফেলে, তাই পরবর্তী টেস্ট রান, যেকোনো prompt-এর জন্য, আরেকটি কোহর্ট নেয়, এবং কোনো কোহর্ট বাকি না থাকলে 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 এটি কখনো ব্যবহার করে না। Webhook অপরিবর্তিত থাকে। টুলকিটবিহীন প্রতিষ্ঠানগুলো কোনো 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 উদাহরণের ইতিহাস, উত্তর বা উত্তর-কী পুনর্লিখন করে, সেটি refreshed_needs_review লেবেলসহ আবার pending_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প্রোডাকশন রিট্রিভালের মাধ্যমে অনুসন্ধান করে।

ইন্টিগ্রেশন, ওয়েবহুক ও রিমোট 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, Iupdated_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_humansummaryOসহায়তার জন্য ThunderPhone টিমকে অনুরোধ করে। তারা 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ব্যালান্স এবং প্রামাণিক tier মূল্য পায়; কোনো পেমেন্ট পরিবর্তন উন্মুক্ত করা হয় না।
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-এর মতো একই পথে ফলাফলটি খসড়ায় লেখে। প্রতিটি সম্পাদনার পালা এলে সেই সময়ের prompt-এ প্রতিটি find অবশ্যই ঠিক একবার থাকতে হবে। কোনোটি না থাকলে কিছুই লেখা হয় না এবং ত্রুটিতে সম্পাদনাটির নাম থাকে:

কোডঅর্থকী করবেন
prompt_edit_not_foundবর্তমান খসড়া prompt-এ find টেক্সটটি নেই। 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 গ্রহণ করে: prompt এবং if_updated_at সহ PATCH /v1/agents/{agent_id}।

ধ্বংসাত্মক কাজ নিশ্চিত করা

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 আপনাকে নির্দিষ্ট পরিবর্তনটি নিশ্চিত করতে বলে, সেটি ফিরিয়ে নেওয়া যায় না বলে সতর্ক করার পরিবর্তে।

প্রারম্ভিক prompt

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এই টুলগুলোর সঙ্গে একজন সহকারী কীভাবে কাজ করবে: খসড়ায় ছোট ছোট ধাপ, প্রতিটি ডিপ্লয়ের আগে একটি পরীক্ষা, লাইভ বা বিলযোগ্য যেকোনো কিছুর জন্য ব্যবহারকারীর সম্মতি, এবং কখনোই গোপন তথ্য না চাওয়া।

একটি পড়তে resources/read ব্যবহার করুন। সর্বজনীন ফেচে স্বল্প টাইমআউট, 2 MiB সীমা এবং দশ মিনিটের ইন-প্রসেস ক্যাশ ব্যবহার করা হয়।

প্রোটোকল এবং ত্রুটি

সার্ভারটি 2025-06-18 এবং 2025-03-26 প্রোটোকল সংস্করণ সমর্থন করে; এটি সমর্থিত ক্লায়েন্ট সংস্করণ প্রতিধ্বনিত করে এবং অন্যথায় 2025-06-18 নির্বাচন করে। এটি initialize, ping, টুল, prompt, রিসোর্স এবং নোটিফিকেশন বাস্তবায়ন করে। নোটিফিকেশন 202 Accepted ফেরত দেয়। এই স্টেটলেস সার্ভার কোনো SSE লিসেনার বা সেশন মুছে ফেলার সুবিধা প্রকাশ করে না, তাই 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."
}

স্বতন্ত্র outbound_tcpa_confirmation_required: প্রিফিক্সটি place_call-এর জন্য রাখা হয়েছে। অজানা JSON-RPC মেথড HTTP 200 প্রতিক্রিয়ায় -32601 ফেরত দেয়। JSON-RPC ব্যাচ MCP 2025-06-18 দ্বারা সমর্থিত নয় এবং একটি পরিষ্কার -32600 অবৈধ-অনুরোধ ত্রুটি ফেরত দেয়।