Skip to main content

​
全链路接入：生成并部署

适用于从自然语言需求开始，让 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。

​
接入流程

​
1. 创建项目

接入方保存业务应用与响应 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 恢复。
  • 收到交互 Action 时，通过 POST .../agent/action-responses 回复。
  • 网络超时后先查询当前 Run，避免重复创建。
  • 失败时保存具体 code、message、details 和 request_id，供人工或 AI 修复。
字段、事件和恢复策略见 Agent 接入指南。

​
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；Action 可以闭环。
  • 预览验收通过后才发布，最终向业务返回正式 access_url。
  • 接入方保存 external_app_id → project_id 并校验每次业务访问权限。