Copy

适用于从自然语言需求开始，让 Meoo 生成应用并最终发布为可访问网站。流程同时使用项目、Agent 和 Release 能力。

前置选择

先按认证与授权选择身份：系统集成统一使用团队版。单一大账号使用团队 Owner 临时 Token；需要平台隔离最终用户时使用虚拟成员临时 Token；需要用户登录授权时使用 OAuth。用户 API Key 仅用于个人测试，不推荐系统集成。最小 Scope：project.write project.read agent.run agent.read release.write release.read。若生成过程需要数据库、云函数、Secret 或 Skill，再增加对应 Scope。

接入流程

获得业务 Bearer 凭证
  → 创建或选择项目
  → 创建 Agent Run
  → 消费 SSE 事件并处理 Action
  → 获取预览地址、验收生成结果
  → 创建 Release
  → 查询当前发布，保存 access_url

1. 创建项目

curl --request POST \
  --url "${MEOO_BASE_URL}/open/v1/projects" \
  --header "Authorization: Bearer ${MEOO_TOKEN}" \
  --header "Content-Type: application/json" \
  --data '{"name":"AI 应用","type":"web"}'

接入方保存业务应用与响应 project_id 的映射，不把外部用户 ID 当作项目边界参数。

2. 创建并跟踪 Agent Run

调用 POST /open/v1/projects/{project_id}/agent/runs 提交需求，保存 run_id、conversation_id 及按工具、积分结算维护的客户端状态；随后订阅 GET .../runs/{run_id}/events。

SSE 帧 id 仅在本次连接内有效，不支持 Last-Event-ID 断点续传。断线后退避重订阅同一 Run，用 message.snapshot 校正文本；存在 tool_calls 时整体替换当前轮工具状态和素材结果卡。
通过 Bash 的 tool.call.sub_type 区分普通命令、生图、生视频、语音和音乐，完成状态结合 outcome 判断；素材结果使用可选的 result 展示。
消费主 Agent 和素材独立结算的 run.usage，按 usage_id 去重后累加 credits_used，并按 Run 保存累计状态。积分事件不含工具调用 ID，不应按到达顺序绑定工具。
收到交互 Action 时，通过 POST .../agent/action-responses 回复。
网络超时后先查询当前 Run，避免重复创建。
失败时保存具体 code、message、details 和 request_id，供人工或 AI 修复。

字段和接入流程见 Agent 接入指南，工具分类、素材结果、积分和重连规则见事件流与 Action。

3. 预览和验收

通过 POST .../agent/preview-links 获取短期预览入口。预览用于验收，不等同于稳定线上地址，不应长期保存或对外承诺其可用性。

4. 发布生成结果

调用 POST /open/v1/projects/{project_id}/releases 发布项目当前生成结果，再通过 GET .../releases/current 查询。成功后保存 release_id、version 和 access_url。若上传的是自行构建的 zip，而非 Meoo 生成结果，应改用仅部署接入的 prepare → PUT → complete 流程。

完成标准

外部用户始终解析到正确的 member_id、主账号或 OAuth openid。
SSE 断开后可重订阅同一 Run 并从快照恢复，不重复创建 Run；Action 可以闭环。
素材进度和结果可以展示；积分按 usage_id 去重累计，刷新或重连不重复累计，缓存缺失不被解释为零消耗。
预览验收通过后才发布，最终向业务返回正式 access_url。
接入方保存 external_app_id → project_id 并校验每次业务访问权限。

​前置选择

​接入流程

​1. 创建项目

​2. 创建并跟踪 Agent Run

​3. 预览和验收

​4. 发布生成结果