profile builder是hermes agent的可视化配置工具，通过拖拽填空方式整合五类核心配置：需从dashboard左侧profiles入口进入构建页；填写唯一标识符及描述；选择或手动配置模型服务商；开关内置技能并安装社区技能包；配置mcp服务器类型与参数，经预览校验后创建实例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在网页端快速创建一个专属AI智能体，不用写配置文件、不碰命令行、不手动改yaml，直接拖拽填空就能生成可运行的Hermes Agent实例——Profile Builder就是为此而生，它把原本散落在终端里的五类核心配置整合成可视化流程，每一步都有明确提示和实时校验。
进入Profile Builder构建页
打开Hermes Dashboard，默认地址是 http://127.0.0.1:9119，确保本地服务已启动；若未运行，先执行 hermes chat 启动主进程。
点击左侧导航栏的 Profiles 选项，页面顶部会出现一个醒目的 Build 按钮，点击后跳转至 /profiles/new 路径，正式进入构建流程。
这一步不能跳过或手动拼URL访问，【必须通过左侧导航栏进入】，否则会因缺失上下文导致后续步骤无法保存配置。
填写身份名称与描述
第一步是定义这个智能体“是谁”：输入唯一标识符（如 video_agent），它将作为Profile目录名和命令别名（例如 video_agent chat）；同时填写中文名称与简短描述，用于界面识别和团队协作时快速理解角色定位。
名称中禁止使用空格、中文标点或特殊符号，只允许字母、数字、下划线和短横线；若填入 my agent，系统会自动报错并阻止进入下一步。
描述字段虽非必填，但建议写清用途，比如“负责生成短视频脚本与封面文案”，后续在多Profile管理列表中能一眼区分功能边界。
选择模型与服务商
方法一：从预设列表快速选择
在“Model Provider”下拉框中，选择你已配置过API Key的服务商（如 Z.AI、Kimi、Qwen），系统会自动加载该服务商下所有可用模型；选中目标模型（如 kimi-2.5）即可，无需重复输入密钥。
方法二：手动配置新服务商
若列表中没有你需要的服务商，点击 More providers → 输入Base URL（如 https://dashscope.aliyuncs.com/compatible-mode/v1）→ 粘贴对应API Key → 手动填写模型名称（如 qwen3.5-plus）→ 点击 Add provider。
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载，专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统，支持本地高效运行与多模态交互，集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载，确保安全稳定，助您实现智能办公与创作升级。
【注意：Base URL错误会导致后续测试失败，且Profile Builder不会主动校验格式合法性】，务必核对服务商文档中的标准地址，漏掉末尾 /v1 或多加斜杠都会使模型调用返回404。
开关内置技能与安装Skills Hub
左侧技能开关区列出所有Hermes默认内置能力（file、browser、shell、git等），勾选即启用，取消勾选则完全禁用——这比手动编辑 skills/ 目录更直观安全。
右侧Skills Hub区域支持一键安装社区技能包：点击 Browse Skills，在弹窗中搜索关键词（如 wecom 或 feishu），找到后点击 Install，系统会自动下载 SKILL.md 并放入当前Profile的 skills/ 目录。
已安装的技能会在下方显示状态条，绿色表示就绪，灰色表示依赖未满足（如缺少 ffmpeg 系统命令）；此时不要强行进入下一步，需先在终端执行 hermes doctor --check skills 定位缺失依赖。
配置MCP服务器与检查预览
第一步：选择MCP类型
下拉选择 HTTP（对接远程MCP服务）或 stdio（本地命令行工具集成），二者不可混用。
第二步：填写连接参数
选HTTP时填入完整URL（如 https://mcp.example.com/v1）；选stdio时填入绝对路径（如 /home/user/.hermes/mcp-tools/ffmpeg-wrapper.sh），路径必须可执行且有读写权限。
第三步：点击 Preview & Validate
系统会模拟一次最小化启动，检查所有配置项是否语法合法、路径可达、密钥格式正确；只有全部打钩 ✓ 才能点击最终的 Create Profile 按钮。
创建成功后，页面跳转至新Profile详情页，同时终端会自动输出一行提示：Created profile: video_agent → use 'video_agent chat' to start。
