# 获取 AI 助手调用方统计 (/zh/api/analytics/assistant-caller-stats)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 1003 · updated: 2026-07-30 -->
Related: [获取反馈](/zh/api/analytics/feedback.md), [获取 AI 助手会话记录](/zh/api/analytics/assistant-conversations.md), [启动静态导出作业](/zh/api/static-export/start-job.md)

<div id="usage">
  ## 使用方法 [#使用方法]
</div>

使用此端点查看助手查询在不同调用方类型之间的分布情况。响应将总查询次数细分为：

* `web`：来自文档站点的查询
* `api`：来自直接 API 调用的查询
* `other`：来自其他来源的查询（例如集成、SDK）
* **total**：所有查询类型的总和

<div id="filtering">
  ## 筛选 [#筛选]
</div>

使用 `dateFrom` 和 `dateTo` 参数按日期范围筛选。

<div id="rate-limits">
  ## 速率限制 [#速率限制]
</div>

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

`GET /v1/analytics/{projectId}/assistant/caller-stats`

返回指定日期范围内按调用方类型（网页端、API 和其他）划分的助手查询次数明细。

使用管理员 API 密钥进行身份验证。

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "你的项目 ID，可在控制台的 [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) 页面中复制。"
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "description": "ISO 8601 或 YYYY-MM-DD 格式的日期",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateFrom",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "ISO 8601 或 YYYY-MM-DD 格式的日期。`dateTo` 为不包含在内的上限。结果将包含早于该日期的记录，但不包含该日期当天的记录。",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateTo",
      "in": "query"
    }
  ],
  "responses": {
    "200": {
      "description": "按调用方类型划分的助手查询次数",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "web": {
                "type": "number",
                "description": "来自网页端（文档站点）的助手查询次数。"
              },
              "api": {
                "type": "number",
                "description": "来自 API 调用的助手查询次数。"
              },
              "other": {
                "type": "number",
                "description": "来自其他来源（例如集成、SDK）的助手查询次数。"
              },
              "total": {
                "type": "number",
                "description": "所有调用方类型的助手查询总数。"
              }
            },
            "required": [
              "web",
              "api",
              "other",
              "total"
            ]
          }
        }
      }
    },
    "400": {
      "description": "无效的查询参数",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "描述错误原因的错误信息。"
              },
              "details": {
                "type": "array",
                "description": "关于该错误的其他详细信息。",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "对某个特定校验或处理错误的说明。"
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "服务器错误",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "描述错误原因的错误信息。"
              },
              "details": {
                "type": "array",
                "description": "关于该错误的其他详细信息。",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "对某个特定校验或处理错误的说明。"
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```