Open in
สร้างด้วย Claude Code, Codex หรือ Cursor
ติดตั้ง Agent Skills ของ ThunderPhone เชื่อมต่อเซิร์ฟเวอร์ MCP ของ ThunderPhone และมอบเอกสารประกอบผลิตภัณฑ์ที่เป็นปัจจุบันให้แก่เอเจนต์เขียนโค้ด
ThunderPhone มีสามเลเยอร์สำหรับเอเจนต์เขียนโค้ด:
| เลเยอร์ | สิ่งที่มอบให้เอเจนต์ |
|---|---|
| Agent Skills | ขั้นตอนการทำงานเฉพาะด้านสำหรับเอเจนต์ พรอมป์ต์ หมายเลข การโทร เครื่องมือ เว็บฮุก ความรู้ การทดสอบ การปรับปรุงเอเจนต์แบบวงจรปิด แคมเปญ วิดเจ็ต เฟรมเวิร์กเรียลไทม์ และการย้ายระบบ |
| MCP | เครื่องมือที่ผ่านการยืนยันตัวตนครอบคลุมเอเจนต์ หมายเลข การโทร การทดสอบ ความรู้ เครื่องมือ/เว็บฮุก แคมเปญ เสียง การนำเข้า และเอกสารตามลำดับที่เปิดให้ใช้งาน เรียก tools/list เพื่อดูแค็ตตาล็อกปัจจุบัน |
| เอกสารต้นฉบับ | แหล่งข้อมูล Markdown ปัจจุบันสำหรับลักษณะการทำงานของผลิตภัณฑ์และรายละเอียด API |
ทักษะอธิบายวิธีทำงาน MCP ช่วยให้เอเจนต์เขียนโค้ดตรวจสอบและดำเนินการกับ องค์กรของคุณ เอกสารต้นฉบับให้ข้อมูลอ้างอิงสำหรับคำถามที่อยู่นอกเหนือจาก ทักษะที่โหลดไว้
ติดตั้งในโปรเจ็กต์
บล็อกนี้ติดตั้งทักษะ ทำให้คีย์พร้อมใช้งานในเชลล์ปัจจุบัน และเพิ่มเซิร์ฟเวอร์ MCP ระดับโปรเจ็กต์ลงใน Claude Code แทนที่เพลซโฮลเดอร์ โดยอ่านค่าจริงจากตัวจัดการข้อมูลลับของคุณ ห้ามวางคีย์ลงในรีโพซิทอรีหรือแชต
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
--header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
thunderphone https://api.thunderphone.com/v1/mcpสำหรับ Codex ให้แทนที่คำสั่งสุดท้ายด้วย:
codex mcp add thunderphone \
--url https://api.thunderphone.com/v1/mcp \
--bearer-token-env-var THUNDERPHONE_API_KEYCursor อ่านการกำหนดค่าโปรเจ็กต์จาก .cursor/mcp.json:
{
"mcpServers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}VS Code ใช้เซิร์ฟเวอร์เดียวกันภายใต้คีย์ servers ใน .vscode/mcp.json:
{
"servers": {
"thunderphone": {
"type": "http",
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
}
}
}
}ตัวอย่างเซสชัน: พนักงานต้อนรับคลินิกทันตกรรมสองภาษา
- ขอให้ AI เอเจนต์เขียนโค้ดโหลด
create-agent,thunderphone-prompt-builder,build-tool-integration,add-knowledgeและtest-agentแจ้งให้วางแผนก่อนและยังไม่สร้างทรัพยากร - ให้ข้อมูลข้อเท็จจริงของคลินิกที่ตรวจสอบแล้ว งานที่รองรับ กฎการส่งต่อ และ ภาษาท้องถิ่นที่จำเป็นทั้งสองภาษา ให้ตรวจสอบแค็ตตาล็อกเสียงและภาษาที่รองรับแบบสดแทนการสร้างเสียงหรือภาษาท้องถิ่นขึ้นเอง
- ขอพรอมป์ต์สำหรับใช้งานจริงหนึ่งชุดที่สร้างจากหลักการทั่วไปและข้อเท็จจริง เอเจนต์ควรสลับไปใช้ภาษาที่รองรับของผู้โทร พูดให้กระชับ ถามครั้งละหนึ่งคำถาม และหลีกเลี่ยงสคริปต์คำตอบของผู้โทร
- ให้กำหนดเครื่องมือจัดตารางเวลาที่มีขอบเขตแคบ และแนบเฉพาะความรู้ที่พนักงานต้อนรับต้องใช้ ทดสอบความสำเร็จของเครื่องมือ ไม่มีช่วงเวลาว่าง อินพุตไม่ถูกต้อง หมดเวลา และการส่งต่อให้มนุษย์ก่อนนำไปใช้งาน
- สร้างสถานการณ์สำหรับทั้งสองภาษา การขัดจังหวะ การแก้ไข ข้อมูลที่ขาดหาย คำถามเกี่ยวกับความรู้ ความล้มเหลวในการจัดตารางเวลา และการส่งต่อ รันสถานการณ์ ตรวจสอบทรานสคริปต์และหลักฐานจากเครื่องมือ แก้ไขกฎทั่วไปที่เล็กที่สุด แล้วรันชุดเดิมอีกครั้ง
- ตรวจสอบฉบับร่างและหลักฐานการทดสอบที่แน่นอน จากนั้นอนุมัติการนำไปใช้งาน และการผูกหมายเลขอย่างชัดเจน โทรทดสอบเสียงแบบควบคุมในแต่ละภาษาก่อนเริ่มรับสายจริง
ปรับปรุงเอเจนต์ในวงจรปิด
เมื่อเอเจนต์เริ่มรับสาย ให้เอเจนต์เขียนโค้ดโหลด iterate-on-agent
ทักษะนี้จะทำงานตามวงจรเดียวกับที่ ThunderPhone ใช้กับเอเจนต์ของตนเอง เพื่อให้มีการวัดผลทุก
การเปลี่ยนแปลงก่อนนำไปใช้งานจริง:
- อ่าน เอเจนต์ การแก้ไขพรอมป์ต และคู่มือรูปแบบพรอมป์ต การแก้ไขพรอมป์ตพร้อมใช้งานผ่าน REST และ MCP ดังนั้นเอเจนต์เขียนโค้ดจึงตรวจสอบการเปลี่ยนแปลงพรอมป์ตล่าสุดได้โดยตรง
- สร้างชุดทดสอบ
import_conversationsเปลี่ยนสายล่าสุด หรือสายที่เลือกด้วยcall_idsให้เป็นการสนทนาทดสอบ และเปลี่ยนช่วงเวลาที่ยากที่สุดให้เป็นตัวอย่างพร้อมเฉลย หากการสร้างตัวอย่างล้มเหลวสำหรับการสนทนาที่นำเข้าบางรายการ ให้เรียกใช้import_conversationsด้วยredo_failed: trueเพื่อสร้างตัวอย่างสำหรับการสนทนาของเอเจนต์เหล่านั้นอีกครั้งโดยไม่ต้องนำเข้าสายใด ๆgenerate_conversationsจะสร้าง การสนทนาเหล่านั้นสำหรับเอเจนต์ใหม่ รวมถึงผู้โทรที่รับมือยากซึ่งมุ่งเป้าไปยัง จุดอ่อนของพรอมป์ต (รายการเหล่านั้นจะอยู่ในชุดแบ่ง dev เสมอ) การสนทนาแต่ละรายการอยู่ใน ชุดแบ่ง dev สำหรับปรับแต่ง หรือชุดแบ่งทดสอบสำหรับวัดผลเพียงครั้งเดียว สาย ที่ผู้โทรอยู่ในชุดแบ่งทดสอบจะถูกกันไว้: สำหรับ API key หรือโทเค็น OAuth ไม่ว่าจะผ่าน REST หรือ MCP จะส่งกลับมาเฉพาะ id เวลาเริ่มต้น และheld_out: trueเท่านั้น ระบบจะปฏิเสธการเขียนข้อมูลลงในสายนั้น (held_out_call) รวมถึงสถานการณ์ทดสอบที่เลื่อนระดับมาจากสายนั้นด้วย อย่านำสายนั้นมารวมเมื่อปรับแต่ง - สร้างค่าอ้างอิง ด้วย
run_replaysในชุดแบ่ง dev เมื่อใช้ Bolt v2 เทิร์นที่มีการบันทึกเสียงจะถูกเล่นซ้ำ ตามวิธีที่ สายจริงจะทำงาน - แก้ไขฉบับร่าง
review_promptตรวจสอบพรอมป์ตเทียบกับคู่มือรูปแบบ และเสนอการแก้ไขแบบค้นหาและแทนที่update_agentนำการแก้ไขไปใช้กับ ฉบับร่างด้วยprompt_editsการตรวจสอบครั้งที่สองด้วยprevious_promptจะตรวจสอบสิ่งที่เปลี่ยนแปลงrefactor_promptจะเขียนพรอมป์ตใหม่ที่ สะสมแพตช์มากเกินไป และรายงานพฤติกรรมที่เปลี่ยนแปลง เมื่อการแก้ไข เพิ่มหรือลบพฤติกรรมrefresh_conversationsจะอัปเดตการสนทนาทดสอบ ให้ตรงกับพรอมป์ตใหม่ โดยกู้คืนเวอร์ชันก่อนหน้าตรงจุดที่กฎกลับมา - ตรวจสอบ ด้วย
run_replaysเทียบกับค่าอ้างอิง โดยอ่าน ความล้มเหลวในแบบที่ผู้โทรจะได้ยินcompare_configsทดลองใช้ ระดับการฟัง เสียง การตรวจจับจุดสิ้นสุดการพูด หรือระดับความสามารถที่ต่างกันกับ ตัวอย่าง dev เดิม การเปรียบเทียบใช้ได้เฉพาะ dev - วัดผลเพียงครั้งเดียว ในชุดแบ่งทดสอบ การรันทดสอบจะเล่นซ้ำกลุ่มทดสอบทั้งหมดหนึ่งกลุ่ม
และผลลัพธ์แรกจะใช้กลุ่มนั้นไป ดังนั้นการรันทดสอบครั้งถัดไปแต่ละครั้ง ไม่ว่าจะใช้
พรอมป์ตใด ต้องมีข้อมูลทดสอบใหม่จากสายที่นำเข้าหรือการสนทนาที่สร้างขึ้น
เอนจินของแต่ละตัวอย่างจะถูกกำหนดจากข้อมูลก่อนเริ่มรัน
(เสียงที่บันทึกไว้จะเล่นซ้ำแบบตรงตัว ตัวอย่างที่มีเฉพาะข้อความจะทำงานเป็นข้อความ)
ระบบแสดงผลรวมแยกตามเอนจิน และไม่มีสิ่งใดถอยกลับไปใช้ข้อความ: กลุ่มที่มี
เสียงบันทึกไว้ภายใต้การกำหนดค่าอื่นนอกจาก Bolt v2 จะถูกปฏิเสธ
(
test_needs_exact_replay) และยังคงไม่ถูกใช้ ดังนั้นให้วัดผลการกำหนดค่านั้น บน dev เอเจนต์เขียนโค้ดจะได้รับเฉพาะผลรวม พร้อมคำอธิบายการเปรียบเทียบด้วยภาษาทั่วไป สำหรับการรันบน dev จึงไม่สามารถปรับแต่งบนชุดแบ่งทดสอบได้ - ฟัง การบันทึกจาก
run_simulationหรือเปิด ลิงก์สนทนา แล้วสนทนากับฉบับร่างด้วยตนเอง - ปรับใช้ เมื่อคุณสั่ง
ทุกสิ่งที่ใช้เครดิตจะขอใบเสนอราคาก่อน: ส่ง dry_run: true เพื่อรับค่าประมาณ จากนั้นจึงรันด้วย quote_id และ max_cost_cents ซึ่งเป็นเพดานตายตัว ใบเสนอราคาหนึ่งใบชำระได้สำหรับการรันหนึ่งครั้ง: งานการสนทนา การรันรีเพลย์ และการตรวจสอบและปรับโครงสร้างพรอมป์ต์ที่เรียกใช้โมเดลจะใช้ใบเสนอราคาอย่างถาวรเมื่อเริ่มต้น การรันแบบชำระเงินที่เริ่มด้วยคีย์ API แอป OAuth หรือ MCP ของคุณจะนับรวมในวงเงินชุดเครื่องมือเดียวกันที่องค์กรของคุณเปิดใช้ด้วย และการเริ่มต้นที่ถูกปฏิเสธหรือล้มเหลวก่อนจะยังคงทำให้ใบเสนอราคาใช้งานได้; หลังจากใช้แล้ว ให้รันที่ล้มเหลวซ้ำด้วยการทำ dry run ใหม่ แต่ละคำขอจะกันค่าใช้จ่ายสูงสุดที่เป็นไปได้ไว้ก่อนส่ง และการรันจะถูกเรียกเก็บตามค่าใช้จ่ายจริง ดังนั้นให้เผื่อส่วนต่างจากค่าประมาณไว้ การรีเพลย์แบบตรงกันทุกประการจะกันไว้ประมาณ 85 เซ็นต์ถึง $1.25 ต่อรีเพลย์ที่กำลังดำเนินการสำหรับหนึ่งเทิร์นทั่วไป (หนึ่งเทิร์นปกติพร้อมการรันซ้ำในระบบจริงหนึ่งครั้ง) เทียบกับค่าใช้จ่ายจริงเพียงไม่กี่เซ็นต์: กำหนดเพดานสำหรับการรันรีเพลย์ให้มีพื้นที่เพียงพอ เทิร์นที่ยังใช้งบประมาณเกินจะถูกนับแยกต่างหากและไม่ใช้ชุดทดสอบใด เอเจนต์จะรันงานการสนทนาหรือการรันรีเพลย์ได้ครั้งละหนึ่งงานเท่านั้น สำหรับ OAuth เครื่องมือพรอมป์ต์ต้องใช้ขอบเขต agents:write เมื่อปิดการบันทึกของการโทรหรือลบการโทร การสนทนาทดสอบและตัวอย่างที่นำมาจากการโทรนั้นจะถูกลบด้วย เครื่องมือการสนทนาทดสอบ รีเพลย์ และการตรวจสอบพรอมป์ต์เป็นส่วนหนึ่งของชุดเครื่องมือสำหรับการปรับปรุงเอเจนต์ ซึ่งเปิดใช้แยกตามองค์กรในระหว่างที่ยังเป็นเบต้า (ลิงก์พูดคุยเปิดใช้สำหรับทุกองค์กร); โปรดขอให้ ฝ่ายสนับสนุน เปิดใช้งานให้
ใช้ Python หรือ TypeScript SDK สำหรับคำขอ REST แบบมีชนิดข้อมูลกำกับ
ใช้ REST แทน MCP เมื่อการสร้างต้องใช้เพย์โหลดที่กำหนดแน่นอน
ฟิกซ์เจอร์ที่มีการกำหนดเวอร์ชัน การประสานงานแบบกลุ่ม
หรือการดำเนินการที่ไม่มีในรายการเครื่องมือ MCP ปัจจุบัน API เริ่มต้นที่ https://api.thunderphone.com/v1; ดู
ข้อมูลเบื้องต้นเกี่ยวกับ API และ
คู่มือ MCP