乐享知识库接口文档

# AI 问答记录

# 获取问答记录列表

请求URL

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

请求头

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

其他说明

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

参数说明

参数 是否必须 默认值 说明
limit 是 20 单个分页下AI历史记录的条数
page 是 1 分页
started_at 否 无 开始日期
ended_at 否 无 结束日期

响应

200 OK 状态码

{
  "data": [
    {
      "type": "ai_history",
      "id": 1,
      "attributes": {
        "created_at": "2025-04-17 20:02:13",
        "question": "苏州有什么美食",
        "generated_question": "",
        "answer": "苏州拥有丰富多样的美食，以下是一些代表性的苏州美食：\n\n### 一、苏帮菜\n1. **松鼠鳜鱼**：这道菜以鳜鱼为主料，经过巧妙刀工处理后炸至金黄酥脆，再浇上糖醋汁，造型宛如松鼠，外酥里嫩，甜酸适口。\n2. **响油鳝糊**：选用太湖流域的新鲜野生鳝鱼，经过焯烫、煸炒、烧制等步骤，最后浇上热油，鳝肉鲜嫩爽滑，口感醇厚。\n3. **太湖三白**：包括白鱼、银鱼和白虾。白鱼清蒸后鲜嫩爽滑，银鱼可炒蛋或做羹，白虾常以白灼方式烹饪，味道鲜甜。\n\n### 二、特色小吃\n1. **生煎包**：面皮蓬松柔软，馅料以新鲜猪肉为主，煎制后底部酥脆，汤汁四溢，鲜香可口。\n2. **梅花糕**：外形宛如盛开的梅花，口感松软香甜，豆沙馅的甜蜜与果仁、红枣的丰富口感相互交织。\n3. **苏式月饼**：有甜月饼和咸月饼之分，甜月饼馅料多样，咸月饼以鲜肉为馅，外皮酥脆，内馅鲜嫩多汁。\n\n### 三、其他美食\n1. **苏绣**：虽然不是食物，但苏州的糕点如桂花糖芋艿、梅花糕等也颇具特色，口感细腻，甜而不腻。\n2. **蟹粉豆腐**：选用阳澄湖大闸蟹的蟹粉，与嫩豆腐一起烹制，蟹香浓郁，豆腐滑嫩，口感丰富。\n\n苏州的美食不仅种类繁多，而且注重食材的新鲜和烹饪的精细，每一道菜都蕴含着苏州人对美食的极致追求与热爱。",
        "question_type": "qa",
        "answer_source": "internal",
        "answer_source_id": "e1782cb1cc7848b19f441010ae164900",
        "answer_source_name": "测试知识库",
        "qa_mode": "normal",
        "answerable": "true",
        "session_id": "c5c9ee5db6eb0f7c3f5a6090395a4077e424748b"
      }
    },
    {
      "type": "ai_history",
      "id": 2,
      "attributes": {
        "created_at": "2025-04-17 14:46:01",
        "question": "有什么美食",
        "generated_question": "苏州市有什么美食",
        "answer": " 苏州拥有丰富多样的美食，以下是一些代表性的苏州美食：\n\n### 一、苏帮菜\n1. **松鼠鳜鱼**：这道菜以鳜鱼为主料，经过巧妙刀工处理后炸至金黄酥脆，再浇上糖醋汁，造型宛如松鼠，外酥里嫩，甜酸适口。\n2. **响油鳝糊**：选用太湖流域的新鲜野生鳝鱼，经过焯烫、煸炒、烧制等步骤，最后浇上热油，鳝肉鲜嫩爽滑，口感醇厚。\n3. **太湖三白**：包括白鱼、银鱼和白虾。白鱼清蒸后鲜嫩爽滑，银鱼可炒蛋或做羹，白虾常以白灼方式烹饪，味道鲜甜。\n\n### 二、特色小吃\n1. **生煎包**：面皮蓬松柔软，馅料以新鲜猪肉为主，煎制后底部酥脆，汤汁四溢，鲜香可口。\n2. **梅花糕**：外形宛如盛开的梅花，口感松软香甜，豆沙馅的甜蜜与果仁、红枣的丰富口感相互交织。\n3. **苏式月饼**：有甜月饼和咸月饼之分，甜月饼馅料多样，咸月饼以鲜肉为馅，外皮酥脆，内馅鲜嫩多汁。\n\n### 三、其他美食\n1. **苏绣**：虽然不是食物，但苏州的糕点如桂花糖芋艿、梅花糕等也颇具特色，口感细腻，甜而不腻。\n2. **蟹粉豆腐**：选用阳澄湖大闸蟹的蟹粉，与嫩豆腐一起烹制，蟹香浓郁，豆腐滑嫩，口感丰富。\n\n苏州的美食不仅种类繁多，而且注重食材的新鲜和烹饪的精细，每一道菜都蕴含着苏州人对美食的极致追求与热爱。",
        "question_type": "qa",
        "answer_source": "doc",
        "answer_source_id": "e1782cb1cc7848b19f441010ae164900",
        "answer_source_name": "测试知识库",
        "qa_mode": "reasoning",
        "answerable": true,
        "session_id": "c5c9ee5db6eb0f7c3f5a6090395a4077e424748b"
      }
    }
  ],
  "links": {
    "first": "http://lxapi.lexiangla.com/cgi-bin/v1/ai-histories?limit=20&started_at=2025-04-17+12%3A00%3A00&ended_at=2025-04-17+20%3A59%3A59&page=1",
    "last": "http://lxapi.lexiangla.com/cgi-bin/v1/ai-histories?limit=20&started_at=2025-04-17+12%3A00%3A00&ended_at=2025-04-17+20%3A59%3A59&page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "http://lxapi.lexiangla.com/cgi-bin/v1/ai-histories",
    "per_page": 20,
    "to": 2,
    "total": 2
  }
}

400 Bad Request 状态码

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

{
  "errors": [
    {
      "detail": "{\"limit\":[\"limit 必须在 1 和 200 之间.\"],\"page\":[\"page 的最小长度为 1 .\"]}"
    }
  ]
}

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

参数说明

参数 说明
id AI历史问答记录标识
created_at 提问时间
question 原始问题
generated_question 改写问题
answer 答案
question_type 提问方式。qa: 对话问答; openapi: API调用
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: 拒答; -: 该回答不支持判断拒答
answer_source_id 知识范围id：team_id/space_id/entry_id
answer_source_name 知识范围名称：团队/知识库/指定知识 名称
session_id 会话ID

# 导出问答记录

请求URL

POST https://lxapi.lexiangla.com/cgi-bin/v1/jobs

请求头

参数 是否必须 说明
Content-Type 是 固定值："application/json; charset=utf-8"
Authorization 是 接口调用凭证 access_token
值格式："Bearer access_token"
示例值："Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJS"
x-staff-id 是 成员帐号，作为导出任务创建者

其他说明

事项 说明
权限要求 AI助手
频率限制 累计到所有导出任务的次数统计，共200次/小时

参数说明

{
  "action": "exportAIQAHistoryV2",
  "attributes": {
    "started_at": "2025-07-01",
    "ended_at": "2025-07-01"
  }
}

参数说明

参数 是否必须 默认值 说明
access_token 是 无 调用接口凭证
action 是 无 导出任务类型，固定为：exportAIQAHistoryV2 表示导出AI问答记录
started_at 是 无 统计开始日期，格式为Y-m-d，格式参考如：2022-02-02
ended_at 是 无 统计结束日期，格式为Y-m-d，大于等于开始日期，时间跨度不超过一年

响应

{
  "code": 0,
  "msg": "success",
  "data": {
    "job_id": "xxxxx"
  }
}

参数说明

参数 说明
job_id 任务ID，可通过查询任务接口查询任务进度，当任务完成时，可通过download_url下载json文件

json文件字段说明

参数 说明
created_at 提问时间
organization 部门
question 用户提问
generated_question 问题改写
answer 回答内容
qa_mode 回答思考方式
model 调用模型
unanswerable 回答状态：拒答；正常
answer_source 知识范围
answer_source_id 知识范围ID
answer_source_name 知识范围名称
ref_doc_count 引用知识数
language 系统语言
session_id 会话ID
ref_docs_top10 引文知识top10
has_clicked_doc 是否点击引用知识：1；0
has_copied_answer 是否复制AI回答内容：1；0
click_type_1 第一点击类型: 引文；搜索结果
click_index_1 第一点击顺序
click_doc_1 第一点击知识: {"Value": "问答标题","Link": "https://lexiang.com/pages/123?company_from=abc"}
click_type_2 第二点击类型
click_index_2 第二点击顺序
click_doc_2 第二点击知识
click_type_3 第三点击类型
click_index_3 第三点击顺序
click_doc_3 第三点击知识
click_type_4 第四点击类型
click_index_4 第四点击顺序
click_doc_4 第四点击知识
click_type_5 第五点击类型
click_index_5 第五点击顺序
click_doc_5 第五点击知识

← AI 反馈 →