用途:把 CodeSpring Agents 应用从零搭好或修好,产出可运行的智能体,而不是一堆草稿。完成标志是应用仓库中的简短 AGENT_SETUP.md 回执,以及一次真实会话回放,证明模型与预期工具确实运行过。
主要能力:先确定六项事实(应用仓库与框架、已安装的 @codespring-app/use-agent 版本、CodeSpring 工作区/租户、development 或 production 环境、目标稳定模型 ID、已有 agent ID 与已发布修订),再按“provider connection -> 稳定模型 ID -> agent 草稿 -> 已发布修订 -> 修订授权的 API key -> 浏览器客户端令牌 -> 会话”的资源链逐层配置。区分草稿(可编辑)与已发布修订(不可变,固定模型策略、工具、MCP 快照与技能);区分 provider key、Agents API key 与浏览器客户端令牌。按动词选择最小能力集:推理/方法用技能指令,第三方服务用 MCP 工具,应用自身数据或动作用客户托管工具,结构化问答或图表用 React 生成式 UI。
使用方式:先只读检查,例如 npm ls @codespring-app/use-agent、npx @codespring-app/use-agent auth status --json、npx @codespring-app/use-agent agents list --json、npx @codespring-app/use-agent tools list --json;需要交互式授权时运行 npx @codespring-app/use-agent auth login 并由本人批准设备码。可读取随包技能:npx @codespring-app/use-agent skills get app-builder、control-plane、react-ui。客户托管工具需用 defineTool 定义、createToolHandler 暴露并部署到公网 HTTPS 端点后注册;MCP 需注册服务器、完成认证、刷新发现并只挂载所需工具。发布前检查草稿差异,发布后必须用真实会话验证到 turn.completed,并确认回放中的修订、模型与 tool.started/tool.completed。
适用场景与限制:适合搭建或修复 CodeSpring Agents 应用、配置模型路由与工具、连接前端并做冒烟验证。面向不熟悉术语的使用者时,需用平实语言逐步说明,一次只给一个操作。托管运行时无法调用仅存在于 localhost 的处理器;浏览器代码不得使用 Agents API key,需由服务端签发五分钟客户端令牌。生产发布、凭据变更、付费开通、禁用归档与客户数据访问均需明确授权。资料未提供具体价格、平台支持范围与效果数据。