乐享知识库接口文档

# AI 反馈

# 获取反馈列表

请求URL

GET https://lxapi.lexiangla.com/cgi-bin/v1/ai-feedbacks

请求头

参数 是否必须 说明
Authorization 是 接口调用凭证 access_token
值格式："Bearer access_token"
示例值："Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJS"

其他说明

事项 说明
权限要求 AI助手
频率限制 3000次/分钟

参数说明

参数 是否必须 默认值 说明
limit 是 20 单个分页下AI反馈记录的条数
page 是 1 分页
started_at 否 无 开始日期
ended_at 否 无 结束日期
feedback_type 否 无 反馈类型。1: 赞; 2: 踩

响应

200 OK 状态码

{
    "data": [
        {
            "type": "ai_feedback",
            "id": 1,
            "attributes": {
                "feedback_type": "踩",
                "feedback_item": "misunderstanding_context",
                "supplementary": "数据错误",
                "user_input": "成都市有多大",
                "ai_output": "成都面积 3797.79平方千米<span id=\"ai-qa-ref\" data-completion-id=\"eaec56e9957a4063b94dbf17ee910b45\" data-ref-doc=\"1\" data-ref-chunks=\"1\">1</span>。",
                "answer_source": "internal",
                "answer_source_id": "a70cebb97f6046cb812d9c00df8b4bbc",
                "answer_source_name": "测试知识库",
                "qa_mode": "normal",
                "answerable": true,
                "staff_name": "李四",
                "created_at": "2025-04-15 14:13:05",
                "session_id": "2b45c5fa2ed2ef63e189bc802eb9d74422c63a16"
            }
        },
        {
            "type": "ai_feedback",
            "id": 2,
            "attributes": {
                "feedback_type": "赞",
                "feedback_item": "accurate_content|completed_content",
                "supplementary": "说明正确",
                "user_input": "万里长江第一桥是什么",
                "ai_output": "万里长江第一桥是指武汉长江大桥<span id=\"ai-qa-ref\" data-completion-id=\"9b61a705b99e473c8a6667c3608d6ec0\" data-ref-doc=\"1\" data-ref-chunks=\"1,2,3\">1</span><span id=\"ai-qa-ref\" data-completion-id=\"9b61a705b99e473c8a6667c3608d6ec0\" data-ref-doc=\"2\" data-ref-chunks=\"4\">2</span><span id=\"ai-qa-ref\" data-completion-id=\"9b61a705b99e473c8a6667c3608d6ec0\" data-ref-doc=\"3\" data-ref-chunks=\"5,6\">3</span>。",
                "answer_source": "doc",
                "answer_source_id": "a70cebb97f6046cb812d9c00df8bxxxx",
                "answer_source_name": "测试知识库1",
                "qa_mode": "reasoning",
                "answerable": true,
                "staff_name": "张三",
                "created_at": "2025-04-17 11:34:15",
                "session_id": "2b45c5fa2ed2ef63e189bc802eb9d74422xxxxxx"
            }
        }
    ],
    "links": {
        "first": "http://lxapi.lexiangla.com/cgi-bin/v1/ai-feedbacks?limit=20&page=1",
        "last": "http://lxapi.lexiangla.com/cgi-bin/v1/ai-feedbacks?limit=20&page=2",
        "prev": "http://lxapi.lexiangla.com/cgi-bin/v1/ai-feedbacks?limit=20&page=1",
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "http://lxapi.lexiangla.com/cgi-bin/v1/ai-feedbacks",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}

400 Bad Request 状态码

{
    "errors": [
        {
            "detail": "起始时间不能大于结束时间"
        }
    ]
}

{
    "errors": [
        {
            "detail": "{\"limit\":[\"limit 必须在 1 和 200 之间.\"],\"page\":[\"page 的最小长度为 1 .\"],\"feedback_type\":[\"选定的 feedback type 是无效的.\"]}"
        }
    ]
}

{
    "errors": [
        {
            "detail": "{\"limit\":[\"不能为空\"],\"page\":[\"不能为空\"]}"
        }
    ]
}

参数说明

参数 说明
id AI问答反馈标识
feedback_type 反馈类型
feedback_item 反馈选项，多个选项使用竖线分隔。详见下方反馈选项枚举值说明
supplementary 补充说明
user_input 用户输入
ai_output 模型输出
answer_source 知识范围。internal: AI-站内知识; external: AI-联网搜索; doc: AI-指定文档; internal-space: AI-站内知识-知识库; internal-team: AI-站内知识-团队空间
qa_mode 思考方式。normal: 快速回答; normal-ds-v3: 快速回答-deepseek-v3-0324; reasoning: 深度思考; research: 专业研究
answerable 是否拒答。true: 非拒答; false: 拒答; -: 该回答不支持判断拒答
staff_name 反馈人
created_at 反馈时间
answer_source_id 知识范围id：team_id/space_id/entry_id
answer_source_name 知识范围名称：团队/知识库/指定知识 名称
session_id 会话ID

反馈选项枚举值说明：

反馈类型 反馈选项-key 反馈选项-value
踩 no_matched_context 未匹配相关内容
outdated_content 内容老旧
wrong_content 内容错误
illusion_context 回答幻觉
misunderstanding_context 上下文理解错误
wrong_link_image 链接/图片错误
other_problems 其他
赞 accurate_content 内容准确
completed_content 全面完整
formated_content 格式规范

← 概述 →