Muse智能体工作目录配置因部署模式而异:Mac版自动以用户主目录为沙箱起点,无需手动设置;Spark 1.3通过a365.config.json中deploymentProjectPath字段指定相对或绝对路径;云端模式由MuleRun平台自动托管,路径固定为/app/。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Muse智能体部署时,工作目录(即项目根路径)的配置方式取决于你采用的部署模式。它不是通用环境变量,而是由具体运行时或配置文件显式指定,不同场景下位置和作用不同。
Muse for Mac 本地执行模式:自动识别,无需手动设路径
该模式下,Muse 作为 macOS 原生应用安装后,默认以用户主目录(~/)为信任沙箱起点。它不会强制要求你填写“工作目录”,而是通过系统权限申请访问特定文件夹(如 Downloads、Documents 或你手动授权的任意路径)。
- 实际运行时,每个智能体任务会动态创建临时上下文目录(如
~/Library/Caches/Muse/agent-runs/20260923-abc123/),用于缓存中间文件、日志和截图; - 若需固定读写某文件夹(例如批量处理发票 PDF),只需在任务指令中明确写出相对路径(如
./Invoices/),Muse 会基于当前授权范围解析——前提是该路径已获你授权。
Muse Spark 1.3 本地部署(CLI 或服务模式):通过 a365.config.json 指定
当你用命令行启动或以服务方式运行 Muse Spark 时,需在项目根目录下提供 a365.config.json,其中 deploymentProjectPath 字段即为工作目录路径:
{
"messagingEndpoint": "http://localhost:3000/api/messages",
"deploymentProjectPath": "./my-agent-project"
}
-
deploymentProjectPath是相对路径或绝对路径,指向含mule-artifact.json、flows/、src/等标准结构的智能体工程目录; - 若填
.,表示当前命令执行目录即为工作目录; - 路径中不能含中文、空格或特殊符号(如
我的项目或agent v2会导致加载失败); - 若路径不存在或不可读,启动时会报错
Failed to resolve deployment project at [path]。
云端计算机模式(MuleRun 平台):路径由平台托管,不暴露给用户
在 https://www.php.cn/link/e1508a958e7df0833ae54777d6475b9e 的「Agent部署向导」中,你上传的是打包好的 mulerun-app-*.jar 或 mulerun-app-*.zip,内部已固化资源路径。平台自动解压并设定运行时工作目录为容器内 /app/,你无需也不应配置路径——所有文件读写均通过内置虚拟文件系统抽象层完成。
常见问题处理建议
- 启动报错 “Cannot find mule-artifact.json”:检查
deploymentProjectPath是否指向了正确目录,且该目录下确实存在该文件; - 本地脚本读不到
./data/config.yaml:确认config.yaml在deploymentProjectPath指定目录内,而非在a365.config.json所在目录; - Muse for Mac 提示“无权访问该文件夹”:前往「系统设置 → 隐私与安全性 → 完全磁盘访问」,添加 Muse 应用并重启。
路径设置本质是告诉运行时“从哪开始找东西”,不是越深越好,而是要与你的资源组织方式对齐。











