1. 项目缘起当“文旅管家”的想法撞上“零代码”工具最近在规划一次家庭出游面对海量的景点信息、复杂的交通路线、众说纷纭的餐厅评价还有那些需要提前预约的博物馆和演出我感到了前所未有的信息过载。这让我萌生了一个想法能不能有一个智能的“文旅管家”它能理解我的自然语言需求比如“帮我规划一个周末的苏州园林之旅要包含经典园林和本地人爱去的小吃”然后自动帮我搜索景点、规划路线、推荐餐厅甚至生成一份图文并茂的行程单这个想法听起来很美好但作为一个非专业开发者让我去写一个爬虫、调用地图API、再搞个对话机器人简直是天方夜谭。直到我接触到了WorkBuddy、腾讯地图Skills和MCPModel Context Protocol这套组合拳我发现原来“零代码”搭建一个功能强大的文旅管家并非遥不可及。整个过程我没有写一行传统的编程代码而是通过配置、连接和“组装”现有的智能模块来实现的。今天我就来分享一下这个有趣的实践过程。2. 核心工具拆解WorkBuddy、Skills与MCP分别是什么在动手之前我们必须先理解手中的“积木”是什么。这套方案的核心是三个概念WorkBuddy作为执行大脑腾讯地图Skills作为专业能力MCP作为连接它们的“万能胶水”。2.1 WorkBuddy你的AI工作伙伴与自动化中枢你可以把WorkBuddy理解为一个高度可定制的AI智能体Agent平台。它本身具备强大的自然语言理解和任务分解能力。但它的核心价值不在于“全能”而在于“连接”。WorkBuddy允许你为它安装各种“技能”Skills从而扩展其能力边界。比如安装一个“日历管理”Skill它就能帮你安排会议安装一个“文档处理”Skill它就能总结PDF内容。在我们的项目中我们将为它安装“腾讯地图”相关的Skills让它获得地理位置查询、路线规划等专业能力。WorkBuddy通常通过一个Web界面或API进行交互。你给它下达一个复杂的指令它会自动分析这个指令需要调用哪些已安装的Skills并按顺序执行最后将结果整合后返回给你。它扮演的是“指挥官”和“调度员”的角色。2.2 腾讯地图Skills封装好的地理信息服务模块Skills是具体功能的实现者。腾讯地图Skills就是由腾讯地图官方或社区开发者将腾讯地图丰富的API如地点搜索、路线规划、逆地址解析等封装成一个个独立的、可被AI智能体调用的功能模块。一个Skill通常包含两部分一是能力描述告诉AI这个Skill能做什么二是具体的执行逻辑当被调用时如何访问腾讯地图API并返回结果。例如“地点搜索Skill”的能力描述是“根据关键词搜索特定位置的地点信息”其执行逻辑就是接收一个“关键词”和“城市”参数向腾讯地图的Place API发送请求并将返回的JSON数据整理成AI能理解的格式。对于我们用户来说不需要关心Skill内部的代码实现只需要知道“安装了这个Skill我的WorkBuddy就具备了地图搜索能力”。这极大地降低了使用门槛。2.3 MCPModel Context Protocol统一的“技能插座”那么WorkBuddy如何发现并调用这些分散的Skills呢这就是MCP的用武之地。MCP是由Anthropic提出的一种开放协议你可以把它想象成智能体世界的“USB标准”或“应用商店协议”。在MCP框架下Skill提供者如腾讯地图按照MCP协议的标准格式将自己的服务包装成一个MCP Server服务器。AI智能体平台如WorkBuddy、Claude Code、Cursor等内置了MCP Client客户端。用户只需要在WorkBuddy中配置这个MCP Server的地址可能是一个本地运行的服务器地址或一个安全的远程服务地址WorkBuddy就能自动发现该Server提供了哪些Skills称为“Tools”或“Resources”并将其纳入自己的技能库。MCP协议规定了数据交换的格式确保了不同来源的Skills能在不同的AI平台上无缝工作。它解决了生态碎片化的问题是“零代码”集成的关键。3. 零代码搭建实战三步组装你的文旅管家理解了核心组件搭建过程就变得清晰了。整个过程可以分为三个主要步骤环境准备与工具配置、Skills的获取与连接、以及最终的任务编排与测试。3.1 第一步环境准备与WorkBuddy基础配置首先你需要一个可以运行WorkBuddy的环境。目前常见的方式有两种云服务版部分平台提供托管的WorkBuddy服务你只需要注册账号即可使用。这种方式最简单但自定义程度可能受限。本地/自托管版通过Docker或直接安装的方式在你自己的电脑或服务器上运行WorkBuddy。这种方式灵活性最高也是大多数深度用户的选择。我选择的是自托管方案。以Docker为例通常只需要执行一条类似下面的命令具体命令请以WorkBuddy官方文档为准docker run -p 3000:3000 -v /your/data/path:/app/data workbuddy/workbuddy:latest这条命令会在本地的3000端口启动WorkBuddy服务。启动后在浏览器访问http://localhost:3000就能看到WorkBuddy的Web管理界面。首次进入你需要进行一些基础设置比如创建一个新的智能体Agent给它起个名字例如“我的文旅管家”。这个智能体就是我们将要赋予各种技能的本体。3.2 第二步获取并连接腾讯地图SkillsMCP Server这是最关键的一步。我们需要找到封装了腾讯地图API的MCP Server。情况一使用官方或社区现成的MCP Server最理想的情况是腾讯地图官方或某个开发者社区已经提供了打包好的MCP Server。例如可能有一个名为tencent-map-mcp的开源项目。你只需要按照其README的说明运行这个Server。# 假设这是一个Node.js项目 git clone tencent-map-mcp-repo-url cd tencent-map-mcp npm install npm start这个Server启动后会监听某个本地端口比如http://localhost:8080。然后你需要在WorkBuddy的Web管理界面中找到“MCP设置”或“添加技能源”的选项。将上一步启动的MCP Server地址如http://localhost:8080添加进去。情况二自行基于MCP协议封装仍无需写业务逻辑代码如果找不到现成的我们也可以利用一些“零代码”工具来创建自己的MCP Server。例如有一些可视化工具或配置驱动框架如基于modelcontextprotocol/sdk的脚手架允许你通过编写一个简单的配置文件如server.yaml或server.json来定义Skill。你需要在这个配置文件中做两件事声明Skill定义Skill的名称、描述、输入参数如keyword,city和输出格式。配置执行动作指定当这个Skill被调用时应该向哪个HTTP端点即腾讯地图的API地址发送请求并如何传递参数。以下是一个高度简化的概念性配置示例用于说明逻辑# 假设的配置文件示例 (server.yaml) name: tencent-map-server tools: - name: search_places description: 根据关键词在城市内搜索地点 inputSchema: type: object properties: keyword: type: string description: 搜索关键词如“拙政园”、“苏州博物馆” city: type: string description: 城市名称如“北京市”、“苏州市” required: [keyword, city] handler: type: http url: https://apis.map.qq.com/ws/place/v1/search method: GET queryParams: key: ${env:TENCENT_MAP_KEY} # 从环境变量读取密钥 keyword: {{input.keyword}} boundary: region({{input.city}},0)在这个例子中我们定义了一个叫search_places的Skill。当WorkBuddy调用它时这个MCP Server会按照handler的配置向腾讯地图的搜索API发送一个HTTP GET请求并将keyword和city参数填充进去。这里最关键的是key参数你需要提前申请腾讯地图的开发者密钥并将其设置为环境变量TENCENT_MAP_KEY。注意密钥安全是重中之重。腾讯地图API密钥绝对不能硬编码在配置文件或前端代码中。必须通过环境变量、安全的密钥管理服务等方式注入。在自托管环境下在启动MCP Server的终端中设置环境变量是常见做法export TENCENT_MAP_KEYyour_secret_key_here。配置好这个文件后使用对应的工具启动这个MCP Server它就能提供search_places这个Skill了。同样将这个Server的地址添加到WorkBuddy中。3.3 第三步在WorkBuddy中编排任务与测试连接成功后回到WorkBuddy的智能体配置页面你应该能在“可用技能”列表中看到刚刚添加的“腾讯地图”系列Skills例如“地点搜索”、“路线规划”、“地址解析”等。现在你可以开始给你的“文旅管家”智能体下达指令了。这个过程不再是写代码而是用自然语言与它对话。测试场景1基础地点搜索你可以在WorkBuddy的聊天界面输入“用腾讯地图搜索一下北京市的故宫博物院。” WorkBuddy会解析你的指令识别出需要调用search_places这个Skill并自动提取出keyword故宫博物院和city北京市作为参数。然后它通过MCP协议调用你本地的MCP ServerServer调用腾讯地图API拿到结果后层层返回。最终你会在聊天窗口看到故宫的地址、评分、联系电话等信息。测试场景2复杂行程规划接下来尝试一个复杂任务“帮我规划一个上海外滩的一日游上午要去东方明珠中午在附近找一家本帮菜馆下午去豫园并规划一下这几个地点之间的驾车路线。” 这个指令会被WorkBuddy分解成多个子任务搜索“东方明珠”获取其精确坐标。搜索“豫园”获取其精确坐标。以“东方明珠”和“豫园”的坐标搜索“本帮菜”餐厅。分别调用路线规划Skill计算“东方明珠 - 餐厅”和“餐厅 - 豫园”的驾车路线。将所有这些信息地点详情、路线概览、耗时整合成一段连贯的文字回复甚至可以生成一个简单的行程时间表。你可能会问WorkBuddy怎么知道要先搜索地点再规划路线这得益于其内置的AI推理能力。它理解“规划一日游”这个目标依赖于“确定地点位置”和“计算地点间路线”这些子步骤并会自动编排执行顺序。4. 功能深化与个性化定制基础功能跑通后你可以考虑为你的文旅管家增添更多色彩让它更贴心、更强大。这些深化工作依然可以保持在“低代码”或“零代码”的范畴。4.1 集成多数据源Skills丰富信息维度一个优秀的管家不能只认路。你还可以为WorkBuddy集成其他MCP Server例如天气Skill在规划行程时自动查询目的地的天气情况并给出穿衣建议。票务/预订Skill如果存在查询景点门票价格、开放时间甚至模拟预订流程注意合规性。美食点评Skill接入大众点评或类似平台的API需自行封装或寻找现成MCP Server获取更详细的餐厅评价、人均消费和推荐菜。翻译Skill如果规划境外游可以集成翻译能力方便查询外文信息。在WorkBuddy中同时配置多个MCP Server后它就能在一次对话中协同调用这些技能。例如当你问“周末杭州天气如何有什么推荐的西湖边的茶馆”它可以先调用天气Skill再调用地图点评Skill来综合回答。4.2 设计智能体角色与系统提示词虽然我们没有写代码但可以通过精心设计WorkBuddy智能体的“系统提示词”System Prompt来塑造其性格和行为模式。这就像给演员一个剧本。在智能体设置中你可以输入类似这样的提示词你是一个专业的文旅管家名叫“游侠”。你的回答风格应该热情、细致、充满人文关怀。在提供地点信息时除了基础信息尽量补充一点历史典故或文化小贴士。在规划路线时要优先考虑游客的体验避免过于紧张的行程。如果用户的需求不够明确你应该主动提出一些启发性的问题比如“您这次旅行更偏向自然风光还是历史文化”、“同行有老人或小孩吗”。所有关于地理位置、路线、搜索类的任务请务必使用你已连接的腾讯地图相关技能来获取准确信息。通过这段提示词你的文旅管家就不再是一个冷冰冰的信息查询工具而是一个有温度、会思考的旅行顾问。4.3 构建可复用的工作流模板对于常见的旅游需求你可以在WorkBuddy中创建“工作流”或“预设指令”。例如创建一个名为“生成周末城市漫步行程”的工作流模板。这个模板可以预置一系列指令“请搜索城市[城市名]的[地标性建筑]。”“请搜索该地标附近步行15分钟内的、评分4.0以上的咖啡馆。”“请搜索从咖啡馆到[城市名]的[著名博物馆]的公共交通路线。”“请将以上信息整合成一份时间安排表。”之后你只需要触发这个工作流并填入具体的城市名、地标和博物馆名就能快速生成一份定制化的行程草案。这相当于为你最常用的场景制作了一个快捷方式。5. 避坑指南与实战心得在整个搭建和使用的过程中我踩过一些坑也积累了一些经验分享给大家希望能帮你少走弯路。5.1 MCP Server连接失败的常见原因与排查这是新手最容易遇到的问题。WorkBuddy里添加了MCP Server地址却显示连接失败或找不到Tools。检查网络与端口首先确认你的MCP Server是否真的在运行。在终端使用curl http://localhost:端口号/或对应的健康检查端点看是否有响应。确保WorkBuddy客户端能访问到MCP Server服务端的IP和端口如果两者不在同一台机器要检查防火墙设置。核对MCP协议版本WorkBuddy和你的MCP Server可能支持不同版本的MCP协议。查看双方的文档确保版本兼容。通常较新的WorkBuddy会兼容MCP的常见版本。审查Server配置文件如果你的MCP Server是自建的仔细检查配置文件如server.yaml的语法是否正确Tool的定义是否符合MCP协议规范。一个常见的错误是inputSchema的定义格式不对导致WorkBuddy无法正确解析该Skill所需的参数。查看日志同时打开WorkBuddy的服务日志和MCP Server的运行日志。连接失败时日志中通常会打印出具体的错误信息如“连接被拒绝”、“协议握手失败”、“Tool定义解析错误”等这是定位问题最直接的依据。5.2 腾讯地图API使用中的关键注意事项配额限制腾讯地图免费API有每日调用次数限制。如果你的文旅管家使用频繁很容易超限。务必在腾讯地图开发者控制台监控调用量并考虑升级付费套餐或优化调用逻辑例如对相同查询做短期缓存。坐标系一致性腾讯地图API返回的坐标通常是国测局GCJ-02坐标系。如果你后续还需要集成其他地图服务虽然本项目不涉及需要注意坐标系转换问题否则位置会偏差。关键词模糊性用户输入如“那个很高的塔”、“吃烤鸭的地方”非常模糊。直接传给地图搜索API效果可能不好。更好的做法是结合WorkBuddy的AI能力先对用户query进行意图识别和关键词提炼比如将“那个很高的塔”转化为“东方明珠电视塔”再用提炼后的关键词进行搜索。5.3 提升智能体决策准确性的技巧有时候WorkBuddy可能“犯傻”比如用户问“北京有什么好玩的”它却调用了路线规划Skill因为“好玩”和“路线”在它的理解里可能有微弱关联。细化Skill描述在定义或选择Skill时其description字段要尽可能精确。例如将“搜索地点”的描述写成“根据名称或类型关键词在指定城市内搜索地点如景点、餐厅、酒店的详细信息返回地址、坐标、评分等”而不是简单的“找地方”。提供示例对话在WorkBuddy的智能体配置中有一个“示例对话”或“Few-shot Learning”的功能。你可以手动编写几个正确调用Skills的对话示例这能极大地帮助AI学习在什么情况下该调用哪个Skill。分步引导用户对于极度模糊的需求可以设计让智能体主动追问。正如前面在系统提示词里设定的当用户需求不明确时文旅管家应该反问“您是想搜索景点、规划路线还是查找美食呢” 通过交互缩小范围再触发精准的Skill。通过这个项目我深刻体会到AI应用开发的范式正在从“从头编写一切”向“智能组装现有能力”转变。WorkBuddy、MCP和各类Skills构成了一个乐高式的生态系统。作为构建者我们的核心价值不再是编码实现每一个细节而是深刻理解业务需求、选择合适的“乐高积木”Skills、并通过巧妙的编排智能体提示词与工作流将它们组合成一个能解决实际问题的有机整体。这个“文旅管家”只是一个开始同样的思路你可以组装出“智能客服”、“数据分析助手”、“个人健康顾问”等无数可能。