零基礎(chǔ)也能搭 AI 語音客服:MCP + GPT-5 實(shí)戰(zhàn)指南
不會(huì) Python?沒學(xué)過 NLP?跟著本文 30 分鐘讓你擁有一套能聽懂、會(huì)查詢、可回答的保險(xiǎn)語音客服系統(tǒng),本地運(yùn)行、零部署費(fèi)用!
一、MCP 是什么?(一句話記?。?/h2>
Model Context Protocol(MCP)= AI 大模型與外部工具的“翻譯官”。
它讓 GPT-5 可以安全地調(diào)用數(shù)據(jù)庫、搜索網(wǎng)頁、播放語音,而無需寫一堆接口。
二、最終效果預(yù)覽
場景 | 語音輸入 | AI 回答(語音) | 背后工具 |
---|---|---|---|
保險(xiǎn)條款咨詢 | “糖尿病報(bào)銷比例?” | 實(shí)時(shí)播報(bào)條款 | 本地文件 RAG |
價(jià)格篩選 | “月保費(fèi) <300 的計(jì)劃?” | 逐條朗讀 | SQLite 查詢 |
健康常識(shí) | “糖尿病怎么吃?” | 語音總結(jié) | 實(shí)時(shí)網(wǎng)頁搜索 |
三、30 分鐘 5 步搭建
① 安裝環(huán)境(3 分鐘)
工具 | 一鍵命令 | 備注 |
---|---|---|
Python 3.10+ | Python 3.13.3 64位 安裝包 for Windows 下載地址 | 勾選“Add to PATH” |
ffmpeg(音頻) | Mac: brew install ffmpeg Win: 下載 exe |
讓電腦能錄音放音 |
項(xiàng)目依賴 | pip install -U openai-agents[voice] mcp uv |
國內(nèi)源加 -i https://pypi.tuna.tsinghua.edu.cn/simple |
② 準(zhǔn)備資料(2 分鐘)
- 把保險(xiǎn)條款 PDF / Word 放到
sample_files/
- 新建
database.db
(SQLite)存價(jià)格表:CREATE TABLE plans(name TEXT, premium INTEGER); INSERT INTO plans VALUES ('基礎(chǔ)保',200),('全面保',350);
③ 啟動(dòng) MCP 工具服務(wù)(1 分鐘)
在終端執(zhí)行:
# 克隆示例倉庫(已含中文注釋)
git clone https://gitee.com/w3cschool/mcp-voice-demo.git
cd mcp-voice-demo
uv run python search_server.py
看到 ? SSE server started
即可。
④ 配置語音客服(1 分鐘)
新建 env.txt
填:
OPENAI_API_KEY=你的key
再執(zhí)行:
uv run python voice_bot.py
屏幕顯示 ??? Insurance Voice Assistant Ready! 就可以說話了。
⑤ 開麥對(duì)話(無限時(shí)長)
直接問:
- “哪些計(jì)劃月保費(fèi)低于 300?”
- “條款里糖尿病怎么報(bào)銷?”
- “糖尿病飲食注意啥?”
系統(tǒng)會(huì)自動(dòng):
錄音 → GPT-5 理解 → 調(diào)用工具 → 語音回答。
四、小白也能改的 3 個(gè)地方
目標(biāo) | 改哪里 | 中文示例 |
---|---|---|
換行業(yè) | voice_bot.py |
把提示詞“保險(xiǎn)”換成“教育” |
換聲音 | voice_bot.py 第 30 行 |
"Personality: 溫柔耐心的客服小姐姐" |
加文件 | 放新 PDF 到 sample_files/ |
自動(dòng)重新索引,無需重啟 |
五、核心代碼拆解(中文注釋版)
# 1?? 定義工具:RAG + 搜索 + 數(shù)據(jù)庫
tools = [
{"type": "rag", "source": "sample_files/"},
{"type": "sqlite", "db": "database.db"},
{"type": "web_search"}
]
# 2?? 創(chuàng)建語音客服代理
agent = Agent(
name="智能客服",
instructions="用中文口語回答,簡短清晰",
tools=tools,
model="gpt-4.1-mini"
)
# 3?? 啟動(dòng)語音對(duì)話
voice_pipeline.start(agent)
全部代碼不到 100 行
六、常見問題速查
報(bào)錯(cuò) | 原因 | 中文解決 |
---|---|---|
ffmpeg not found |
沒裝音頻驅(qū)動(dòng) | 重裝 ffmpeg 并重啟電腦 |
OPENAI_API_KEY not set |
密鑰沒填 | 復(fù)制 .env.example 為 .env |
語音識(shí)別亂碼 | 麥克風(fēng)權(quán)限 | Win10 設(shè)置→隱私→麥克風(fēng)→允許桌面應(yīng)用 |
七、一句話總結(jié)
“會(huì)用中文說話,就能讓 GPT-5 幫你做語音客服?!?/strong>