> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meoo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 全链路接入

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

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

## 前置选择

先按[认证与授权](https://app.mintlify.com/alibaba-b47c397f/alibaba-b47c397f/~/757c99e3-fa24-43b5-848e-3c86fe532fb0)选择身份：系统集成统一使用团队版。单一大账号使用团队 Owner 临时 Token；需要平台隔离最终用户时使用虚拟成员临时 Token；需要用户登录授权时使用 OAuth。用户 API Key 仅用于个人测试，不推荐系统集成。

最小 Scope：`project.write project.read agent.run agent.read release.write release.read`。若生成过程需要数据库、云函数、Secret 或 Skill，再增加对应 Scope。

## 接入流程

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

### 1. 创建项目

```text theme={null}
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` 恢复。
* 收到交互 Action 时，通过 `POST .../agent/action-responses` 回复。
* 网络超时后先查询当前 Run，避免重复创建。
* 失败时保存具体 `code`、`message`、`details` 和 `request_id`，供人工或 AI 修复。

字段、事件和恢复策略见 [Agent 接入指南](https://app.mintlify.com/alibaba-b47c397f/alibaba-b47c397f/~/902f9879-a028-41dc-829e-6ad2525780a3)。

### 3. 预览和验收

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

### 4. 发布生成结果

调用 `POST /open/v1/projects/{project_id}/releases` 发布项目当前生成结果，再通过 `GET .../releases/current` 查询。成功后保存 `release_id`、`version` 和 `access_url`。

若上传的是自行构建的 zip，而非 Meoo 生成结果，应改用[仅部署接入](https://app.mintlify.com/alibaba-b47c397f/alibaba-b47c397f/~/e0c02cae-8c7f-4fda-b17b-ca6303fe4903)的 `prepare → PUT → complete` 流程。

## 完成标准

* 外部用户始终解析到正确的 `member_id`、主账号或 OAuth `openid`。
* SSE 断开后可从游标恢复，不重复创建 Run；Action 可以闭环。
* 预览验收通过后才发布，最终向业务返回正式 `access_url`。
* 接入方保存 `external_app_id → project_id` 并校验每次业务访问权限。