生成工单 GitHub Issue 草稿

从工单结构化事实生成可核对的标题和正文;本动作不提交外部 Issue。

POST https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/{id}/github-issue-draft

调用前准备

准备当前环境可用的 Genesis 管理员 Bearer;普通个人访问令牌、X-API-Key 和工作区 Owner 不能替代。会话模式的写操作另需 CSRF。参见AI Studio。示例 ID 需换为获准查看的真实工单 ID。

草稿从标题、问题、期望、实际、复现、建议优先级和反馈编号生成;不复制完整 messages、管理员回复或用户目录信息。正文受当前本地化模板影响,示例仅展示一组输入的结果。检测与替换不保证覆盖全部敏感内容,提交前仍需人工核对。

请求参数

curl -X POST "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/ticket-example/github-issue-draft" \
  -H "Authorization: Bearer $GENESIS_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"kind":"bug"}'

参数

类型

是否必填

说明

Authorization

string

Bearer示例是

Bearer 加当前环境可信管理员令牌;不要同时设置 API Key。

id

string

是

路径工单 ID。

kind

string

是

bug、feature 或 auto。省略/空值不自动选 auto。

成功响应

{
  "code": 0,
  "data": {
    "kind": "bug",
    "template": "moi-bug",
    "title": "[MOI BUG] 示例反馈",
    "body": "本 Issue 基于管理员提交的 MatrixFlow Feedback Ticket 事实创建。\n\n## 问题描述\n\n界面显示结果与预期不同。\n\n## 期望行为\n\n待确认\n\n## 实际行为\n\n待确认\n\n## 复现步骤\n\n待确认\n\n## 用户建议优先级(仅供分诊参考)\n\n待确认\n\n## 内部反馈编号\n\nFB-EXAMPLE\n\n<!-- matrixflow-feedback-ticket:ticket-example -->",
    "sensitive_findings": []
  }
}

字段

类型

说明

code

integer

成功为数字 0。

data

object

生成的草稿。

data.kind

string

bug、feature 或 auto;创建策略,不等同最终 GitHub Type。

data.template

string

当前模板标识 moi-bug、moi-feature 或 moi-auto。

data.title

string

生成的草稿标题,包含当前类型的前缀。

data.body

string

生成的 Markdown 草稿正文,需人工核对;不包含完整工单对话。

data.sensitive_findings

string(字符串数组)

检测到的类别数组;当前已知 token、credential、temporary_url、personal_data、business_data,不代表穷尽所有敏感内容。

嵌套工单、用户、消息、审批事实和 GitHub 请求的全部公开字段见公共对象。字段可空与可省略分别列明,不把旧 SDK fixture 的 submitter_email 当作当前字段。

错误响应

{"code":"Unauthorized","msg":"Unauthorized"}

字段

类型

说明

code

string / integer

随失败阶段而异;示例为认证层字符串。

msg

string

认证或服务层失败文本,服务层通常本地化。

message

string

参数解析阶段数字错误码的文本;与 msg 区分。

data

null

当前服务层 responseEnvelope 错误保留 null;认证示例可不含此字段。

details

object

文本字段 422 错误可带 field/reason 等,见错误说明。

HTTP / code

条件与处理

401 / Unauthorized

认证层拒绝;不要使用普通 PAT 或同时带 X-API-Key。

403 / ErrForbidden

未取得可信管理员事实,或当前调用身份与管理员事实不匹配。

404 / ErrFeedbackTicketNotFound

目标工单不存在;当前 service 错误返回 code/msg/data:null。

503 / ErrServiceUnavailable

已分类的身份、目录、授权依赖不可用或网络超时。

500 / ErrServer

内部处理或本地化失败;写请求错误后先回读确认。

400 / ErrFeedbackGitHubIssueDraftInvalid

kind 或 JSON 结构不合法。

422 / ErrFieldRequired 或 ErrFieldTooLong

最终标题或正文为空/超长;详细字段位置与 Unicode 计数见错误说明。

完整错误族与各阶段见错误和恢复。

最后更新于