Appearance
业界文档对照(取经真源)
之前定调时取经的是 开放接入形态,不是抄某一家的产品文案。
本页把「看过谁的文档 → 学了什么 → 晨悦对应哪一页」写清,避免手册只剩自家 API 摘录、读起来像悬空。
1. 我们到底对标了什么
三家公开文档的共性骨架(不是某一段文案):
text
画布 / 编辑器
↕ 同一对象
可发布的 Agent / Workflow(有 ID、有版本)
↕
OpenAPI + 官方 SDK(人 / AI / CI 同调)
↕
Chat / Run(试聊或跑图)| 业界共性 | 晨悦落地 |
|---|---|
| 资源有稳定 ID,可发布 | Agent / Workflow / entrypoint |
| 机器契约先于控制台糖衣 | Builder OpenAPI · Workflow {nodes,edges} |
| 官方 SDK 薄封装同一 API | chenyue_flow(后续 TS) |
| AI 操作面不另造语义 | MCP builder_* 1:1 映射 |
| 模板 / Starter ≠ 旗舰全图 | edu_qa_thin;小悦走复刻或灌装验收 |
明确不取经:把内部 seed / 引擎源码当「SDK」发给客户。
2. 公开文档入口(建议对照读)
扣子 Coze · OpenAPI / SDK
| 看什么 | 链接 |
|---|---|
| 开发者指南总览 / SDK | docs.coze.cn 开发者指南(Node / Python / Go 等) |
| Python SDK | coze-dev/coze-py |
| 典型路径 | PAT → 创建/发布 Bot → Chat / Workflow API |
我们学的:PAT/Token + 官方多语言 SDK +「创建→发布→对话」同一套 OpenAPI;文档站是开发者第一入口,不是内部脚本说明。
我们没照抄:空间/渠道生态、OAuth 全家桶;晨悦现阶段测服 Bearer + 练习隔离即可。
Dify · Service API / Workflow
| 看什么 | 链接 |
|---|---|
| API 入门 | Get Started with the Dify API |
| Workflow App API | Workflow App API |
| 跑图 | Run Workflow |
我们学的:发布后的 App = 可调 REST;Workflow 有明确 run 语义;文档按 App 类型分章(Chat / Workflow / Agent)。
边界注意:Dify 公开 Service API 偏「跑已发布应用」;建图/导入 DSL 更多在控制台 / Console API。晨悦 Builder 刻意把 provision(创建+绑图) 也做成一等公民——这是教学/AI 构建刚需,比单纯「chat 已有 bot」多一步。
OpenAI · Agent Builder ↔ 可发布对象 ↔ SDK
| 看什么 | 链接 |
|---|---|
| Agent Builder 概述 | Agent Builder |
| 节点参考 | Node reference |
| Agents SDK | openai-agents-python |
我们学的:画布产物是有 ID、可版本的对象;对外要么嵌 ChatKit 式入口,要么导出/对接 SDK——画布不是孤岛。
边界注意:OpenAI 产品线在演进(Agent Builder 有弃用时间表),学的是模式,不绑定某一控制台生命周期。晨悦引擎与 DSL 自有,不搬他们的节点集合。
3. 和本册其它页怎么对齐
本册已按 ToB 三层重写(跑通 / 集成 / 构建):
| 业界文档里常见章节 | 晨悦本册 |
|---|---|
| Quickstart | 快速开始 |
| Integration | 集成指南 |
| Build / Design→Publish→Deploy | 构建应用 |
| API Reference | API 参考 |
| Templates / Starter | 规格模板 · Recipe |
| 旗舰验收(教学补) | 小悦验收金样 |
读法:首页 → 快速开始;本页仅作取经附录。
4. 修订
| 日期 | 说明 |
|---|---|
| 2026-10-09 | 补:业界文档真链 + 学什么/不学什么 + 与本册映射 |