mosoodocs

保存 Agent 预设

保存并测试可复用的指令、工具与环境配置。

需要复用配置时可以保存 Agent 预设。无需预设直接执行,请从 API 快速开始 开始。

1. 打开 Project

登录 cloud.mosoo.ai。新账号会自动创建 Default Project。当你需要独立的资源与用量边界时,可通过 Project switcher 创建或切换 Project。

2. 添加模型服务商密钥

打开 Config → Providers。为准备使用的 runtime 添加 key,并按需执行连接测试。配置完成后,页面顶部会显示 runtime 已就绪。

Provider 凭据只属于当前 Project。保存后的 key 只显示掩码,导出的 Agent package 也不会包含凭据。

3. 创建 Agent

打开 Agents → Create agent,填写名称并选择 runtime。

New Agent 对话框提供 Claude Agent SDK、OpenAI Runtime、OpenCode 和 Pi。

  • Claude Agent SDK 使用 Anthropic key。
  • OpenAI Runtime 使用 OpenAI-compatible key,并要求 endpoint 支持相应 Responses API。
  • OpenCode 可使用支持的 Provider 配置,包括自定义 OpenAI-compatible endpoint。Project 仅配置自定义 OpenAI-compatible Provider 时,仍默认使用 OpenCode。
  • Pi 需要显式选择,可使用 Project 中兼容的内置和自定义 Provider。自定义 endpoint 需选择其实现的模型协议;Pi 支持 Chat Completions、Responses、Anthropic Messages 和 Google Gemini。

4. 配置行为

在 Preview 中设置模型和 system prompt。只有预设确有需要时才添加 Skills、MCP servers 或自定义 Environment。

5. 测试预设

在左侧 Preview 中发送具有代表性的任务。验证回答、工具调用、文件以及失败行为。用 Logs 查看执行细节,用 Cost 查看模型用量。

6. 复用已保存的预设

保存后可在 v2 中使用 configuration: {type: "agent", agent_id: "Agent ID"} 引用预设,这条路径不需要发布。如果要使用已发布配置的交付流程,再从 Publish 发布草稿;已有 Session 始终保留接纳时的配置。

发布后选择交付方式:

  • Thread:在 mosoo 控制台中开始工作。
  • API Access:取得 Agent ID,通过 Public Thread API 调用。
  • Instruction for LLM:复制适用于受支持 coding-agent 工作流的指令。

On this page