查看知识库标签列表

读取当前工作区可读取知识库的标签统计。

GET https://api.moi.matrixorigin.cn/v5/semantic-models/tags

调用前准备

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求参数

curl "https://api.moi.matrixorigin.cn/v5/semantic-models/tags?search=product" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

字段

类型

必填

说明

search

string

否

仅统计与该搜索条件匹配的知识库标签。

成功响应

成功时返回 200。data.items 为标签统计列表。

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "items": [
      {
        "tag": "product",
        "count": 3
      },
      {
        "tag": "support",
        "count": 1
      }
    ]
  }
}

字段

类型

说明

code

string

成功时为 OK。

msg

string

成功时为 OK。

data

object

查询结果。

下面表格展开响应示例中 data 对象；每一行是该对象的一个字段。

字段

类型

说明

items

array of object

标签统计列表；没有标签时为空数组。

下面表格展开响应示例中 data.items 数组的每一项；每一行是该数组项的一个字段。

字段

类型

说明

tag

string

标签名称。

count

integer

当前调用者可读取的、带有该标签的知识库数量。

错误响应

{
  "code": "ErrForbidden",
  "msg": "permission denied",
  "data": null
}

字段

类型

说明

code

string

错误代码。

msg

string

面向调用者的错误信息。

data

null

发生错误时为 null。

后续操作

按标签筛选查询知识库列表。

最后更新于