跳转到主要内容
GET
获取 AI 助手调用方统计

使用方法

使用此端点查看来自每种调用方类型的助手会话数量。无论会话包含多少个问题,每个会话只计数一次。响应将会话总数细分为:
  • web:来自文档站点的会话
  • api:来自直接 API 调用的会话
  • other:来自其他来源的会话(例如集成、SDK)
  • total:所有调用方类型的总和

筛选

使用 dateFrom 和 dateTo 参数按日期范围筛选。每个会话计入其开始时所在的日期范围。

速率限制

此端点允许每个组织每小时最多 100 次请求。所有分析端点共享此限制。

授权

Authorization
string
header
必填

Authorization 请求头需要使用 Bearer 令牌。请使用管理员 API 密钥。这是仅供服务端使用的机密密钥。你可以在控制台的 API 密钥页面 中生成一个。

路径参数

projectId
string
必填

你的项目 ID,可在控制台的 API keys 页面中复制。

查询参数

dateFrom
string

ISO 8601 或 YYYY-MM-DD 格式的日期

示例:

"2024-01-01"

dateTo
string

ISO 8601 或 YYYY-MM-DD 格式的日期。dateTo 为不包含在内的上限。结果将包含早于该日期的记录,但不包含该日期当天的记录。

示例:

"2024-01-01"

响应

按调用方类型划分的助手会话数

web
number
必填

从网页端(文档站点)发起的助手会话数。

api
number
必填

从 API 调用发起的助手会话数。

other
number
必填

从其他来源(例如集成、SDK)发起的助手会话数。

total
number
必填

所有调用方类型的助手会话总数。