提交反馈工单¶
提交问题描述及可选的对话记录,获取工单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。当前请求没有幂等键,网络超时后直接重试可能生成新工单;可先查看本人列表,再决定是否重新提交。