提交反馈工单

提交问题描述及可选的对话记录,获取工单ID和编号,随后通过本人列表跟踪处理状态。此接口创建平台内工单,不创建GitHub Issue。

POST https://api.moi.matrixorigin.cn/v5/feedback-tickets

调用前准备

MOI_ENDPOINT 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

准备当前环境的个人访问令牌,将MOI_ENDPOINT设置为包含API前缀的地址;工单归属由当前认证主体确定,不接受客户端指定account_id或uc_account_id。运行任务证明不能代替普通认证。

请求参数

curl -X POST "$MOI_ENDPOINT/feedback-tickets" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"title":"工作流发布后未找到API服务","description":"发布完成后,API服务列表没有出现对应服务。","expected_behavior":"可以在API服务列表找到新服务。","actual_behavior":"刷新列表后仍未找到。","reproduction_steps":"发布工作流后打开API服务列表。","suggested_priority":"请协助排查","messages":[{"role":"user","content":"发布后没有找到API服务。"}]}'

参数

类型

是否必填

说明

title

string 或 null

否

问题标题。建议填写,便于识别工单。

description

string 或 null

否

问题说明。

expected_behavior

string 或 null

否

预期结果。

actual_behavior

string 或 null

否

实际结果。

reproduction_steps

string 或 null

否

重现步骤。

suggested_priority

string 或 null

否

建议优先级说明;当前没有固定枚举,不会直接设置管理员处理状态。

messages

object(对象数组)

否

可选对话记录,最多50条;省略、null或空数组均表示没有对话记录。

messages[].role

string

是

user或assistant,不接受system或tool。

messages[].content

string

是

内容不能仅含空白,最多8000个Unicode字符;不按UTF-8字节数计数。

成功响应

{
  "code": 0,
  "data": {
    "id": "019a1234-1234-7123-8123-123456789abc",
    "ticket_no": "FB-00000001",
    "account_id": "principal-example",
    "uc_account_id": null,
    "title": "工作流发布后未找到API服务",
    "description": "发布完成后,API服务列表没有出现对应服务。",
    "expected_behavior": "可以在API服务列表找到新服务。",
    "actual_behavior": "刷新列表后仍未找到。",
    "reproduction_steps": "发布工作流后打开API服务列表。",
    "suggested_priority": "请协助排查",
    "status": "submitted",
    "admin_reply": null,
    "created_at": "2026-11-12T01:00:00Z",
    "updated_at": "2026-11-12T01:00:00Z",
    "messages": [
      {
        "sequence": 0,
        "role": "user",
        "content": "发布后没有找到API服务。",
        "created_at": "2026-11-12T01:00:00Z"
      }
    ]
  }
}

字段

类型

说明

code

integer

成功为0。此接口不返回成功msg字段。

data

object

工单对象。有对话时包含messages;没有对话时省略messages。

错误响应

{"code":2,"message":"feedback ticket transcript is invalid"}

字段

类型

说明

code

integer

处理器错误为数字:2无效请求,5无权限,6未认证,15依赖不可用,1内部错误。认证中间层也可能返回字符串code/msg,需按实际封套解析。

message

string

当前处理器的错误信息;不能按msg字段读取。

提交成功后保存id和ticket_no。当前请求没有幂等键,网络超时后直接重试可能生成新工单;可先查看本人列表,再决定是否重新提交。

最后更新于