尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

用Coze空间搭建旅行攻略智能体:从知识库到工作流实战

用Coze空间搭建旅行攻略智能体:从知识库到工作流实战 1. 为什么要用 Coze 空间制作旅行攻略先聊一个很多人遇到的场景每次出门旅行前订机票、查酒店、看景点、排路线、找美食往往要在十几个 App 和网页之间来回切换。信息分散在各处很难统一整理最后要么做成一个又长又乱的备忘录要么只能边走边查体验很受影响。如果用 Coze扣子智能体平台来搭建一个专属的旅行攻略智能体情况会好很多。它可以把“信息收集、路线规划、攻略生成”整合成一个自动化流程。而在 Coze 平台中管理这些智能体、知识库、工作流、插件等资源的基本单元就是空间Space。这里需要先澄清一个概念Coze 空间并不是磁盘空间、也不是云存储空间而是 Coze 平台里用来组织和管理 AI 应用的一种项目空间。你可以把空间理解成一个“项目文件夹”或者“工作台”里面可以集中存放智能体Bot知识库Knowledge工作流Workflow插件Plugin触发器/定时任务变量与记忆数据当我们把“旅行攻略”作为主题时创建一个专门的 Coze 空间就意味着我们拥有了一个独立、可复用、可持续更新的旅行攻略生产环境。以后不管是做国内周边游、国外长途游还是帮朋友生成攻略都可以在这个空间内完成而不会和其他的 AI 应用混在一起。本文会从空间创建、知识库搭建、智能体配置、工作流实战、发布使用、常见排错和最佳实践几个方面完整演示如何用 Coze 空间制作一套旅行攻略智能体。无论你是 AI 初学者还是已经在使用 Coze 的开发者都可以按照本文的步骤实操。2. Coze 空间环境准备与初始化2.1 平台选择与账号准备目前 Coze/扣子平台提供国际版coze.com和国内版coze.cn两种环境。两者在账号体系、部分插件和发布渠道上存在差异。本文以国内版扣子为例因为国内版对中文内容、国内地图/天气类插件支持更直接适合大多数旅行场景。使用前需要准备一个可用的手机号或邮箱完成 Coze 平台账号注册。建议使用 Chrome 或 Edge 等现代浏览器。如果需要调用外部 API比如地图、天气提前准备好对应服务的 API Key。需要注意的是Coze 平台的界面和功能迭代很快不同版本下按钮位置、插件名称可能稍有差异。本文重点演示配置思路和完整流程具体界面请以你登录后看到的实际版本为准。2.2 创建旅行攻略空间登录扣子平台后左侧导航栏可以看到“空间”入口。创建空间的操作通常如下点击“创建空间”或“新建空间”按钮。输入空间名称例如“旅行攻略助手”。选择空间类型。个人使用选择“个人空间”即可如果希望团队成员共同维护可以选择团队空间并配置成员权限。添加空间描述例如“用于集中管理旅行攻略类智能体、知识库与工作流”。点击确认创建。创建完成后你会进入该空间的详情页。空间内的智能体、知识库、工作流、插件等资源都会在左侧导航中按分类展示。这里有一个建议一个空间最好只做一类业务主题。比如“旅行攻略”空间专门做旅行不要把它和“办公文档助手”混在一个空间里。这样既方便管理也能避免后续工作流和知识库之间产生数据混乱。2.3 空间核心资源概览进入空间后重点关注的四个模块如下模块作用在旅行攻略中的用途智能体面向用户的对话机器人、AI 应用用户通过对话获取最终攻略知识库存放结构化或非结构化文档存放城市景点数据、行程模板、美食清单工作流将多个步骤编排成自动化流程实现查询天气→推荐路线→生成攻略的流程插件扩展智能体能力的工具接入天气、地图、翻译、图片搜索等能力这四个模块是整个旅行攻略系统的四大支柱。下面我们就围绕它们一一展开。3. 搭建旅行攻略知识库3.1 为什么需要知识库很多人在制作智能体时只配置了人设提示词然后希望大模型“凭空”生成攻略。这样做出来的内容往往泛泛而谈没有具体营业时间、门票价格、路线耗时等关键信息实用性很差。知识库的作用就是给智能体提供“可靠的本地知识来源”。你可以把网上整理的景点资料、自己的旅行经验、酒店测评、美食推荐等内容导入知识库。智能体在回答问题时会优先检索知识库中的内容并基于这些内容生成答案而不是完全依赖大模型的通用知识。对于旅行攻略来说知识库适合放以下内容景点基础信息开放时间、门票政策、交通方式、建议游玩时长。行程模板一日游、两日游、亲子游、穷游等不同主题路线。美食与住宿推荐本地特色餐厅、口碑酒店。注意事项天气变化提醒、景区预约要求、文化禁忌。3.2 准备文档并导入知识库知识库支持上传的格式包括文本、PDF、Word、Markdown 等。为了获得最好的检索效果建议将内容整理成清晰的 Markdown 或纯文本格式每个景点或主题作为一个小标题。下面是一个示例片段# 北京环球度假区 ## 基本信息 - 地址北京市通州区京哈高速与东六环交汇处西北侧 - 开放时间通常 09:00-21:00实际以当天公告为准 - 建议游玩时长1 天 ## 交通方式 - 地铁八通线/7 号线环球度假区站 - 公交589 路等 - 自驾园区有停车场停车费按天计费 ## 游玩建议 - 热门项目建议提前预约或购买优速通 - 园区内餐饮较贵可自带未开封食品 - 周末和节假日人流量大建议错峰在知识库模块中点击“创建知识库”输入名称如“北京旅行资料库”把整理好的多个文档批量上传。Coze 会自动完成分段、向量化处理这样智能体就能在回答时实时检索了。3.3 设置知识库检索策略创建知识库后在智能体中引用该知识库时可以设置检索策略。常见的策略模式有智能匹配由系统自动决定检索方式适合大多数场景。全文检索适合精确匹配关键词比如“环球影城开放时间”。向量检索适合语义相近的模糊匹配比如“北京有什么适合带孩子玩的地方”。旅行攻略场景中建议使用“智能匹配”或“混合检索”模式。因为用户提问往往口语化、多样化不能只靠关键词精确匹配。知识库的大小也需要控制。如果导入的内容过于庞杂检索时容易出现“答非所问”的情况。比较好的做法是按城市或主题拆分成多个知识库例如“北京旅行资料”“成都旅行资料”“通用旅行模板”让智能体根据用户目的地选择性地检索对应知识库。4. 配置旅行攻略智能体4.1 创建智能体并绑定空间资源在空间内点击“创建智能体”填写名称如“旅行攻略助手”和功能介绍。创建后你可以在智能体编排页面中完成人设提示词、模型、技能、知识库、工作流等配置。智能体编排页通常分为三个区域左侧是功能组件区人设、技能、知识库、工作流等中间是预览调试区右侧是参数设置区。当你把知识库、工作流、插件都添加到智能体后需要确保它们的开关状态为“启用”。4.2 编写人设与回复逻辑人设提示词决定了智能体的语气、行为边界和回复风格。旅行攻略智能体的人设建议包含四个方面角色定位你是资深旅行规划师。服务范围负责目的地推荐、路线规划、美食推荐、交通建议。回复风格简洁清晰按结构化格式输出。约束条件信息以知识库为准不确定的内容要说明“请以官方公告为准”。一个可以参考的人设提示词如下你是一名经验丰富的旅行规划师熟悉国内各大热门旅游城市和景点的玩法。你擅长根据用户的出行时间、预算、人数和兴趣偏好规划出合理、可执行的旅行攻略。 在回答时请遵循以下规则 1. 优先使用知识库中的景点、交通、美食、住宿数据。 2. 如果知识库中缺少相关信息可以基于常识补充但要注明“建议出行前再次确认”。 3. 攻略输出必须结构清晰包含行程概览、每日安排、交通建议、美食推荐、注意事项。 4. 行程安排要合理避免一天内安排过多景点导致赶场。 5. 针对家庭出游、情侣出游、独自旅行等不同人群调整推荐内容。这里要注意的是人设提示词不要太长重点是要把行为规则说清楚。如果提示词写得过大而全模型反而容易“圈住自己”导致回复模板化。4.3 模型与技能选择在模型设置中选择一个适合中文文本生成和工具调用的大模型即可。不同模型的成本、速度和理解能力有差异旅行攻略场景建议优先选择推理能力均衡的模型因为攻略生成需要对信息做组合和排序。技能工具方面需要重点确认是否开启了“知识库”技能并绑定对应知识库。是否添加了“工作流”技能并选择相关流程。是否添加了插件例如天气查询、位置查询、图片搜索。技能添加得越多智能体的能力越强但也会带来调用失败或延迟增加的风险。所以插件和技能要按需添加不要贪多。5. 工作流实战制作旅行攻略生成流程5.1 什么是工作流如果说智能体是一个“大脑”那么工作流就是大脑里的“标准作业程序”。工作流允许你用可视化的方式把多个步骤连接起来形成一条从输入到输出的自动化流水线。在旅行攻略场景中一个典型的工作流可以拆解为接收用户输入的目的地、天数、人数、偏好。调用天气插件查询当地近期天气。从知识库中检索相关景点和美食数据。根据知识库数据生成初步攻略。将结果整理成 Markdown 文本输出。通过工作流我们可以让攻略生成过程更稳定、可重复而不是每次让大模型自由发挥。5.2 创建旅行攻略工作流在空间的“工作流”模块中点击“创建”输入工作流名称如“旅行攻略生成器”和描述。进入编辑界面后可以看到一个画布左侧是节点库。常用节点包括开始节点定义输入参数。大模型节点调用 LLM 进行文本生成。知识库节点检索知识库内容。插件节点调用外部 API。代码节点执行自定义 Python/JavaScript 代码。结束节点定义输出结果。下面以一个精简但完整的流程为例。第一步配置开始节点开始节点需要定义接收的参数例如destination目的地days行程天数travelers出行人数preference偏好描述第二步添加天气查询插件节点在插件节点中选择天气查询类插件并将“destination”字段映射到插件入参。天气数据会作为后续大模型生成攻略时的参考信息。第三步添加知识库检索节点在知识库节点中选择前面创建的“旅行资料库”将“destination”映射为检索关键字并设置返回条数例如返回 5 条相关文档片段。这一步是为了让大模型“有据可依”。第四步添加大模型节点大模型节点是整个工作流的核心。在提示词中把知识库检索结果、天气数据、用户输入作为变量引用进来。下面是一个提示词模板你是一名旅行规划专家请根据以下信息为用户生成一份旅行攻略。 【用户需求】 目的地{{input.destination}} 行程天数{{input.days}} 出行人数{{input.travelers}} 偏好{{input.preference}} 【近期天气】 {{weather.result}} 【参考资料】 {{knowledge.result}} 请按以下结构输出攻略 1. 行程概览 2. 每日详细安排 3. 交通建议 4. 美食推荐 5. 注意事项其中{{input.destination}}、{{weather.result}}、{{knowledge.result}}是引用上游节点的变量不同平台的变量引用语法可能略有差异请按照实际编辑器提示插入变量不要手动猜测。第五步配置结束节点结束节点输出最终生成的攻略文本通常直接引用大模型节点的回复内容。5.3 测试工作流工作流编辑完成后点击“试运行”或“测试”输入测试参数例如{ destination: 成都, days: 3, travelers: 2, preference: 喜欢美食和人文景点 }运行后可以查看每个节点的输入输出日志确认天气插件是否成功返回数据、知识库是否检索到相关内容、大模型是否按照指定结构生成攻略。如果某一步数据为空可以根据日志定位问题比如插件没有配置 API Key、或者知识库中的文档没有匹配到检索词。5.4 将工作流绑定到智能体工作流测试通过后回到智能体编排页面在技能区域添加“工作流”并选择刚刚创建的工作流。这样用户在对话中触发相关意图时智能体就会自动调用该工作流来生成攻略。为了让智能体知道“哪些问题应该触发工作流”建议在人设提示词中做一些说明。例如当用户请求生成旅行攻略、行程规划、路线推荐时必须调用“旅行攻略生成器”工作流。如果智能体没有主动触发工作流可以检查技能配置是否已启用以及提示词中的触发条件是否明确。6. 发布与调用旅行攻略智能体6.1 发布到对话/应用渠道智能体配置完成后点击右上角“发布”按钮可以把它发布到不同渠道。常见渠道包括Coze 平台内置的对话预览链接。微信客服/公众号需要绑定对应平台账号。API 服务通过 HTTP 调用智能体。其他第三方渠道。初次使用时建议先发布到“Coze 对话”渠道通过分享链接在浏览器中测试完整效果。这样不需要额外开发工作就能快速验证智能体的实用程度。6.2 通过 API 调用智能体如果你希望把旅行攻略能力集成到自己的网页或小程序中可以开通 API 服务。Coze 提供了标准的 API 接口思路如下在平台中创建 API Token。找到智能体的 IDBot ID。调用对话接口传入用户消息。下面是一个使用 Python requests 库调用智能体 API 的示例仅演示核心思路具体接口地址和参数请以平台文档为准import requests # 请替换为你自己的 API Token 和 Bot ID api_token your_api_token bot_id your_bot_id url fhttps://api.coze.cn/v1/bot/chat headers { Authorization: fBearer {api_token}, Content-Type: application/json } payload { bot_id: bot_id, user_id: test_user_001, stream: False, auto_save_history: True, additional_messages: [ { role: user, content: 帮我做一个北京三日游攻略两个人喜欢美食和历史文化, content_type: text } ] } response requests.post(url, headersheaders, jsonpayload) print(response.json())这里要提醒大家API Token 是敏感信息不要把它硬编码在前端页面中也不要在公开仓库中提交。正确做法是将 Token 放在后端环境变量中由服务端发起调用。6.3 导出攻略文档旅行攻略生成后的结果是文本内容。如果你需要保存为 Markdown、Word 或 PDF可以在工作流中增加一个转换节点或者在智能体外通过脚本处理。一个常见的做法是让智能体在回复中同时输出 Markdown 格式的攻略正文然后手动复制保存到本地编辑器。也可以在外部 API 调用逻辑中将返回的 Markdown 文本通过 pandoc 或其他工具转换为 Word 文档。例如在 Linux 环境中可以使用下面的命令将 Markdown 转换为 Wordpandoc guide.md -o guide.docx这样从 AI 生成到文档交付形成了一条完整的链路适合整理成可分享的旅行手册。7. 常见问题与排查思路在使用 Coze 空间制作旅行攻略的过程中比较容易遇到以下几类问题。这里按照现象、原因、解决思路整理成一张排查表。问题现象常见原因解决思路智能体回答内容泛泛没有用到知识库知识库未绑定、检索策略不合适、文档内容未被检索命中确认知识库已启用把问题改为更具体的关键词尝试“智能匹配”检索策略检查文档分段质量工作流没有按预期触发人设提示词没有明确触发条件技能开关未打开意图识别失败在提示词中增加“必须调用工作流”的指令检查技能开关简化触发意图表达天气插件返回空数据插件 API Key 未配置城市名称不标准重新检查插件配置在入参前增加“城市标准化”处理节点攻略内容出现明显错误如景点营业时间过期知识库文档过旧大模型补充了不准确信息及时更新知识库文档在提示词中要求“优先使用知识库不确定内容标注待确认”工作流运行报错“节点入参缺失”上游节点参数映射错误在调试日志中查看节点输入输出按日志提示修正变量映射发布到微信后提示绑定失败平台权限或公众号类型不支持检查公众号是否为服务号确认已按平台要求完成授权API 调用返回 401 未授权Token 错误或过期重新生成 API Token检查请求头格式生成内容太长导致输出截断模型最大 token 限制在提示词中要求分章节输出或者二次拼接结果此外如果你的空间内创建了多个智能体和多个工作流建议给每个资源加上清晰的前缀命名比如“旅行攻略-知识库-北京”“旅行攻略-工作流-生成器”避免后续混淆。8. 最佳实践与工程化建议8.1 知识库维护要持续进行旅行信息具有很强的时效性。景区的开放时间、门票价格、交通线路随时可能调整。如果知识库内容长期不更新智能体给出的信息很可能是过时的。比较好的做法是每个季度复盘一次知识库重点检查热门景点的开放时间、门票信息。在知识库文档中标注“信息更新时间”让用户知道数据的新鲜程度。对于重要景区可以引导用户出行前二次确认。8.2 工作流节点要尽量单一职责在设计工作流时每个节点只做一件事。比如天气查询节点只负责查天气知识库检索节点只负责检索资料大模型节点只负责生成文本。不要试图在一个节点里完成所有事情否则排错会非常困难。尽量使用有意义的节点名称例如“查询成都天气”“检索北京景点库”“生成三日游路线”这样日志中的可读性会更高。8.3 控制插件数量降低调用失败率每增加一个插件就增加一个外部依赖点。如果某个第三方插件服务不稳定整个工作流都可能失败。建议先实现最小可用闭环知识库 大模型生成攻略。跑通后再逐步增加天气查询、地图导航等插件。插件不在多而在稳定。8.4 注意 API Key 与敏感信息管理在 Coze 空间中使用外部 API 时很多插件需要配置 API Key。这些 Key 由平台加密存储通常不会明文展示。但在本地开发中不要把 API Key 写在代码里也不要复制到公开文档中。对于生产环境建议使用独立专用 Key 给 Coze 空间调用便于控制和撤销权限。定期审核插件配置删除不再使用的 Key。如果平台支持开启调用日志了解每个 Key 的使用情况。8.5 用空间分隔不同场景避免资源冲突如果你除了旅行攻略之外还有办公、编程、学习等其他 AI 应用需求建议创建不同的空间来隔离它们。不同空间之间的知识库、工作流、插件互不干扰维护起来更清爽。团队协作时空间还可以配置成员权限让不同成员分别维护知识库、工作流和智能体形成专人专责的协作模式。8.6 从模板化输出走向个性化推荐最初的攻略生成可能比较模板化这是正常现象。随着你对提示词的优化和知识库的丰富智能体的个性化程度会逐步提升。建议在提示词中引导智能体提出反问。例如在生成攻略之前如果用户没有说明出行人数、预算和偏好可以先追问一句“这趟出行大概有几个人预算范围是多少更喜欢自然风光还是城市人文”获取足够信息后再生成攻略体验会明显改善。9. 总结本文从 Coze 空间的概念出发完整演示了如何通过空间来组织和管理旅行攻略智能体。我们创建了独立空间整理了旅行知识库配置了智能体人设和插件又通过工作流串联起天气查询、知识库检索和攻略生成三个核心环节最后还展示了发布到对话平台和通过 API 调用的方式。整个流程的核心在于用空间做资源隔离用知识库做信息保障用工作流做流程固化用提示词做交互控制。这四个点环环相扣缺一不可。如果你正准备做自己的旅行攻略智能体建议先从一个小众城市入手把知识库资料做扎实再逐步扩展。你会发现比起直接让大模型“编”攻略结合知识库和专业流程生成的攻略在实用性和准确性上都要高出一个台阶。接下来你可以继续研究 Coze 的多智能体协作、定时触发任务、更复杂的条件分支工作流甚至把攻略生成结果自动同步到飞书文档或微信公众号。玩法还有很多关键是先把基础闭环跑通。如果本文对你有所帮助可以收藏备用。也欢迎在实操后回来对照检查看看你的空间和智能体配置还有哪些可以优化的地方。
返回列表