生成工单 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"}'
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
Bearer示例是 |
Bearer 加当前环境可信管理员令牌;不要同时设置 API Key。 |
|
string |
是 |
路径工单 ID。 |
|
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": []
}
}
字段 |
类型 |
说明 |
|---|---|---|
|
integer |
成功为数字 0。 |
|
object |
生成的草稿。 |
|
string |
bug、feature 或 auto;创建策略,不等同最终 GitHub Type。 |
|
string |
当前模板标识 moi-bug、moi-feature 或 moi-auto。 |
|
string |
生成的草稿标题,包含当前类型的前缀。 |
|
string |
生成的 Markdown 草稿正文,需人工核对;不包含完整工单对话。 |
|
string(字符串数组) |
检测到的类别数组;当前已知 token、credential、temporary_url、personal_data、business_data,不代表穷尽所有敏感内容。 |
嵌套工单、用户、消息、审批事实和 GitHub 请求的全部公开字段见公共对象。字段可空与可省略分别列明,不把旧 SDK fixture 的 submitter_email 当作当前字段。
错误响应¶
{"code":"Unauthorized","msg":"Unauthorized"}
字段 |
类型 |
说明 |
|---|---|---|
|
string / integer |
随失败阶段而异;示例为认证层字符串。 |
|
string |
认证或服务层失败文本,服务层通常本地化。 |
|
string |
参数解析阶段数字错误码的文本;与 msg 区分。 |
|
null |
当前服务层 responseEnvelope 错误保留 null;认证示例可不含此字段。 |
|
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 计数见错误说明。 |
完整错误族与各阶段见错误和恢复。