智慧景区语音导览agent需选择agent类型创建，开启asr/tts语音能力，接入gis或高德等地理工具，配置语音优先提示词与地理位置敏感知识库，最后真机测试验证定位-讲解-路径规划闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要一个能听懂游客语音提问、自动定位当前景点、实时播报讲解内容，并同步规划下一步游览路线的智慧景区Agent，而不是在手机上反复切换地图App、查公众号推文、手动暂停音频再找下一个点位。
创建Agent应用并启用语音能力
登录Dify Cloud控制台→点击【创建应用】→【必须选择“Agent(智能体)”类型，不能选“Workflow”或“Chatbot”】→点击【创建空白应用】。命名建议为“智慧景区语音导览”，避免与后续知识库或工作流应用混淆。
进入应用【设置】页→找到【语音输入/输出】开关→开启“语音识别（ASR）”和“语音合成（TTS）”两项。此时Dify会自动加载默认语音模型，支持中文普通话识别与自然女声播报；若需方言支持（如粤语导览），需在【高级配置】中上传自定义ASR模型文件。
接入景区专属地理与讲解数据源
方法一：使用MCP SSE插件直连景区GIS服务（推荐）
点击右上角【插件】→搜索“MCP SSE”→安装→配置服务地址为景区已部署的MCP服务器URL（例如：https://mcp.scenic-area.gov.cn/sse?token=xxx）。系统将自动发现并注册三项核心能力：景点坐标定位、语音讲解文本流、动线路径重规划。这三者必须全部显示为“已就绪”，否则后续步骤无法触发地理位置感知逻辑。
方法二：手动添加三项独立工具（无MCP环境时）
① 高德地图POI检索API（填写景区专属key，限定检索范围为景区边界坐标矩形）；
② 景区本地知识库HTTP工具（POST请求地址为https://api.scenic-area.gov.cn/v1/explain，需携带X-Auth-Token头）；
③ 路径规划代码节点（Python脚本读取景区内部步行路网GeoJSON，调用Shapely计算最短无障碍路径）。
【注意：手动添加时，三项工具的输入参数必须统一使用“current_location”和“target_poi_id”两个变量名，否则Agent无法在多步推理中自动传递位置上下文】
设计语音优先的多轮交互提示词
第一步：强制激活语音上下文
在【编排】→【提示词】区域粘贴以下指令开头：
你是一位驻守在【西湖景区】的AI导览员，全程通过语音与游客交互。用户首次发言即视为已开启语音输入，你必须优先响应其所在位置，并立即播报当前景点讲解。若未获取到GPS坐标或蓝牙信标ID，请主动提示：“请打开手机定位，或靠近景区入口的蓝色信标柱”。
第二步：嵌入结构化决策链
在提示词中插入以下执行顺序：
① 解析语音转文字结果，提取实体：景点名、方位词（“左边”“对面”“往北走50米”）、时间状语（“现在”“半小时后”）；
② 调用“景点坐标定位”工具匹配最近POI，若置信度＜85%，则调用“周边搜索”工具扩大半径至300米；
③ 获取该POI的讲解文本后，截取前120字生成语音播报摘要，同时异步触发“动线路径重规划”工具生成至下一推荐点的步行指引；
④ 所有输出必须以TTS友好格式组织：禁用markdown、表格、换行符；长句拆分为≤8秒可播完的短句；数字读作“三十五号碑”而非“35#碑”。
第三步：植入语音中断处理机制
在提示词末尾追加：若用户语音中出现“停一下”“重播”“跳到雷峰塔”，必须立即终止当前播报，切换至对应动作——重播不重复加载API，跳转不重新计算路径，所有状态保留在内存中。
配置景区实景触发式知识库
进入【知识库】页→点击【新建知识库】→选择“景区导览专用”模板→上传三类文件：
• GeoJSON格式的景点点位文件（含name、id、audio_url、description字段）；
• MP3分段讲解音频（命名规则：poi_1024_intro.mp3、poi_1024_history.mp3）；
• PDF版《无障碍游览指南》（用于回答轮椅通道、母婴室等特殊需求）。
上传完成后，点击【向量化设置】→选择“地理位置+语义双权重”模式→开启“GPS坐标敏感度”滑块至70%。这一步决定当游客站在断桥残雪东侧5米时，系统是否优先返回“断桥”而非“白堤”相关内容。
最后，在【编排】页的LLM节点配置中，将该知识库设为“强绑定检索源”，并勾选“仅返回匹配度＞65%的结果”。【未勾选此项将导致语音提问‘这里是什么’时返回整个西湖的百科介绍，而非断桥残雪的专属讲解】
发布并启动语音真机测试
点击左上角【发布】按钮→等待状态变为“已上线”→复制右侧【体验链接】→用手机浏览器打开该链接→点击麦克风图标开始说话。
测试话术示例：
“我在平湖秋月，现在想去花港观鱼，路上有什么好拍的？”
“刚才说的苏堤春晓，能再讲一遍吗？”
“婴儿车能从雷峰塔直接到净慈寺吗？”
观察控制台【调试日志】中的Tool Call记录：若“景点坐标定位”与“动线路径重规划”连续出现且参数连贯，说明地理上下文已成功穿透全链路；若某次调用中“current_location”为空，则需检查手机端是否授予了高精度定位权限。
