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 સર્વરને voice agent સાથે કનેક્ટ કરવાની વિરુદ્ધ દિશા છે:
| દિશા | પરિણામ |
|---|---|
| રિમોટ MCP સર્વર → ThunderPhone એજન્ટ | voice agent રિમોટ સર્વરના ટૂલ્સ કૉલ કરી શકે છે. |
| 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 સહાયક સાથે છે અને તેને રેકોર્ડ તથા ટ્રાન્સક્રાઇબ કરવામાં આવશે." તેને બંધ કરવાનો પ્રયાસ (consent_announcement_enabled false, અથવા ai_live_processing_disclosure_override off) નકારવામાં આવે છે, સિવાય કે સંસ્થાના એડમિને પહેલાં ડેશબોર્ડમાં હસ્તાક્ષરિત ઘોષણા નોંધાવી હોય, કોઈપણ ક્લાયન્ટમાંથી, જેમાં Claude પણ સામેલ છે.
ChatGPT
- જો ChatGPT એપ ડિરેક્ટરીમાં ThunderPhone દેખાય, તો તેને પસંદ કરો અને કનેક્ટ કરો.
- અન્યથા સેટિંગ્સ → એપ્સ અને કનેક્ટર્સ → એડવાન્સ્ડ સેટિંગ્સ ખોલો, ડેવલપર મોડ ચાલુ કરો અને URL
https://api.thunderphone.com/v1/mcpતથા 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 જે વર્તનો માંગે છે તેની સ્થિર id સાથેની સૂચિ પણ આપે છે, રિફેક્ટર જરૂરી છે કે નહીં તે દર્શાવે છે અને એજન્ટના પોતાના 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) અને વપરાયા વિના રહે છે: તે રૂપરેખાંકનને ડેવ વિભાજનમાં માપો. એજન્ટ ઇટરેશન ટૂલકિટ જરૂરી છે. |
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 પરત કરે છે. એજન્ટની દરેક વાતચીત તેના ડેવ સ્પ્લિટ અથવા ટેસ્ટ સ્પ્લિટમાં હોય છે. ટેસ્ટ સ્પ્લિટ ફેરફારનું માપન કરવા માટે છે, તેને ટ્યુન કરવા માટે નહીં, તેથી વાતચીત ટૂલ્સ ટેસ્ટ-સ્પ્લિટની વાતચીતને ફક્ત તેના id, split, source, status અને counts તરીકે પરત કરે છે. ટેસ્ટ સ્પ્લિટ પરનું રીપ્લે રન એક સંપૂર્ણ ટેસ્ટ કોહોર્ટને ફરી ચલાવે છે (sample_size અને sample_seed અવગણવામાં આવે છે), દરેક ઉદાહરણને તેના ડેટા મંજૂરી આપે તે એન્જિન પર, ઉદાહરણમાંથી રન પહેલાં નક્કી કરીને ચલાવે છે (રેકોર્ડ કરેલા કૉલર ઑડિયો માટે exact, ફક્ત ટેક્સ્ટવાળા ઉદાહરણ માટે text; Bolt v2 સિવાયના કન્ફિગરેશનમાં exact માર્ગ નથી, તેથી રેકોર્ડ કરેલા ઑડિયોવાળો કોહોર્ટ તેના માટે test_needs_exact_replay સાથે નકારવામાં આવે છે અને વપરાયા વિના રહે છે; engine છોડવામાં આવે છે અથવા auto હોય છે, કારણ કે exact અથવા text ને test_engine_per_example સાથે નકારવામાં આવે છે અને કંઈપણ ટેક્સ્ટ પર પાછું ફરતું નથી), અને દરેક એન્જિન માટે ફક્ત કુલ પરિણામો પરત કરે છે: પાસ દર, ગંભીરતા અને પ્રકાર મુજબ નિષ્ફળતાઓ, લેટન્સી અને ખર્ચ. રીપ્લે સંગ્રહિત કરતું તેનું પ્રથમ પરિણામ કોહોર્ટ વાપરી નાખે છે, તેથી કોઈપણ prompt માટેના આગામી ટેસ્ટ રનને બીજો કોહોર્ટ મળે છે, અને કોઈ કોહોર્ટ બાકી ન હોય તો તેને no_test_cohort સાથે નકારવામાં આવે છે (કૉલ ઇમ્પોર્ટ કરવાથી અથવા વાતચીત જનરેટ કરવાથી નવા કોહોર્ટ ભરાય છે); એક સંગ્રહિત થાય તે પહેલાં સમાપ્ત થતું રન (Core તેના ઑડિયો ઉદાહરણોને exact રીતે રીપ્લે ન કરી શકે, exact_replay_unavailable, તેની રીપ્લે ક્ષમતા વ્યસ્ત રહે, core_busy, અથવા દરેક ટર્નનું બજેટ સમાપ્ત થઈ ગયું હોય, replay_budget_exhausted) કોહોર્ટને વપરાયા વિના છોડી દે છે. ડેવ સ્પ્લિટ પર, Core ચલાવી ન શકે તેવું exact રીપ્લે ટેક્સ્ટ પર પાછું ફરે છે અને રનને degraded તરીકે ચિહ્નિત કરવામાં આવે છે. તુલનાઓ ફક્ત ડેવ સ્પ્લિટ પર ચાલે છે. દરેક ચૂકવવાપાત્ર ટૂલ તેના ડ્રાય રનનું quote_id લે છે, જે એક રન માટે માન્ય છે: રન શરૂ થાય ત્યારે તે એક વખત કાયમી રીતે વપરાઈ જાય છે, અને તે પહેલાં નકારવામાં આવેલું અથવા નિષ્ફળ થયેલું શરૂ થવું તેને ઉપયોગયોગ્ય રાખે છે; ત્યારબાદ નિષ્ફળ થતું રન એવું સૂચવે છે, અને નવા quote_id માટે નવા ડ્રાય રન સાથે ફરી ચલાવવામાં આવે છે. OAuth સાથે, review_prompt અને refactor_promptને, ડ્રાય રન સહિત, agents:write સ્કોપની જરૂર છે, અને વાતચીત તથા રીપ્લે ટૂલ્સને ચલાવવા માટે testing:writeની જરૂર છે. લોકો ડેશબોર્ડમાં સંપૂર્ણ ટેસ્ટ સ્પ્લિટ જોઈ શકે છે. જે કૉલનો કૉલર એજન્ટના ટેસ્ટ સ્પ્લિટમાં હોય તે રોકી રાખવામાં આવે છે, કારણ કે તે ટેસ્ટ સેટનો ભાગ છે. ટૂલકિટ ધરાવતી સંસ્થામાં, list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade અને export_calls તેને ટ્રાન્સક્રિપ્ટ, રેકોર્ડિંગ, ઇતિહાસ, ગ્રેડ અથવા રિપોર્ટ વિના બરાબર {"call_id", "start_time", "held_out": true} તરીકે પરત કરે છે (એક્સપોર્ટની પંક્તિઓમાં start_timeના સ્થાને started_at); કૉલનું દરેક અન્ય ફીલ્ડ ગેરહાજર હોય છે, તેથી અન્ય કંઈપણ પહેલાં રોકી રાખેલી પંક્તિને તેના held_out દ્વારા વાંચો. REST API, API કી અને OAuth ટોકન માટે પણ આવું જ કરે છે, અને ઘણા કૉલ્સમાં તેના દૃશ્યો (રિપોર્ટ સારાંશો, ઇશ્યૂ ક્લસ્ટર્સ, તપાસો, પાઇપલાઇન રિપોર્ટ્સ) રોકી રાખેલા કૉલ્સને તેમની ગણતરીઓ, ક્લસ્ટર્સ અને નમૂનાઓમાંથી બહાર રાખે છે, તેમજ મોડેલે તેમાંથી લખેલું કોઈપણ ટેક્સ્ટ અટકાવી રાખે છે. રોકી રાખેલા કૉલ પર લખવાની ક્રિયા (ગ્રેડિંગ, તેને ટેસ્ટ સિનારિયોમાં પ્રમોટ કરવું, ટર્ન ફરી જનરેટ કરવો) held_out_call સાથે નકારવામાં આવે છે. કોઈએ રોકી રાખેલા કૉલમાંથી પ્રમોટ કરેલું ટેસ્ટ સિનારિયો list_test_scenariosમાંથી અને ટેસ્ટ રનમાં બરાબર {"id", "held_out": true} તરીકે પરત આવે છે, અને તેમાંથી થયેલું સિમ્યુલેશન રન get_test_run અને સિમ્યુલેશન ટૂલ્સમાંથી બરાબર {"id", "scenario_id", "held_out": true} તરીકે પરત આવે છે; તેના સિમ્યુલેટેડ કૉલ્સ પણ રોકી રાખવામાં આવે છે, અને ટેસ્ટ રન તેમ છતાં તેને ચલાવે છે. રોકી રાખેલા કૉલરના કૉલમાંથી નકલ કરાયેલી ડેવ વાતચીત, ઉદાહરણ અથવા રીપ્લે પરિણામ (સ્પ્લિટ્સ દરેક એજન્ટ માટે હોય છે, તેથી તે કૉલર બીજા એજન્ટના ટેસ્ટ સ્પ્લિટમાં હોઈ શકે છે) ટેસ્ટ-સ્પ્લિટના પરિણામની જેમ વાંચાય છે. લોકો ડેશબોર્ડમાં રોકી રાખેલા કૉલ્સ સંપૂર્ણ રીતે જોઈ શકે છે, અને એડમિન દરેક કૉલની જરૂર હોય તેવા ઇન્ટિગ્રેશન માટે એક API કીને તેને સંપૂર્ણ રીતે જોવાની મંજૂરી આપી શકે છે (include_held_out_calls, ડિફૉલ્ટરૂપે બંધ, ફક્ત ડેશબોર્ડમાં સેટ કરી શકાય છે); MCP તેનો ક્યારેય ઉપયોગ કરતું નથી. વેબહુક્સમાં કોઈ ફેરફાર નથી. ટૂલકિટ વગરની સંસ્થાઓને held_out ફીલ્ડ દેખાતું નથી અને કોઈ ફેરફાર થતો નથી.
generate_conversations, import_conversations અને refresh_conversations મોડેલ ક્રેડિટ ખર્ચે છે. પહેલાં તેમને dry_run: true સાથે કૉલ કરો: જવાબમાં તબક્કાવાર ખર્ચ અંદાજ, quote_id મળે છે અને કંઈ ચલાવવામાં આવતું નથી. અંદાજ સામાન્ય કદ પર રન કરી શકે તેવી દરેક રિક્વેસ્ટની ગણતરી કરે છે. વાસ્તવિક રન માટે તે quote_id (તે 15 મિનિટ પછી સમાપ્ત થાય છે અને માત્ર સમાન દલીલો સાથે જ કાર્ય કરે છે) અને max_cost_cents, એક કડક મર્યાદા, જરૂરી છે: દરેક રિક્વેસ્ટ પહેલાં જૉબ તે રિક્વેસ્ટનો શક્ય મહત્તમ ખર્ચ અલગ રાખે છે અને જે તેમાં સમાતી નથી તેને મોકલવાને બદલે અટકી જાય છે, અને તેણે જે લખ્યું છે તે જાળવી રાખે છે. આ અલગ રાખવાને કારણે, રન તેની મર્યાદામાંથી થોડો ખર્ચ કર્યા વગર અટકી શકે છે; અંદાજનું largest_reservation_cents કેટલી વધારાની જગ્યા રાખવી તે જણાવે છે. સિમ્યુલેટેડ કૉલર્સ એજન્ટના prompt પરથી બનાવવામાં આવે છે; style: "adversarial" promptના નબળા મુદ્દાઓ પર દબાણ કરતા મુશ્કેલ કૉલર્સ બનાવે છે, અને તે વાતચીતો હંમેશા ડેવ સ્પ્લિટમાં જાય છે. target: "changed_behaviors" કૉલર્સને છેલ્લી prompt સંપાદનમાં શું બદલાયું તેના તરફ દોરે છે. દરેક એજન્ટ એક સમયે આમાંથી એક જૉબ અથવા એક રિપ્લે રન ચલાવે છે, તેથી રિફ્રેશ રિપ્લે જે ઉદાહરણો પર ચાલી રહ્યો હોય તેમાં ક્યારેય ફેરફાર કરતું નથી; બીજું ચાલી રહ્યું હોય ત્યારે શરૂ કરવાથી job_active, replay_run_active અથવા conversation_job_active મળે છે, સાથે કઈ બાબતની રાહ જોવી તે પણ મળે છે.
વર્તન ઉમેરતી, દૂર કરતી અથવા બદલતી prompt સંપાદન પછી, એજન્ટના ડ્રાફ્ટ પરનું review_prompt જણાવે છે કે અન્ય વર્તનો ધરાવતા prompt માટે કેટલી ટેસ્ટ વાતચીતો લખવામાં આવી હતી (conversations.refresh_suggested). પછી refresh_conversations તેમને ડ્રાફ્ટ મુજબ અપડેટ કરે છે, જેથી ડેવ અને ટેસ્ટ સેટ્સ નવા promptને તે બનાવી શક્યો હોત એવા ઇતિહાસો પર માપે છે. રિફ્રેશ ક્યારેય કંઈ ગુમાવતું નથી: દરેક વાતચીત પહેલાનાં દરેક રિવિઝનને જાળવે છે અને જ્યારે દૂર કરેલો નિયમ પાછો આવે છે, ત્યારે તે અસ્તિત્વમાં હતો તે સમયનું રિવિઝન તેના વાસ્તવિક કૉલર ઑડિયો સાથે પુનઃસ્થાપિત થાય છે. કોડિંગ એજન્ટ દ્વારા શરૂ કરાયેલ રિફ્રેશ ટેસ્ટ-સ્પ્લિટ વાતચીતો અને અલગ રાખેલા કૉલ્સમાંથી કૉપિ કરાયેલી વાતચીતોને તેની પસંદગી, અંદાજ, પ્રગતિ અને ખર્ચમાંથી બહાર રાખે છે; conversation_idsમાં એવી એકનું નામ આપવાથી 403 test_conversation મળે છે. વ્યક્તિ ડૅશબોર્ડમાંથી તેમને રિફ્રેશ કરે છે, અને કોડિંગ એજન્ટોને તે જૉબના પરિણામોમાં તેઓ માત્ર આઈડી અને ગણતરીઓ તરીકે દેખાય છે. જે active ઉદાહરણનો ઇતિહાસ, જવાબ અથવા ઉત્તર કી રિફ્રેશ ફરીથી લખે છે તે refreshed_needs_review લેબલ સાથે પાછું pending_reviewમાં જાય છે. રિફ્રેશનો અંદાજ તે વાંચે છે એવી દરેક વાતચીતનો ભાવ એવો નક્કી કરે છે જાણે તેને ફરીથી લખવામાં આવતી હોય, દરેક મોડેલ કૉલનો તેની આઉટપુટ મર્યાદા મુજબ, અને તે જે prompt તથા વાતચીતો માટે અંદાજ આપવામાં આવ્યો હતો તેમના માટે જ માન્ય રહે છે: રન પહેલાં તેમાંનું કોઈપણ બદલાય તો ફરી અંદાજ લો; રન દરમિયાન prompt બદલાય તો જૉબ તેણે જે રિફ્રેશ કર્યું છે તે જાળવી રાખીને failed તરીકે અટકી જાય છે.
જ્ઞાન
| સાધન | મુખ્ય દલીલો | એનોટેશન્સ | તે શું કરે છે |
|---|---|---|---|
list_knowledge_bases | — | R, I | નોલેજ બેઝિસની સૂચિ આપે છે. |
create_knowledge_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 નામ અને તેની જાહેર કરેલી દલીલો સાથે prompts/get નો ઉપયોગ કરો.
સંસાધનો
resources/list જાહેર, કૅશ કરેલા સંદર્ભો પ્રદર્શિત કરે છે:
| URI | સામગ્રી |
|---|---|
thunderphone://docs/llms.txt | જાહેર દસ્તાવેજીકરણ સૂચિ. |
thunderphone://docs/quickstart | ક્વિકસ્ટાર્ટ Markdown. |
thunderphone://pricing | વર્તમાન જાહેર કિંમત નિર્ધારણ Markdown. |
thunderphone://guides/prompt-style | વૉઇસ એજન્ટ prompt શૈલી માર્ગદર્શિકા, જેની સામે review_prompt તપાસ કરે છે. તેના માર્ગદર્શિકા ID (P1, W2 વગેરે)નો જ નિષ્કર્ષોમાં ઉલ્લેખ થાય છે. |
thunderphone://guides/working-with-thunderphone | સહાયકે આ ટૂલ્સ સાથે કેવી રીતે કાર્ય કરવું: ડ્રાફ્ટ પર નાના ચક્રો, દરેક ડિપ્લોય પહેલાં તપાસ, લાઇવ અથવા બિલ લાગુ પડે તેવી કોઈપણ બાબત માટે વપરાશકર્તાની હા, અને ક્યારેય સિક્રેટ્સ ન માંગવા. |
resources/read વડે એક વાંચો. જાહેર ફેચ ટૂંકા timeout, 2 MiB મર્યાદા અને દસ-મિનિટની in-process કૅશનો ઉપયોગ કરે છે.
પ્રોટોકોલ અને ભૂલો
સર્વર 2025-06-18 અને 2025-03-26 પ્રોટોકોલ સંસ્કરણોને સમર્થન આપે છે; તે સમર્થિત ક્લાયન્ટ સંસ્કરણને echo કરે છે અને અન્યથા 2025-06-18 પસંદ કરે છે. તે initialize, ping, ટૂલ્સ, prompt, સંસાધનો અને સૂચનાઓ અમલમાં મૂકે છે. સૂચનાઓ 202 Accepted પરત કરે છે. આ stateless સર્વર 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."
}અલગ outbound_tcpa_confirmation_required: ઉપસર્ગ place_call માટે જાળવી રાખવામાં આવે છે. અજાણી JSON-RPC પદ્ધતિઓ HTTP 200 પ્રતિભાવમાં -32601 પરત કરે છે. MCP 2025-06-18 દ્વારા JSON-RPC બેચ સમર્થિત નથી અને તે સ્વચ્છ -32600 અમાન્ય-વિનંતિ ભૂલ પરત કરે છે.