Muse智能体以Muse Spark模型为原生内核，非依赖外部大模型API；SaaS版默认用云端Spark1.3，私有部署需配置自定义API地址及tool_calls兼容响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Muse 智能体本身不依赖“连大模型”来运行——它不是靠调用外部大模型 API 实现能力的聊天机器人，而是以 Muse Spark 系列模型为原生驱动内核 的智能体运行时（Agent Runtime）。所以所谓“部署连大模型”，实际是配置 Muse 如何调用自身已集成的模型能力，或在需要时对接你自己的模型服务（如私有化部署的 Muse Spark）。
关键点很直接：
- Muse 默认使用云端托管的 Muse Spark1.3（或更高版本），无需额外配置；
- 若你已有本地/私有 Muse Spark 模型服务，才需手动配置 API 地址与认证；
- 所有模型调用都通过 Muse 内置的
Tool Call协议完成，不是自由发 POST 请求。
一、确认你用的是哪种部署形态
- SaaS 版 Muse（iOS/Android/Web/WhatsApp）：模型完全由 Meta 托管，用户不可更换，也无需配置 API。你只需写提示词、设工具权限、保存智能体即可。
- Muse for Mac / Muse Secure VM（企业私有部署）：支持指定模型后端地址，适用于已部署 Muse Spark 的本地或 VPC 环境。
-
Muse Connectors 架构下的自定义 Agent：可声明式绑定外部模型服务（如兼容 OpenAI 格式的接口），但必须满足 Muse 的响应结构规范（含
tool_calls字段、function.name等）。
二、私有 Muse Spark 服务的 API 配置方式（Mac / 企业版）
前提：你已在本地或服务器部署好 Muse Spark1.3 的推理服务（例如通过 Ollama、vLLM 或官方 Docker 镜像启动），且服务监听在 http://localhost:8080/v1/chat/completions 类似路径。
操作路径（以 Muse for Mac 设置为例）：
- 打开 Muse → 左下角「设置」→ 「高级」→ 「模型后端」
- 切换为「自定义模型服务」
- 填写：
-
API 地址：
http://localhost:8080/v1/chat/completions -
API Key：若服务启用鉴权（如
Bearer xxx），填入密钥；无则留空 -
模型名称：填
muse-spark-1.3（必须与服务返回的model字段一致，否则触发 fallback）
-
API 地址：
- 点击「测试连接」→ 显示 “✅ 连接成功，模型识别为 muse-spark-1.3” 即生效
⚠️ 注意：Muse 不接受任意 LLM 接口。它要求响应中必须包含标准 tool call 结构，例如：
飞书群聊机器人接入大模型下载从零搭建飞书机器人。支持 MiniMax/MiMo 等模型、工具调用（搜索/天气/百科/记忆）、Skill 架构。一站式交付可上线运行的飞书群聊 bot。基础版本，后续可自行升级能力
{ "choices": [{ "message": { "tool_calls": [{ "function": { "name": "search_web", "arguments": "{\"query\":\"上海天气\"}" } }] } }] }
三、通过 Muse Connectors 对接第三方模型（非 Muse Spark）
适用场景：你已有成熟 RAG 服务、微调模型 API 或内部推理平台，希望 Muse Agent 在特定步骤中调用它。
你需要做两件事：
-
在 Muse 平台创建一个 Connector
- 类型选「HTTP Function」
- URL 填你的模型服务地址（如
https://api.your-rag.com/query） - 方法选
POST，Header 加Content-Type: application/json - 在「请求模板」中声明输入结构，例如：
{ "prompt": "{{input}}", "top_k": 3 }
-
在智能体工作流中插入该 Connector 作为 Tool
- 编辑智能体 → 添加「调用外部服务」节点
- 选择刚建好的 Connector
- 设置输出映射：把返回 JSON 中的
answer字段映射为下一步可用变量
这样，Muse 就能在规划动作时，主动触发你的模型服务，并把结果纳入后续决策链。
四、常见失败原因与检查项
- ❌ 测试连接失败：检查服务是否运行、CORS 是否允许
http://localhost:3000（Muse for Mac 前端地址）、防火墙是否放行端口 - ❌ 模型调用无响应：确认返回 JSON 包含
choices[0].message.tool_calls或choices[0].message.content，二者至少其一 - ❌ 工具调用被忽略：检查 Connector 的「响应解析规则」是否匹配实际返回字段名（如误写
result而实际是output） - ❌ 敏感操作被拦截：Muse Secure VM 会审计所有模型输出，若返回内容含高风险关键词（如“执行 rm -rf”），将自动阻断并记录
不复杂但容易忽略。
