Open in
ThunderPhoneను MCP సర్వర్గా ఉపయోగించండి
Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code లేదా మరొక Streamable HTTP MCP క్లయింట్ నుండి ThunderPhone వాయిస్ ఏజెంట్లను నిర్మించండి, పరీక్షించండి, ధృవీకరించండి మరియు నిర్వహించండి.
ThunderPhone ఇందులో Streamable HTTP Model Context Protocol సర్వర్ను అందిస్తుంది:
https://api.thunderphone.com/v1/mcpఇది రిమోట్ MCP సర్వర్ను వాయిస్ ఏజెంట్కు కనెక్ట్ చేయడంకు వ్యతిరేక దిశ:
| దిశ | ఫలితం |
|---|---|
| రిమోట్ MCP సర్వర్ → ThunderPhone ఏజెంట్ | వాయిస్ ఏజెంట్ రిమోట్ సర్వర్ టూల్స్ను కాల్ చేయగలదు. |
| ThunderPhone → మీ MCP క్లయింట్ | మీ కోడింగ్ ఏజెంట్ ThunderPhoneను రూపొందించగలదు, పరీక్షించగలదు మరియు నిర్వహించగలదు. |
ప్రామాణీకరించండి
డైరెక్టరీ క్లయింట్ల కోసం డిఫాల్ట్గా OAuth ఉపయోగించండి: సైన్ ఇన్ చేసి, ఒక సంస్థను ఎంచుకుని, అభ్యర్థించిన అనుమతులను ఆమోదించండి. సెట్టింగ్లు → భద్రత → మీరు కనెక్ట్ చేసిన యాప్లు కింద దీనిని డిస్కనెక్ట్ చేయండి. మీ పాస్వర్డ్ను మార్చడం లేదా రీసెట్ చేయడం, లేదా మీ ఖాతా ఇమెయిల్ను మార్చడం కూడా కనెక్షన్ను రద్దు చేస్తుంది; కాబట్టి ఆ తర్వాత క్లయింట్ను మళ్లీ కనెక్ట్ చేయండి.
API కీతో కాన్ఫిగర్ చేసిన క్లయింట్ల కోసం, ఇంటిగ్రేషన్లు → API కీలు కింద ఒక sk_live_ కీని సృష్టించి, దానిని మీ MCP క్లయింట్కు THUNDERPHONE_API_KEYగా అందుబాటులో ఉంచండి. ఈ కీ ఒకే సంస్థకు అనుసంధానించబడుతుంది; మరొక సంస్థకు చెందిన ID కనుగొనబడనట్లుగా ప్రవర్తిస్తుంది.
PHIను నిర్వహించే సంస్థలు
మీ సంస్థ కాల్లలో రక్షిత ఆరోగ్య సమాచారం (PHI) ఉండవచ్చు అయితే,
మీకు ThunderPhoneతో BAA ఉన్నందున లేదా మీ ఏజెంట్లు PHIని ప్రాసెస్ చేసేలా
నియమించబడినందున, పై URL ఎప్పుడూ కాల్ కంటెంట్ను తిరిగి ఇవ్వదు: ట్రాన్స్క్రిప్ట్లు,
రికార్డింగ్లు, గ్రేడ్లు, కాల్ జాబితాలు, ఎగుమతులు, క్యాంపెయిన్ ఫలితాలు, కాల్ విశ్లేషణలు మరియు
అంతర్దృష్టులు, నిజమైన కాల్ల నుండి రూపొందించిన సంభాషణలు మరియు రీప్లే ఫలితాలు. ఆ టూల్లు
code: "phi_content_unavailable"తో లోపాన్ని అందిస్తాయి. ఏజెంట్లను నిర్మించడం, పరీక్షించడం మరియు కాన్ఫిగర్ చేయడం
యథావిధిగా పనిచేస్తుంది.
ఆ URL పబ్లిక్ సహాయక డైరెక్టరీలలో జాబితా చేయబడినది, అవి PHIని కలిగి ఉండకపోవచ్చు. మీరు ఉపయోగించే వర్క్స్పేస్ను కవర్ చేసే సహాయకుడి ప్రొవైడర్తో మీ సంస్థకు సొంత BAA ఉంటే:
- సంస్థ అడ్మిన్ 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కి ప్రాధాన్యం ఉంటుంది; 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 అసిస్టెంట్తో జరుగుతుంది మరియు రికార్డ్ చేసి ట్రాన్స్క్రైబ్ చేయబడుతుంది." అని చెబుతుంది. సంస్థ అడ్మిన్ ముందుగా డ్యాష్బోర్డ్లో, Claudeతో సహా ఏ క్లయింట్ నుంచైనా, సంతకం చేసిన ధృవీకరణను నమోదు చేసి ఉండకపోతే దీన్ని ఆఫ్ చేయడం (consent_announcement_enabledను falseగా సెట్ చేయడం లేదా ai_live_processing_disclosure_overrideను ఆఫ్ చేయడం) నిరాకరించబడుతుంది.
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 కోరిన ప్రవర్తనలు స్థిరమైన ఐడీలతో, రీఫ్యాక్టర్ అవసరమా లేదా, అలాగే ఏజెంట్ స్వంత 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, రూటింగ్/లేబుల్/వెబ్హుక్ ఫీల్డ్లు | 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) మరియు ఉపయోగించబడదు: ఆ కాన్ఫిగరేషన్ను dev స్ప్లిట్లో కొలవండి. ఏజెంట్ ఇటరేషన్ టూల్కిట్ అవసరం. |
compare_configs | agent_id, configs (2 నుండి 4, మొదటిది బేస్లైన్), ఐచ్ఛిక sample_size, sample_seed, max_cost_cents, quote_id, dry_run | O | ప్రతి కాన్ఫిగరేషన్లో అదే ఉదాహరణలను మళ్లీ అమలు చేసి, ఉత్తీర్ణత రేటు, బేస్లైన్తో పోలిస్తే సరిచేయబడిన మరియు విఫలమైన ఉదాహరణలు, మొదటి ఆడియోకు జాప్యం, కాలర్ అంగీకారం, టిక్లు లేదా నిశ్శబ్దం కోసం ఎంత తరచుగా వేచి ఉన్నారు, మరియు ఒక్కో ఇంజిన్కు ఒక్కో టర్న్ ఖర్చును నివేదిస్తుంది. run_replays మాదిరిగా dry_runతో ధర అంచనా పొందండి. dev స్ప్లిట్లో మాత్రమే: పరీక్ష స్ప్లిట్లో ఇది తిరస్కరించబడుతుంది (comparison_dev_only); devలో పోల్చి, ఆపై ఎంచుకున్న దాన్ని 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 | డ్యాష్బోర్డ్లోని టాక్ బటన్లా, బ్రౌజర్లో తెరిచి ఏజెంట్ ప్రస్తుత డ్రాఫ్ట్తో మాట్లాడేందుకు ఒక వ్యక్తికి ఒకసారి మాత్రమే ఉపయోగించగల లింక్ను సృష్టిస్తుంది. డిఫాల్ట్గా లింక్ 30 నిమిషాల తర్వాత గడువు ముగుస్తుంది (గరిష్ఠంగా 120); సంభాషణకు టాక్ పరీక్ష కాల్ మాదిరిగా బిల్లు చేయబడుతుంది. టాక్ లింక్లు చూడండి. |
ఏజెంట్ ఇటరేషన్ టూల్కిట్ అవసరమని గుర్తించిన టూల్లు దానిలో భాగమే; ఇది బీటాలో ఉన్న సమయంలో ప్రతి సంస్థకు టూల్కిట్ ప్రారంభించబడుతుంది, అది లేకపోతే తదుపరి ఏమి చేయాలో సూచిస్తూ అవి feature_not_enabledను తిరిగి ఇస్తాయి. ఏజెంట్ యొక్క ప్రతి సంభాషణ దాని dev స్ప్లిట్ లేదా test స్ప్లిట్లో ఉంటుంది. test స్ప్లిట్ మార్పును కొలవడానికి ఉద్దేశించబడింది, దాన్ని మెరుగుపరచడానికి కాదు; కాబట్టి సంభాషణ టూల్లు test-స్ప్లిట్ సంభాషణకు దాని ఐడి, స్ప్లిట్, మూలం, స్థితి మరియు గణనలను మాత్రమే తిరిగి ఇస్తాయి. test స్ప్లిట్లోని రీప్లే రన్ ఒక పూర్తి test కోహోర్ట్ను రీప్లే చేస్తుంది (sample_size మరియు sample_seed విస్మరించబడతాయి), ప్రతి ఉదాహరణను దాని డేటా అనుమతించే ఇంజిన్పై, ఉదాహరణ నుంచే రన్కు ముందు నిర్ణయించి అమలు చేస్తుంది (రికార్డ్ చేసిన కాలర్ ఆడియోకు ఖచ్చితమైనది, కేవలం టెక్స్ట్ ఉదాహరణకు టెక్స్ట్; Bolt v2 కాకుండా ఇతర కాన్ఫిగరేషన్కు ఖచ్చితమైన మార్గం ఉండదు, కాబట్టి రికార్డ్ చేసిన ఆడియో ఉన్న కోహోర్ట్ను దానికి test_needs_exact_replayతో తిరస్కరిస్తారు మరియు అది ఉపయోగించబడకుండా ఉంటుంది; exact లేదా textను test_engine_per_exampleతో తిరస్కరిస్తారు కాబట్టి engineను వదిలివేస్తారు లేదా autoగా ఉంచుతారు, మరియు ఏదీ టెక్స్ట్కు ప్రత్యామ్నాయంగా మారదు), అలాగే ఇంజిన్కు విడిగా మొత్తం వివరాలను మాత్రమే ఇస్తుంది: పాస్ రేటు, తీవ్రత మరియు రకం ప్రకారం వైఫల్యాలు, జాప్యం మరియు ఖర్చు. రీప్లేను నిల్వ చేసే దాని మొదటి ఫలితం కోహోర్ట్ను వినియోగిస్తుంది, కాబట్టి ఏ promptకైనా తదుపరి test రన్ మరొకదాన్ని తీసుకుంటుంది, ఏదీ మిగలకపోతే దాన్ని no_test_cohortతో తిరస్కరిస్తారు (కాల్లను దిగుమతి చేయడం లేదా సంభాషణలను రూపొందించడం కొత్త కోహోర్ట్లను నింపుతుంది); ఒకదాన్ని నిల్వ చేయకముందే ముగిసే రన్లో (Core దాని ఆడియో ఉదాహరణలను ఖచ్చితంగా రీప్లే చేయలేకపోవడం, exact_replay_unavailable, దాని రీప్లే సామర్థ్యం బిజీగా ఉండటం, core_busy, లేదా ప్రతి టర్న్ దాని బడ్జెట్ను పూర్తిగా వినియోగించుకోవడం, replay_budget_exhausted) కోహోర్ట్ ఉపయోగించబడకుండా ఉంటుంది. dev స్ప్లిట్లో, Core అమలు చేయలేని ఖచ్చితమైన రీప్లే టెక్స్ట్కు ప్రత్యామ్నాయంగా మారుతుంది మరియు రన్ను degradedగా గుర్తిస్తారు. పోలికలు dev స్ప్లిట్లో మాత్రమే నడుస్తాయి. ప్రతి చెల్లింపు టూల్ దాని డ్రై రన్లోని quote_idను తీసుకుంటుంది, ఇది ఒక రన్కు చెల్లుతుంది: రన్ ప్రారంభమైనప్పుడు అది ఒకసారి, శాశ్వతంగా వినియోగించబడుతుంది; అంతకుముందు తిరస్కరించబడిన లేదా విఫలమైన ప్రారంభం దాన్ని ఉపయోగించదగినదిగా ఉంచుతుంది; ఆ తర్వాత విఫలమయ్యే రన్ అలా సూచిస్తుంది మరియు కొత్త quote_id కోసం కొత్త డ్రై రన్తో మళ్లీ అమలు చేయబడుతుంది. OAuthతో, డ్రై రన్లతో సహా review_prompt మరియు refactor_promptకు agents:write స్కోప్ అవసరం, అలాగే సంభాషణ మరియు రీప్లే టూల్లు అమలు కావడానికి testing:write అవసరం. వ్యక్తులు డాష్బోర్డ్లో పూర్తి test స్ప్లిట్ను చూస్తారు. కాలర్ ఏజెంట్ test స్ప్లిట్లో ఉన్న కాల్ test సెట్లో భాగం కాబట్టి నిలిపి ఉంచబడుతుంది. టూల్కిట్ ఉన్న సంస్థలో, 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 టోకెన్లకు ఇదే చేస్తుంది, అలాగే అనేక కాల్లలోని దాని వీక్షణలు (నివేదిక సంగ్రహాలు, సమస్య క్లస్టర్లు, పరిశోధనలు, పైప్లైన్ నివేదికలు) నిలిపి ఉంచిన కాల్లను వాటి గణనలు, క్లస్టర్లు మరియు నమూనాల నుండి మినహాయిస్తాయి, వాటి నుండి మోడల్ రాసిన ఏ టెక్స్ట్నైనా దాచిపెడతాయి. నిలిపి ఉంచిన కాల్పై రాయడం (గ్రేడింగ్ చేయడం, దాన్ని test scenarioగా ప్రమోట్ చేయడం, టర్న్ను మళ్లీ రూపొందించడం) held_out_callతో తిరస్కరించబడుతుంది. ఎవరైనా నిలిపి ఉంచిన కాల్ నుండి ప్రమోట్ చేసిన test scenario, list_test_scenarios నుండి మరియు test రన్లలో కచ్చితంగా {"id", "held_out": true}గా తిరిగి వస్తుంది; దాని నుండి వచ్చిన సిమ్యులేషన్ రన్, get_test_run మరియు సిమ్యులేషన్ టూల్ల నుండి కచ్చితంగా {"id", "scenario_id", "held_out": true}గా వస్తుంది; దాని సిమ్యులేట్ చేసిన కాల్లు కూడా నిలిపి ఉంచబడతాయి, అయినప్పటికీ test రన్లు దాన్ని అమలు చేస్తాయి. నిలిపి ఉంచిన కాలర్ కాల్ నుండి కాపీ చేసిన dev సంభాషణ, ఉదాహరణ లేదా రీప్లే ఫలితం (స్ప్లిట్లు ఏజెంట్కు ప్రత్యేకమైనవి కాబట్టి, ఆ కాలర్ మరొక ఏజెంట్ test స్ప్లిట్లో ఉండవచ్చు) test-స్ప్లిట్ దాని లాగానే చదవబడుతుంది. వ్యక్తులు డాష్బోర్డ్లో నిలిపి ఉంచిన కాల్లను పూర్తిగా చూస్తారు, మరియు ప్రతి కాల్ అవసరమైన ఇంటిగ్రేషన్ కోసం అడ్మిన్ ఒక API కీకి వాటిని పూర్తిగా చూడటానికి అనుమతించవచ్చు (include_held_out_calls, డిఫాల్ట్గా ఆఫ్, డాష్బోర్డ్లో మాత్రమే సెట్ చేయబడుతుంది); MCP దీన్ని ఎప్పుడూ ఉపయోగించదు. వెబ్హుక్లలో ఎటువంటి మార్పు లేదు. టూల్కిట్ లేని సంస్థలకు held_out ఫీల్డ్ కనిపించదు మరియు ఎటువంటి మార్పు ఉండదు.
generate_conversations, import_conversations, మరియు refresh_conversations మోడల్ క్రెడిట్లను ఖర్చు చేస్తాయి. ముందుగా వాటిని dry_run: trueతో కాల్ చేయండి: ప్రతిస్పందన దశలవారీగా ఖర్చు కోట్తో, ఒక quote_idతో వస్తుంది మరియు ఏదీ అమలు కాదు. సాధారణ పరిమాణంలో రన్ చేయగల ప్రతి అభ్యర్థనను కోట్ లెక్కిస్తుంది. నిజమైన రన్కు ఆ quote_id అవసరం (ఇది 15 నిమిషాల తర్వాత గడువు ముగుస్తుంది మరియు అదే ఆర్గ్యుమెంట్లతో మాత్రమే పనిచేస్తుంది), అలాగే కఠిన పరిమితి అయిన max_cost_cents కూడా అవసరం: ప్రతి అభ్యర్థనకు ముందు, ఆ అభ్యర్థనకు అయ్యే గరిష్ఠ ఖర్చును జాబ్ కేటాయిస్తుంది; సరిపోని అభ్యర్థనను పంపకుండా ఆగిపోతుంది మరియు తాను వ్రాసినదాన్ని ఉంచుతుంది. ఆ కేటాయింపు కారణంగా, రన్ తన పరిమితిలో కొంత ఖర్చు కాకుండానే ఆగవచ్చు; ఎంత ఖాళీ పరిమితి ఉంచాలో కోట్లోని largest_reservation_cents తెలియజేస్తుంది. అనుకరించిన కాలర్లను ఏజెంట్ prompt ఆధారంగా రూపొందిస్తారు; style: "adversarial" prompt బలహీనతలను ఒత్తిడి చేసే క్లిష్టమైన కాలర్లను వ్రాస్తుంది, మరియు ఆ సంభాషణలు ఎల్లప్పుడూ 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 తిరిగి వస్తుంది. వ్యక్తి వాటిని డ్యాష్బోర్డ్ నుంచి రిఫ్రెష్ చేస్తారు, మరియు కోడింగ్ ఏజెంట్లకు ఆ జాబ్ ఫలితాలు వాటిని IDs మరియు కౌంట్లుగా మాత్రమే చూపుతాయి. రిఫ్రెష్ చరిత్రను, ప్రతిస్పందనను లేదా జవాబు కీని మళ్లీ వ్రాసే 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 | ప్రొడక్షన్ రిట్రీవల్లో శోధిస్తుంది. |
ఇంటిగ్రేషన్లు, webhookలు మరియు రిమోట్ 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 ధృవీకరణ, ప్రొవైడర్ భద్రత మరియు ఆడిట్ ప్రవర్తన ఎటువంటి మార్పు లేకుండా వర్తిస్తాయి.
ప్రాంప్ట్ను స్థానంలోనే సవరించడం
update_agent మొత్తం టెక్స్ట్ను తిరిగి పంపకుండా డ్రాఫ్ట్ ప్రాంప్ట్లోని ఒక భాగాన్ని మార్చగలదు. 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."
}
]
}సర్వర్ సవరణలను క్రమంలో ఏజెంట్ ప్రస్తుత డ్రాఫ్ట్ ప్రాంప్ట్కు వర్తింపజేస్తుంది (డ్రాఫ్ట్ లేనప్పుడు డిప్లాయ్ చేసిన ప్రాంప్ట్కు) మరియు మొత్తం-ప్రాంప్ట్ update_agent ఉపయోగించే అదే మార్గం ద్వారా ఫలితాన్ని డ్రాఫ్ట్కు వ్రాస్తుంది. ప్రతి find, ఆ సవరణ వంతు వచ్చే సమయానికి ప్రాంప్ట్లో ఉన్నట్లుగానే కచ్చితంగా ఒక్కసారి కనిపించాలి. అలా లేకపోతే, ఏదీ వ్రాయబడదు మరియు లోపం ఆ సవరణను సూచిస్తుంది:
| కోడ్ | అర్థం | చేయాల్సినది |
|---|---|---|
prompt_edit_not_found | find టెక్స్ట్ ప్రస్తుత డ్రాఫ్ట్ ప్రాంప్ట్లో లేదు. edit_index ఏ సవరణో తెలియజేస్తుంది. | ఏజెంట్ను మళ్లీ చదివి, భాగాన్ని కచ్చితంగా కాపీ చేయండి. |
prompt_edit_ambiguous | find టెక్స్ట్ ఒకటి కంటే ఎక్కువసార్లు కనిపిస్తుంది. occurrences ఎన్ని సార్లో తెలియజేస్తుంది. | పరిసర టెక్స్ట్లో మరింత భాగాన్ని చేర్చండి. |
stale_prompt | expected_prompt_sha256 ప్రస్తుత డ్రాఫ్ట్ ప్రాంప్ట్ యొక్క SHA-256 కాదు: మీరు చదివిన తర్వాత అది మారింది. | ఏజెంట్ను మళ్లీ చదవండి, ప్రస్తుత టెక్స్ట్కు అనుగుణంగా మార్పును తిరిగి వ్రాయండి, దాని SHA-256ను పంపండి. |
conflict | సర్వర్ డ్రాఫ్ట్ను చదవడానికి, దానిని వ్రాయడానికి మధ్యలో మరొక వ్రాత చేరింది. | మళ్లీ ప్రయత్నించండి; ఈ కాల్ ద్వారా డ్రాఫ్ట్ మార్చబడలేదు. |
expected_prompt_sha256 ఐచ్ఛికం మరియు మొత్తం-ప్రాంప్ట్ వ్రాతను కూడా రక్షిస్తుంది. review_prompt నుండి prompt_sha256ను లేదా refactor_prompt నుండి source_prompt_sha256ను ఉపయోగించండి. ప్రాంప్ట్ను మార్చే ఏ కాల్ అయినా కొత్త టెక్స్ట్ కోసం prompt_sha256ను, సర్వర్ ముందుగా డ్రాఫ్ట్ను చదివినప్పుడు previous_prompt_sha256ను, మరియు మార్పుకు ముందు ఉన్న టెక్స్ట్గా previous_prompt సెట్ చేసిన review_promptను సూచించే next_stepను తిరిగి ఇస్తుంది. REST API మొత్తం ప్రాంప్ట్ను మాత్రమే స్వీకరిస్తుంది: 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; అలాగే దాని attention_reasons ఏజెంట్ అలర్ట్లలో ఒకదాన్ని ఆఫ్ చేసినప్పుడు update_agent. వాటి 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 పేరు మరియు దాని ప్రకటించిన ఆర్గ్యుమెంట్లతో 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తో ఒకదాన్ని చదవండి. పబ్లిక్ ఫెచ్లు తక్కువ టైమ్అవుట్, 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."
}place_call కోసం ప్రత్యేకమైన outbound_tcpa_confirmation_required: ప్రిఫిక్స్ అలాగే ఉంచబడుతుంది. తెలియని JSON-RPC మెథడ్లు HTTP 200 ప్రతిస్పందనలో -32601ను తిరిగి ఇస్తాయి. JSON-RPC బ్యాచ్లకు MCP 2025-06-18 మద్దతు ఇవ్వదు మరియు అవి స్పష్టమైన -32600 చెల్లని-అభ్యర్థన ఎర్రర్ను తిరిగి ఇస్తాయి.