构建应用

在「已跑通、能集成」之后，按场景加深：换 Recipe、自带工作流、MCP、规格与验收。
生命周期对齐 OpenAI Agent Builder 的三步：设计 → 发布（有 ID）→ 部署；晨悦对应 Spec → provision → 接客户端。

---

1. 设计：写清 Spec

不要一上来堆节点。先填（或让 AI 填）规格：

→ 规格模板

人只审：禁区与测题。AI 负责扩写 system_prompt 并调用 Builder。

---

2. 发布：选一条构建路径

图从哪来（平台不负责业务）：她的 AI 按 节点参考 生成 {nodes,edges} → 先 validate → 再 provision。
官方只提供薄 Recipe 当起点，不替她生成行业全图。

2.1 薄 Recipe（默认）

recipe_id	图
edu_qa_thin	start → llm → end
http_call_thin	start → http → llm → end（示范 http；默认 GET /health）

ProvisionRequest(
    agent_name="...",
    system_prompt="...",
    recipe_id="edu_qa_thin",
)

GET /api/builder/recipes · client.list_recipes()。

2.2 自带 Workflow JSON（自己的业务）

1. client.list_node_types() 或读 节点参考
2. AI 生成 {nodes, edges}
3. client.validate_workflow(wf) —— 不通过不要 provision
4. ProvisionRequest(..., workflow=wf)（优先于 recipe）

wf = {...}  # 她的流程
print(client.validate_workflow(wf))
client.provision(ProvisionRequest(
    agent_name="选品助手",
    system_prompt="...",
    workflow=wf,
))

2.3 MCP · Cursor

MCP 启动命令与环境变量由教练下发；工具一览见 MCP · Cursor。

工具	作用
builder_list_recipes	列 recipe
builder_provision	等同 HTTP provision

---

3. 部署：接到产品

provision 成功后对象已有稳定 agent_id（及可选 entrypoint.workflow_id）。
部署 = 集成指南 里的小程序 / 后端 / CI，而不是再发明一套配置。

---

4. 场景怎么选

目标	做法
交自己的教育/客服作品	薄 Spec + edu_qa_thin + 人审
学官网小悦怎么设计的	跟学复刻（不是 Builder 默认作业）
验收平台装配完程度	小悦金样灌装 → 验收金样

---

5. 和「控制台手搓」的关系

方式	角色
Builder API / SDK / MCP	主构建路径
控制台逐项点菜单	可补洞；不是 ToB 主文档叙事
内部 seed	运维；不对学员/合作方文档出现

---

下一步

• 字段全集：API 参考
• 写法取经：业界文档对照