FastGPTFastGPT

搜索应用对话日志

使用游标搜索 FastGPT 应用的对话日志,支持按标题或精确的会话 ID 查找。每页最多 50 条,可以使用响应中的 nextCursor 继续获取结果。

端点概览

  • HTTP 方法:POST
  • 请求路径:/api/core/app/logs/search
  • 所属模块:应用管理 / 应用日志
  • 鉴权方式:Authorization: Bearer <apiKey>—支持 应用 API Key(无需 appId)与 个人密钥(需传 appId)(详见 API 入门:完成首次请求)
  • 在线调试:在云服务 Scalar 调试台打开(自部署实例请将域名替换为 <instance>/apidoc/systemopenapi#tag/%E5%BA%94%E7%94%A8%E6%97%A5%E5%BF%97/POST/core/app/logs/search)

接口说明与注意事项

按游标搜索应用的对话日志列表,每页固定 50 条且不查询总数

请求参数

Request Body 请求体(application/json)

字段类型必填默认值约束与说明
feedbackTypestring (enum)否-反馈类型:all- 全部记录,has_feedback- 包含反馈,good- 包含赞,bad- 包含踩。可选值:all , has_feedback , good , bad
unreadOnlyboolean否-是否仅显示未读反馈(当 feedbackType 为 all 时忽略)
errorFilterstring (enum)否-报错筛选:all- 全部记录,has_error- 仅看报错。可选值:all , has_error
dateStartstring是-开始时间
dateEndstring是-结束时间
sourcesstring (enum)[]`否-对话来源筛选
tmbIdsstring[]否-团队成员 ID 列表
outLinkUidsstring[]否-外部用户 ID 列表
chatSearchstring否-搜索关键词;与 searchType 共同指定标题搜索或会话 ID 精确匹配
searchTypestring (enum)否-搜索类型:title 搜索标题,chatId 精确匹配会话 ID;省略时兼容旧搜索。可选值:title , chatId
cursorobject否-上一页响应中的 nextCursor;首屏请求省略,后续请求原样传入
cursor.timestampinteger是-游标时间戳(毫秒)。最小值:0;最大值:9007199254740991
cursor.idstring是-游标日志 ID。正则:^[a-f\d]{24}$

互斥参数分支(anyOf 选填其一)

  • 显式指定应用

个人密钥或登录态必须传 appId;应用 Key 始终以 Key 绑定的应用为准。

字段类型必填默认值约束与说明
appIdstring是-应用 ID。最小长度:1
  • 应用 API Key(无需 appId)

Authorization 使用绑定应用的 APP API Key 时无需传 appId 或 sourceType,服务端从 Key 绑定取得应用,sourceType 固定为 app。个人密钥和登录态不能使用此省略方式;显式传入 appId 时仍以 Key 绑定为准。

该分支无需额外字段。

请求示例

调用前请将 YOUR_API_KEY 与示例 ID 替换为真实值;私有化部署实例请将基础域名替换为 <instance>/api。

cURL 请求示例

curl --fail-with-body -X POST "https://cloud.fastgpt.cn/api/core/app/logs/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "appId": "68ad85a7463006c963799a05",
  "dateStart": "2024-01-01T00:00:00.000Z",
  "dateEnd": "2024-12-31T23:59:59.999Z"
}'

最小合法 JSON 请求体示例

{
  "appId": "68ad85a7463006c963799a05",
  "dateStart": "2024-01-01T00:00:00.000Z",
  "dateEnd": "2024-12-31T23:59:59.999Z"
}

响应结构与示例

除兼容 OpenAI 协议的对话补全或二进制下载接口外,成功响应统一包裹在 { "code": 200, "statusText": "", "message": "", "data": ... } 标准结构中;下方 200 字段表对应 data 载荷结构(若契约未声明具体载荷结构,请以上方状态描述及实际响应为准)。

HTTP 200

成功搜索应用日志列表

Content-Type : application/json

字段类型必填默认值约束与说明
listobject[]是-对话日志记录列表,固定返回 50 条
list[].publishSourceobject否--
list[].publishSource.typestring (enum)否"unknown"最近一次运行的调用渠道类型;无法识别时归为 unknown。可选值:test , online , share , api , cronJob , feishu , official_account , wecom , wechat , mcp , dingtalk , unknown
list[].publishSource.idstring否-渠道记录的数据库 ID;内部入口及无法恢复引用的历史数据可省略。正则:^[0-9a-fA-F]{24}$
list[].publishSource.namestring否-当前渠道名称,兼容历史来源名称
list[]._idstring是-对话日志 ID
list[].chatIdstring是-对话 ID。最大长度:1024
list[].titlestring | null否-对话标题
list[].customTitlestring | null否-自定义对话标题
list[].sourcestring (enum)是"unknown"已弃用。旧调用渠道类型,兼容保留;使用 publishSource.type。可选值:test , online , share , api , cronJob , feishu , official_account , wecom , wechat , mcp , dingtalk , unknown
list[].sourceNamestring | null否-已弃用。旧渠道名称,兼容保留;使用 publishSource.name
list[].updateTimestring是-更新时间
list[].createTimestring | null否-创建时间
list[].messageCountinteger | null否-消息数量
list[].userGoodFeedbackCountinteger | null否-好评反馈数量
list[].userBadFeedbackCountinteger | null否-差评反馈数量
list[].customFeedbacksCountinteger | null否-自定义反馈数量
list[].markCountinteger | null否-标记数量
list[].averageResponseTimenumber | null否-平均响应时间(毫秒)
list[].errorCountinteger | null否-错误次数
list[].totalPointsnumber | null否-总积分消耗
list[].outLinkUidstring | null否-使用者 ID,外链访客或 API customUid;非空时优先于 tmbId
list[].tmbIdstring | null否-本次实际鉴权成员 ID,代理调用时为被代理成员
list[].sourceMemberobject | null否-来源成员信息(兼容字段,分享来源可能为访客)
list[].authMemberobject | null否-按 tmbId 解析的鉴权成员信息,仅用于展示
list[].versionNamestring | null否-版本名称
list[].originIpstring | null否-原始 IP 地址
list[].regionstring | null否-区域
nextCursorobject否-下一页游标;省略表示已加载全部
nextCursor.timestampinteger是-游标时间戳(毫秒)。最小值:0;最大值:9007199254740991
nextCursor.idstring是-游标日志 ID。正则:^[a-f\d]{24}$
在 GitHub 上编辑

文件更新时间

本页导航

准备好开始了吗?

让你的企业知识真正被 AI 用起来