打造你的专属 AI 旅行管家:基于 OpenAgents 的多智能体旅游助手实战

打造你的专属 AI 旅行管家:基于 OpenAgents 的多智能体旅游助手实战

基于 OpenAgents 的多智能体旅游助手实战

在大模型与智能体(Agent)技术快速发展的今天,构建一个能理解需求、协调任务、调用工具的 AI 助手已不再是遥不可及的梦想。传统的聊天机器人往往只能被动回答问题,而现代智能体系统则具备“主动性”——它能拆解复杂目标、调用多个子模块、甚至与外部服务交互,从而完成端到端的任务。本文将带你从零开始,利用 OpenAgents 这一开源框架,搭建一个由多个专业智能体协同工作的本地旅游小助手。这个系统不仅能根据用户一句话生成完整的旅行计划、推荐个性化景点,还能逐步扩展至查询实时天气、预订酒店、规划交通等实用功能,真正实现“一句话开启智能旅行”。


一、本地启动智能体

要运行基于 OpenAgents 的智能体系统,首先需要启动其核心网络服务。该服务负责管理所有 Agent 的注册、通信和协作,是整个多智能体生态的“中枢神经系统”。

在终端中执行以下命令:

openagents network start 

首次运行时,OpenAgents 会自动打开浏览器,引导你完成初始化配置(如设置管理员密码、选择模型类型等)。配置完成后,服务将在后台持续运行,并监听默认端口。

✅ 启动成功的界面如下所示:

启动成功

接下来,我们需要启动具体的智能体实例。以 von.yaml 为例,这是一个基于智谱 GLM-4.7 模型的中文助手配置文件。由于 OpenAgents 兼容 OpenAI 协议,我们只需将智谱的 API 地址和密钥通过环境变量传入即可。

PowerShell 中执行以下命令(请务必将 "你的API-Key" 替换为你在 智谱 AI 开放平台 申请的实际密钥):

$env:PYTHONUTF8 = "1"$env:PYTHONIOENCODING = "utf-8"$env:OPENAI_BASE_URL = "https://open.bigmodel.cn/api/paas/v4"$env:OPENAI_API_KEY = "你的API-Key" openagents agent start agents/von.yaml 
💡 关键提示:YAML 配置文件中请勿包含任何中文字符(包括注释),即使文件保存为 UTF-8 编码,也可能因底层解析器兼容性问题导致启动失败。建议全程使用英文编写配置。

若终端输出类似 Agent 'von' is running on http://localhost:8080 的信息,且无报错,则说明智能体已成功加载并接入网络:

智能体启动成功

此时,该智能体已准备好接收来自 Web 控制台或其他 Agent 的消息请求。


二、通过 Web 平台进行测试

OpenAgents 提供了一个内置的 Web Studio 界面,用于可视化管理智能体、发送测试消息并查看响应。服务启动后,默认会跳转至控制台页面(通常为 http://localhost:8700/studio/):

Web 控制台首页

点击的 “管理员登录” 按钮:

管理员登录入口

输入你在首次配置 OpenAgents 网络服务时设置的管理员密码:

输入管理员密码

登录成功后,进入用户控制台主界面。这里会列出当前在线的所有智能体,并提供聊天窗口用于交互:

用户控制台

现在,你可以向 von 智能体发送一条中文消息,例如:“你好,你能帮我做什么?” 如果一切配置正确,它将返回一段符合预设行为规范的友好回复:

智能体成功响应

这标志着从模型调用、网络通信到前端交互的完整链路已打通。

🔗 若你在配置过程中遇到问题,可参考前置文章:《使用 OpenAgents 搭建基于智谱 GLM 的本地智能体(Agent)》,其中详细讲解了环境变量设置、YAML 结构及常见错误排查方法。

三、开发多 Agent 旅游小助手

单个智能体虽能完成简单问答,但面对“规划一次三天两晚的杭州旅行”这类复杂任务时,往往力不从心。为此,我们采用 多智能体协作架构(Multi-Agent Collaboration) ——将大任务拆解为多个子任务,由不同专业 Agent 分工处理,再由主控 Agent 整合结果。这种设计不仅提升系统鲁棒性,也便于后续功能扩展。

1. 行程规划智能体

该 Agent 专注于时间管理与日程安排。当接收到“帮我安排三天行程”类指令时,它会根据目的地、天数、用户偏好(如“喜欢自然风光”或“想体验夜市”)生成结构化的每日计划,包括时间段、活动内容和建议停留时长。

行程规划 - 输入


行程规划 - 输出
实现方式:通过在 YAML 的 instruction 字段中明确角色职责和输出格式,引导模型生成结构化文本。

2. 景点推荐智能体

此 Agent 拥有丰富的旅游知识库,能结合地理位置、季节、人群热度等因素,推荐匹配度高的景点。例如,用户说“我想去人少但风景好的地方”,它会优先推荐西湖周边的冷门古村落而非断桥。

景点推荐 - 输入


景点推荐 - 输出
优势:通过专用 Agent 隔离领域知识,避免主控逻辑臃肿,同时便于单独优化推荐算法。

3. 天气查询智能体

理想情况下,该 Agent 应能调用天气 API(如和风天气、OpenWeather)获取未来几天的预报。然而,当前 OpenAgents 的 YAML 模式仅支持纯语言模型推理,无法直接发起 HTTP 请求或执行代码

因此,在 YAML 配置下尝试天气查询会失败或返回模拟数据:

天气查询尝试(受限)
解决方案:OpenAgents 支持通过 Python 编写自定义 Agent 类。你可创建一个继承 BaseAgent 的模块,在 react() 方法中集成 requests 调用天气接口,并将结果注入对话上下文。这种方式虽需少量编码,但能解锁真正的“工具调用(Tool Calling)”能力。

4. 主控小助手智能体

作为用户唯一交互入口,主控 Agent 扮演“指挥官”角色。它负责:

  • 理解用户意图(如识别“规划旅行”是一个复合任务)
  • 拆解子任务(“需要行程 + 景点 + 天气”)
  • 依次调用对应专业 Agent
  • 整合各子结果,生成连贯、自然的最终回复

例如,当用户输入:“帮我规划一个三天两晚的杭州旅行,包括景点和天气”,主控 Agent 会内部协调其他三个模块,并返回一份整合报告:

主助手 - 用户提问


主助手 - 协同响应
🌟 这正是多智能体系统的魅力所在:每个 Agent 保持简单专注,整体却能完成复杂任务。

通过本次实践,我们不仅验证了 OpenAgents 在本地部署和多智能体协作方面的强大能力,也为构建更复杂的 AI 应用打下了坚实基础。未来,只需为每个智能体赋予更丰富的工具(如数据库查询、邮件发送、支付接口)和长期记忆(通过向量数据库或工作区机制),这个“旅游小助手”就能进化为真正的个人生活助理——不仅能安排行程,还能自动预订机票、提醒签证到期、甚至根据预算动态调整方案。

AI 的终极目标不是取代人类,而是成为我们最得力的协作者。而这一切,就从一行命令、一个 YAML 文件、一次本地部署开始。现在,轮到你来创造属于自己的智能体世界了。

Read more

5款必知的STL预览工具:stl-thumb让3D模型管理更高效

5款必知的STL预览工具:stl-thumb让3D模型管理更高效 【免费下载链接】stl-thumbThumbnail generator for STL files 项目地址: https://gitcode.com/gh_mirrors/st/stl-thumb 在3D打印和CAD设计领域,STL文件预览一直是用户面临的痛点。传统的文件管理器无法直接显示3D模型的缩略图,导致用户需要反复打开专业软件才能确认文件内容。今天我要向大家推荐一款优秀的STL文件缩略图生成器——stl-thumb,它能完美解决这一问题。 🎯 stl-thumb:终极3D模型预览解决方案 stl-thumb是一款基于Rust语言开发的轻量级工具,专门用于生成STL文件缩略图。它采用OpenGL渲染引擎,能够在文件管理器中直接显示3D模型的预览效果,让3D模型预览变得前所未有的简单。 核心优势 ✨ * 跨平台兼容性:完美支持Windows 7+和主流Linux发行版 * 高性能渲染:基于OpenGL实现快速、高质量的3D模型渲染 * 无缝集成:自动与系统文件管理器集成,无需额外操作 *

By Ne0inhk
【C++】继承

【C++】继承

继承 ✨前言:继承是C++面向对象编程的核心特性之一,它允许我们在已有类的基础上创建新类,实现代码的复用和功能的扩展。通过继承,我们可以构建出层次分明的类体系,让代码更加结构化、可维护。本文将深入探讨继承的各个方面,从基本概念到底层实现,帮助读者全面掌握这一重要特性。 📖专栏:【C++成长之旅】 目录 * 继承 * 一、继承的概念及定义 * 1.1 继承的概念 * 1.2 继承的定义 * 1.2.1 定义格式 * 1.2.2 继承基类成员访问方式的变化 * 1.3 继承类模板 * 二、基类和派生类间的转化 * 三、继承中的作用域 * 3.1 隐藏规则 * 3.2 考察继承作用域相关选择题 * 3.2.1

By Ne0inhk
RabbitMQ如何成为分布式系统的“神经中枢“?——从安装部署到C++调用实战的完整流程,带你体验它的奥妙所在!​

RabbitMQ如何成为分布式系统的“神经中枢“?——从安装部署到C++调用实战的完整流程,带你体验它的奥妙所在!​

文章目录 * 本篇摘要 * ①·RabbitMq(轻量级消息队列中间件) 介绍 * RabbitMQ 是什么? * 核心功能与特点 * 1. **核心功能** * 2. **核心优势** * RabbitMQ 的核心概念 * 1. **生产者(Producer)** * 2. **消费者(Consumer)** * 3. **队列(Queue)** * 4. **交换机(Exchange)** * 5. **绑定(Binding)** * 工作流程(以 Direct 交换机为例) * 常见应用场景 * RabbitMQ 与相关技术对比 * 图像理解 * 总结一句话 * ②·RabbitMq 安装教程 * RabbitMq安装 * **1. 安装 RabbitMQ** * **2. 启动 & 检查状态** * **3. 创建管理员用户(

By Ne0inhk
【C++】C++ 重载深度解析:赋值运算与取地址运算符,你真的会了吗?

【C++】C++ 重载深度解析:赋值运算与取地址运算符,你真的会了吗?

🔭 个人主页:散峰而望 《C语言:从基础到进阶》《编程工具的下载和使用》《C语言刷题》 《C++》《算法竞赛从入门到获奖》《人工智能》《AI Agent》 愿为出海月,不做归山云 🎬博主简介 【C++】C++ 重载深度解析:赋值运算与取地址运算符,你真的会了吗? * 前言 * 1. 赋值运算符重载 * 1.1 运算符重载 * 1.2 赋值运算符重载 * 2. 取地址运算符重载 * 2.1 const成员函数 * 2.2 取地址运算符重载 * 结语 前言 在C++中,运算符重载是一项强大的特性,允许开发者自定义运算符的行为,使其适用于用户定义的类型。赋值运算符(operator=)和取地址运算符(operator&)是其中两个关键的重载目标,但它们的实现细节和潜在陷阱往往容易被忽视。

By Ne0inhk