> ## Documentation Index > Fetch the complete documentation index at: https://docs.counso.ai/llms.txt > Use this file to discover all available pages before exploring further. # 列出智能体用量筛选项 返回指定智能体在所选期间内可用的用量筛选值。工作区 Manager 和该智能体的编辑者可以调用此接口。结果不包含智能体维度，其他可选值取决于已应用的筛选条件。 ```http theme={"system"} POST /api/w/{wId}/assistant/agent_configurations/{aId}/analytics/consumption/facets ``` 服务地址：`https://app.counso.ai` ## 认证 此接口需要用户身份：外部客户端通过 `Authorization: Bearer ` 传入用户 OAuth access token；已登录的浏览器也可使用 Counso 会话 Cookie。工作区 API key 不能代替用户身份。 ## 请求参数 | 参数 | 位置 | 类型 | 必填 | 说明 | | ----- | -- | ------ | -- | -------- | | `wId` | 路径 | string | 是 | | | `aId` | 路径 | string | 是 | 智能体配置 ID | ## 请求体 `Content-Type: application/json` | 字段 | 类型 | 必填 | | ------------ | -------------- | -- | | `period` | string | 否 | | `days` | integer | 否 | | `scope` | string | 否 | | `dimensions` | array\[string] | 否 | | `filter` | object | 否 | 完整字段约束与嵌套结构见下方接口规范。 ## 响应 | HTTP 状态 | 说明 | | ------- | --------------- | | 200 | 用量分析筛选值及其上下文可用性 | | 400 | 请求正文无效 | | 403 | 无权访问此分析视图 | | 500 | 获取用量分析筛选值失败 | ## 接口规范 可下载完整的[OpenAPI / Postman](/zh-cn/docs/developer-platform/counso-api-documentation/openapi-and-postman) 文件。 ```json theme={"system"} { "openapi": "3.0.0", "info": { "title": "Counso API", "version": "1.0.2", "description": "API reference for Counso workspaces, Agents, conversations and data sources.", "license": { "name": "MIT", "url": "https://opensource.org/licenses/MIT" } }, "servers": [ { "url": "https://app.counso.ai", "description": "Counso" } ], "paths": { "/api/w/{wId}/assistant/agent_configurations/{aId}/analytics/consumption/facets": { "post": { "summary": "List consumption analytics facets", "description": "Return the available consumption filters for one agent in the selected period. Workspace managers and editors of that agent can use this route. The agent dimension is omitted, and active filters determine which other values are available.", "tags": [ "Private Analytics" ], "parameters": [ { "in": "path", "name": "wId", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "aId", "required": true, "description": "ID of the agent configuration", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "period": { "type": "string", "enum": [ "cycle", "days" ], "default": "cycle" }, "days": { "type": "integer", "minimum": 1, "default": 30 }, "scope": { "type": "string", "enum": [ "all", "automations" ], "default": "all", "description": "Restricts which documents the facets are computed over. `automations` counts only trigger-originated runs." }, "dimensions": { "type": "array", "description": "Dimensions to compute facets for. Defaults to every dimension. Omitted dimensions come back as empty arrays. The personal route omits user and group dimensions, and the agent route omits the agent dimension.", "items": { "type": "string", "enum": [ "agent", "user", "api_key", "group", "model", "tool", "skill", "source" ] } }, "filter": { "type": "object", "description": "Map of consumption dimensions to selected values.", "additionalProperties": false, "properties": { "agents": { "type": "array", "items": { "type": "string" } }, "users": { "type": "array", "items": { "type": "string" } }, "api_keys": { "type": "array", "items": { "type": "string" } }, "groups": { "type": "array", "items": { "type": "string" } }, "models": { "type": "array", "items": { "type": "string" } }, "tools": { "type": "array", "items": { "type": "string" } }, "skills": { "type": "array", "items": { "type": "string" } }, "sources": { "type": "array", "items": { "type": "string" } } } } } } } } }, "security": [ { "UserAccessToken": [] }, { "BrowserSession": [] } ], "responses": { "200": { "description": "Consumption facets and their contextual availability", "content": { "application/json": { "schema": { "type": "object", "required": [ "period", "facets" ], "properties": { "period": { "type": "object", "required": [ "startDate", "endDate" ], "properties": { "startDate": { "type": "string", "format": "date-time" }, "endDate": { "type": "string", "format": "date-time" } } }, "facets": { "type": "object", "required": [ "agent", "user", "api_key", "group", "model", "tool", "skill", "source" ], "properties": { "agent": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } }, "user": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } }, "api_key": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } }, "group": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } }, "model": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } }, "tool": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } }, "skill": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } }, "source": { "type": "array", "items": { "$ref": "#/components/schemas/PrivateConsumptionFacet" } } } } } } } } }, "400": { "description": "Invalid request body" }, "403": { "description": "Not authorized for this analytics view" }, "500": { "description": "Failed to retrieve consumption facets" } }, "x-counso-auth": "user" } } }, "components": { "securitySchemes": { "WorkspaceApiKey": { "type": "http", "scheme": "bearer", "description": "A workspace API key issued by this Counso deployment. Permissions and resource access are checked for each operation." }, "UserAccessToken": { "type": "http", "scheme": "bearer", "description": "A user OAuth access token issued for this Counso deployment. A workspace API key is not a substitute for a user token." }, "BrowserSession": { "type": "apiKey", "in": "cookie", "name": "workos_session", "description": "The signed-in Counso browser session. External clients should use a user access token." } }, "schemas": { "PrivateConsumptionFacet": { "type": "object", "required": [ "value", "label", "pictureUrl", "documentCount", "disabled" ], "properties": { "value": { "type": "string", "description": "Raw indexed value accepted by the corresponding consumption filter." }, "label": { "type": "string", "description": "Human-readable label, falling back to the raw value when its resource was deleted." }, "pictureUrl": { "type": "string", "nullable": true }, "icon": { "type": "string", "nullable": true, "description": "Design-system icon name for tool and skill facets when known." }, "documentCount": { "type": "integer", "minimum": 0, "description": "Number of matching indexed documents after applying the selected period and every other facet." }, "disabled": { "type": "boolean", "description": "Whether selecting this value would produce no matching indexed document." }, "scope": { "type": "string", "enum": [ "global", "visible", "hidden" ], "description": "Current agent scope, when the agent still has accessible configuration metadata." }, "maker": { "type": "string", "description": "Model maker, for known model facets." }, "tier": { "type": "string", "enum": [ "cost_efficient", "balanced", "premium" ], "description": "Default reasoning-effort tier, for known model facets." } } } } } } ```