---
orphan: true
---

# 导出智能体包

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

导出指定智能体版本的 `.moiagent` 包。

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-packages/{agent_id}/versions/{version}/export
```

## 调用前准备

准备有目标工作区访问权限的个人访问令牌、目标工作区 ID、智能体 ID 和要导出的版本。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 请求示例

```bash
curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-packages/$AGENT_ID/versions/$VERSION/export" -H "X-API-Key: $AI_STUDIO_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID" -o agent.moiagent
```

:::::
:::::{tab-item} 参数说明

::::{tab-set}
:::{tab-item} 请求参数

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `workspace_id` | string | 是 | 当前工作区 ID。 |
| `agent_id` | string | 是 | 要导出其包文件的智能体 ID。 |
| `version` | string | 是 | 要导出的智能体版本。 |
| `agent_workspace_id` | string | 否 | 查询参数；仅允许当前 workspace_id 或 system。省略时使用当前工作区，显式空值无效。 |
:::
::::
:::::
::::::
:::::::

来源工作区只能选择当前工作区或 system，并通过对应的来源查询参数指定；空值不能表示默认来源。

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```text
agent-id-version.moiagent（二进制包文件）
```

:::::
:::::{tab-item} 字段说明

成功时返回 `200` 和包文件字节流。

:::::
::::::
:::::::

导出会记录操作审计；若记录操作失败，下载请求也可能失败。该 GET 不只是读取包内容，不应据此自动重复导出。

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": 3,
  "message": "agent version not found"
}
```

:::::
:::::{tab-item} 字段说明

::::{tab-set}
:::{tab-item} 错误字段

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | integer | 错误代码。 |
| `message` | string | 错误说明。 |

:::
::::
:::::
::::::
:::::::