读取首页引导的 Catalog 文件引用¶
GET /workspaces/{id}/agent-home-guide/guides/{guide_id}/files,普通产品身份,无请求体。先经过 regular service boundary,再按目标卷调用受 volume.read 约束的 Catalog 文件列表。
请求参数¶
GET https://api.moi.matrixorigin.cn/v5/workspaces/{id}/agent-home-guide/guides/{guide_id}/files
需要当前工作区的普通产品身份、目标引导ID及相关卷的读取权限,无业务请求体。
引导与文件¶
|
逻辑样例键 |
|---|---|
|
|
|
|
|
|
analyze-data 不属于文件引导 ID;前端走 Catalog 表元数据链。文件解析只读取当前部署语言的不可变样例及工作区挂载卷,逐项核对 file ID 与 volume ID。缺少初始化、挂载或目标文件时失败,不创建文件、不复制文件,也不替换为另一语言资源。
响应字段¶
字符串 code: "OK" 封套的 data 为:
字段 |
类型 |
说明 |
|---|---|---|
|
string |
当前引导 ID |
|
string |
部署决定的样例语言 |
|
array(数组) |
以下文件对象,保持引导键顺序 |
|
string |
稳定逻辑样例键 |
|
string |
Catalog 名称去首尾空白;为空时使用解析出的文件名 |
|
integer |
Catalog 文件字节数 |
|
string |
解析所得内容类型;空值回退 application/octet-stream |
|
string |
当前工作区 |
|
integer |
挂载卷 ID |
|
string |
用于后续附件交接的 Catalog 文件 ID |
列表查询固定 page=1、page_size=20,带单个 file ID 过滤和目标卷;这是内部存在性检查,接口本身没有对外分页输入。
handler 错误映射¶
HTTP |
|
条件 |
|---|---|---|
404 |
|
未知引导 ID |
404 |
|
所需样例不可用 |
403 |
|
授权拒绝 |
503 |
|
授权服务不可用 |
500 |
|
其他错误或错误文本本地化失败 |
错误封套包含 code、本地化 msg、data: null。HTTP/封套为源码映射证据,不代表真实请求已测。接口成功只说明这些文件引用在读取时可见,后续任务执行和模型访问仍须验证。