Open in
ThunderPhone चा MCP सर्व्हर म्हणून वापर करा
Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code किंवा दुसऱ्या Streamable HTTP MCP क्लायंटमधून ThunderPhone व्हॉइस एजंट तयार करा, चाचणी करा, पडताळा आणि चालवा.
ThunderPhone येथे स्ट्रीम करण्यायोग्य 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 नसल्याचे हाताळलेला कॉल दोन्ही 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 प्राधान्याचे आहे; Claude 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
- ChatGPT अॅप निर्देशिकेत ThunderPhone दिसल्यास ते निवडा आणि कनेक्ट करा.
- अन्यथा सेटिंग्ज → अॅप्स आणि कनेक्टर्स → प्रगत सेटिंग्ज उघडा, डेव्हलपर मोड सुरू करा आणि
https://api.thunderphone.com/v1/mcpURL व 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 | एजंट कॉन्फिगरेशन | — | एजंट तयार करते. steps, handoffs, intro_clip आणि intro_ring_count यांसह update_agent सारख्याच सेटिंग्ज घेते. |
update_agent | agent_id, बदललेली फील्ड्स, पर्यायी prompt_edits, expected_prompt_sha256 | D | ड्राफ्टमध्ये असलेली मूल्ये बदलून, एजंट ड्राफ्टमध्ये फील्ड्स स्टेज करते. पुष्टीकरणाच्या टप्प्याशिवाय चालते: deploy_agent होईपर्यंत डिप्लॉय केलेला एजंट बदलत नाही आणि discard_agent_draft ड्राफ्ट पूर्ववत करते. तुम्ही max_hold_seconds, system_tool_settings आणि words देखील सेट करू शकता. prompt चा काही भाग बदलण्यासाठी prompt_edits पाठवा (prompt जागेवर संपादित करणे पहा). |
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 | ड्राफ्टसह एजंटच्या prompt मजकुरातील प्रत्येक बदलाची यादी करते; प्रत्येक बदलासोबत त्याने बदललेल्या पुनरावृत्तीशी फरक दिलेला असतो. तुमच्या कनेक्शनसाठी एजंट पुनरावृत्ती टूलकिट उपलब्ध असेल तेव्हा उपलब्ध (खाली पहा). |
review_prompt | agent_id, पर्यायी prompt, previous_prompt, quote_id, max_cost_cents | — | ड्राफ्ट prompt चे (किंवा तुम्ही पाठवलेल्या मजकुराचे) prompt शैली मार्गदर्शकाच्या तुलनेत पुनरावलोकन करते. प्रत्येक निष्कर्ष उतारा उद्धृत करतो, मार्गदर्शक तत्त्वाचे नाव देतो आणि शोधून-बदला संपादन सुचवतो; निकालात prompt ने मागितलेल्या वर्तनांची स्थिर IDs सह यादी, रिफॅक्टर करणे आवश्यक आहे का आणि एजंटच्या स्वतःच्या prompt साठी त्याची चाचणी संभाषणे रीफ्रेश करणे आवश्यक आहे का हेही दिलेले असते. एजंटवर काहीही बदलत नाही; ही यादी त्याच्या prompt पुनरावृत्तीसह जतन केली जाते. हे सशुल्क असल्याने केवळ-वाचन म्हणून चिन्हांकित केलेले नाही: प्रथम dry_run सह त्याचे कोटेशन मिळवा, नंतर परत येणारा quote_id आणि max_cost_cents सह dry_run शिवाय ते पुन्हा चालवा. या सशुल्क रन आता इतर टूलकिट रनप्रमाणेच संस्थेच्या एकाच टूलकिट भत्त्यात मोजल्या जातात. तुमच्या कनेक्शनसाठी एजंट पुनरावृत्ती टूलकिट उपलब्ध असेल तेव्हा उपलब्ध (खाली पहा). |
refactor_prompt | agent_id, पर्यायी prompt, inventory, instructions, quote_id, max_cost_cents | — | prompt चे शैली मार्गदर्शकाच्या स्वरूपात पुनर्लेखन करते आणि प्रत्येक वर्तन जसेच्या तसे ठेवले, विलीन केले, पुनर्मांडले किंवा वगळले असे मॅप करते. नवीन मजकूर आणि फरक परत करते आणि डीफॉल्टनुसार 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_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 | एजंटची ज्या संभाषणांवर चाचणी केली जाते त्यांची यादी देते. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
get_conversation | conversation_id | R, I | एका चाचणी संभाषणाचे त्याच्या सध्याच्या टर्नसह तपशील मिळवते. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
get_conversation_revisions | conversation_id, ऐच्छिक limit, offset | R, I | चाचणी संभाषणाची प्रत्येक पुनरावृत्ती सूचीबद्ध करते: ते कसे आणि का बदलले (prompt बदलासाठी रीफ्रेश केले, आधीच्या पुनरावृत्तीतून पुनर्संचयित केले), जोडलेले, काढलेले आणि बदललेले वर्तन, हलवलेली किंवा निष्क्रिय केलेली उदाहरणे आणि ओळ फरक. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
generate_conversations | agent_id, ऐच्छिक count, style | O | एजंटच्या मसुद्याविरुद्ध सिम्युलेटेड चाचणी संभाषणे लिहिते आणि त्यांतील सर्वात कठीण क्षणांना उत्तर कळांसह पडताळणी उदाहरणांमध्ये रूपांतरित करते. प्रथम dry_run सह कोट घ्या; वास्तविक रनसाठी त्याचा quote_id आणि max_cost_cents आवश्यक असतो. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
import_conversations | agent_id, ऐच्छिक since_days, max_calls | O | एजंटच्या अलीकडील कॉलचे चाचणी संभाषणांमध्ये रूपांतर करते (प्रत्येक कॉलरसाठी जास्तीत जास्त दोन, रेकॉर्डिंग बंद असलेले कॉल वगळले जातात) आणि त्यांच्या सर्वात कठीण क्षणांचे उदाहरणांमध्ये रूपांतर करते. प्रथम dry_run सह कोट घ्या; वास्तविक रनसाठी त्याचा quote_id आणि max_cost_cents आवश्यक असतो. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
refresh_conversations | agent_id, ऐच्छिक conversation_ids, from_prompt_revision_id | O | वर्तन जोडले, काढले किंवा बदलले गेल्यानंतर एजंटची चाचणी संभाषणे त्याच्या सध्याच्या prompt पर्यंत अद्ययावत करते: पुन्हा निर्देशित करते, आधीची पुनरावृत्ती पुनर्संचयित करते (वास्तविक ऑडिओसह) किंवा कालबाह्य टर्न पुन्हा लिहिते आणि ज्या उदाहरणांचा कॉलर टर्न नाहीसा झाला आहे ती निष्क्रिय करते. प्रथम dry_run सह कोट घ्या; वास्तविक रनसाठी त्याचा quote_id आणि max_cost_cents आवश्यक असतो. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
get_conversation_job | job_id | R, I | जनरेट, इम्पोर्ट किंवा रीफ्रेश जॉबची स्थिती, त्याच्या कमाल मर्यादेच्या तुलनेत आतापर्यंतचा खर्च आणि त्याने काय लिहिले किंवा रीफ्रेश केले ते मिळवते. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
run_replays | agent_id, ऐच्छिक overrides, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, 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) आणि न वापरलेलाच राहतो: त्या संरचनेचे मापन डेव्ह विभाजनावर करा. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
compare_configs | agent_id, configs (2 ते 4, पहिले बेसलाइन आहे), ऐच्छिक sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | प्रत्येक संरचनेखाली तीच उदाहरणे पुन्हा चालवते आणि उत्तीर्ण दर, बेसलाइनच्या तुलनेत दुरुस्त व बिघडलेली उदाहरणे, पहिल्या ऑडिओपर्यंतचा विलंब, कॉलरने पुष्टीकरण, टिक्स किंवा शांततेसाठी किती वेळा प्रतीक्षा केली आणि प्रत्येक इंजिननुसार प्रति टर्न खर्च नोंदवते. run_replays प्रमाणे dry_run सह कोट घ्या. केवळ डेव्ह विभाजनासाठी: चाचणी विभाजनावर ते नाकारले जाते (comparison_dev_only); डेव्हवर तुलना करा, नंतर निवडलेल्या पर्यायाचे मापन run_replays सह करा. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
get_replay_run | run_id, ऐच्छिक include_trace | R, I | रिप्ले रनची एकूण आकडेवारी, बदल आणि प्रत्येक उदाहरणाचे निकाल तसेच त्याचा तुलना गट मिळवते. त्यांच्या बजेटपेक्षा अधिक लागलेले अचूक रिप्ले उत्तीर्ण दराबाहेर, स्वतंत्रपणे (budget_exhausted) मोजले जातात. एजंट पुनरावृत्ती टूलकिट आवश्यक आहे. |
create_talk_link | agent_id, ऐच्छिक variant_id, language, expires_in_minutes | O | डॅशबोर्डमधील Talk बटणाप्रमाणे, एखादी व्यक्ती ब्राउझरमध्ये उघडून एजंटच्या सध्याच्या मसुद्याशी बोलू शकेल अशी एकदाच वापरता येणारी लिंक तयार करते. लिंक डीफॉल्टनुसार 30 मिनिटांनंतर कालबाह्य होते (जास्तीत जास्त 120); संभाषणासाठी Talk चाचणी कॉलप्रमाणे शुल्क आकारले जाते. Talk लिंक्स पहा. |
एजंट इटरेशन टूलकिट आवश्यक म्हणून चिन्हांकित केलेली साधने त्याचा भाग आहेत; टूलकिट बीटामध्ये असताना प्रत्येक संस्थेसाठी सक्षम केले जाते आणि त्याशिवाय ती पुढे काय करावे यासह feature_not_enabled परत करतात. एजंटचे प्रत्येक संभाषण त्याच्या dev split किंवा test split मध्ये असते. test split बदल मोजण्यासाठी आहे, तो सुधारण्यासाठी नाही, त्यामुळे संभाषण साधने test-split संभाषणासाठी फक्त त्याचा id, split, source, status आणि counts परत करतात. test split वरील replay रन एक संपूर्ण test cohort पुन्हा चालवते (sample_size आणि sample_seed दुर्लक्षित केले जातात), प्रत्येक उदाहरण त्याच्या डेटाने अनुमती दिलेल्या इंजिनवर, रनपूर्वी उदाहरणावरून ठरवलेले (रेकॉर्ड केलेल्या कॉलर ऑडिओसाठी exact, फक्त मजकूर असलेल्या उदाहरणासाठी text; Bolt v2 व्यतिरिक्तच्या कॉन्फिगरेशनसाठी exact मार्ग नसतो, त्यामुळे रेकॉर्ड केलेला ऑडिओ असलेला cohort त्यासाठी test_needs_exact_replay सह नाकारला जातो आणि वापरला जात नाही; engine वगळले जाते किंवा auto असते, कारण exact किंवा text हे test_engine_per_example सह नाकारले जातात आणि काहीही text वर फॉलबॅक होत नाही), आणि प्रत्येक इंजिनसाठी फक्त एकूण निकाल परत करते: pass rate, गंभीरता आणि प्रकारानुसार अपयश, विलंब आणि खर्च. replay जतन करणारा त्याचा पहिला निकाल cohort वापरून टाकतो, त्यामुळे कोणत्याही prompt साठी पुढील test रन दुसरा cohort घेते, आणि कोणताही शिल्लक नसल्यास ती no_test_cohort सह नाकारली जाते (कॉल आयात केल्याने किंवा संभाषणे जनरेट केल्याने नवीन cohorts भरले जातात); एखादा जतन करण्यापूर्वी संपणारी रन (Core त्याची ऑडिओ उदाहरणे exact रीतीने पुन्हा चालवू शकत नाही, exact_replay_unavailable, त्याची replay क्षमता व्यस्त राहते, core_busy, किंवा प्रत्येक turn चे बजेट संपते, replay_budget_exhausted) cohort न वापरलेलाच ठेवते. dev split वर, Core चालवू शकत नसलेला exact replay text वर फॉलबॅक होतो आणि रन degraded म्हणून चिन्हांकित केली जाते. तुलना फक्त dev split वर चालतात. प्रत्येक सशुल्क साधन त्याच्या dry run मधील quote_id स्वीकारते, जो एका रनसाठी वैध असतो: रन सुरू होताच तो एकदाच कायमस्वरूपी वापरला जातो, आणि त्यापूर्वी नाकारलेले किंवा अयशस्वी झालेले सुरूकरण तो वापरण्यायोग्य ठेवते; त्यानंतर अयशस्वी झालेली रन नवीन quote_id साठी नवीन dry run सह पुन्हा चालवली जाते. OAuth सह, review_prompt आणि refactor_prompt यांना dry runs सह agents:write scope आवश्यक असतो, आणि संभाषण व replay साधनांना चालण्यासाठी testing:write आवश्यक असते. लोकांना डॅशबोर्डमध्ये संपूर्ण test split दिसतो. ज्या कॉलचा कॉलर एजंटच्या test split मध्ये आहे तो वेगळा ठेवला जातो, कारण तो test set चा भाग असतो. टूलकिट असलेल्या संस्थेत, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade आणि export_calls तो कॉल त्याचे transcript, recording, history, grade किंवा report शिवाय अचूकपणे {"call_id", "start_time", "held_out": true} म्हणून परत करतात (export च्या rows मध्ये start_time ऐवजी started_at); कॉलचे इतर सर्व fields अनुपस्थित असतात, म्हणून इतर काहीही करण्यापूर्वी वेगळा ठेवलेला row त्याच्या held_out वरून ओळखा. REST API API keys आणि OAuth tokens साठीही असेच करते, आणि अनेक कॉलवरील त्याच्या views मध्ये (report summaries, issue clusters, investigations, pipeline reports) वेगळे ठेवलेले कॉल त्यांच्या counts, clusters आणि samples मधून वगळले जातात, तसेच मॉडेलने त्यांच्यासाठी लिहिलेला कोणताही मजकूर रोखला जातो. वेगळ्या ठेवलेल्या कॉलवर write केल्यास (grading, त्याला test scenario म्हणून promote करणे, turn पुन्हा जनरेट करणे) held_out_call सह नाकारले जाते. कोणीतरी वेगळ्या ठेवलेल्या कॉलमधून promote केलेले test scenario list_test_scenarios मधून आणि test runs मध्ये अचूकपणे {"id", "held_out": true} म्हणून परत येते, आणि त्यातून आलेली simulation रन get_test_run व simulation साधनांमधून अचूकपणे {"id", "scenario_id", "held_out": true} म्हणून परत येते; त्याचे simulated calls देखील वेगळे ठेवले जातात आणि test runs तरीही ते चालवतात. वेगळ्या ठेवलेल्या कॉलरच्या कॉलमधून कॉपी केलेले dev conversation, example किंवा replay result (splits प्रत्येक एजंटनुसार असतात, त्यामुळे तो कॉलर दुसऱ्या एजंटच्या test split मध्ये असू शकतो) test-split मधील परिणामाप्रमाणे वाचले जाते. लोकांना डॅशबोर्डमध्ये वेगळे ठेवलेले कॉल पूर्णपणे दिसतात, आणि प्रत्येक कॉल आवश्यक असलेल्या integration साठी admin एका API key ला ते पूर्णपणे पाहू देऊ शकतो (include_held_out_calls, डीफॉल्टनुसार बंद, फक्त डॅशबोर्डमध्ये सेट केले जाते); MCP ते कधीही वापरत नाही. Webhooks मध्ये बदल नाही. टूलकिट नसलेल्या संस्थांना held_out field दिसत नाही आणि कोणताही बदल होत नाही.
generate_conversations, import_conversations आणि refresh_conversations मॉडेल क्रेडिट्स वापरतात. प्रथम त्यांना dry_run: true सह कॉल करा: प्रतिसादात टप्प्याटप्प्याने खर्चाचा अंदाज, quote_id मिळतो आणि काहीही चालवले जात नाही. अंदाजामध्ये रन सामान्य आकारात करू शकणाऱ्या प्रत्येक विनंतीचा समावेश असतो. प्रत्यक्ष रनसाठी तो quote_id (तो 15 मिनिटांनंतर कालबाह्य होतो आणि फक्त त्याच आर्ग्युमेंट्ससह कार्य करतो) आणि कमाल कठोर मर्यादा असलेले max_cost_cents आवश्यक असते: प्रत्येक विनंतीपूर्वी जॉब त्या विनंतीचा जास्तीत जास्त होऊ शकणारा खर्च राखून ठेवतो आणि न बसणारी विनंती पाठवण्याऐवजी थांबतो, तसेच त्याने लिहिलेले जतन करतो. या राखीव ठेवण्यामुळे रन त्याच्या मर्यादेतील काही रक्कम न वापरता थांबू शकतो; अंदाजातील largest_reservation_cents किती अतिरिक्त मर्यादा ठेवायची ते सांगते. सिम्युलेट केलेले कॉलर एजंटच्या prompt मधून तयार केले जातात; style: "adversarial" prompt मधील कमकुवत मुद्द्यांवर दबाव आणणारे कठीण कॉलर तयार करते आणि ती संभाषणे नेहमी dev स्प्लिटमध्ये जातात. target: "changed_behaviors" कॉलरना मागील prompt संपादनात काय बदलले यावर केंद्रित करते. प्रत्येक एजंट एका वेळी यापैकी एक जॉब किंवा एक रीप्ले रन चालवतो, त्यामुळे रीफ्रेश कधीही रीप्ले चालू असलेली उदाहरणे बदलत नाही; दुसरा चालू असताना सुरू करण्याचा प्रयत्न job_active, replay_run_active किंवा conversation_job_active आणि कशाची प्रतीक्षा करायची ते परत करतो.
वर्तन जोडणाऱ्या, काढून टाकणाऱ्या किंवा बदलणाऱ्या prompt संपादनानंतर, एजंटच्या मसुद्यावरील review_prompt इतर वर्तन असलेल्या prompt साठी किती चाचणी संभाषणे लिहिली होती ते नोंदवतो (conversations.refresh_suggested). त्यानंतर refresh_conversations ती संभाषणे मसुद्याशी अद्ययावत करते, त्यामुळे dev आणि test संच नवीन prompt मोजतो, जे तो तयार करू शकला असता अशा इतिहासांवर. रीफ्रेश कधीही काहीही गमावत नाही: प्रत्येक संभाषण प्रत्येक आधीचे पुनरावलोकन जतन करते आणि काढलेला नियम परत आल्यावर, तो अस्तित्वात होता तेव्हाचे पुनरावलोकन त्याच्या वास्तविक कॉलर ऑडिओसह पुनर्संचयित केले जाते. कोडिंग एजंटने सुरू केलेला रीफ्रेश test-स्प्लिट संभाषणे आणि राखून ठेवलेल्या कॉलमधून कॉपी केलेली संभाषणे निवड, अंदाज, प्रगती आणि खर्चातून वगळतो; conversation_ids मध्ये त्यापैकी एखाद्याचे नाव दिल्यास 403 test_conversation परत मिळते. व्यक्ती डॅशबोर्डमधून ती रीफ्रेश करते आणि कोडिंग एजंटना त्या जॉबचे निकाल फक्त आयडी आणि संख्या म्हणून दिसतात. ज्या active उदाहरणाचा इतिहास, उत्तर किंवा उत्तर-कुंजी रीफ्रेश पुन्हा लिहिते, ते refreshed_needs_review लेबलसह पुन्हा pending_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 | उत्पादनातील पुनर्प्राप्तीद्वारे शोधते. |
इंटिग्रेशन्स, वेबहुक्स आणि रिमोट 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 बदल पूर्ववत करता येणार नाही अशी चेतावणी देण्याऐवजी तुम्हाला अचूक बदलाची पुष्टी करण्यास सांगते.
प्रारंभिक prompt
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 नाव आणि त्याचे घोषित arguments वापरून prompts/get वापरा.
संसाधने
resources/list सार्वजनिक, कॅश केलेले संदर्भ उघड करते:
| URI | सामग्री |
|---|---|
thunderphone://docs/llms.txt | सार्वजनिक दस्तऐवजीकरण अनुक्रमणिका. |
thunderphone://docs/quickstart | क्विकस्टार्ट Markdown. |
thunderphone://pricing | सध्याचे सार्वजनिक किंमतनिर्धारण Markdown. |
thunderphone://guides/prompt-style | review_prompt ज्याच्या विरुद्ध तपासते ते व्हॉइस एजंट prompt शैली मार्गदर्शक. त्यातील मार्गदर्शक आयडी (P1, W2 इत्यादी) हेच निष्कर्षांमध्ये उद्धृत केले जातात. |
thunderphone://guides/working-with-thunderphone | सहाय्यकाने या टूल्ससह कसे काम करावे: मसुद्यावर लहान फेऱ्या, प्रत्येक डिप्लॉयपूर्वी तपासणी, लाइव्ह किंवा बिल आकारले जाणाऱ्या कोणत्याही गोष्टीसाठी वापरकर्त्याची होकारार्थी संमती, आणि गुपिते कधीही न विचारणे. |
resources/read वापरून एक वाचा. सार्वजनिक fetch साठी कमी timeout, 2 MiB मर्यादा आणि दहा मिनिटांचा इन-प्रोसेस कॅश वापरला जातो.
प्रोटोकॉल आणि त्रुटी
सर्व्हर 2025-06-18 आणि 2025-03-26 या प्रोटोकॉल आवृत्त्यांना समर्थन देतो; तो समर्थित क्लायंट आवृत्ती परत पाठवतो आणि अन्यथा 2025-06-18 निवडतो. तो initialize, ping, साधने, prompt, संसाधने आणि सूचना अंमलात आणतो. सूचनांसाठी 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 परत करतात. MCP 2025-06-18 द्वारे JSON-RPC बॅचेस समर्थित नाहीत आणि त्या स्वच्छ -32600 अवैध-विनंती त्रुटी परत करतात.