Skip to main content
想用自然语言创建云端 Agent，可以把 Z Agent Builder 安装到本地编码助手。它帮助你选择配置、调用 Managed Agents API、运行一个真实任务，并留下可复用的 Agent / Environment ID。

​
适用场景

适合需要云端工具、文件、持续执行或定时运行的任务。短问答和单次模型调用通常直接使用模型 API 更简单。

​
下载并安装到本地 Agent

下载 Z Agent Builder ZIP
  1. 解压 ZIP，保留完整的 z-agent-builder/ 目录。
  2. 将整个目录放入本地编码助手支持的 Skill 目录，确认里面有 SKILL.md、references/ 和 examples/。
  3. 新开一个会话，发“使用 Z Agent Builder，先说说你能做什么”，确认助手已发现该 Skill。
不知道安装目录时，可以直接把下面这段话发给本地助手：
Claude Code 可使用项目的 .claude/skills/z-agent-builder/ 或个人的 ~/.claude/skills/z-agent-builder/。其他助手按各自 Skill 安装方式操作；普通 ZIP 附件不等于宿主已经加载 Skill。
Builder 安装在你的本地助手里，用于构建和调试云端 Agent。云端运行的业务 Skill（例如财务分析流程）则通过 Skills API 上传并挂载，见Agent Skills。二者用途不同，不需要为了使用 Builder 把它上传到云端。

​
第一次使用

准备智谱开放平台 API Key，在本地通过环境变量或密钥管理配置；不要将密钥写进任务描述。然后给助手说明任务、输入、输出和触发方式：
助手会整理简短配置方案，创建或复用所需资源，并通过 Session 检查真实输入、工具结果和产物。Agent/Environment 创建成功仅代表配置保存，任务成功还要看实际结果。

​
能交付什么

  • 可复用的 Agent / Environment / Session ID。
  • 一次真实运行的回复、事件或产物链接，以及尚未接通的部分。
  • Setup 与 Runtime 分开的调用示例：配置只建一次，后续用 ID 运行。
  • 对更新或迁移的能力差异说明；凭据、渠道或本地登录不能自动搬到云端。
给已有 Agent 增加能力时，会保留未修改的数组项；更新只影响新版本引用。Multi Agent、Web 工具和定时触发按任务选用，不是创建普通 Agent 的前置条件。

​
更新与版本

版本读取包内 SKILL.md 的 metadata.version / released_at；不要把本页日期当作已安装版本。可向本地助手发送：
普通构建不自动替换本地 Skill。更新失败时保留原安装，新开会话再加载新版本。下载包中的旧示例可能沿用旧 beta header；新字段和 API 以当前协议文档为准。

​
下一步

快速入门

用 API 跑通一个任务

Agent Skills

挂载业务方法和模板

最佳实践

选择工具和任务配方

协议版本

核对接口和兼容性