数安云智数据分类分级同步接口

这是一个用于批量处理字段信息分类分级的同步接口服务。

接口信息

接口地址: http://localhost:8080/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync
认证方式: Bearer Token
Content-Type: application/json

环境变量配置

方式一：环境变量

# ~/.zshrc
export SHUYAN_API_KEY="your-api-key-here"
export SHUYAN_API_URL="http://localhost:8080"

方式二：OpenClaw配置

在 ~/.openclaw/openclaw.json 中配置：

{
  "skills": {
    "entries": {
      "shuyan-data-classification": {
        "enabled": true,
        "apiKey": "your-api-key-here",
        "apiUrl": "http://localhost:8080"
      }
    }
  }
}

使用场景

✅ USE this skill when:

需要对数据库字段进行敏感数据分类
需要识别数据敏感级别
需要批量处理数据分类分级
需要获取分类理由和置信度

❌ DON'T use this skill when:

单个字段的实时查询（效率较低）
历史数据分析

请求格式

请求参数说明

| 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | colNameCh | string | 否 | 字段中文名 | | colNameComment | string | 否 | 字段含义 | | colNameEn | string | 否 | 字段英文名 | | projectName | string | 否 | 业务系统 | | sampleList | array | 否 | 字段样例 | | sizeInBytes | integer | 否 | 数据大小（字节） | | standardCode | string | 是 | 分类标准代码 | | tableNameCh | string | 否 | 表中文名 | | tableNameEn | string | 否 | 表英文名 | | sensitivityLevelRedisKey | string | 否 | 分级标准代码 | | dataSize | string | 否 | 数据量 | | isDesensitize | integer | 否 | 是否脱敏（0: 未脱敏, 1: 已脱敏） |

命令示例

批量分类分级同步

API_KEY="${SHUYAN_API_KEY:-your-api-key-here}"
API_URL="${SHUYAN_API_URL:-http://localhost:8080}"

curl -s -X POST "${API_URL}/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "colNameCh": "用户姓名",
      "colNameComment": "用户的真实姓名",
      "colNameEn": "user_name",
      "projectName": "用户管理系统",
      "sampleList": ["张三", "李四", "王五"],
      "sizeInBytes": 1024,
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "tableNameCh": "用户表",
      "tableNameEn": "user",
      "sensitivityLevelRedisKey": "fenji_standard",
      "dataSize": "10000",
      "isDesensitize": 0
    },
    {
      "colNameCh": "身份证号",
      "colNameComment": "用户的身份证号码",
      "colNameEn": "id_card",
      "projectName": "用户管理系统",
      "sampleList": ["110101199001011234"],
      "sizeInBytes": 2048,
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "tableNameCh": "用户表",
      "tableNameEn": "user",
      "sensitivityLevelRedisKey": "fenji_standard",
      "dataSize": "10000",
      "isDesensitize": 1
    }
  ]'

响应格式

成功响应

{
  "code": 200,
  "message": "Batch processing completed successfully",
  "result": [
    {
      "colNameCh": "用户姓名",
      "colNameComment": "用户的真实姓名",
      "colNameEn": "user_name",
      "confidence": 0,
      "itemName": "个人基本信息",
      "label": ["客户", "个人", "个人自然信息", "个人基本概况信息"],
      "projectName": "用户管理系统",
      "reasoningProcess": "字段含义为用户的真实姓名，属于个人基本情况数据",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "tableNameCh": "用户表",
      "tableNameEn": "user",
      "sensitivityLevel": 2
    }
  ]
}

响应字段说明

| 字段名 | 类型 | 描述 | |--------|------|------| | code | integer | 响应状态码（200: 成功, 500: 失败） | | message | string | 响应消息 | | result | array | 处理结果列表 |

结果项字段说明

| 字段名 | 类型 | 描述 | |--------|------|------| | colNameCh | string | 字段中文名 | | colNameComment | string | 字段含义 | | colNameEn | string | 字段英文名 | | confidence | integer | 置信度 | | itemName | string | 业务类型 | | label | array | 分类标签列表 | | projectName | string | 业务系统 | | reasoningProcess | string | 分类理由 | | standardCode | string | 标准代码 | | tableNameCh | string | 表中文名 | | tableNameEn | string | 表英文名 | | sensitivityLevel | integer | 敏感度等级（1-5，5为最高） |

敏感度等级说明

| 等级 | 说明 | |------|------| | 1 | 一般数据 | | 2 | 重要数据 | | 3 | 核心数据 | | 4 | 敏感数据 | | 5 | 绝密数据 |

错误处理

常见错误：

| 错误信息 | 原因 | |----------|------| | No result returned from batch processing | 批量处理没有返回结果 | | Result is not a list | 返回结果不是列表格式 | | batch processing result length mismatch | 处理结果数量与输入数量不匹配 |

常见使用示例

示例1：用户信息表分类

curl -s -X POST "http://localhost:8080/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync" \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "colNameCh": "手机号",
      "colNameComment": "用户联系电话",
      "colNameEn": "phone",
      "projectName": "用户系统",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "sensitivityLevelRedisKey": "fenji_standard"
    }
  ]'

示例2：金融数据分类

curl -s -X POST "http://localhost:8080/api/llm_infer_zh_and_cls_and_type_v2_batchdata_sync" \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "colNameCh": "银行账号",
      "colNameComment": "银行账户号码",
      "colNameEn": "bank_account",
      "projectName": "金融系统",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "sensitivityLevelRedisKey": "fenji_standard"
    },
    {
      "colNameCh": "交易金额",
      "colNameComment": "交易金额",
      "colNameEn": "amount",
      "projectName": "金融系统",
      "standardCode": "llm_infer_zh_and_cls_and_type_v2_test",
      "sensitivityLevelRedisKey": "fenji_standard"
    }
  ]'

注意事项

接口为同步处理，处理时间可能较长
建议批量处理时控制单次请求数量（建议不超过100条）
接口会自动对失败的字段进行重试