用户组件调用排行
更新时间：2026-03-04
POST
https://qianfan.baidubce.com/v2/components
统计指定时间范围内当前用户各组件的调用量排行，返回各组件的调用次数、成功次数及失败次数等统计信息。数据统计范围：组件广场上上架过的有调用记录的组件及用户发布的组件。时间跨度限制：起始时间和终止时间跨度最大三个月。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
接口标识，用于指定请求的操作类型
可选
Body 参数
startTime
string
起始时间，天级别指定，格式如：2026-01-08，实际时间默认为当天的0点
必选
endTime
string
终止时间，天级别指定，格式如：2026-01-08，实际时间默认为当天的23点59分59秒
必选
channel
string
调用渠道，用于筛选组件的调用来源。可选值: agent, custom_tool, mcp, api。不填默认全渠道
可选
marker
string
起始位置，分页标识。第一次查询不传，后续查询使用返回的 nextMarker
可选
maxKeys
integer
每页返回的数据条数，默认值 10，最大值 100
可选
请求结构
POST /v2/components?Action={Action} HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"startTime": "2026-01-01",
"endTime": "2026-01-10",
"channel": "agent",
"marker": "",
"maxKeys": 10
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/components?Action=ComponentMonitor" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"startTime": "2026-01-01",
"endTime": "2026-01-10",
"channel": "agent",
"marker": "",
"maxKeys": 10
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
状态码，0 表示成功
可选
message
string
状态消息，成功时为空字符串
可选
result
object {6}
结果数据对象，包含组件调用排行的统计信息
可选
显示子属性
隐藏子属性
requestId
string
请求记录ID，用于唯一标识本次请求
可选
data
array
各组件统计信息数组，包含每个组件的调用量排行数据
可选
显示子属性
隐藏子属性
items
object {5}
显示子属性
隐藏子属性
code
string
组件代码标识，用于唯一标识组件
可选
name
string
组件名称
可选
totalCount
integer
组件总执行次数
可选
successCount
integer
组件成功执行次数
可选
failureCount
integer
组件失败执行次数
可选
marker
string
本次查询的起始位置
可选
maxKeys
integer
本次查询包含的最大结果集数量
可选
isTruncated
boolean
是否还有更多数据。true 表示后面还有数据，false 表示已经是最后一页
可选
nextMarker
string
下次查询的起始位置，当 isTruncated 为 true 时，将此值作为下次请求的 marker 参数
可选
响应示例
{
"code": 0,
"message": "",
"result": {
"requestId": "3e1b78c7-e4aa-476c-9243-65477a79f41c",
"data": [
{
"code": "mcp_server_baidu_map",
"name": "百度地图",
"totalCount": 835,
"successCount": 835,
"failureCount": 0
}
],
"marker": "",
"maxKeys": 2,
"isTruncated": true,
"nextMarker": "mcp_baidubaike"
}
}