Open in
ใช้ ThunderPhone เป็นเซิร์ฟเวอร์ MCP
สร้าง ทดสอบ ตรวจสอบความถูกต้อง และใช้งานเอเจนต์เสียง ThunderPhone จาก Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code หรือไคลเอนต์ Streamable HTTP MCP อื่น
ThunderPhone เปิดให้ใช้งานเซิร์ฟเวอร์ Model Context Protocol แบบ Streamable HTTP ที่:
https://api.thunderphone.com/v1/mcpนี่เป็นทิศทางตรงข้ามกับการเชื่อมต่อเซิร์ฟเวอร์ MCP ระยะไกลกับเอเจนต์เสียง:
| ทิศทาง | ผลลัพธ์ |
|---|---|
| เซิร์ฟเวอร์ MCP ระยะไกล → เอเจนต์ ThunderPhone | เอเจนต์เสียงสามารถเรียกใช้เครื่องมือของเซิร์ฟเวอร์ระยะไกลได้ |
| ThunderPhone → ไคลเอนต์ MCP ของคุณ | เอเจนต์เขียนโค้ดของคุณสามารถสร้าง ทดสอบ และดำเนินการ ThunderPhone ได้ |
การยืนยันตัวตน
ใช้ OAuth เป็นค่าเริ่มต้นสำหรับไคลเอ็นต์ไดเรกทอรี: ลงชื่อเข้าใช้ เลือกองค์กร และอนุมัติสิทธิ์ที่ร้องขอ ยกเลิกการเชื่อมต่อได้ที่ การตั้งค่า → ความปลอดภัย → แอปที่คุณเชื่อมต่อ การเปลี่ยนหรือรีเซ็ตรหัสผ่าน หรือการเปลี่ยนอีเมลบัญชี จะเพิกถอนการเชื่อมต่อด้วย ดังนั้นให้เชื่อมต่อไคลเอ็นต์อีกครั้งหลังจากนั้น
สำหรับไคลเอ็นต์ที่กำหนดค่าด้วยคีย์ API ให้สร้างคีย์ sk_live_ ที่ การผสานการทำงาน → คีย์ API และเปิดให้ไคลเอ็นต์ MCP ของคุณเข้าถึงในชื่อ THUNDERPHONE_API_KEY คีย์จะผูกกับองค์กรเดียว; id ที่เป็นขององค์กรอื่นจะแสดงผลเสมือนไม่พบ
องค์กรที่จัดการ PHI
หากการโทรขององค์กรอาจมีข้อมูลสุขภาพที่ได้รับการคุ้มครอง (PHI)
เนื่องจากคุณมี BAA กับ ThunderPhone หรือเอเจนต์ของคุณถูกกำหนดให้
ประมวลผล PHI URL ข้างต้นจะไม่ส่งคืนเนื้อหาการโทร ได้แก่ บทถอดเสียง
ไฟล์บันทึกเสียง คะแนน รายการการโทร การส่งออก ผลลัพธ์ของแคมเปญ การวิเคราะห์การโทรและ
ข้อมูลเชิงลึก บทสนทนาที่สร้างจากการโทรจริง และผลการเล่นซ้ำ เครื่องมือเหล่านั้นจะส่งคืนข้อผิดพลาดพร้อม
code: "phi_content_unavailable" การสร้าง การทดสอบ และการกำหนดค่าเอเจนต์
ยังทำงานได้ตามปกติ
URL นั้นคือรายการที่แสดงในไดเรกทอรีผู้ช่วยสาธารณะ ซึ่งอาจไม่รองรับ PHI หากองค์กรของคุณมี BAA ของตนเองกับผู้ให้บริการของผู้ช่วย ซึ่งครอบคลุมเวิร์กสเปซที่คุณใช้:
- ผู้ดูแลระบบองค์กรเปิด องค์กร → ทั่วไป → การเข้าถึง AI เอเจนต์ ใน ThunderPhone และยืนยันความครอบคลุมนั้น
- เชื่อมต่อผู้ช่วยเป็นตัวเชื่อมต่อแบบกำหนดเองโดยใช้ 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 พร้อมรีเฟรชโทเค็นที่หมดอายุ แล้วใช้
OAuth ผ่าน mcp-remote การเข้าสู่ระบบด้วยอุปกรณ์และ OAuth ต้องอาศัยการเปิดใช้ API
OAuth ที่เกี่ยวข้อง แต่เส้นทางคีย์ API ไม่ต้องใช้ การกำหนดค่า HTTP โดยตรงจะไม่อ่าน
ที่เก็บข้อมูลรับรองของ CLI ให้ใช้ตัวครอบ stdio เพื่อใช้การเข้าสู่ระบบด้วยอุปกรณ์ซ้ำ
สิ่งเหล่านี้เป็นทางเลือกแทนการกำหนดค่าไคลเอนต์ด้วยตนเองด้านล่าง
การกำหนดค่าไคลเอนต์
Claude และ ChatGPT ลงชื่อเข้าใช้ด้วย OAuth โดยไม่ต้องใช้คีย์ API หากคุณยังไม่มีบัญชี ThunderPhone ให้เลือก สร้างบัญชี ในหน้าลงชื่อเข้าใช้ แล้วคุณจะกลับไปยังหน้าจออนุมัติหลังยืนยันอีเมลแล้ว
Claude (เว็บ เดสก์ท็อป และมือถือ)
- เปิด ปรับแต่ง → ตัวเชื่อมต่อ (การตั้งค่า → ตัวเชื่อมต่อ ในเวอร์ชันเก่า) หาก ThunderPhone ปรากฏในไดเรกทอรีตัวเชื่อมต่อ ให้เลือก 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 เป็นเท็จ หรือ ai_live_processing_disclosure_override ปิด) จะถูกปฏิเสธ เว้นแต่ผู้ดูแลองค์กรจะบันทึกคำรับรองที่ลงนามแล้วในแดชบอร์ดก่อน ผ่านไคลเอนต์ใดก็ได้ รวมถึง Claude
ChatGPT
- หาก ThunderPhone ปรากฏในไดเรกทอรีแอป ChatGPT ให้เลือกแล้วเชื่อมต่อ
- มิฉะนั้น ให้เปิด การตั้งค่า → แอปและตัวเชื่อมต่อ → การตั้งค่าขั้นสูง เปิด โหมดนักพัฒนา แล้วสร้างตัวเชื่อมต่อด้วย 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
เพิ่มบริดจ์ mcp-remote ไปยังการกำหนดค่า 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
สร้าง .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 | การกำหนดค่าเอเจนต์ | — | สร้างเอเจนต์ ใช้การตั้งค่าเดียวกับ update_agent รวมถึง steps, handoffs, intro_clip และ intro_ring_count |
update_agent | agent_id, ฟิลด์ที่เปลี่ยนแปลง, prompt_edits ที่ไม่บังคับ, expected_prompt_sha256 | D | จัดเตรียมฟิลด์ไว้ในฉบับร่างของเอเจนต์ โดยแทนที่ข้อมูลเดิมในฉบับร่าง ทำงานโดยไม่มีขั้นตอนยืนยัน: เอเจนต์ที่ปรับใช้แล้วจะไม่เปลี่ยนแปลงจนกว่าจะใช้ deploy_agent และ discard_agent_draft จะคืนค่าฉบับร่าง นอกจากนี้ยังตั้งค่า max_hold_seconds, system_tool_settings และ words ได้ หากต้องการเปลี่ยนบางส่วนของพรอมต์ ให้ส่ง prompt_edits (ดู แก้ไขพรอมต์ในตำแหน่งเดิม) |
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 | แสดงรายการการเปลี่ยนแปลงทั้งหมดในข้อความพรอมต์ของเอเจนต์ รวมถึงฉบับร่าง โดยแต่ละรายการมีความแตกต่างเทียบกับการแก้ไขที่ถูกแทนที่ ใช้งานได้เมื่อชุดเครื่องมือวนซ้ำเอเจนต์พร้อมใช้งานสำหรับการเชื่อมต่อของคุณ (ดูด้านล่าง) |
review_prompt | agent_id, prompt, previous_prompt, quote_id, max_cost_cents ที่ไม่บังคับ | — | ตรวจสอบพรอมต์ฉบับร่าง (หรือข้อความที่คุณส่ง) เทียบกับคู่มือสไตล์พรอมต์ ผลการตรวจพบแต่ละรายการจะอ้างอิงข้อความ ระบุแนวทาง และเสนอการแก้ไขแบบค้นหาและแทนที่ ผลลัพธ์ยังแสดงรายการพฤติกรรมที่พรอมต์ร้องขอ พร้อม ID ที่คงที่ สถานะว่าควรปรับโครงสร้างหรือไม่ และสำหรับพรอมต์ของเอเจนต์เอง สถานะว่าบทสนทนาทดสอบต้องรีเฟรชหรือไม่ ไม่มีการเปลี่ยนแปลงใดกับเอเจนต์ โดยรายการพฤติกรรมจะบันทึกไว้พร้อมการแก้ไขพรอมต์ มีค่าใช้จ่าย จึงไม่ได้ทำเครื่องหมายเป็นแบบอ่านอย่างเดียว: ให้ประเมินค่าใช้จ่ายก่อนด้วย dry_run จากนั้นเรียกใช้อีกครั้งโดยไม่ใช้ dry_run พร้อม quote_id ที่ส่งกลับและ max_cost_cents การเรียกใช้แบบมีค่าใช้จ่ายเหล่านี้จะนับรวมในโควต้าชุดเครื่องมือขององค์กรเดียวกันกับการเรียกใช้ชุดเครื่องมืออื่น ใช้งานได้เมื่อชุดเครื่องมือวนซ้ำเอเจนต์พร้อมใช้งานสำหรับการเชื่อมต่อของคุณ (ดูด้านล่าง) |
refactor_prompt | agent_id, prompt, inventory, instructions, quote_id, max_cost_cents ที่ไม่บังคับ | — | เขียนพรอมต์ใหม่ให้อยู่ในรูปแบบของคู่มือสไตล์ และแมปทุกพฤติกรรมเป็นคงไว้ รวมกัน ปรับถ้อยคำ หรือตัดออก ส่งกลับข้อความใหม่และความแตกต่าง และโดยค่าเริ่มต้นจะอ่านซ้ำเพื่อรายงาน behavior_changes (เพิ่ม ลบ หรือเปลี่ยนแปลง) และ behavior_preserved; ใช้ผลลัพธ์กับ update_agent มีค่าใช้จ่าย: ประเมินค่าใช้จ่ายด้วย dry_run แล้วเรียกใช้หนึ่งครั้งด้วย quote_id ที่ส่งกลับและ max_cost_cents ใช้งานได้เมื่อชุดเครื่องมือวนซ้ำเอเจนต์พร้อมใช้งานสำหรับการเชื่อมต่อของคุณ (ดูด้านล่าง) |
list_reusable_instructions | — | R, I | แสดงรายการคำสั่งที่ใช้ซ้ำได้: กฎพรอมต์ที่ใช้ร่วมกันซึ่งแนบกับเอเจนต์หลายรายการผ่าน reusable_instruction_ids ของ update_agent |
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 | ส่ง SMS ข้อความล้วนหนึ่งข้อความผ่านหมายเลข Twilio หรือ Telnyx ที่เชื่อมต่ออยู่ |
การโทร
| เครื่องมือ | อาร์กิวเมนต์หลัก | คำอธิบายประกอบ | สิ่งที่ทำ |
|---|---|---|---|
list_calls | ตัวกรองที่ไม่บังคับ, limit, offset | R, I | แสดงรายการสายด้วยตัวกรองประวัติการโทรของ REST รวมถึง exclude_test_calls |
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 endpoint เป็น 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 | สร้างสถานการณ์จากพรอมป์ต์ของเอเจนต์ |
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 | ทดสอบเอเจนต์ด้วยการเรียกครั้งเดียว: เรียกใช้สถานการณ์ที่บันทึกไว้ของเอเจนต์ (สร้างบางรายการเมื่อยังไม่มี) และรอผลการตัดสินสูงสุดหนึ่งนาที หรือส่งคืน batch_id สำหรับ get_test_run คิดค่าบริการเช่นเดียวกับ 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 | แสดงรายการการแก้ไขทุกเวอร์ชันของบทสนทนาทดสอบ: เปลี่ยนอย่างไรและเพราะเหตุใด (รีเฟรชสำหรับการเปลี่ยนพรอมป์ต์ กู้คืนจากเวอร์ชันก่อนหน้า) พฤติกรรมที่เพิ่ม ลบ และเปลี่ยน ตัวอย่างที่ย้ายหรือเลิกใช้ และความแตกต่างของแถว ต้องใช้ชุดเครื่องมือการปรับปรุงเอเจนต์ |
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 | อัปเดตบทสนทนาทดสอบของเอเจนต์ให้สอดคล้องกับพรอมป์ต์ปัจจุบันหลังเพิ่ม ลบ หรือเปลี่ยนพฤติกรรม: ชี้ใหม่ กู้คืนเวอร์ชันก่อนหน้า (รวมเสียงจริง) หรือเขียนเทิร์นที่ล้าสมัยใหม่ และเลิกใช้ตัวอย่างที่ไม่มีเทิร์นของผู้โทรแล้ว เรียกดูราคาด้วย 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 | เล่นซ้ำตัวอย่างส่วนหนึ่งของเอเจนต์ภายใต้ฉบับร่าง หรือภายใต้การแทนที่ เช่น พรอมป์ต์ เสียง หรือระดับที่เสนอ และตัดสินแต่ละคำตอบเทียบกับเฉลยของตัวอย่าง การเล่นซ้ำแบบตรงจะใช้เสียงที่บันทึกไว้ของเทิร์นเหมือนการโทรจริง รายงานอัตราการผ่านแยกตามเอนจิน การเล่นซ้ำของการโทร 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 | เล่นซ้ำตัวอย่างเดียวกันภายใต้การกำหนดค่าแต่ละรายการ และรายงานอัตราการผ่าน ตัวอย่างที่แก้ไขได้และเสียหายเมื่อเทียบกับค่าพื้นฐาน เวลาแฝงจนถึงเสียงแรก ความถี่ที่ผู้โทรรอการตอบรับ เสียงติ๊กหรือความเงียบ และค่าใช้จ่ายต่อเทิร์น แยกตามเอนจิน เรียกดูราคาด้วย dry_run เช่นเดียวกับ run_replays ใช้ได้เฉพาะชุดพัฒนา: ในชุดทดสอบระบบจะปฏิเสธ (comparison_dev_only) ให้เปรียบเทียบในชุดพัฒนา แล้ววัดผลตัวเลือกด้วย run_replays ต้องใช้ชุดเครื่องมือการปรับปรุงเอเจนต์ |
get_replay_run | run_id, include_trace ที่ไม่บังคับ | R, I | รับยอดรวม การเปลี่ยนผล และผลลัพธ์รายตัวอย่างของการรันเล่นซ้ำ รวมถึงกลุ่มเปรียบเทียบ การเล่นซ้ำแบบตรงที่ต้องใช้งบประมาณมากกว่าที่กำหนดจะนับแยก (budget_exhausted) และไม่นำไปรวมในอัตราการผ่าน ต้องใช้ชุดเครื่องมือการปรับปรุงเอเจนต์ |
create_talk_link | agent_id, variant_id, language, expires_in_minutes ที่ไม่บังคับ | O | สร้างลิงก์ใช้ครั้งเดียวที่บุคคลเปิดในเบราว์เซอร์เพื่อสนทนากับฉบับร่างปัจจุบันของเอเจนต์ เช่นเดียวกับปุ่ม Talk ในแดชบอร์ด ลิงก์หมดอายุหลัง 30 นาทีโดยค่าเริ่มต้น (สูงสุด 120 นาที) การสนทนาจะคิดค่าบริการเช่นการโทรทดสอบ Talk ดู ลิงก์ Talk |
เครื่องมือที่ระบุว่าต้องใช้ชุดเครื่องมือการทำซ้ำเอเจนต์เป็นส่วนหนึ่งของชุดเครื่องมือนั้น ชุดเครื่องมือนี้จะเปิดใช้แยกตามองค์กรในช่วงเบต้า และหากไม่มี เครื่องมือจะส่งคืน feature_not_enabled พร้อมคำแนะนำสำหรับขั้นตอนถัดไป การสนทนาแต่ละรายการของเอเจนต์จะอยู่ใน dev split หรือ test split ของเอเจนต์นั้น test split มีไว้สำหรับวัดผลการเปลี่ยนแปลง ไม่ใช่สำหรับปรับจูน ดังนั้นเครื่องมือการสนทนาจึงส่งคืนการสนทนาใน test split โดยมีเพียง id split source status และจำนวนต่างๆ เท่านั้น การรัน replay บน test split จะเล่นซ้ำทั้งกลุ่มทดสอบหนึ่งกลุ่ม (sample_size และ sample_seed จะถูกละเว้น) โดยเล่นแต่ละตัวอย่างด้วยเอนจินที่ข้อมูลของตัวอย่างอนุญาต ซึ่งกำหนดจากตัวอย่างก่อนเริ่มรัน (exact สำหรับเสียงผู้โทรที่บันทึกไว้ และ text สำหรับตัวอย่างที่มีเฉพาะข้อความ การกำหนดค่าที่ไม่ใช่ Bolt v2 ไม่มีเส้นทาง exact ดังนั้นกลุ่มที่มีเสียงบันทึกของผู้โทรจะถูกปฏิเสธด้วย test_needs_exact_replay และยังไม่ถูกใช้ engine จะถูกละเว้นหรือเป็น auto เนื่องจาก exact หรือ text จะถูกปฏิเสธด้วย test_engine_per_example และไม่มีสิ่งใดสำรองไปใช้ text) และส่งคืนเฉพาะผลรวมแยกตามเอนจิน ได้แก่ อัตราการผ่าน ความล้มเหลวตามระดับความรุนแรงและประเภท เวลาแฝง และค่าใช้จ่าย ผลลัพธ์แรกที่จัดเก็บ replay จะใช้กลุ่มนั้นไป ดังนั้นการทดสอบครั้งถัดไป ไม่ว่าจะใช้พรอมป์ตใด จะใช้กลุ่มอื่น และเมื่อไม่มีกลุ่มเหลือ ระบบจะปฏิเสธด้วย no_test_cohort (การนำเข้าสายหรือการสร้างการสนทนาจะเพิ่มกลุ่มใหม่) การรันที่สิ้นสุดก่อนจัดเก็บ replay หนึ่งรายการ (Core ไม่สามารถเล่นซ้ำตัวอย่างเสียงแบบ exact ได้ exact_replay_unavailable ความสามารถในการเล่นซ้ำของ Core ยังไม่ว่าง core_busy หรือทุกเทิร์นใช้งบประมาณหมด replay_budget_exhausted) จะไม่ใช้กลุ่มนั้น บน dev split replay แบบ exact ที่ Core ไม่สามารถรันได้จะสำรองไปใช้ text และการรันจะถูกทำเครื่องหมายเป็น degraded การเปรียบเทียบจะรันบน dev split เท่านั้น เครื่องมือแบบชำระเงินทุกตัวรับ quote_id จาก dry run ของตน ซึ่งใช้ได้สำหรับการรันหนึ่งครั้ง โดยจะถูกใช้ไปอย่างถาวรหนึ่งครั้งเมื่อเริ่มการรัน การเริ่มที่ถูกปฏิเสธหรือล้มเหลวก่อนหน้านั้นจะยังคงใช้ได้ ส่วนการรันที่ล้มเหลวหลังจากนั้นจะระบุสถานะดังกล่าว และต้องทำ dry run ใหม่เพื่อรับ quote_id ใหม่ก่อนรันซ้ำ เมื่อใช้ OAuth review_prompt และ refactor_prompt ต้องใช้ขอบเขต agents:write รวมถึง dry run และเครื่องมือการสนทนาและ replay ต้องใช้ testing:write เพื่อรัน ผู้ใช้สามารถดู test split ทั้งหมดได้ในแดชบอร์ด สายที่ผู้โทรอยู่ใน test split ของเอเจนต์จะถูกกันออก เนื่องจากเป็นส่วนหนึ่งของชุดทดสอบ ในองค์กรที่มีชุดเครื่องมือนี้ list_calls, get_call, get_call_transcript, get_call_audio_url, get_call_grade และ export_calls จะส่งคืนสายดังกล่าวเป็น {"call_id", "start_time", "held_out": true} เท่านั้น (started_at แทน start_time ในแถวของการส่งออก) โดยไม่มีทรานสคริปต์ การบันทึก ประวัติ เกรด หรือรายงาน ฟิลด์อื่นทั้งหมดของสายจะไม่มีอยู่ ดังนั้นให้อ่านแถวที่ถูกกันออกจาก held_out ก่อนสิ่งอื่นใด REST API ทำเช่นเดียวกันสำหรับ API key และ OAuth token และมุมมองที่ครอบคลุมหลายสายของ REST API (สรุปรายงาน กลุ่มปัญหา การตรวจสอบ รายงานไปป์ไลน์) จะไม่นับสายที่ถูกกันออกในจำนวน กลุ่ม และตัวอย่าง และจะไม่แสดงข้อความใดๆ ที่โมเดลสร้างจากสายเหล่านั้น การเขียนข้อมูลลงในสายที่ถูกกันออก (การให้เกรด การเลื่อนเป็นสถานการณ์ทดสอบ หรือการสร้างเทิร์นใหม่) จะถูกปฏิเสธด้วย held_out_call สถานการณ์ทดสอบที่มีผู้เลื่อนมาจากสายที่ถูกกันออกจะส่งคืนจาก list_test_scenarios และในการรันทดสอบเป็น {"id", "held_out": true} เท่านั้น และการรันจำลองจากสถานการณ์นั้นจะส่งคืนจาก get_test_run และเครื่องมือจำลองเป็น {"id", "scenario_id", "held_out": true} เท่านั้น สายจำลองของสถานการณ์นั้นจะถูกกันออกเช่นกัน แต่การรันทดสอบยังคงรันสถานการณ์นั้น การสนทนา ตัวอย่าง หรือผลลัพธ์ replay ใน dev ที่คัดลอกจากสายของผู้โทรที่ถูกกันออก (split แยกตามเอเจนต์ ดังนั้นผู้โทรนั้นอาจอยู่ใน test split ของเอเจนต์อื่น) จะอ่านได้เช่นเดียวกับรายการใน test split ผู้ใช้สามารถดูสายที่ถูกกันออกทั้งหมดได้ในแดชบอร์ด และผู้ดูแลระบบสามารถอนุญาตให้ API key หนึ่งรายการดูสายเหล่านั้นทั้งหมดได้ (include_held_out_calls ปิดอยู่โดยค่าเริ่มต้น และตั้งค่าได้เฉพาะในแดชบอร์ด) สำหรับการผสานรวมที่ต้องใช้ทุกสาย MCP จะไม่ใช้ตัวเลือกนี้ Webhook ไม่มีการเปลี่ยนแปลง องค์กรที่ไม่มีชุดเครื่องมือนี้จะไม่เห็นฟิลด์ held_out และไม่มีการเปลี่ยนแปลงใดๆ
generate_conversations, import_conversations และ refresh_conversations ใช้เครดิตโมเดล เรียกใช้ด้วย dry_run: true ก่อน ผลลัพธ์คือใบเสนอราคาค่าใช้จ่ายแบบแยกเป็นขั้นตอน พร้อม quote_id และจะไม่มีการรันใด ๆ ใบเสนอราคาจะนับทุกคำขอที่การรันอาจส่งได้ในขนาดปกติ การรันจริงต้องใช้ quote_id นั้น (จะหมดอายุหลัง 15 นาที และใช้ได้กับอาร์กิวเมนต์เดิมเท่านั้น) และ max_cost_cents ซึ่งเป็นเพดานสูงสุด ก่อนส่งแต่ละคำขอ งานจะกันค่าใช้จ่ายสูงสุดที่คำขอนั้นอาจมีไว้ และหยุดแทนการส่งคำขอที่ไม่อยู่ในเพดาน โดยเก็บสิ่งที่เขียนไว้แล้วไว้ เนื่องจากการกันค่าใช้จ่ายนี้ การรันอาจหยุดทั้งที่ยังใช้เพดานไม่หมด largest_reservation_cents ในใบเสนอราคาจะระบุว่าควรเผื่อวงเงินไว้เท่าใด ผู้โทรจำลองถูกสร้างจากพรอมต์ของเอเจนต์ style: "adversarial" จะสร้างผู้โทรที่รับมือยากซึ่งกดดันจุดอ่อนของพรอมต์ และการสนทนาเหล่านั้นจะอยู่ในชุดพัฒนาเสมอ target: "changed_behaviors" จะมุ่งผู้โทรไปที่สิ่งที่เปลี่ยนแปลงในการแก้ไขพรอมต์ล่าสุด เอเจนต์แต่ละตัวรันงานเหล่านี้ได้ครั้งละหนึ่งงาน หรือรันซ้ำได้ครั้งละหนึ่งรายการ ดังนั้นการอัปเดตจะไม่เปลี่ยนตัวอย่างที่การรันซ้ำกำลังใช้อยู่ การเริ่มงานขณะที่อีกงานกำลังทำงานจะส่งคืน job_active, replay_run_active หรือ conversation_job_active พร้อมระบุสิ่งที่ต้องรอ
หลังการแก้ไขพรอมต์ที่เพิ่ม ลบ หรือเปลี่ยนพฤติกรรม review_prompt บนฉบับร่างของเอเจนต์จะรายงานจำนวนการสนทนาทดสอบที่เขียนไว้สำหรับพรอมต์ซึ่งมีพฤติกรรมอื่น (conversations.refresh_suggested) จากนั้น refresh_conversations จะอัปเดตการสนทนาเหล่านั้นให้ตรงกับฉบับร่าง เพื่อให้ชุดพัฒนาและชุดทดสอบวัดพรอมต์ใหม่จากประวัติที่พรอมต์นั้นอาจสร้างได้ การอัปเดตจะไม่ทำให้ข้อมูลใดสูญหาย การสนทนาแต่ละรายการจะเก็บการแก้ไขก่อนหน้าทุกเวอร์ชันไว้ และเมื่อกฎที่ถูกลบกลับมา เวอร์ชันจากช่วงที่กฎนั้นมีอยู่จะถูกกู้คืนพร้อมเสียงผู้โทรจริง การอัปเดตที่เอเจนต์เขียนโค้ดเริ่มต้นจะไม่นำการสนทนาในชุดทดสอบ และการสนทนาที่คัดลอกจากสายที่กันไว้ มารวมในการเลือก ใบเสนอราคา ความคืบหน้า และค่าใช้จ่าย การระบุรายการใดรายการหนึ่งใน conversation_ids จะส่งคืน 403 test_conversation บุคคลสามารถอัปเดตรายการเหล่านั้นจากแดชบอร์ด และผลลัพธ์ของงานนั้นจะแสดงต่อเอเจนต์เขียนโค้ดเป็นเพียงรหัสและจำนวนเท่านั้น ตัวอย่าง active ที่การอัปเดตเขียนประวัติ คำตอบ หรือเฉลยอ้างอิงใหม่จะกลับไปเป็น pending_review พร้อมป้ายกำกับ refreshed_needs_review ใบเสนอราคาของการอัปเดตจะคิดราคาการสนทนาทุกรายการที่อ่านเสมือนว่าเขียนใหม่ คิดทุกการเรียกโมเดลที่ขีดจำกัดเอาต์พุต และใช้ได้กับพรอมต์และการสนทนาที่ออกใบเสนอราคาไว้เท่านั้น หากรายการใดรายการหนึ่งเปลี่ยนก่อนเริ่มรัน ให้ขอใบเสนอราคาใหม่ หากพรอมต์เปลี่ยนระหว่างที่งานกำลังรัน งานจะหยุดเป็น 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, method/body/timeout ที่ไม่บังคับ, integration_id พร้อม header_names, confirmation_token ในคำขอครั้งที่สอง | D, O | ส่งคำขอทดสอบที่มีขอบเขตและป้องกัน SSRF ค่าส่วนหัวที่บันทึกไว้จะถูกเติมจากการผสานรวมและส่งไปยังโฮสต์ของการผสานรวมนั้นเท่านั้น POST (ค่าเริ่มต้น), PUT, PATCH และ DELETE เป็นแบบสองขั้นตอน ส่วน GET จะทำงานทันที |
list_webhook_endpoints | — | R, I | แสดงรายการปลายทาง webhook ที่ลงนามแล้ว |
list_webhook_deliveries | agent_id ที่ไม่บังคับ, endpoint_id ที่ไม่บังคับ | R, I | แสดงรายการผลลัพธ์การส่ง webhook ล่าสุดโดยไม่มีเพย์โหลด |
create_webhook_endpoint | label, url, events/status ที่ไม่บังคับ | O | สร้างปลายทาง webhook ที่ลงนามแล้ว |
copy_webhook_endpoint | endpoint_id, target_agent_id | I | คัดลอก webhook ของเอเจนต์ รวมถึงข้อมูลลับสำหรับการลงนาม ไปยังเอเจนต์อื่นบนเซิร์ฟเวอร์ เฉพาะผู้ดูแลระบบเท่านั้น |
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 | — | เพิ่มผู้ติดต่อ JSON ได้สูงสุด 5,000 ราย |
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 ต้องใช้ ขอบเขต OAuth org:read หรือ org:write การเชื่อมต่อที่สร้างขึ้นก่อนมีขอบเขตเหล่านี้จะถูกขอให้อนุมัติเมื่อใช้งานครั้งแรก
ความสามารถ ความช่วยเหลือ และการนำเข้า
| เครื่องมือ | อาร์กิวเมนต์หลัก | คำอธิบายประกอบ | การทำงาน |
|---|---|---|---|
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 ที่นั่นได้
เครื่องมือผลิตภัณฑ์ทั้งหมดใช้เส้นทางโค้ด REST เดียวกันกับ API สาธารณะ ดังนั้นการตรวจสอบ 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 เป็นค่าไม่บังคับ และใช้ป้องกันการเขียนพรอมป์ทั้งหมดได้เช่นกัน ใช้ prompt_sha256 จาก review_prompt หรือ source_prompt_sha256 จาก refactor_prompt การเรียกใดก็ตามที่เปลี่ยนพรอมป์จะส่งคืน prompt_sha256 สำหรับข้อความใหม่ previous_prompt_sha256 เมื่อเซิร์ฟเวอร์อ่านฉบับร่างก่อน และ next_step ที่แนะนำ review_prompt โดยตั้งค่า previous_prompt เป็นข้อความก่อนการเปลี่ยนแปลง REST API รับเฉพาะพรอมป์ทั้งหมด: 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 นาที ใช้ได้ครั้งเดียวแม้ว่าการเรียกนั้นจะล้มเหลว และครอบคลุมหนึ่งองค์กร หนึ่งบุคคล หนึ่งเครื่องมือ และอาร์กิวเมนต์ชุดเดียวกันทุกประการ ดังนั้นการลบเอเจนต์ 3 รายจึงต้องยืนยัน 3 ครั้ง campaign_action ที่ใช้ pause หรือ stop จะข้ามขั้นตอนนี้ เพื่อให้สามารถหยุดแคมเปญที่กำลังทำงานได้ทันทีเสมอ เช่นเดียวกับ test_integration ที่ใช้ GET เครื่องมือ 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 ของรายการเหล่านี้จะขอให้คุณยืนยันการเปลี่ยนแปลงที่แน่นอน แทนที่จะเตือนว่าไม่สามารถย้อนกลับได้
พรอมป์ต์เริ่มต้น
prompts/list แสดงเวิร์กโฟลว์ที่นำกลับมาใช้ซ้ำได้ 12 รายการ:
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
ใช้ prompts/get พร้อมชื่อพรอมป์ต์ที่ระบุและอาร์กิวเมนต์ที่ประกาศไว้ เพื่อรับข้อความผู้ใช้ที่พร้อมเรียกใช้
ทรัพยากร
resources/list แสดงข้อมูลอ้างอิงสาธารณะที่แคชไว้:
| URI | เนื้อหา |
|---|---|
thunderphone://docs/llms.txt | ดัชนีเอกสารสาธารณะ |
thunderphone://docs/quickstart | Quickstart ในรูปแบบ Markdown |
thunderphone://pricing | ราคาแบบสาธารณะปัจจุบันในรูปแบบ Markdown |
thunderphone://guides/prompt-style | คู่มือรูปแบบพรอมป์ต์สำหรับเอเจนต์เสียงที่ review_prompt ใช้ตรวจสอบ รหัสแนวทาง (P1, W2 เป็นต้น) คือรหัสที่ใช้ในการอ้างอิงผลการตรวจพบ |
thunderphone://guides/working-with-thunderphone | วิธีที่ผู้ช่วยควรใช้เครื่องมือเหล่านี้: ดำเนินการกับฉบับร่างเป็นรอบสั้นๆ ตรวจสอบก่อนปรับใช้ทุกครั้ง ต้องได้รับคำยืนยันจากผู้ใช้สำหรับสิ่งที่เผยแพร่จริงหรือมีค่าใช้จ่าย และห้ามขอข้อมูลลับ |
อ่านทรัพยากรหนึ่งรายการด้วย resources/read การดึงข้อมูลสาธารณะใช้ระยะหมดเวลาสั้น ขีดจำกัด 2 MiB และแคชในกระบวนการเป็นเวลา 10 นาที
โปรโตคอลและข้อผิดพลาด
เซิร์ฟเวอร์รองรับโปรโตคอลเวอร์ชัน 2025-06-18 และ 2025-03-26 โดยจะสะท้อนเวอร์ชันไคลเอ็นต์ที่รองรับ และหากไม่รองรับจะเลือก 2025-06-18 เซิร์ฟเวอร์ใช้ initialize, ping, เครื่องมือ พรอมป์ต์ ทรัพยากร และการแจ้งเตือน การแจ้งเตือนจะส่งคืน 202 Accepted เซิร์ฟเวอร์แบบไร้สถานะนี้ไม่มี SSE listener หรือการลบเซสชัน ดังนั้น GET และ DELETE จึงส่งคืน 405 Method Not Allowed พร้อม Allow: POST
ความล้มเหลวของเครื่องมือยังคงเป็นการตอบกลับ JSON-RPC ที่สำเร็จโดยมี isError: true ข้อความจะมีประโยคสั้นตามด้วยบล็อก 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 ที่ไม่รู้จักจะส่งคืน -32601 ในการตอบกลับ HTTP 200 MCP 2025-06-18 ไม่รองรับแบตช์ JSON-RPC และจะส่งคืนข้อผิดพลาดคำขอไม่ถูกต้อง -32600 ที่ชัดเจน