Open in
Tumia ThunderPhone kama seva ya MCP
Unda, jaribu, thibitisha na endesha ejenti za sauti za ThunderPhone kutoka Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code au mteja mwingine wa Streamable HTTP MCP.
ThunderPhone hutoa seva ya Streamable HTTP Model Context Protocol katika:
https://api.thunderphone.com/v1/mcpHii ni mwelekeo kinyume na kuunganisha seva ya mbali ya MCP kwenye ejenti ya sauti:
| Mwelekeo | Matokeo |
|---|---|
| Seva ya mbali ya MCP → ejenti ya ThunderPhone | Ejenti ya sauti inaweza kuita zana za seva ya mbali. |
| ThunderPhone → mteja wako wa MCP | Ejenti yako ya uandishi wa msimbo inaweza kujenga, kujaribu na kuendesha ThunderPhone. |
Thibitisha utambulisho
Tumia OAuth kwa chaguomsingi kwa wateja wa saraka: ingia, chagua shirika, na idhinisha ruhusa zilizoombwa. Katisha muunganisho chini ya Mipangilio → Usalama → Programu ulizounganisha. Kubadilisha au kuweka upya nenosiri lako, au kubadilisha barua pepe ya akaunti yako, pia hubatilisha muunganisho, hivyo unganisha tena mteja baadaye.
Kwa wateja waliowekwa na ufunguo wa API, unda ufunguo wa sk_live_ chini ya Miunganisho → Funguo za API na uufichue kwa mteja wako wa MCP kama THUNDERPHONE_API_KEY. Ufunguo umefungwa kwa shirika moja; id inayomilikiwa na shirika lingine hutenda kana kwamba haijapatikana.
Mashirika yanayoshughulikia PHI
Iwapo simu za shirika lako zinaweza kuwa na taarifa za afya zilizolindwa (PHI),
kwa sababu una BAA na ThunderPhone au ejenti zako zimeainishwa kuwa
zinachakata PHI, URL iliyo hapo juu hairudishi kamwe maudhui ya simu: nakala za
maandishi, rekodi, alama, orodha za simu, uhamishaji, matokeo ya kampeni,
uchanganuzi na maarifa ya simu, mazungumzo yaliyojengwa kutoka kwa simu halisi
na matokeo ya kurudia. Zana hizo hurudisha hitilafu yenye
code: "phi_content_unavailable". Kujenga, kujaribu na kusanidi ejenti
hufanya kazi kama kawaida.
URL hiyo ndiyo iliyoorodheshwa katika saraka za umma za wasaidizi, ambazo huenda zisiweze kubeba PHI. Ikiwa shirika lako lina BAA yake yenyewe na mtoa huduma wa msaidizi inayoshughulikia eneo la kazi unalotumia:
- Msimamizi wa shirika hufungua Shirika → Jumla → Ufikiaji wa msaidizi wa AI katika ThunderPhone na kuthibitisha ufunikaji huo.
- Unganisha msaidizi kama kiunganishi maalum ukitumia URL hii badala yake:
https://api.thunderphone.com/v1/mcp/baaMaudhui ya simu yanapatikana hapo, ikiwemo simu ambazo zinaweza kuwa na PHI. Kuondoa uthibitisho husimamisha hili kwenye ombi linalofuata la msaidizi. Simu ambayo shirika lako liliishughulikia kama isiyo na PHI inapatikana kwenye URL yoyote kati ya hizo.
Njia mbadala za CLI na stdio
ThunderPhone CLI inaweza kuandika usanidi wa mteja huku ikihifadhi seva zisizohusiana:
npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope userBaada ya usakinishaji wa kimfumo mzima wa @thunderphone/mcp, tumia thunderphone-mcp setup pamoja na
chaguo zilezile. Usanidi unasaidia Claude Code, Codex, Cursor, VS Code, Gemini, Claude
Desktop na Windsurf. HTTP ya moja kwa moja inapendekezwa; Desktop hutumia stdio.
Kwa mteja yeyote anayeweza kutumia stdio, sanidi command: "npx" pamoja na
args: ["-y", "@thunderphone/mcp"]. Kifungashi hutumia THUNDERPHONE_API_KEY kwanza,
kisha vitambulisho kutoka thunderphone login, kikihuisha tokeni zilizoisha muda wake, kisha
OAuth kupitia mcp-remote. Kuingia kwa kifaa na OAuth kunahitaji uanzishaji husika wa
OAuth ya API. Njia ya ufunguo wa API haihitaji. Usanidi wa HTTP wa moja kwa moja hausomi
hifadhi ya vitambulisho ya CLI; tumia kifungashi cha stdio kutumia tena kuingia kwa kifaa.
Hizi ni njia mbadala za usanidi wa mikono wa wateja hapa chini.
Usanidi wa mteja
Claude na ChatGPT huingia kwa kutumia OAuth; hakuna API key inayohusika. Ikiwa bado huna akaunti ya ThunderPhone, chagua Fungua akaunti kwenye ukurasa wa kuingia, kisha utarudi kwenye skrini ya kuidhinisha baada ya kuthibitisha barua pepe yako.
Claude (wavuti, kompyuta ya mezani, na simu)
- Fungua Geuza kukufaa → Viunganishi (Mipangilio → Viunganishi katika matoleo ya zamani). Ikiwa ThunderPhone inaonekana katika saraka ya viunganishi, ichague. Vinginevyo, chagua Ongeza kiunganishi maalum, ipe jina
ThunderPhone, na uwekehttps://api.thunderphone.com/v1/mcp. - Chagua Unganisha, ingia kwenye ThunderPhone, chagua shirika, na uidhinishe ruhusa.
- Kwenye gumzo, wezesha ThunderPhone kutoka kwenye menyu ya zana na uombe unachohitaji, kwa mfano "Orodhesha ejenti zangu".
Claude huomba uthibitisho kabla ya kutumia kila zana kwa mara ya kwanza. Ili kuruka vichocheo vingi hivyo, fungua Geuza kukufaa → Viunganishi → ThunderPhone na uweke Zana za kusoma pekee ziruhusiwe kila wakati. Zana hizo hutafuta taarifa pekee: ejenti, simu, nakala za mazungumzo, salio, na nyaraka. Acha Zana za kuandika/kufuta katika hali ya kuidhinishwa ikiwa unataka kuona kila mabadiliko kabla hayajatokea.
Viunganishi maalum vinahitaji mpango wa Claude unaolipiwa. Kwenye mipango ya Team na Enterprise, mmiliki huongeza kiunganishi kwanza chini ya mipangilio ya viunganishi ya shirika, kisha kila mwanachama huunganisha akaunti yake mwenyewe ya ThunderPhone.
Kinachotofautiana katika Claude
Claude (kiunganishi na programu-jalizi ya Claude Code) hupata seti ndogo zaidi ya zana, kwa kufuata sera ya saraka ya viunganishi vya Claude:
- Kila simu na ujumbe wa maandishi huthibitishwa mmoja baada ya mwingine.
place_callnasend_smskwanza hurejesha mwoneko wa awali (ejenti, namba za kutuma na kupokea, na kwa ujumbe wa maandishi, ujumbe wenyewe) pamoja naconfirmation_token; hakuna simu inayopigwa au ujumbe unaotumwa hadi Claude irudie ombi kwa tokeni baada ya kukubali kwako. - Hakuna usimamizi wa kampeni.
create_campaign,add_campaign_contactsnacampaign_actionhazipatikani; unda, pakia na anza kampeni katika dashibodi.list_campaigns,get_campaign_statsnacheck_campaignbado zinafanya kazi. - Hakuna
test_integration. Jaribu ombi la ujumuishaji kutoka kwenye ukurasa wake katika dashibodi. preview_voicehucheza salamu ya mfano isiyobadilika kwa sauti na lugha unayochagua; haisemi maandishi maalum.list_voicesnalist_agentshurejesha muhtasari;get_agentina usanidi kamili wa ejenti.
Taarifa ya AI
Kila simu ambayo ejenti wa ThunderPhone hupiga au kujibu huanza kwa taarifa ya AI inayotolewa kwa sauti. Kwa chaguo-msingi husema "Simu hii inahusisha msaidizi wa AI na itarekodiwa na kunakiliwa kwa maandishi." Kuizima (consent_announcement_enabled false, au ai_live_processing_disclosure_override off) kunakataliwa isipokuwa msimamizi wa shirika awe ameweka kwanza uthibitisho uliotiwa saini katika dashibodi, kutoka kwa mteja wowote, ikiwemo Claude.
ChatGPT
- Ikiwa ThunderPhone inaonekana katika saraka ya programu tumizi za ChatGPT, ichague na uiunganishe.
- Vinginevyo, fungua Mipangilio → Programu na Viunganishi → Mipangilio ya kina, washa Hali ya msanidi, na uunde kiunganishi chenye URL
https://api.thunderphone.com/v1/mcpna uthibitishaji wa OAuth. - Ingia kwenye ThunderPhone, chagua shirika, na uidhinishe ruhusa. Ongeza ThunderPhone kwenye gumzo kutoka kwenye menyu ya zana.
Kufuta ejenti au nambari ya simu, kutupa rasimu, kuzindua kampeni, na kutuma ombi la majaribio linaloweza kuandika kwenye mfumo wa nje kunahitaji uthibitisho wa pili katika programu yoyote; tazama Kuthibitisha vitendo vya uharibifu.
Claude Code
claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
--header "Authorization: Bearer $THUNDERPHONE_API_KEY"Codex
Ongeza hii kwenye ~/.codex/config.toml:
[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"Cursor
Unda .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}Claude Desktop
Ongeza daraja la mcp-remote kwenye usanidi wa Claude Desktop:
{
"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
Unda .vscode/mcp.json na uweke ufunguo kupitia kidokezo cha ingizo cha 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}"
}
}
}
}Zana
Kila zana ina ufafanuzi wa MCP. Kwenye majedwali, R inamaanisha kusoma pekee, D ni uharibifu, I ni idempotenti, na O ni mwingiliano wa mtandao/ulimwengu wazi. Kistari kinamaanisha hakuna kidokezo kilichowekwa.
Muunganisho
| Zana | Hoja kuu | Ufafanuzi | Inachofanya |
|---|---|---|---|
get_connection_identity | — | R, I | Huthibitisha kitambulisho na kurudisha shirika lake pamoja na metadata salama ya kitambulisho. |
Ejenti
| Zana | Hoja kuu | Maelezo | Inachofanya |
|---|---|---|---|
list_agents | — | R, I | Huorodhesha ejenti. |
get_agent | agent_id | R, I | Hupata ejenti moja. |
create_agent | usanidi wa ejenti | — | Huunda ejenti. Huchukua mipangilio sawa na update_agent, ikijumuisha steps, handoffs, intro_clip na intro_ring_count. |
update_agent | agent_id, sehemu zilizobadilishwa, prompt_edits ya hiari, expected_prompt_sha256 | D | Huweka sehemu kwenye rasimu ya ejenti, ikibadilisha yaliyokuwa kwenye rasimu. Hufanya kazi bila hatua ya uthibitisho: ejenti iliyotumwa haibadiliki hadi deploy_agent itumiwe, na discard_agent_draft hurudisha rasimu katika hali ya awali. Unaweza pia kuweka max_hold_seconds, system_tool_settings, na words. Ili kubadilisha sehemu ya prompt, tuma prompt_edits (tazama Kuhariri prompt mahali pake). |
deploy_agent | agent_id, if_updated_at ya hiari | D, I | Hupandisha rasimu hadi uzalishaji. |
discard_agent_draft | agent_id, if_updated_at ya hiari, confirmation_token kwenye ombi la pili | D, I | Hutupa mabadiliko yaliyowekwa. Hatua mbili, tazama Kuthibitisha vitendo vya uharibifu. |
duplicate_agent | agent_id, name ya hiari | — | Hunakili ejenti ndani ya shirika. |
delete_agent | agent_id, confirmation_token kwenye ombi la pili | D, I | Hufuta ejenti kabisa. Hatua mbili. |
list_agent_versions | agent_id | R, I | Huorodhesha matoleo ya usanidi uliotumwa. |
list_prompt_revisions | agent_id, source ya hiari, limit, offset | R, I | Huorodhesha kila mabadiliko kwenye maandishi ya prompt ya ejenti, yakiwemo rasimu, kila moja likiwa na diff dhidi ya marekebisho iliyobadilisha. Inapatikana wakati seti ya zana ya uboreshaji wa ejenti inapatikana kwenye muunganisho wako (tazama hapa chini). |
review_prompt | agent_id, prompt ya hiari, previous_prompt, quote_id, max_cost_cents | — | Hukagua prompt ya rasimu (au maandishi unayotuma) kulingana na mwongozo wa mtindo wa prompt. Kila matokeo hunukuu kifungu, hutaja mwongozo na kutoa hariri ya tafuta na ubadilishe; matokeo pia huorodhesha mienendo ambayo prompt inaomba, yenye vitambulisho thabiti, iwapo uundaji upya wa muundo unahitajika na, kwa prompt ya ejenti yenyewe, iwapo mazungumzo yake ya majaribio yanahitaji kusasishwa. Haibadilishi chochote kwenye ejenti; orodha huhifadhiwa pamoja na marekebisho yake ya prompt. Inalipiwa, kwa hivyo haijawekwa alama ya kusoma tu: kwanza ipate bei kwa dry_run, kisha iendeshe tena bila dry_run, kwa quote_id inayorejesha na max_cost_cents. Uendeshaji huu unaolipiwa sasa huhesabiwa dhidi ya posho ileile ya seti ya zana ya shirika kama uendeshaji mwingine wa seti ya zana. Inapatikana wakati seti ya zana ya uboreshaji wa ejenti inapatikana kwenye muunganisho wako (tazama hapa chini). |
refactor_prompt | agent_id, prompt ya hiari, inventory, instructions, quote_id, max_cost_cents | — | Huandika upya prompt katika muundo wa mwongozo wa mtindo na huainisha kila mwenendo kama uliohifadhiwa, uliounganishwa, ulioandikwa upya au ulioondolewa. Hurejesha maandishi mapya na diff, na kwa chaguo-msingi huyasoma tena ili kuripoti behavior_changes (zilizoongezwa, zilizoondolewa au zilizobadilishwa) na behavior_preserved; yatumie kwa update_agent. Inalipiwa: ipate bei kwa dry_run, kisha iendeshe mara moja kwa quote_id inayorejesha na max_cost_cents. Inapatikana wakati seti ya zana ya uboreshaji wa ejenti inapatikana kwenye muunganisho wako (tazama hapa chini). |
list_reusable_instructions | — | R, I | Huorodhesha maagizo yanayoweza kutumika tena: kanuni za prompt zinazoshirikiwa zilizounganishwa na ejenti nyingi kwa reusable_instruction_ids za update_agent. |
create_reusable_instruction | name, content | — | Huunda agizo linaloweza kutumika tena ambalo halijaunganishwa. Wasimamizi pekee. |
Nambari za simu na waendeshaji
| Chombo | Hoja kuu | Vifafanuzi | Kazi yake |
|---|---|---|---|
list_phone_numbers | — | R, I | Huorodhesha nambari za shirika na uelekezaji. |
get_phone_number_limits | — | R, I | Hupata matumizi na vikomo vya nambari zinazosimamiwa. |
provision_phone_number | hiari area_code, city, state, idempotency_key | D, O | Hunua nambari ya kupokea simu inayosimamiwa na ThunderPhone. |
list_voip_connections | — | R, I | Huorodhesha watoa huduma wa mawasiliano wa wateja waliounganishwa. |
search_voip_numbers | connection_id, country, type, hiari area_code | R, I, O | Hutafuta orodha ya nambari za mtoa huduma. |
import_voip_numbers | connection_id, numbers | D, O | Huagiza nambari ambazo tayari zinamilikiwa na mtoa huduma. |
update_phone_number | phone_number_id, sehemu za uelekezaji/lebo/webhook | D | Husasisha uelekezaji wa nambari, ikiwemo uteuzi wa ejenti. |
delete_phone_number | phone_number_id, confirm, hiari release_at_provider, confirmation_token kwenye ombi la pili | D, I, O | Huachilia nambari. Hatua mbili. |
get_voip_setup_session | hiari session_id | R, I | Husoma usanidi elekezi wa mtoa huduma (hali, orodha hakiki, swali linalosubiriwa), au huorodhesha usanidi ulio wazi. Usanidi huanzishwa kwenye dashibodi kwa sababu unahitaji nenosiri la mtoa huduma. Kwa wasimamizi pekee. |
answer_voip_setup_question | session_id, question_id, answer | O | Hupitisha jibu la mtumiaji kwa usanidi. Nenosiri, idhini ya simu ya majaribio, anwani ya seva, jina la mtumiaji na kuruhusu ThunderPhone iingie kwenye akaunti ya mtoa huduma hujibiwa katika kielekezi cha usanidi pekee; kwa hayo hurejesha kiungo cha kielekezi na haitumi chochote. |
save_voip_setup | session_id, hiari name, confirmation_token kwenye ombi la pili | D, I, O | Huhifadhi muunganisho wa rasimu uliounganishwa ili uweze kutumika. Hatua mbili. |
check_phone_number | phone_number au phone_number_id | R, I, O | Huchunguza mojawapo ya nambari za shirika lenyewe kwa kutumia ushahidi: uelekezaji, muunganisho, uthibitishaji, simu za hivi karibuni za mtoa huduma na za majaribio, na mahali ambapo mtoa huduma huipeleka. |
SMS
| Zana | Hoja kuu | Vidokezo | Inachofanya |
|---|---|---|---|
send_sms | from_number, to, body, idempotency_key | D, I, O | Hutuma SMS moja ya maandishi matupu kupitia nambari ya Twilio au Telnyx iliyounganishwa. |
Simu
| Zana | Hoja kuu | Maelezo | Inachofanya |
|---|---|---|---|
list_calls | vichujio vya hiari, limit, offset | R, I | Huorodhesha simu kwa vichujio vya historia ya simu vya REST, ikijumuisha exclude_test_calls. |
get_call | call_id | R, I | Hupata hali ya simu na metadata. |
get_call_transcript | call_id, live ya hiari | R, I | Hupata nakala ya mazungumzo ya simu. |
get_call_audio_url | call_id, download ya hiari | R, I, O | Hurejesha URL ya sauti iliyotiwa sahihi; kamwe haitiririshi sauti kupitia MCP. |
get_call_grade | call_id | R, I | Hupata tathmini ya hivi karibuni zaidi ya simu. |
place_call | agent_id, from_number, to_number | D, O | Hupiga simu moja ya kutoka isiyo idempotenti. |
export_calls | vichujio vya simu, export_format | R, I | Husafirisha hadi kikomo cha endpoint ya REST kama JSON au CSV. |
get_call_analytics | since_days ya hiari, agent_id | R, I | Hujumlisha simu halisi kwa hali, mwelekeo, matokeo, tathmini na tatizo, huku simu za majaribio zikihesabiwa kivyake. |
get_call_insights | call_ids (hadi 10) | R, I | Hupata tathmini, matokeo, muhtasari na matatizo yaliyogunduliwa ya simu kadhaa kwa wakati mmoja. |
Upimaji na uthibitishaji
| Zana | Hoja kuu | Maelezo | Inachofanya |
|---|---|---|---|
list_test_scenarios | agent_id | R, I | Huorodhesha hali za majaribio. |
create_test_scenario | agent_id, title, scenario_prompt, masharti ya hiari | — | Huunda hali ya majaribio. |
generate_test_scenarios | agent_id, count ya hiari, include_edge_cases, locale | O | Huzalisha hali kutoka kwa prompt ya ejenti. |
run_agent_tests | agent_id, channel, consent_to_charge, uteuzi/matrix ya hiari | D, O | Hutekeleza hali kupitia wavuti au simu. |
get_test_run | agent_id, batch_id | R, I | Hupata hali ya kundi na matokeo kwa kila hali. |
test_my_agent | agent_id, consent_to_charge, scenario_ids ya hiari, count, wait_seconds | D, O | Hupima ejenti kwa simu moja: huendesha hali zake zilizohifadhiwa (ikizalisha baadhi ikiwa haina) na kusubiri hadi dakika moja kwa maamuzi, au hurejesha batch_id kwa get_test_run. Hutozwa kama run_agent_tests. |
test_in_text | agent_id, callers (maelezo 1 hadi 3), version ya hiari, direction | O | Jaribio huru la maandishi: wapigaji simu wa kuigwa huzungumza na rasimu ya ejenti (au toleo la moja kwa moja) kwa maandishi kupitia mchakato halisi, na nakala za mazungumzo hurudi baada ya takriban dakika moja. Matokeo ya zana yameigwa. |
run_simulation | agent_id, consent_to_charge, scenario_prompt ya hiari, direction, language | D, O | Huanzisha simu moja ya kuigwa kati ya mpigaji simu wa AI na rasimu ya ejenti, ili mtu aweze kusikiliza mabadiliko. Hurejesha utekelezaji ukiwa in_progress. Hurekodiwa ejenti inaporekodi simu, na hupimwa baada ya kuisha. Hutozwa kama simu ya majaribio, kwanza kutoka kwenye bajeti ya majaribio ya bila malipo. |
get_simulation | simulation_id | R, I | Hupata hali ya simu ya kuigwa na, inapomalizika, ilichozalisha: URL ya muda mfupi ya rekodi na nakala ya mazungumzo ejenti inaporekodi simu, pamoja na alama baada ya upimaji kukamilika (null kabla ya hapo). |
list_validation_runs | agent_id | R, I | Huorodhesha utekelezaji wa hivi karibuni wa uthibitishaji wa rasimu. |
get_validation_status | agent_id | R, I | Hupata hali ya hivi karibuni ya uthibitishaji na ulinganifu wa rasimu. |
list_conversations | agent_id, split ya hiari, source | R, I | Huorodhesha mazungumzo ambayo ejenti hujaribiwa dhidi yake. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
get_conversation | conversation_id | R, I | Hupata mazungumzo moja ya majaribio pamoja na zamu zake za sasa. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
get_conversation_revisions | conversation_id, limit ya hiari, offset | R, I | Huorodhesha kila marekebisho ya mazungumzo ya majaribio: jinsi na sababu yalivyobadilika (yaliyosasishwa kwa mabadiliko ya prompt, yaliyorejeshwa kutoka marekebisho ya awali), tabia zilizoongezwa, kuondolewa na kubadilishwa, mifano iliyohamishwa au kuondolewa, na tofauti za safu. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
generate_conversations | agent_id, count ya hiari, style | O | Huandika mazungumzo ya majaribio yaliyoigwa dhidi ya rasimu ya ejenti na kugeuza nyakati zake ngumu zaidi kuwa mifano ya uthibitishaji yenye majibu sahihi. Tumia dry_run kupata nukuu kwanza; utekelezaji halisi unahitaji quote_id yake na max_cost_cents. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
import_conversations | agent_id, since_days ya hiari, max_calls | O | Hugeuza simu za hivi karibuni za ejenti kuwa mazungumzo ya majaribio (zisizozidi mbili kwa kila mpigaji simu, simu zisizorekodiwa zikirukwa) na nyakati zake ngumu zaidi kuwa mifano. Tumia dry_run kupata nukuu kwanza; utekelezaji halisi unahitaji quote_id yake na max_cost_cents. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
refresh_conversations | agent_id, conversation_ids ya hiari, from_prompt_revision_id | O | Husasisha mazungumzo ya majaribio ya ejenti hadi prompt yake ya sasa baada ya tabia kuongezwa, kuondolewa au kubadilishwa: huelekeza upya, hurejesha marekebisho ya awali (ikiwemo sauti halisi) au huandika upya zamu zilizopitwa na wakati, na huondoa mifano ambayo zamu ya mpigaji simu haipo tena. Tumia dry_run kupata nukuu kwanza; utekelezaji halisi unahitaji quote_id yake na max_cost_cents. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
get_conversation_job | job_id | R, I | Hupata kazi ya kuzalisha, kuleta au kusasisha: hali, gharama hadi sasa dhidi ya kikomo chake, na ilichoandika au kusasisha. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
run_replays | agent_id, overrides ya hiari, split, engine, sample_size, sample_seed, max_cost_cents, quote_id, dry_run | D, O | Hurudia sampuli ya mifano ya ejenti chini ya rasimu yake, au chini ya ubatilishaji kama prompt ya majaribio, sauti au kiwango, na hutathmini kila jibu dhidi ya jibu sahihi la mfano. Marudio kamili huendesha sauti iliyorekodiwa ya zamu kama simu ya moja kwa moja; viwango vya ufaulu huripotiwa kwa kila injini. Marudio ya simu za PHI huendeshwa kama PHI, na usanidi ambao hayawezi kuendesha (sauti ya ElevenLabs, bidhaa ya majaribio) hukataliwa. dry_run hurejesha makadirio, sample_seed iliyotolewa na quote_id; utekelezaji halisi hutuma ombi lilelile pamoja na quote_id na sample_seed hizo, na max_cost_cents, kikomo kisichopitika: kila ombi hutenga kiwango chake cha juu kabla ya kutumwa, na utekelezaji husimama badala ya kutuma ombi lisilotoshea, kwa hivyo acha nafasi ya akiba ya largest_reservation_cents ya makadirio kwa kila mfanyakazi. Marudio kamili hutenga hali yake mbaya zaidi, takriban senti 85 hadi $1.25 kwa kila marudio yanayoendelea kwa zamu ya kawaida (mawili huendeshwa kwa wakati mmoja), dhidi ya gharama halisi ya senti chache; utekelezaji hutozwa gharama halisi ya marudio, kwa hivyo weka max_cost_cents kwa nafasi ya kutosha. Marudio kamili huendeshwa chini ya bajeti inayotosha kwa zamu ya kawaida pamoja na uendeshaji mmoja tena wa aina inayotokea kwenye uzalishaji (mbio ya jibu tena na jaribio tena la uangalizi); zamu inayohitaji zaidi hurekodiwa kama hitilafu, replay_budget_exhausted, huhesabiwa kando kama budget_exhausted, haijumuishwi katika kiwango cha ufaulu na, kwenye mgawanyo wa majaribio, haitumii kundi lolote. Kwenye mgawanyo wa majaribio, kundi lenye sauti ya mpigaji simu iliyorekodiwa chini ya usanidi mwingine isipokuwa Bolt v2 hukataliwa (test_needs_exact_replay) na hubaki halijatumika: pima usanidi huo kwenye mgawanyo wa dev. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
compare_configs | agent_id, configs (2 hadi 4, ya kwanza ni msingi), sample_size ya hiari, sample_seed, max_cost_cents, quote_id, dry_run | O | Hurudia mifano ileile chini ya kila usanidi na huripoti kiwango cha ufaulu, mifano iliyorekebishwa na iliyoharibika dhidi ya msingi, muda wa kusubiri hadi sauti ya kwanza, mara ambazo mpigaji simu alisubiri uthibitisho, milio ya tik au kimya, na gharama kwa kila zamu, kwa kila injini. Pata nukuu kwa dry_run kama run_replays. Kwa mgawanyo wa dev pekee: kwenye mgawanyo wa majaribio hukataliwa (comparison_dev_only); linganisha kwenye dev, kisha pima chaguo kwa run_replays. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
get_replay_run | run_id, include_trace ya hiari | R, I | Hupata jumla, mabadiliko na matokeo kwa kila mfano ya utekelezaji wa marudio, pamoja na kundi lake la ulinganisho. Marudio kamili yaliyohitaji zaidi ya bajeti yake huhesabiwa kando (budget_exhausted), nje ya kiwango cha ufaulu. Inahitaji kifurushi cha zana cha urudiaji wa ejenti. |
create_talk_link | agent_id, variant_id ya hiari, language, expires_in_minutes | O | Huunda kiungo cha matumizi moja ambacho mtu hufungua kwenye kivinjari ili kuzungumza na rasimu ya sasa ya ejenti, kama kitufe cha Ongea kwenye dashibodi. Kiungo kinaisha muda baada ya dakika 30 kwa chaguo-msingi (kiwango cha juu ni 120); mazungumzo hutozwa kama simu ya majaribio ya Ongea. Tazama Viungo vya Ongea. |
Zana zilizoalamishwa kuwa zinahitaji kifurushi cha uboreshaji wa ejenti ni sehemu yake; kifurushi hiki huwashwa kwa kila shirika kikiwa katika beta, na bila kifurushi hicho zinarudisha feature_not_enabled pamoja na hatua inayofuata. Kila mazungumzo ya ejenti yako katika mgawanyo wake wa dev au mgawanyo wake wa majaribio. Mgawanyo wa majaribio ni wa kupima mabadiliko, si wa kuyarekebisha, kwa hivyo zana za mazungumzo hurudisha mazungumzo ya mgawanyo wa majaribio kama kitambulisho chake, mgawanyo, chanzo, hali na hesabu pekee. Uendeshaji wa kurudia kwenye mgawanyo wa majaribio hurudia kundi moja zima la majaribio (sample_size na sample_seed hupuuziwa), kila mfano kwenye injini inayoruhusiwa na data yake, iliyowekwa kabla ya uendeshaji kutoka kwa mfano huo (exact kwa sauti ya mpigaji iliyorekodiwa, text kwa mfano wa maandishi pekee; usanidi usio Bolt v2 hauna njia ya exact, kwa hivyo kundi lenye sauti iliyorekodiwa hukataliwa kwa usanidi huo kwa test_needs_exact_replay na hubaki halijatumika; engine huachwa au huwa auto, kwa kuwa exact au text hukataliwa kwa test_engine_per_example, na hakuna kinachorudi kwenye text), na hurudisha jumla pekee, kwa kila injini: kiwango cha ufaulu, hitilafu kwa uzito na aina, muda wa kusubiri na gharama. Matokeo yake ya kwanza yanayohifadhi urudiaji hutumia kundi hilo, kwa hivyo uendeshaji unaofuata wa majaribio, kwa prompt yoyote, huchukua jingine, na yasipobaki hukataliwa kwa no_test_cohort (kuagiza simu au kutengeneza mazungumzo hujaza makundi mapya); uendeshaji unaoisha kabla ya kuhifadhi moja (Core haiwezi kurudia mifano yake ya sauti kwa exact, exact_replay_unavailable, uwezo wake wa urudiaji bado unashughulika, core_busy, au kila zamu iliishiwa na bajeti yake, replay_budget_exhausted) huacha kundi hilo halijatumika. Kwenye mgawanyo wa dev, urudiaji wa exact ambao Core haiwezi kuendesha hurudi kwenye text na uendeshaji huwekewa alama degraded. Ulinganisho huendeshwa kwenye mgawanyo wa dev pekee. Kila zana inayolipishwa huchukua quote_id ya dry run yake, halali kwa uendeshaji mmoja: hutumika mara moja kwa kudumu uendeshaji unapoanza, na kuanza kunakokataliwa au kushindwa kabla ya hapo huiacha iweze kutumika; uendeshaji unaoshindwa baada ya hapo huripoti hivyo, na hurudiwa kwa dry run mpya ili kupata quote_id mpya. Kwa OAuth, review_prompt na refactor_prompt zinahitaji scope ya agents:write, ikijumuisha dry runs, na zana za mazungumzo na urudiaji zinahitaji testing:write ili kuendeshwa. Watu huona mgawanyo wote wa majaribio kwenye dashibodi. Simu ambayo mpigaji wake yuko katika mgawanyo wa majaribio wa ejenti hutengwa, kwa sababu ni sehemu ya seti ya majaribio. Katika shirika lenye kifurushi hiki, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade na export_calls huirudisha kama {"call_id", "start_time", "held_out": true} hasa (started_at badala ya start_time katika safu za export), bila transkripti, rekodi, historia, daraja au ripoti yake; kila sehemu nyingine ya simu haipo, kwa hivyo soma safu iliyozuiwa kwa held_out yake kabla ya kitu kingine chochote. REST API hufanya vivyo hivyo kwa funguo za API na tokeni za OAuth, na mitazamo yake kwenye simu nyingi (muhtasari wa ripoti, makundi ya matatizo, uchunguzi, ripoti za pipeline) huacha simu zilizotengwa nje ya hesabu, makundi na sampuli zake, na huzuia maandishi yoyote ambayo modeli iliandika kutokana nazo. Uandishi kwenye simu iliyotengwa (kuiwekea daraja, kuipandisha kuwa hali ya majaribio, kutengeneza upya zamu) hukataliwa kwa held_out_call. Hali ya majaribio ambayo mtu alipandisha kutoka simu iliyotengwa hurudi kutoka list_test_scenarios na katika uendeshaji wa majaribio kama {"id", "held_out": true} hasa, na uendeshaji wa uigaji kutoka kwayo, kutoka get_test_run na zana za uigaji, kama {"id", "scenario_id", "held_out": true} hasa; simu zake zilizoigwa pia hutengwa, na uendeshaji wa majaribio bado huiendesha. Mazungumzo ya dev, mfano au matokeo ya urudiaji yaliyonakiliwa kutoka simu ya mpigaji iliyotengwa (migawanyo ni kwa kila ejenti, kwa hivyo mpigaji huyo anaweza kuwa katika mgawanyo wa majaribio wa ejenti mwingine) husomwa kama ya mgawanyo wa majaribio. Watu huona simu zilizotengwa kikamilifu kwenye dashibodi, na msimamizi anaweza kuruhusu ufunguo mmoja wa API kuziona kikamilifu (include_held_out_calls, imezimwa kwa chaguo-msingi, huwekwa kwenye dashibodi pekee), kwa ujumuishaji unaohitaji kila simu; MCP haiitumii kamwe. Webhook hazijabadilika. Mashirika yasiyo na kifurushi hiki hayaoni sehemu ya held_out wala mabadiliko yoyote.
generate_conversations, import_conversations na refresh_conversations hutumia salio la modeli. Vipigie simu kwa dry_run: true kwanza: jibu ni makadirio ya gharama, hatua kwa hatua, yenye quote_id, na hakuna kinachoendeshwa. Makadirio huhesabu kila ombi ambalo uendeshaji unaweza kufanya kwa ukubwa wa kawaida. Uendeshaji halisi unahitaji quote_id hiyo (inaisha baada ya dakika 15, na hufanya kazi tu kwa hoja zilezile) na max_cost_cents, kikomo kisichovukwa: kabla ya kila ombi, kazi hutenga kiasi cha juu ambacho ombi hilo linaweza kugharimu, na husimama badala ya kutuma ombi lisilotoshea, huku ikihifadhi ilichoandika. Kwa sababu ya utengaji huo, uendeshaji unaweza kusimama huku sehemu ya kikomo chake haijatumika; largest_reservation_cents ya makadirio inaonyesha kiasi cha nafasi ya akiba kinachopaswa kuachwa. Wapigaji simu wa kuigwa hubuniwa kutoka kwenye prompt ya ejenti; style: "adversarial" huandika wapigaji simu wagumu wanaosisitiza maeneo dhaifu ya prompt, na mazungumzo hayo daima huenda kwenye mgawanyo wa dev. target: "changed_behaviors" hulenga wapigaji simu kwenye kilichobadilika katika uhariri wa mwisho wa prompt. Kila ejenti huendesha moja ya kazi hizi au uendeshaji mmoja wa replay kwa wakati mmoja, hivyo refresh haibadilishi kamwe mifano ambayo replay inaendesha; kuanzisha moja huku nyingine ikiendelea hurejesha job_active, replay_run_active au conversation_job_active pamoja na cha kusubiri.
Baada ya uhariri wa prompt unaoongeza, kuondoa au kubadilisha tabia, review_prompt kwenye rasimu ya ejenti huripoti ni mazungumzo mangapi ya majaribio yaliyoandikwa kwa prompt yenye tabia nyingine (conversations.refresh_suggested). Kisha refresh_conversations huyaleta hadi kwenye rasimu, ili seti za dev na test zipime prompt mpya kwa historia ambazo ingeweza kuwa imezalisha. Refresh haipotezi chochote: kila mazungumzo huhifadhi kila marekebisho ya awali, na sheria iliyoondolewa inaporudi, marekebisho ya wakati ilipokuwepo hurejeshwa pamoja na sauti halisi ya mpigaji simu. Refresh inayoanzishwa na ejenti ya kuandika msimbo huacha mazungumzo ya mgawanyo wa test, na mazungumzo yaliyonakiliwa kutoka simu zilizozuiwa, nje ya uteuzi, makadirio, maendeleo na gharama zake; kutaja moja katika conversation_ids hurejesha 403 test_conversation. Mtu huyafanya refresh hayo kutoka kwenye dashibodi, na kwa ejenti za kuandika msimbo matokeo ya kazi hiyo huwaonyesha kama ids na hesabu pekee. Mfano wa active ambao refresh huandika upya historia, jibu au ufunguo wa jibu hurudi kwenye pending_review, ukiwa na lebo refreshed_needs_review. Makadirio ya refresh hutoza kila mazungumzo inayoyasoma kana kwamba yangeandikwa upya, kila mwito wa modeli kwa kikomo chake cha matokeo, na hubaki halali kwa prompt na mazungumzo ambayo yalikadiriwa: mojawapo ikibadilika kabla ya uendeshaji, pata makadirio tena; prompt ikibadilika wakati inaendelea, kazi husimama kama failed, huku ikihifadhi ilichofanya refresh.
Maarifa
| Zana | Hoja kuu | Ufafanuzi | Inachofanya |
|---|---|---|---|
list_knowledge_bases | — | R, I | Huorodhesha hifadhidata za maarifa. |
create_knowledge_base | name, description ya hiari | — | Huunda hifadhidata ya maarifa. |
add_knowledge_document | knowledge_base_id, name, content | — | Huongeza maandishi au Markdown. |
import_knowledge_url | url, name ya hiari | O | Huweka ukurasa wa umma kwenye foleni kwa ajili ya uingizaji salama. |
search_knowledge | knowledge_base_id, query | R, I | Hutafuta kupitia urejeshaji wa uzalishaji. |
Miunganisho, webhook, na seva za MCP za mbali
| Zana | Hoja kuu | Ufafanuzi | Kazi yake |
|---|---|---|---|
list_integrations | — | R, I | Huorodhesha miunganisho ya kazi za HTTP. |
create_integration | display_name, spec ya kazi, sehemu za hiari za anwani lengwa | — | Huunda zana ya HTTP. Ongeza vichwa vya uthibitishaji kwenye dashibodi. |
test_integration | url, mbinu/mwili/muda wa kusubiri wa hiari, integration_id yenye header_names, confirmation_token kwenye ombi la pili | D, O | Hutuma ombi la majaribio lenye mipaka, lililolindwa dhidi ya SSRF. Thamani za vichwa vilivyohifadhiwa hujazwa kutoka kwenye muunganisho na hutumwa kwa mwenyeji wake pekee. POST (chaguo-msingi), PUT, PATCH na DELETE zina hatua mbili; GET huendeshwa mara moja. |
list_webhook_endpoints | — | R, I | Huorodhesha anwani lengwa za webhook zilizosainiwa. |
list_webhook_deliveries | agent_id ya hiari, endpoint_id ya hiari | R, I | Huorodhesha matokeo ya hivi karibuni ya uwasilishaji wa webhook yasiyo na mzigo wa data. |
create_webhook_endpoint | label, url, matukio/hali ya hiari | O | Huunda anwani lengwa ya webhook iliyosainiwa. |
copy_webhook_endpoint | endpoint_id, target_agent_id | I | Hunakili webhook ya ejenti, ikijumuisha siri ya kutia saini, hadi ejenti nyingine kwenye seva. Wasimamizi pekee. |
test_webhook_endpoint | endpoint_id | O | Hutuma tukio bandia kupitia uwasilishaji wa kawaida. |
list_mcp_servers | — | R, I | Huorodhesha seva za mbali zinazoweza kuitwa na ejenti za sauti. |
create_mcp_server | display_name, url | O | Husajili na kusawazisha seva ya mbali. Seva zinazohitaji vichwa vya uthibitishaji huongezwa kwenye dashibodi. |
sync_mcp_server_tools | server_id | D, O | Husasisha orodha ya zana ya seva ya mbali. |
Kampeni
| Zana | Hoja kuu | Maelezo | Inachofanya |
|---|---|---|---|
list_campaigns | — | R, I | Huorodhesha kampeni za kupiga simu zinazotoka. |
create_campaign | sehemu za kampeni | — | Huunda rasimu ya kampeni. |
add_campaign_contacts | campaign_id, contacts | — | Huongeza hadi waasiliani 5,000 wa JSON. |
campaign_action | campaign_id, action, hiari consent_to_charge, confirmation_token kwenye ombi la pili | D, O | Huendesha start, pause, resume, au stop. start na resume zina hatua mbili; pause na stop huendeshwa mara moja. |
get_campaign_stats | campaign_id | R, I | Hupata vihesabu na matokeo ya karibuni. |
check_campaign | hiari campaign_id, contact_phone_number, contact_status | R, I | Hueleza kwa nini kampeni haipigi simu: dirisha lake la kupiga simu katika saa za eneo lake, waasiliani wanaotarajiwa sasa, na kinachozuia upigaji simu. |
Mipangilio ya shirika na wapigaji waliowekwa vizuizi
| Zana | Hoja kuu | Maelezo | Inachofanya |
|---|---|---|---|
get_org_settings | — | R, I | Husoma eneo la saa, saa za kazi, nambari za majaribio, lebo za matokeo ya simu, majina ya hali na tahadhari zipi zimezimwa, pamoja na updated_at. |
update_org_settings | mipangilio iliyobadilishwa, if_updated_at, confirmation_token inapohitajika | D, I | Huzibadilisha (wasimamizi pekee). Orodha na vitu hubadilisha thamani iliyohifadhiwa. Kuzima tahadhari au kuongeza nambari ya majaribio ni hatua mbili. Matokeo yana thamani za zamani za kutendua. |
get_account_limits | — | R, I | Hupata vikomo vya mfumo kwa thamani mahususi za shirika hili. |
list_blocked_callers | number, search za hiari | R, I | Huorodhesha nambari za wapigaji waliowekwa vizuizi. |
block_callers | numbers, note ya hiari, confirmation_token kwenye ombi la pili | D, I | Huzuia simu kutoka kwa nambari hizi kabla ejenti yeyote hajajibu. Hatua mbili, wasimamizi pekee. |
unblock_callers | numbers, confirmation_token kwenye ombi la pili | D, I | Huondoa nambari kutoka kwenye orodha ya vizuizi. Hatua mbili, wasimamizi pekee. |
get_org_settings, update_org_settings na get_account_limits zinahitaji org:read au org:write wigo wa OAuth; muunganisho ulioundwa kabla hazijakuwepo huombwa kuidhinisha wigo huo zinapotumiwa kwa mara ya kwanza.
Uwezo, msaada na uagizaji
| Zana | Hoja kuu | Maelezo | Inachofanya |
|---|---|---|---|
get_supported_languages | — | R, I | Huorodhesha lugha zinazozungumzwa na ejenti, pamoja na misimbo. |
get_agent_capabilities | — | R, I | Hueleza ejenti inaweza kufanya nini kwenye simu na mipangilio na miunganisho ipi ipo. |
escalate_to_human | summary | O | Huomba msaada kutoka kwa timu ya ThunderPhone. Hujibu katika ThunderPhone. Kwa mashirika yanayoweza kushughulikia PHI, ni dokezo lisiloegemea upande wowote pekee linaloondoka ThunderPhone. |
request_feature | title, request, details | O | Hutuma ombi la kipengele kwa timu ya ThunderPhone. Kiwango cha juu ni matatu kwa shirika kwa siku. |
start_agent_import | platform | R, I | Hurudisha kiungo cha dashibodi ambapo unaweka ufunguo wako wa Vapi, Retell, ElevenLabs au Bland na kuchagua ejenti. Hakuna zana inayopokea ufunguo huo. |
get_agent_import | import_id ya hiari | R, I | Huorodhesha uagizaji wa hivi karibuni, au hali ya uagizaji mmoja na ejenti zilizopangwa. |
commit_agent_import | import_id, item_ids za hiari | O | Huunda ejenti kutoka kwa uagizaji ulio tayari, chinichini. Wasimamizi pekee. |
Sauti, malipo na nyaraka
| Zana | Hoja kuu | Maelezo | Inachofanya |
|---|---|---|---|
list_voices | — | R, I | Huorodhesha sauti na lugha zinazotumika. |
preview_voice | voice, language, text | O | Huzalisha mfano na kurejesha URL iliyotiwa sahihi. |
list_voice_clones | — | R, I | Huorodhesha nakala maalum za sauti. |
get_billing_summary | — | R, I | Hupata salio na bei rasmi za viwango; hakuna mabadiliko ya malipo yanayofichuliwa. |
search_docs | query, hiari limit | R, I, O | Hutafuta katika faharasa ya nyaraka za umma. |
get_doc_page | path | R, I, O | Hurejesha ukurasa mmoja wa umma wa nyaraka za Markdown. |
Matokeo kuhusu ejenti, simu, nambari, kampeni au mpangilio yana web_url, ukurasa unaolingana wa dashibodi, ili uweze kuufungua katika ThunderPhone au kuendelea na Zeus huko.
Zana zote za bidhaa hutumia njia zilezile za msimbo wa REST kama API ya umma. Kwa hiyo, uthibitishaji wa REST, uwekaji wa mipaka kwa shirika, majukumu, idhini ya malipo, viwango vya matumizi, uthibitisho wa TCPA, usalama wa mtoa huduma, na tabia ya ukaguzi hutumika bila mabadiliko.
Kuhariri prompt moja kwa moja
update_agent inaweza kubadilisha sehemu ya rasimu ya prompt bila kutuma maandishi yote tena. prompt_edits ni orodha iliyopangwa ya jozi za kutafuta na kubadilisha, katika muundo uleule unaorejeshwa na review_prompt na 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."
}
]
}Seva hutumia mabadiliko kwa mpangilio kwenye rasimu ya sasa ya prompt ya ejenti (prompt iliyotumwa kwa uzalishaji ikiwa hakuna rasimu) na huandika matokeo kwenye rasimu kupitia njia ileile inayotumiwa na update_agent ya prompt nzima. Kila find lazima ionekane mara moja tu katika prompt jinsi ilivyo wakati zamu ya mabadiliko hayo inapofika. Isipoonekana, hakuna kinachoandikwa na hitilafu hutaja mabadiliko hayo:
| Msimbo | Maana | Cha kufanya |
|---|---|---|
prompt_edit_not_found | Maandishi ya find hayapo katika rasimu ya sasa ya prompt. edit_index huonyesha mabadiliko gani. | Soma ejenti tena na unakili kifungu hicho sawasawa. |
prompt_edit_ambiguous | Maandishi ya find yanaonekana zaidi ya mara moja. occurrences huonyesha mara ngapi. | Jumuisha maandishi zaidi yanayozunguka. |
stale_prompt | expected_prompt_sha256 si SHA-256 ya rasimu ya sasa ya prompt: ilibadilika baada ya kuisoma. | Soma ejenti tena, andika upya badiliko kulingana na maandishi ya sasa, kisha tuma SHA-256 yake. |
conflict | Uandishi mwingine ulifanyika kati ya seva kusoma rasimu na kuiandika. | Jaribu tena; rasimu haikubadilishwa na mwito huu. |
expected_prompt_sha256 ni ya hiari na pia hulinda uandishi wa prompt nzima. Tumia prompt_sha256 kutoka review_prompt, au source_prompt_sha256 kutoka refactor_prompt. Mwito wowote unaobadilisha prompt hurejesha prompt_sha256 ya maandishi mapya, previous_prompt_sha256 wakati seva ilisoma rasimu kwanza, na next_step inayopendekeza review_prompt huku previous_prompt ikiwekwa kuwa maandishi ya kabla ya badiliko. REST API hupokea prompt nzima pekee: PATCH /v1/agents/{agent_id} yenye prompt na if_updated_at.
Kuthibitisha vitendo visivyoweza kutenduliwa
Zana zilizowekwa alama D hubadilisha au kuondoa kitu, au huanza kupiga simu kwa watu halisi. Zile ambazo haziwezi kutenduliwa zinahitaji maombi mawili. Ombi la kwanza halibadilishi chochote na hurejesha:
{
"status": "confirmation_required",
"action": "Delete agent",
"target": { "id": 195, "name": "Front Desk Receptionist" },
"confirmation_token": "…",
"expires_in_seconds": 600,
"next_step": "…"
}Msaidizi humwonyesha mtumiaji kinachoathiriwa na kuomba uthibitisho. Kisha hurudia ombi kwa hoja zilezile pamoja na confirmation_token. Tokeni ni halali kwa dakika 10, hutumika mara moja (hata kama simu hiyo itashindwa), na inahusu shirika moja, mtu mmoja, zana moja na seti moja kamili ya hoja, hivyo kufuta maejenti watatu kunahitaji uthibitisho mara tatu. campaign_action yenye pause au stop huruka hatua hii ili kampeni inayoendelea iweze kusimamishwa mara moja kila wakati, na vivyo hivyo test_integration yenye GET. Baadhi ya zana za D hutekelezwa kwa ombi moja kwa sababu D inaashiria athari yake, si uthibitisho wa upande wa seva: update_agent hubadilisha yaliyokuwa kwenye rasimu (discard_agent_draft huyarejesha), deploy_agent hubadilisha usanidi unaotumika, update_phone_number huelekeza upya simu zinazoendelea, sync_mcp_server_tools hubadilisha katalogi ya zana ya seva ya mbali, import_voip_numbers huelekeza upya nambari kwa mtoa huduma wako, run_agent_tests na run_simulation zinaweza kutumia salio, send_sms na place_call humfikia mtu halisi (place_call huhifadhi uthibitisho wake wa idhini), na provision_phone_number hununua nambari. test_my_agent hutumia salio la majaribio na inahitaji consent_to_charge. run_replays hutumia pesa pia; nukuu yake ya dry_run na kikomo cha max_cost_cents hutumika badala ya uthibitisho. Mteja wako wa MCP bado anaweza kukuomba uidhinishe haya.
Baadhi ya mabadiliko yanayoweza kurekebishwa bado husubiri idhini: block_callers, unblock_callers na save_voip_setup kila wakati, update_org_settings inapozima tahadhari au kuongeza nambari ya majaribio, na update_agent wakati attention_reasons zake zinazima mojawapo ya tahadhari za ejenti. next_step yao inakuomba uthibitishe mabadiliko mahususi badala ya kuonya kwamba hayawezi kurekebishwa.
Prompt za kuanzia
prompts/list hutangaza mitiririko kumi na miwili ya kazi inayoweza kutumika tena:
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
Tumia prompts/get kwa jina la prompt lililoorodheshwa na hoja zake zilizotangazwa ili kupokea ujumbe wa mtumiaji ulio tayari kutekelezwa.
Rasilimali
resources/list hutoa marejeleo ya umma yaliyohifadhiwa kwenye kache:
| URI | Maudhui |
|---|---|
thunderphone://docs/llms.txt | Faharasa ya umma ya nyaraka. |
thunderphone://docs/quickstart | Markdown ya kuanza haraka. |
thunderphone://pricing | Markdown ya bei za sasa za umma. |
thunderphone://guides/prompt-style | Mwongozo wa mtindo wa prompt wa ejenti ya sauti ambao review_prompt hukagua dhidi yake. Vitambulisho vya miongozo yake (P1, W2 na kadhalika) ndivyo vinavyotajwa na matokeo. |
thunderphone://guides/working-with-thunderphone | Jinsi msaidizi anavyopaswa kutumia zana hizi: hatua ndogo za marekebisho, ukaguzi kabla ya kila uchapishaji, idhini ya mtumiaji kwa chochote kinachowekwa hewani au kinachotozwa, na kamwe asiombe siri. |
Soma mojawapo kwa resources/read. Uletaji wa umma hutumia muda mfupi wa kusubiri, kikomo cha 2 MiB, na kache ya ndani ya mchakato ya dakika kumi.
Itifaki na hitilafu
Seva inasaidia matoleo ya itifaki 2025-06-18 na 2025-03-26; hurudisha toleo la mteja linalotumika na vinginevyo huchagua 2025-06-18. Inatekeleza initialize, ping, zana, prompt, rasilimali na arifa. Arifa hurejesha 202 Accepted. Seva hii isiyo na hali haifichui kisikilizaji cha SSE wala ufutaji wa kipindi, hivyo GET na DELETE hurejesha 405 Method Not Allowed pamoja na Allow: POST.
Hitilafu za zana hubaki kuwa majibu ya JSON-RPC yaliyofaulu yenye isError: true. Maandishi yake yana sentensi fupi ikifuatiwa na bloku ya JSON:
{
"code": "insufficient_balance",
"detail": "There is not enough prepaid balance.",
"next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}Kiambishi awali tofauti cha outbound_tcpa_confirmation_required: huhifadhiwa kwa place_call. Mbinu za JSON-RPC zisizojulikana hurejesha -32601 katika jibu la HTTP 200. Makundi ya JSON-RPC hayaungwi mkono na MCP 2025-06-18 na hurejesha hitilafu safi ya ombi batili -32600.