| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 否 | 配置名 |
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 否 | 配置名 |
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | 配置名称 |
| filePath | string | 是 | 文件存储路径 |
| accesskeyId | string | 是 | accesskey id |
| accesskeySecret | string | 是 | accesskey secret |
| endpoint | string | 是 | Oss 的节点 |
| bucketName | string | 是 | oss 的 bucket 名 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | 配置名称 |
| filePath | string | 是 | 文件存储路径 |
| accesskeyId | string | 是 | accesskey id |
| accesskeySecret | string | 是 | accesskey secret |
| endpoint | string | 是 | S3 的节点 |
| bucketName | string | 是 | S3 的 bucket 名 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | 配置名称 |
| filePath | string | 是 | 文件存储路径 |
| accesskeyId | string | 是 | Azure 的 account name |
| accesskeySecret | string | 是 | azure 的 account key |
| containerName | string | 是 | Azure 的 container 名 |
| accountType | string | 是 | Azure 的 accountType |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | 配置名称 |
| filePath | string | 是 | 文件存储路径 |
| endpoint | string | 是 | 存储节点 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | 数据集名字 |
| alias | string | 否 | 数据集别名 |
| type | int | 否 | 默认是0，0-普通数据集,1-融合数据集 |
| configName | string | 否 | 云配置名，根据对应配置创建数据集 |
| isPublic | bool | 否 | 数据集是否公开, 默认不公开 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 否 | dataset 名称, 如果传值不可为“”空值 |
| alias | string | 否 | 数据集别名 |
| isPublic | bool | 否 | 数据集是否公开，true 对应公开， false 对应私有 |
| defaultBranch | string | 否 | 数据集默认分支名 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| name | string | 否 | 数据集名称 |
| needFuzzyQuery | bool | 否 | 默认false 若为true，则支持数据集名称模糊搜索 |
| needTeamDataset | bool | 否 | 默认false，当用户为团队用户且该值为true，则返回整个团队的数据集 |
| sortBy | string | 否 | 排序的字段，默认updated_at（更新时间）, 目前支持created_at（创建时间）和updated_at,传入其他内容会返回InvalidParamsValue |
| orderBy | string | 否 | 默认desc（倒序），合法内容为asc（顺序）和desc |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | 创建的branch名称 |
| commit | string | 是 | 从哪个commit切出branch, commit 可为 commit id, commit tag 或者 branch name |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | branch名称 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| name | string | 否 | 分支名 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| title | string | 是 | 草稿名称 |
| branchName | string | 否 | branch 名称，缺省branch为main |
| description | string | 否 | 草稿描述 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| title | string | 否 | 草稿名称 |
| description | string | 否 | 草稿描述 |
| status | string | 否 | 草稿状态, OPEN 或者 CLOSED |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| branchName | string | 否 | 基于数据分支名进行筛选 |
| status | string | 否 | 基于状态进行筛选，支持 "OPEN", "COMMITTED", "CLOSED" 和 "ALL"，默认为"OPEN" |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| title | string | 是 | 提交信息,字符数量应小于255 |
| description | string | 否 | 描述 |
| tag | string | 否 | 数据集版本标签，字符数量应大于2小于80 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| commit | string | 否 | commit id 或者 commit tag 或者 branch name, 缺省为默认branch |
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| commit | string | 是 | commit id 或者 commit tag 或者 branch name |
| name | string | 是 | tag 名称,字符数量应大于2小于80 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 是 | tag 名称 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| name | string | 否 | tag 名称,若存在，返回该tag信息 |
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | draft 序号 |
| binPointCloudFields | string[] | 否 | bin格式点云的维度名称 |
| isContinuous | bool | 否 | 是否连续 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | 当commit不为空且正确时，查询该commit的data数据 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| datasetId | string | 是 | 数据集Id |
| commitId | string | 是 | commit Id |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| datasetId | string | 是 | 数据集Id |
| commitId | string | 是 | 提交 ID |
| name | string | 是 | 需求订单名称 |
| deliveryTime | string | 是 | 交付时间 例如 2021-12-14 |
| labelType | string | 是 | 标注类型 例如 BOX2D |
| serviceProvider | string | 否 | 服务商名称 例如 格物钛 |
| requirementDocumentUrl | string | 否 | 需求文档地址 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| title | string | 是 | 任务标题 |
| jobType | string | 是 | 任务类型 squashAndMerge,basicSearch |
| description | string | 否 | 任务描述 |
| maxRetries | int | 否 | 任务最大重试次数 |
| arguments | map | 否 | 任务参数 squashAndMerge |
| ├-sourceBranchName | string | 是 | 源分支 |
| ├-targetBranchName | string | 是 | 目标分支 |
| ├-strategy | string | 否 | 当不是用已有操作时移动重名时的策略，可选项有：abort，override 和 skip，缺省为 abort |
| ├-title | string | 是 | 标题 |
| ├-description | string | 否 | 描述 |
| arguments | map | 否 | 任务参数 basicSearch |
| ├-commit | string | 是 | commit ID |
| ├-tag | string | 否 | tag名 |
| ├-branch | string | 否 | 分支名 |
| ├-draft | string | 否 | 草稿编号 |
| ├-unit | string | 是 | 搜索单位 file, frame |
| ├-segmentNames | string[] | 是 | segment 名字列表 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| jobType | string | 否 | 任务类型 squashAndMerge,basicSearch |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| jobType | string | 否 | 任务类型 squashAndMerge,basicSearch |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| jobType | string | 否 | 任务类型 squashAndMerge,basicSearch |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| jobType | string | 否 | 任务类型 squashAndMerge,basicSearch |
| status | string | 否 | Job状态, FAILED, SUCCESS |
| limit | int | 否 | 需大于0，默认128，单次最多获取128 |
| offset | int | 否 | 默认0 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| jobType | string | 否 | 任务类型 squashAndMerge,basicSearch |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 否 | 数据集分割区 |
| isInternal | bool | 否 | 是否返回内网上传地址 |
| expired | int | 否 | 令牌过期时间，以秒为单位，不可为负，默认60, 大于300会按照300处理 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| OSSAccessKeyId | string | 是 | 与之前获取的凭证返回值OSSAccessKeyId一致 |
| Signature | string | 是 | 与之前获取的凭证返回值Signature一致 |
| policy | string | 是 | 与之前的获取凭证返回的policy一致 |
| key | string | 是 | 之前的获取凭证返回的objectPrefix + 计算文件的cheksum值。用sha1加密算法获取文件checksum值 |
| file | file | 是 | 文件 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| checksum | string | 是 | 上传的文件的checksum,用sha1加密算法获取文件checksum值 |
| segmentName | string | 是 | segment 名称 |
| remotePath | string | 是 | 远程的文件路径，例如a.jpg |
| sensorName | string | 否 | 融合类数据上传必传，传感器名称 |
| frameId | string | 否 | 融合类数据上传必传,帧id, ulid格式，参考 https://github.com/oklog/ulid |
| timestamp | float | 否 | 融合类数据上传非必传 |
| label | map | 否 | 该文件的标注标签信息，具体可参考uploadLabel |
| fileSize | int | 否 | 文件大小, 若未传，服务端将计算文件大小 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| objects | []object | 是 | 批量回调的object |
| ├─checksum | string | 是 | 上传的文件的checksum,用sha1加密算法获取文件checksum值 |
| ├─remotePath | string | 是 | 远程的文件路径，例如a.jpg |
| ├─sensorName | string | 否 | 融合类数据上传必传，传感器名称 |
| ├─frameId | string | 否 | 融合类数据上传必传,帧id, ulid格式，参考 https://github.com/oklog/ulid |
| ├─timestamp | float | 否 | 融合类数据上传非必传 |
| ├─label | map | 否 | 该文件的标注标签信息，具体可参考uploadLabel |
| ├─fileSize | int | 否 | 文件大小, 若未传，服务端将计算文件大小 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| move | bool | 否 | 从已有剪切创建 |
| copy | bool | 否 | 从已有复制创建 |
| multipleMove | bool | 否 | 从多个已有剪切创建 |
| multipleCopy | bool | 否 | 从多个已有复制创建 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| name | string | 否 | segment 名称, 当不是用已有操作时 不可为null,name中不可包含".","\" |
| description | string | 否 | segment 描述 |
| strategy | string | 否 | 当不是用已有操作时移动重名时的策略，可选项有：abort，override 和 skip，缺省为 abort |
| segmentName | string | 否 | 目标数据分段名, 从已有单个创建时使用 |
| segmentNames | string[] | 否 | 目标数据分段名, 从已有多个创建时使用 |
| source | object | 否 | 来源数据分段, 从已有单个创建时使用且必须 |
| ├─ segmentName | string | 否 | 分区名 |
| ├─ id | string | 否 | 数据集id |
| ├─ draftNumber | int | 否 | 草稿编号 |
| ├─ commit | string | 否 | commitId或者commit的tag |
| source | object | 否 | 来源数据分段, 从已有多个创建时使用且必须 |
| ├─ segmentName | string[] | 否 | 分区名 列表 |
| ├─ id | string | 否 | 数据集id |
| ├─ draftNumber | int | 否 | 草稿编号 |
| ├─ commit | string | 否 | commitId或者commit的tag |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| limit | int | 否 | 默认128，单次最多128 |
| offset | int | 否 | 默认0 |
| sortBy | string | 否 | 排序的字段，默认update_at（更新时间）, 目前支持create_at（创建时间）和update_at,传入其他内容会返回InvalidParamsValue |
| orderBy | string | 否 | 默认desc（倒序），合法内容为asc（顺序）和desc |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| catalog | map | 是 | 标注类型。 key: CLASSIFICATION: 分类标注 BOX2D: 2D 框标注 BOX3D: 3D 框标注 POLYGON2D: 2D 多边形标注 POLYLINE2D: 2D 折线标注 KEYPOINTS2D: 2D 关键点标注 CUBOID2D: 2D 立体框标注 SENTENCE: 语音转写标注 以上标注类型，每类标注类型都有自己的结构，具体可看示例或参考标签格式，请严格遵循该标注类型格式传值 |
| ├─description | string | 否 | 描述 |
| ├─categoryDelimiter | string | 否 | 用于分割category父子关系的分割符，缺省为不支持父子关系，推荐分隔符为"." |
| ├─isTracking | bool | 否 | 是否是追踪 |
| ├─categories | object[] | 否 | item 类型: object，category 列表，包含所有 category 信息 |
| ├─name | string | 是 | category 名称 |
| ├─description | string | 否 | category 描述 |
| ├─attributes | object[] | 否 | item 类型，包含属性相关信息 |
| ├─name | string | 是 | attribute 名称 |
| ├─type | string/string[] | 否 | attribute type:string, boolean, integer, number, array, null,例如"interger", ["integer", "null"] |
| ├─minimum | float | 否 | 属性值最小值，当属性为数字时该字段定义了其最小值(闭区间) |
| ├─maximum | float | 否 | 属性值最大值，当属性为数字时该字段定义了其最大值(闭区间) |
| ├─description | string | 否 | 属性描述 |
| ├─enum | string[] | 否 | 属性值选项，表示该属性所有的可能的选项 |
| ├─parentCategories | string[] | 否 | 关联类别，表示该属性隶属于哪些类别，为空则表示全局属性 |
| ├─items | object[] | 否 | item类型,多选属性定义，(当"type"字段为"array"时，表示多选属性) |
| ├─type | string/string[] | 否 | 多选属性值类型:string, boolean, integer, number, array, null,例如"interger", ["integer", "null"] |
| ├─minimum | float | 否 | 多选属性值最小值(闭区间) |
| ├─maximum | float | 否 | 多选属性值最大值(闭区间) |
| ├─enum | string[] | 否 | 多选属性值选项，表示该属性所有的可能的选项 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| name | string | 是 | sensor 名称 |
| type | string | 是 | sensor 类型 |
| description | string | 否 | 描述 |
| extrinsics | object | 否 | sensor 外参 |
| ├─rotation | object | 否 | 旋转矩阵 |
| ├─w | float | 是 | w |
| ├─x | float | 是 | x |
| ├─y | float | 是 | y |
| ├─z | float | 是 | z |
| ├─translation | object | 否 | 平移矩阵 |
| ├─x | float | 是 | x |
| ├─y | float | 是 | y |
| ├─z | float | 是 | z |
| intrinsics | object | 否 | sensr 内参（仅相机类设备需要提供内参） |
| ├─cameraMatrix | object | 否 | |
| ├─cx | float | 是 | cx |
| ├─cy | float | 是 | cy |
| ├─fx | float | 是 | fx |
| ├─fy | float | 是 | fy |
| ├─skew | float | 否 | skew |
| ├─distortionCoefficients | object | 否 | 畸变系数 (p1, p2, k1, k2, k3,还可以有"k4", "k5", "k6"等等，给的越多计算越精确) |
| ├─p1 | float | 否 | p1 |
| ├─p2 | float | 否 | p2 |
| ├─k1 | float | 否 | k1 |
| ├─k2 | float | 否 | k2 |
| ├─k3 | float | 否 | k3 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| sensorName | string | 是 | sensor 名称 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| segmentName | string | 是 | segment 名称 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| segmentName | string | 是 | segment 名称 |
| limit | int | 否 | 默认128，单次最高128 |
| offset | int | 否 | 默认0 |
| sortBy | string | 否 | 排序的字段，默认updated_at（更新时间）, 目前支持created_at（创建时间）和updated_at,传入其他内容会返回InvalidParamsValue |
| orderBy | string | 否 | 默认desc（倒序），合法内容为asc（顺序）和desc |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| segmentName | string | 是 | segment 名称 |
| remotePath | string | 否 | 数据路径名 |
| isInternal | bool | 否 | 是否返回内网上传地址 |
| limit | int | 否 | 默认128，单次最高128 |
| offset | int | 否 | 默认0 |
| sortBy | string | 否 | 排序的字段，默认updated_at（更新时间）, 目前支持created_at（创建时间）和updated_at,传入其他内容会返回InvalidParamsValue |
| orderBy | string | 否 | 默认desc（倒序），合法内容为asc（顺序）和desc |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| remotePath | string | 否 | 数据路径，若传值，则查询具体此数据的url |
| segmentName | string | 是 | 数据所在分区 |
| limit | int | 否 | 默认128，单次最高128 |
| offset | int | 否 | 默认0 |
| isInternal | bool | 否 | 是否返回内网地址 |
| sortBy | string | 否 | 排序的字段，默认按照名字（remotePath）排序, 目前支持created_at（创建时间）和updated_at,传入其他内容会返回InvalidParamsValue |
| orderBy | string | 否 | 默认desc（倒序），合法内容为asc（顺序）和desc |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| segmentName | string | 是 | segment 名称 |
| remotePath | string | 否 | 数据路径名 |
| maskType | string | 是 | mask 标注类型，可选项有 "SEMANTIC_MASK", "INSTANCE_MASK" 和 "PANOPTIC_MASK" |
| isInternal | bool | 否 | 是否返回内网上传地址 |
| limit | int | 否 | 默认128，单次最高128 |
| offset | int | 否 | 默认0 |
| sortBy | string | 否 | 排序的字段，默认updated_at（更新时间）, 目前支持created_at（创建时间）和updated_at,传入其他内容会返回InvalidParamsValue |
| orderBy | string | 否 | 默认desc（倒序），合法内容为asc（顺序）和desc |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| commit | string | 是 | commit id 或者 commit tag 或者 branch name |
| remotePaths | map | 是 | 根据数据分段名分组的数据路径，键为数据分段名，值为数据路径列表 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| commit | string | 是 | commit id 或者 commit tag 或者 branch name |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| prefix | string | 否 | 授权云存储前缀名 |
| marker | string | 否 | 翻页标示符 |
| limit | int | 否 | 查询结果的数量 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| filePath | string | 是 | 数据远端路径 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| segmentName | string | 是 | 数据分段名 |
| deleteSource | bool | 是 | 是否删除源文件 |
| draftNumber | int | 是 | 草稿编号 |
| objects | object[] | 是 | 对应的数据信息 |
| ├─cloudPath | string | 是 | 数据所在云存储路径 |
| ├─remotePath | string | 是 | 数据远端路径 |
| ├─sensorName | string | 否 | 传感器名称，融合类数据上传必传 |
| ├─frameId | string | 是 | 融合数据帧 ID, ulid 格式，参考 https://github.com/oklog/ulid, 融合类数据上传必传 |
| ├─label | map | 是 | 该文件的标注标签信息，具体可参考uploadLabel |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| remotePath | string | 是 | 对应的资源 |
| label | map | 是 | 标签。 key: CLASSIFICATION: 分类标注 BOX2D: 2D 框标注 BOX3D: 3D 框标注 POLYGON2D: 2D 多边形标注 POLYLINE2D: 2D 折线标注 KEYPOINTS2D: 2D 关键点标注 CUBOID2D: 2D 立体框标注 SENTENCE: 语音转写标注 每种key对应的value格式内容请参考请求示例，请严格按照对应格式传递参数 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| limit | int | 否 | 默认128，单次最多128 |
| offset | int | 否 | 默认0 |
| segmentName | string | 是 | segment 名称 |
| remotePath | string | 否 | remotePath |
| sortBy | string | 否 | 排序的字段，默认updated_at（更新时间）, 目前支持created_at（创建时间）和updated_at,传入其他内容会返回InvalidParamsValue |
| orderBy | string | 否 | 默认desc（倒序），合法内容为asc（顺序）和desc |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| objects | object[] | 是 | 对应的数据信息 |
| ├─remotePath | string | 是 | 对应的资源 |
| ├─label | map | 是 | 该文件的标注标签信息，具体可参考uploadLabel |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 否 | 草稿编号,draft和commit二者必须存在一个，但不可全部存在 |
| commit | string | 否 | commit id 或者 commit tag 或者 branch name |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| commit | string | 是 | 提交 ID |
| labelUrl | string | 是 | 标签下载链接 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| remotePath | string | 是 | 需要删除的数据远端的路径列表 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| move | bool | 否 | 从已有剪切创建 |
| copy | bool | 否 | 从已有复制创建 |
| multipleMove | bool | 否 | 从多个已有剪切创建 |
| multipleCopy | bool | 否 | 从多个已有复制创建 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 否 | segment 名称, |
| strategy | string | 否 | 移动重名时的策略，可选项有：abort，override 和 skip，缺省为 abort |
| remotePath | string | 否 | 数据远端路径, 单个操作时使用 |
| remotePaths | string[] | 否 | 数据远端路径列表, 多个操作时使用 |
| source | object | 是 | 来源数据, 单个操作时使用 |
| ├─ segmentName | string | 否 | 分区名 |
| ├─ remotePath | string | 否 | 数据远端路径 |
| ├─ id | string | 否 | 数据集id |
| ├─ draftNumber | int | 否 | 草稿编号 |
| ├─ commit | string | 否 | commitId或者commit的tag |
| source | object | 否 | 来源数据分段, 多个操作时使用 |
| ├─ segmentName | string | 否 | 分区名 |
| ├─ remotePaths | string[] | 否 | 数据远端路径列表 |
| ├─ id | string | 否 | 数据集id |
| ├─ draftNumber | int | 否 | 草稿编号 |
| ├─ commit | string | 否 | commitId或者commit的tag |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| draftNumber | int | 是 | 草稿编号 |
| segmentName | string | 是 | segment 名称 |
| frameId | string | 是 | 需要删除的融合数据帧的 ULID |
| 名称 | 是否必须 | 描述 |
|---|---|---|
| id | 是 | 数据集ID |
| baseHead | 是 | 格式为 commit-commitId/draft-draftNumber...commit-commitId/draft-draftNumber, 后者没传默认找父提交，目前只需要支持与父提交的比较 |
| 名称 | 是否必须 | 描述 |
|---|---|---|
| id | 是 | 数据集ID |
| baseHead | 是 | 格式为 commit-commitId/draft-draftNumber...commit-commitId/draft-draftNumber, 后者没传默认找父提交，目前只需要支持与父提交的比较 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| limit | int | 否 | 默认128，单次最多128 |
| offset | int | 否 | 默认0 |
| 名称 | 是否必须 | 描述 |
|---|---|---|
| id | 是 | 数据集ID |
| baseHead | 是 | 格式为 commit-commitId/draft-draftNumber...commit-commitId/draft-draftNumber, 后者没传默认找父提交，目前只需要支持与父提交的比较 |
| segmentName | 是 | 数据分段名 |
| 名称 | 是否必须 | 描述 |
|---|---|---|
| id | 是 | 数据集ID |
| baseHead | 是 | 格式为 commit-commitId/draft-draftNumber...commit-commitId/draft-draftNumber, 后者没传默认找父提交，目前只需要支持与父提交的比较 |
| segmentName | 是 | 数据分段名 |
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| limit | int | 否 | 默认128，单次最多128 |
| offset | int | 否 | 默认0 |
可以进入数据详情页看到该版本的详细数据。
* 通过版本管理，您可以便捷地对您需要的数据版本进行Commit，并详细查看所有历史Commit的数据以及数据集信息，详情请查看：
{% content-ref url="/pages/-MWTwpDTHZ1jkXGiySfi" %}
[数据版本管理](/guide/tensorbay/version)
{% endcontent-ref %}
## 使用TensorBay上的数据
* 通过开发者工具，包括Python SDK、CLI与Open API，读取您的在TensorBay上准备的数据集，与您的Pipeline快速集成。
{% content-ref url="/pages/-MWUBpTrcMvPUyNWXhPg" %}
[如何与Pipeline集成](/guide/tensorbay/pipeline)
{% endcontent-ref %}
# 快速入门 - 团队版
## 进入TensorBay
* 登录您的账户，在右上方导航栏中切换您的工作空间，切换到您需要进入的团队空间。如果您还没有任何团队空间，可以选择【创建团队】或者联系您的团队管理员申请加入您的团队空间。具体团队协作可查看[：](/guide/tensorbay/collaboration)
{% content-ref url="/pages/-MWU98FNcG0isRpPVbLm" %}
[团队协作](/guide/tensorbay/collaboration)
{% endcontent-ref %}
## 创建您的团队空间
* 在GAS控制台首页或顶部导航栏您的空间列表中，点击【新建团队】进入团队创建页面，详情可见[创建团队空间](/guide/tensorbay/collaboration/create)。
{% content-ref url="/pages/-MWU9NDPoGxjbX8fN1vH" %}
[创建团队空间](/guide/tensorbay/collaboration/create)
{% endcontent-ref %}
* 进入【新建团队】页面，填写您的团队信息，并邀请您的团队成员加入团队。
* 点击【下一步】，填写团队信息。团队创建者默认为该团队的超级管理员，您可以在【团队信息】页面添加团队成员。您也可以点击【稍后进行】，跳过填写团队信息的步骤。
* 您可以对该团队的人员和数据进行管理，包括团队资料管理、团队成员管理、团队资产管理等，详情可见[：](/guide/tensorbay/collaboration/manage)
{% content-ref url="/pages/-MWUAA1fBV9ISayqDQ9M" %}
[资料/成员管理](/guide/tensorbay/collaboration/manage)
{% endcontent-ref %}
* 团队创建成功后，将进入您的团队空间首页，您可在此清晰地了解当前团队的数据使用概况，即数据集的数量，数据托管和授权存储使用的容量，以及数据使用流量。
{% hint style="info" %}
您的个人工作空间和所加入的不同的团队工作空间中的数据以及权限互相独立，无法互通使用。
{% endhint %}
* 在团队空间主页和团队数据集主页，可以查看您和您的团队成员在TensorBay团队空间上的所有操作历史，包括对团队数据集、团队数据的操作详情。
{% content-ref url="/pages/-MYsv-O9e6k2jFM4vtjn" %}
[团队活动日志](/guide/tensorbay/collaboration/log)
{% endcontent-ref %}
## 快速新建团队数据集
* 您可通过首页的快速导航【新建】或顶部导航栏【团队数据集】点击进入您团队的TensorBay空间，选择【新建数据集】开始您的团队的数据之旅。
* 进入【新建数据集】页面，填写数据集名称，选择数据集的存储配置以及可见范围，即可创建新的团队数据集。
* 更多关于新建数据集及存储配置的信息，详情请查看：
{% content-ref url="/pages/-MWSde6OncKl1OKYrLD\_" %}
[新建数据集](/guide/tensorbay/data/create)
{% endcontent-ref %}
* 【确认创建】数据集后，将自动创建Draft-1，并将Draft-1建在默认分支(main)上。然后进入【上传数据】，创建Segment，即可将数据上传至指定Segment中，支持本地上传和开发者工具上传两种方式。
* 点击【确定】，进入版本信息页面。填写**commit信息**和**Tag**，对当前数据创建版本。仅Commit后的数据集可用于标注、训练等数据的后续使用。
* 点击【commit】，新建数据集成功。
## 数据集版本管理
* 每次完成【Commit】后，将进入团队数据集详情页，在左侧版本列表中点击【查看所有Tags】，可浏览所有的Commits记录。
* 在Commits记录中，您可以查看所有的历史版本信息；点击版本右侧的可以进入数据详情页看到该版本的详细数据。
* 通过版本管理，您可以便捷地对您需要的数据版本进行Commit，并详细查看所有历史Commit的数据以及数据集信息，详情请查看：
{% content-ref url="/pages/-MWTwpDTHZ1jkXGiySfi" %}
[数据版本管理](/guide/tensorbay/version)
{% endcontent-ref %}
## 使用TensorBay上的数据
* 您和您的团队成员，可通过开发者工具，包括Python SDK、CLI与Open API，读取您的在TensorBay上准备的数据集，与您的Pipeline快速集成。
{% content-ref url="/pages/-MWUBpTrcMvPUyNWXhPg" %}
[如何与Pipeline集成](/guide/tensorbay/pipeline)
{% endcontent-ref %}
# 数据集准备
TensorBay为您提供多种方式快速准备您的数据集，您可选择您需要的方式完成创建数据集。
* 直接创建新的数据集
{% content-ref url="/pages/-MWSde6OncKl1OKYrLD\_" %}
[新建数据集](/guide/tensorbay/data/create)
{% endcontent-ref %}
* 通过云存储授权的方式高效地管理云端数据
{% content-ref url="/pages/-MWTrNbO2kD-IMDSp3hQ" %}
[管理云服务上的数据](/guide/tensorbay/data/authorize)
{% endcontent-ref %}
* 在已有的数据集中通过筛选数据创建新的数据集
{% content-ref url="/pages/-MWTuv-6QotRKpZJWYq6" %}
[利用数据集筛选快速新建](/guide/tensorbay/data/filter)
{% endcontent-ref %}
* 通过合并已有数据集创建新的数据集
{% content-ref url="/pages/-MWTvc6LNV7VXjv1wo2R" %}
[数据合并拆分及复制移动](/guide/tensorbay/data/merge)
{% endcontent-ref %}
* 通过Fork公开数据集创建新的数据集
{% content-ref url="/pages/-MWTwA3J7wOyGexlgLzK" %}
[通过Fork使用公开数据集](/guide/tensorbay/data/fork)
{% endcontent-ref %}
TensorBay支持两种数据集存储方式：
* 默认存储：您的数据将存储在TensorBay云端存储（阿里云OSS）中，并且为每位注册用户提供100GB的免费存储空间。
* 授权云存储：如果您的数据原本存储在其他公有云存储中，您可以通过公有云的授权使用方式，将权限关联的密钥提供给TensorBay，授权TensorBay管理您的云端数据。通过[管理授权配置](/guide/tensorbay/data/authorize#4)轻松托管云端数据。
# 新建数据集
您可使用【格物钛存储】的方式，将数据上传至TensorBay；也可使用【授权存储】的方式，授权TensorBay管理您存储在其他云服务器上的数据。
## 新建数据集
* 在顶部导航栏点击【我的数据集】（个人开发者）或【团队数据集】（团队开发者），选择【新建数据集】下拉框中的【新建数据集】进行数据集新建。
### 创建名称&别名
* 填写数据集名称、别名（选填），系统将根据数据集名称生成该数据集的URL。数据集名称和别名均可更改。
### 选择存储配置
* 选择【存储配置】，选择或创建您的数据存储方式，并将数据上传至对应的存储空间（注意：这将占用您的格物钛存储或授权存储空间）
### 新增数据存储配置
* 若下拉栏中的存储配置不符合您的存储需求，可以点击【新增数据存储配置】新增存储方式。
* **个人开发者**仅支持选择【格物钛存储】，并且选择存储区域，将数据上传至您在TensorBay上的私有存储空间（注意：这将占用您的默认存储空间）
* 除了【格物钛存储】，**团队开发者**也支持选择【授权存储】，TensorBay将通过授权方式读取和管理您在其他云服务器上的数据，该操作不占用您的默认存储空间，但会占用授权存储空间。在填写相应配置信息后，支持通过授权方式使用您在阿里云OSS、亚马逊S3以及Azure Blob上的数据。详情请参照[如何管理您在云存储上的数据](/guide/tensorbay/data/authorize)。
{% content-ref url="/pages/-MWTrNbO2kD-IMDSp3hQ" %}
[管理云服务上的数据](/guide/tensorbay/data/authorize)
{% endcontent-ref %}
### 选择可见范围
* 选择【公开】，则表示您的数据集的数据将对社区用户开放，任何人都可以搜索、查看、查询和Fork此公开数据集中的所有数据。格物钛支持您对开源社区的贡献，将为您公开的数据集提供不限额的免费存储容量。
* 选择【私有】，则表示这是您的私有数据集，任何人将无权访问，仅您可以控制数据集的查看和使用权限。若您创建私有的团队数据集，则默认您的团队成员可搜索和查看您所创建的数据集的基本信息，您可以控制哪些团队成员可查看、使用、编辑或管理您所创建的团队数据集的数据。
## 添加数据
* 数据集新建成功后，会自动默认新建一个main Branch，并在此branch上默认新建一个draft，并进入【上传数据界面】。
* 您可以将数据上传至指定Segment中（文件上传需先新建segment），数据上传支持【本地上传】、【通过开发者工具上传】这两种方式。
* 您也可以点击【跳过】，直接进入【Commit Draft】界面。
### 本地上传
* 选择【本地上传】，您可将本地文件夹拖入页面中，或在本地目录中选择多个需要上传的数据。数据添加完成后点击【开始传输】，TensorBay则会将数据从您的本地读取后直传至您的私有云存储空间中。在传输未完成前，请不要离开传输界面，否则会造成剩余数据传输失败。
### **通过开发者工具上传**
* **开发者工具上传：**可以通过Python SDK或Open API的方式上传数据文件以及标注数据。该方式支持融合数据集、连续数据以及标注数据的上传、编辑和数据管理。详情可见如何使用[开发者工具](/dev-doc/tools)。
{% content-ref url="/pages/-MLCnlrTBgRXldjOYYbu" %}
[开发者工具](/dev-doc/tools)
{% endcontent-ref %}
## Commit Draft
* 完成数据上传后，点击【确定】进入【Commit Draft】界面。输入Commit 标题、描述（选填）、Tag作为该版本的说明，点击【Commit】发布新的版本，完成Commit操作。发布后该版本将不再接受修改。
{% hint style="info" %}
仅 Commit 后的数据集基本可用于标注、训练等数据的后续使用。
{% endhint %}
* 如果暂时不想将该Draft发布为新版本，您可点击【跳过】，数据集将保留【Draft】版本，回到数据集详情页，您可通过【管理数据】进入【数据列表】继续修改如上传数据、删除数据等；或通过【编辑】进入Draft列表页面，选择Draft，对数据、数据集信息进行修改。
* 通过【管理数据】进入【数据列表】对数据集信息进行修改及查看,支持用户在当前页面查看数据集信息，进行搜索，查看Catalog, 新建draft来编辑数据以及用当前搜索结果创建新数据集等操作。
# 管理云服务上的数据
您可以通过云存储授权的方式使用TensorBay高效地管理您的云端数据。
## 添加数据存储配置
在开发者版个人空间中您可进行【格物钛存储】配置管理，在团队空间中仅团队的超级管理员或管理员可对团队数据集的【格物钛存储】配置及【授权存储】配置进行管理。
* 配置入口一：点击顶部导航栏【我的数据集】（个人开发者）或【团队数据集】（团队开发者）列表界面，点击右侧工具栏
进入数据存储配置列表界面。
* 您可以在数据存储配置列表页面管理当前工作空间的存储配置信息。点击【新建配置】则进入新建配置界面。
* 配置入口二：点击【创建数据集】，点击【新增数据存储配置】，进入新增配置界面。
* 进入【新建数据存储配置】，个人开发者仅支持【格物钛存储】，可以选择不同的区域来存储您在TensorBay上的数据。
* 团队开发者可以选择【格物钛存储】或【授权存储】。
* 【格物钛存储】需选择不同的区域来存储您在Tensorbay上的数据。
* 【授权存储】需填写配置名称，选择您的云存储服务商，填写相关授权信息后，点击【完成】。Tensorbay与云存储服务商成功校验相关配置和授权密钥的正确性后可保存授权信息。目前支持通过授权使用阿里云oss、Amazon S3、Azure Blob上的数据。
.png?alt=media\&token=19547da8-8da2-410e-ae9b-218e2cd26afd)
* 对于存储在阿里云oss上的数据，您也可以选择通过**授权RAM**进行数据授权。
{% content-ref url="/pages/GwkTfwYdgsNo6B8ywwV1" %}
[阿里云oss用户授权RAM](/guide/tensorbay/data/authorize/a-li-yun-oss-yong-hu-shou-quan-ram)
{% endcontent-ref %}
## 管理数据存储配置
* 您可以在数据配置列表对云储存配置进行管理。选择您需要修改的配置，点击最右侧的 
选择您要进行的操作。
* 格物钛存储支持【设为默认】和【删除】操作
* 授权存储支持【修改配置】、【设为默认】和【删除】操作。
* 请注意，管理数据存储配置仅限开发者用户和团队超级管理员或管理员操作，团队普通成员仅可查看不可修改。
#### 管理格物钛存储配置
* 点击【设为默认】可将该存储配置设为您的默认配置，后续新建数据集时，存储配置默认显示为此配置。
* 点击【删除】可删除该默认存储配置，删除默认存储配置将不会影响通过此配置所创建的数据集。
#### 管理授权存储配置
仅团队超级管理员或管理员有权对授权存储配置进行操作
* 点击【设为默认】可将该存储配置设为您的默认配置，后续新建数据集时，存储配置默认显示为此配置。
* 点击【删除】可删除该授权存储配置。
* 请注意，若删除授权存储的配置，则无法在创建数据集时使用。建议确认目前没有正在使用该配置的数据集时，选择删除该配置。
* 点击【修改配置】进入授权存储配置更新页面，您可以修改Accesskey ID或Accesskey Secret（取决于不同云存储服务上），修改完成后选择【确定】保存您的更改。配置修改后将重新校验您的配置和授权信息是否正确。
# 阿里云oss用户授权RAM
您可以通过授权RAM方式进行授权存储，可以有效提高数据安全性。
## 生成RAM UID
* 选择**存储配置商**为**阿里云OSS**，**配置方式**为**授权RAM**
* 复制格物钛平台为您生成的**RAM UID**
## **阿里云授权配置**
### **进入阿里云平台**
* 登录阿里云账号，进入[阿里云oss控制台](https://oss.console.aliyun.com/?spm=a2c4g.11186623.0.0.4e4e28736TGbJq)。
### **进入授权页面**
**方法一：**
* 点击对象存储中左侧【Bucket列表】，选择**目标Bucket名称**，点击进入文件管理页面。
* 进入文件管理页面，点击【授权】。
* 进入授权页面，点击【新增授权】，进行新增授权配置操作。
#### 方法二：
* 进入文件管理页面，点击左侧【权限管理】，切换至权限管理页面。在**Bucket授权策略**模块，点击【设置】，进入授权策略设置页面。
* 点击【新增授权】，进行新增授权配置操作。
### 填写授权策略
* 在新增授权的对话框中，填写授权策略。
* **授权资源**请选择**指定资源**，并填写指定资源路径
* **授权用户**请选择**其他账号**，并填写您在格物钛平台复制的**RAM UID**
* **授权操作**请选择**完全控制**
* **授权条件**：不要勾选访问条件。
.png?alt=media\&token=e7722c45-a48b-4043-a986-db625a8b2ca8)
* 点击【确定】，新增的授权信息将展现在授权页面中。确认授权信息无误后，您可以记录以下配置信息：Bucket Region, Bucket name, File path，以便进行后续配置。
## **填写配置信息**
* 回到格物钛平台，在授权存储配置页面继续填写您的配置信息。
.png?alt=media\&token=77384dbd-fb0f-4c80-89b0-503d74955f51)
* 确认配置信息无误后，点击【确定】，等待平台进行配置验证。
# 利用数据集筛选快速新建
在TensorBay中，您可以在已创建的数据集列表中通过筛选现有的数据，快速创建新的数据集，该操作将不会重复复制数据，无需担心数据量，操作快捷，节约大量存储成本。您在筛选操作中也可以通过可视化组件在线查看数据详情，标签分布等数据信息。
* 在TensorBay数据集列表页，在创建数据集的下拉框中选取【Create by filter】，选择您需要筛选的数据集。
* 代码示例：
```
def init(params: dict):
# 进行初始化工作，可以返回一个函数或None
return None
def run(data: dict, func=None) -> bool:
# 执行判断操作，data传入的是一个数据集文件相关的数据，func时init返回的函数
# 如果通过筛选返回True，否则返回False
return True
def teardown():
# 执行清理工作，没有返回值
pass
```
## 输入筛选条件
在数据信息筛选条件框中，你可以根据筛选数据需求填写【数据名称】。也支持在【Segment 列表】中单选和多选segment。如果您需要的筛选数据集类型为融合数据集，可以选择有无数据标注的选项。根据此选项，可以在【标注信息条件筛选】框中进行进一步的标注信息筛选。
* 点击请选择，选择需要搜索的基本信息，目前Box2D基础信息包括：Segment，数据名称，数据大小和是否包含标注。 点击添加【搜索条件】，添加其他搜索条件；点击搜索条件右上角，删除搜索条件。
## 查看搜索记录
### 查看记录首页
* 点击【搜索记录】，您可以查看过去您使用过的搜索记录的状态。
【未保存】：首次搜索，此时搜索结果未保存，不能新建数据集。
【保存进度】：选中搜索结果，点击保存后，开始对搜索结果进行保存。
【已保存】：第二次搜索，此时结果全量展示并保存，可以用此结果新建数据集。
### 选中搜索记录
* 【未保存】记录：选中未保存的搜索记录，您可以在搜索栏查看搜索条件，在数据列表页查看文件数量及大小并预览100条搜索结果。
* 【已保存】记录：选中已保存的搜索记录，您可以在搜索栏查看搜索条件，在数据列表页查看文件数量及大小并查看全量搜索结果。
## 使用标签筛选数据
* 选择某个需要筛选的数据集后，将进入【数据列表】界面，您可以在左侧下拉框中选择您需要数据管理的版本。
* 确定需要管理的版本后，您可以筛选该数据集的Segment，标注类型以及标注标签，得到数据集中符合筛选条件的数据，筛选后的数据将更新在右侧的数据列表中。
## 查看数据详情
* 在【数据列表】页，您也可以通过右侧可视化中在线预览数据及查看具体的标注情况，使用详情请参考[可视化插件指南](/guide/tensorbay/visualization/visualization-widgets)。
{% content-ref url="/pages/-MWU48zXlRgfjJ5o6rWo" %}
[Pharos 使用指南](/guide/tensorbay/visualization/visualization-widgets)
{% endcontent-ref %}
## 查看标签分布
* 在【数据列表】页，您也可以在【查看模式】的下拉框中选择【统计指标】来查看各标注类型、标注标签的分布情况。
## 通过搜索快速新建数据集
* 初次数据筛选完成后，搜索记录为【未保存】状态，此时您可以，在数据列表页查看文件数量及大小并预览100条搜索结果。
* 如果您希望用此搜索结果新建数据集，请先对搜索结果进行保存，已保存的搜索结果新建数据集。 选中您需要保存的搜索记录，点击【保存】按钮，对搜索结果进行保存。
* 保存完成后，搜索记录状态变更为已保存。选择【用此结果新建数据集】。
* 填写数据集名称并设置可见范围（公开或者私有）后，选择【确认创建】完成数据集创建。注：您可以在此界面看到已选数据和数据来源。
* 数据集创建完成后，将转跳至新创建的数据集的详情页，可查看通过筛选创建的数据集。
## **高级搜索**
除了可以使用基础筛选条件（segment名称、标注类型和有无标注）以外，融合数据集和普通数据集支持自定义高级搜索功能。您可以通过制定GitHub URL的方式获取文件，并以该文件作为筛选方法，对数据进行筛选。
* 在数据集详情页中，点击【管理数据】，进入【数据列表】页面。
* 点击左上角【搜索】，再点击【高级搜索】选项
* 左下角会显示【高级搜索GitHub Repo Link】窗口。将您需要上传的文件链接复制入弹窗中，并点击【搜索】执行筛选。\
注：填写链接需遵循https协议，即链接需用https开头，地址和revision之间需用“:”分割。
* 代码示例：
```
def init(params: dict):
# 进行初始化工作，可以返回一个函数或None
return None
def run(data: dict, func=None) -> bool:
# 执行判断操作，data传入的是一个数据集文件相关的数据，func时init返回的函数
# 如果通过筛选返回True，否则返回False
return True
def teardown():
# 执行清理工作，没有返回值
pass
```
* 结束高级筛选之后，结果会自动录入【筛选记录】中。\
\ # 数据合并拆分及复制移动 在TensorBay中，您可以通过使用Python SDK复制或移动现有数据来准备数据集或创建新数据集。 * 点击顶部导航栏【我的数据集】（个人开发者）或【团队数据集】（团队开发者）进入您工作空间的数据集列表，在【创建数据集】的下拉框中选择【Merge by Python SDK】跳转至SDK文档页面，请参照SDK指引文档完成新数据集创建。 * 通过PythonSDK支持将原数据和标注数据复制或移动至另一个数据集，或在相同的数据集中从一个segment复制或移动至另一个segment。   # 通过Fork使用公开数据集 在TensorBay上，您可以通过Fork在OpenDatasets上获取数据集，快速使用公开数据集。 * 在创建数据集下拉框中选择【Create by fork】，进入公开数据集首页。  * 在公开数据集首页，搜索您需要的公开数据集。 {% hint style="info" %} 建议使用英文搜索 {% endhint %}  * 选择某个数据集后进入数据集详情页，点击右上角的【探索数据集】，在下拉框选择【Fork数据集】可将该公开数据集创建副本至您的TensorBay的工作空间。  * 【Fork数据集】完成后可在您的工作空间的数据集列表中查看该数据集，通过Fork创建的新数据集，在数据集名称前有对应的标志。  # 数据版本管理 在TensorBay中您可对数据集的数据进行版本管理，包括对原数据文件、标注数据以及数据集详情信息进行版本管理。 {% content-ref url="/pages/-MWTx9QhKBC2C1gBQOS6" %} [管理数据文件](/guide/tensorbay/version/data) {% endcontent-ref %} {% content-ref url="/pages/-MWTy1EEwewKUeHRPpUY" %} [管理标注数据](/guide/tensorbay/version/annotation) {% endcontent-ref %} {% content-ref url="/pages/-MWTyIUZu18SDjnIX6vm" %} [管理数据集信息](/guide/tensorbay/version/dataset) {% endcontent-ref %} {% content-ref url="/pages/-MWTzETGYRl1Eud9jwEk" %} [管理版本信息](/guide/tensorbay/version/version-info) {% endcontent-ref %} {% content-ref url="/pages/-MWU-zoqjX7pu5woktwM" %} [数据集活动](/guide/tensorbay/version/activity) {% endcontent-ref %} {% content-ref url="/pages/-MWU0uPGP62aGJrj5N6o" %} [数据集设置](/guide/tensorbay/version/setting) {% endcontent-ref %} # 管理数据文件 面向AI开发者的非结构化数据将以文件形式进行存储和管理。数据文件存储根据格物钛存储或授权存储实际存储在相应的公有云存储上。TensorBay支持通过Web端或Python SDK 、Open API上传数据。 {% hint style="info" %} 仅数据集的【Draft】版本可进行上传、删除数据等对数据修改的操作。 {% endhint %} ## 原数据类型 TensorBay支持图片、视频、音频、文本等原数据类型，支持管理连续数据、多传感器数据等复杂结构的数据集管理。 ## 上传/删除数据 * 在数据集详情页中，点击【编辑】，进入【Draft列表】  * 选择某个Draft（暂时仅支持对每个Branch创建1个Draft）进入数据列表，点击右上角【上传数据】，进行后续上传操作  * 进入Draft详情页后，点击【数据】后的【编辑】，直接进入数据列表页，即可【上传数据】；或找到特定数据文件，进行【删除】。    {% content-ref url="/pages/-MWSbbiz429ASW3po9Q\_" %} [数据集准备](/guide/tensorbay/data) {% endcontent-ref %} * Commit当前版本：确认修改后，点击右上角【Commit】。  * 填写Commit message和Tag后，点击【Commit】完成新版本的发布。 {% hint style="info" %} 当前版本的数据Commit后，该版本的数据将不再接受修改；后续数据的修改将被保存在Draft草稿模式，修改后可Commit为下一版本。 {% endhint %}  # 管理标注数据 在TensorBay上，您可以上传、删除标注数据并对编辑后的数据集进行版本管理。 ## 上传、删除和修改标注数据 * 在【数据上传】页面，选择【通过开发者工具上传】，通过Python SDK、CLI或API完成标注数据的上传、删除和修改。具体详情请参照[开发者工具](/dev-doc/tools)。  {% content-ref url="/pages/-MLCnlrTBgRXldjOYYbu" %} [开发者工具](/dev-doc/tools) {% endcontent-ref %} # 管理数据集信息 * 在【我的数据集】或【团队数据集】列表中，选择需要编辑的数据集，进入该数据集详情页，点击右侧【编辑】，进入Draft列表页，新建Draft后，即可管理您的数据集信息。   * 在【Draft详情页】，您可以点击【数据集信息】右侧的【编辑】来进入数据集信息管理页面，在这里，您可以编辑数据集标签、数据集描述、数据集版权信息。  ## 编辑数据集标签 * 在数据集信息列表中，选择【数据集标签】部分，您可以在此选择该数据集的数据格式，数据集应用场景，也可以添加自定义标签，方便您在搜索数据集时更容易获取到您的数据集。  ## 编辑数据集描述 * 在数据集信息列表中，选择数据集描述部分，您可以在此详细描述数据集的信息，使您自己或您的数据集成员更清晰地了解数据集的内容。  ## 编辑数据集版权信息 在数据集信息列表中，选择数据集版本许可部分，您可以： * 修改版权归属方信息：在版权归属方下面的下拉框中，您可以搜索选择版权归属方。 {% hint style="info" %} 支持添加多个版权方，下拉框中将展示可选的版权方；如果某版权方已被选中，则不可重复选择。 {% endhint %}  * 编辑和移除版权方：您也可以对已有版权所有方进行【编辑】和【移除】操作。 {% hint style="info" %} 对于团队用户，仅管理员有新增和编辑版权方的权限，普通成员只能选择已有的版权方。 {% endhint %}  * 增加版权归属方：您也可以点击下拉框右侧【+】，增加新的版权所有方。其中，版权归属方名称、链接为必填项，头像、描述为选填项。  * 数据集版权信息编辑结束后，点击最下方【保存】对您的修改进行保存。 # 管理版本信息 在TensorBay中，您可以清晰简便地进行数据集版本管理。您可以在修改数据后Commit新数据集版本，查看历史版本数据，实现版本迭代可视化，回溯任意历史版本等操作。 ## Commit数据集版本 * 确认某个Draft的修改后，点击右上角的【Commit】进入Commit界面。  * 填写Commit信息和Tag后，点击【确认】完成新版本的发布。  {% hint style="info" %} Commit后，该版本的数据将不再接受修改；后续数据的修改将被保存在Draft草稿模式，修改后可Commit为下一版本。 {% endhint %} ## 查看历史版本数据 * 在数据集详情页的版本中点击【查看所有Tags】可进入Commit记录。或点击版本列表右侧的【Tags】进入Commit记录页。  * 在Commits记录中，您可以查看所有的历史版本信息；点击版本右侧的
可以进入数据详情页看到该版本的详细数据。
## 可视化版本迭代
* 在Commits记录右上角选择可视化。
# 管理数据集分支
“分支” = “Branch”
## 通过分支管理数据集
* 在不影响原数据集和其他数据分支版本的情况下，分支管理功能可以让用户安全地在不同的原数据集分支版本上根据需求做改动，对数据集进行比较实验。
* 多个用户可以通过Branch同时编辑各自的数据集，了解Commit或Branch之间的关系以及每个版本的来源，不会干扰彼此的工作。
### 默认分支
在TensorBay上创建数据集时，将自动创建默认分支（Default Branch）为第一个分支，该分支默认命名为“main“，支持默认分支重命名或切换默认分支。
### **查看分支**
* **方法1：**创建branch成功后，将自动切换至该branch详情页。
* **方法2：**进入任意版本的数据集详情页，点击左上角的下拉单，切换至目标Branch，查看其最新版本的数据详细信息，进行筛选或创建Draft完成数据集修改。
### 创建分支
* **基于原有分支/ Tags/ Commit 创建新分支**
* 进入数据集详情页，点击左上角切换版本的下拉单，选择一个分支 / Tag 并切换；或点击【查看所有tag】进入Commit记录列表，点击右侧
图标切换。
* 进入相应数据集详情页后，点击左上角切换版本的下拉单，在【查找或创建Branch】输入框中输入新分支名称，完成【创建】。
### 删除 / 重命名分支
* 进入branch列表详情页面。
* 对任意branch，点击右侧删除 / 重命名按钮，即可删除 / 重命名branch
{% hint style="info" %}
default branch不能删除，但可以重命名。
{% endhint %}
### 切换分支
进入branch列表详情页面之后，点击切换branch按钮，选择需要切换default branch的目标branch，即可切换。
# 数据集活动
在TensorBay中，您可以在【活动】页面查看数据集的全部活动日志和引用记录。
## 活动日志
【活动日志】记录了该数据集的操作历史，包括：
* 数据集操作：创建数据集、新建draft、提交draft、修改数据集名称等。
* 操作权限操作：添加团队成员、更改成员操作权限等。
* 数据集引用操作：fork数据集、筛选新建数据集等。
## 引用记录
【引用记录】能够查看通过此数据集fork新建的数据集和筛选新建的数据集以及相关信息。
查看信息：可以点击【数据集名称】跳转数据集首页，点击【user name】跳转用户/团队首页。
# 数据集设置
在TensorBay中，你可以对您的数据集进行管理和设置，您可以修改数据集名称，对数据集成员及其权限进行管理，查看数据集的存储位置，或删除当前数据集。
{% hint style="info" %}
仅数据集的创建者或对数据集有管理权限的成员具有设置权限。
{% endhint %}
* 在数据集详情页，选择【设置】即可进入该数据集的设置界面。
## 修改数据集名称
* 在左侧导航栏中的【基本设置】中，点击数据集名称右侧的
编辑该数据集名称。注意：数据集名称的长度限制为80，仅支持英文、数字、空格、"-"和"\_"。
* 修改完成后，点击【确认修改】进行修改确认。请确保您所拥有的数据集的名称不重复。
## 数据集可见性设置
* 您可在创建数据集的时候设置该数据集的可见性，或在数据集设置中对可见性进行修改。
* 如果您需要将可见性调整为【公开】，则说明您同意任何的社区用户都可以搜索、查看、查询和Fork此公开数据集中的所有数据文件。
## 数据集成员及权限管理
* 在【设置】页面的左侧导航栏选择【成员管理】，您可以在右侧查看该数据集的全部成员包括数据集的创建者、团队超级管理员和其他数据集成员。
{% hint style="info" %}
如果您是团队用户，团队管理员默认对于团队数据集有管理权限。
{% endhint %}
* 添加成员：您可以点击【邀请成员】增加该数据集新成员。
* 选择您需要添加的成员，选择完成后点击【发送邀请】完成添加。
{% hint style="info" %}
添加成员仅限于您团队中的成员。
{% endhint %}
## 数据集存储位置
* 如果您的数据集是通过【授权存储】方式创建的数据集，在左侧导航栏的【存储信息】中可查看该数据集数据的云存储位置。
* 如果您的数据集是通过【格物钛存储】创建的数据集，在左侧导航栏的【存储信息】中，您可查看到该数据集的格物钛存储信息。
## 删除数据集
* 点击【删除数据集】即可删除该数据集。
{% hint style="danger" %}
该操作将删除数据集及其所有的版本，操作不可逆，删除后所有使用此数据集的任务将不可用，请谨慎操作。
{% endhint %}
# Pharos 数据可视化
Pharos 提供丰富的可视化功能，对多种数据文件、标注类型的数据进行管理，快速筛选和迭代AI开发所需的高质量数据。
具体功能介绍如下：
## 查看数据和标注
* 通过切换不同的可视化组件（右上角）对数据进行可视化查看。支持实时查看当前条件下筛选的数据及其标注信息（支持**多种标注类型同步**可视化）。
## 查看数据的标签分布
* 数据可视化组件支持实时可视化查看当前条件下筛选数据的标签分布统计信息，帮助用户直观的感受所筛选数据标签分布情况。数据标签分布可视化组件详情参照标签分布可视化组件。
## 可视化自定义数据集
若需要可视化您的数据集，Pharos 提供以下两种可用的途径：
1. 将您的数据集上传至 TensorBay，具体步骤请参考上传数据。数据上传后，登陆账号后进入对应数据的详情页，找到数据概览，即可完成可视化。
{% content-ref url="/pages/-MWSbbiz429ASW3po9Q\_" %}
[数据集准备](/guide/tensorbay/data)
{% endcontent-ref %}
2\. 使用TensorBay SDK读取您的本地数据，再通过Pharos进行可视化，无需费时上传数据，即可查看本地数据
# 获取 Pharos
## 可视化公开数据集
Pharos 支持对格物钛公开数据集社区中的部分数据集进行在线可视化，在需要可视化的公开数据集详情页的“概要”标签中，下滑找到数据概览，即可完成数据在线可视化。详情请见：
{% content-ref url="/pages/-MS1uI3N7CoJJpyf2ZvA" %}
[在线预览数据及标签分布](/guide/opendataset/visualization)
{% endcontent-ref %}
## 可视化自定义数据集
若需要可视化您的数据集，Pharos 提供以下两种可用的途径：
1. 将您的数据集上传至TensorBay，具体步骤请参考上传数据。数据上传后，登陆账号后进入对应数据的详情页，找到数据概览，即可完成可视化。
{% content-ref url="/pages/-MWSbbiz429ASW3po9Q\_" %}
[数据集准备](/guide/tensorbay/data)
{% endcontent-ref %}
2.通过TensorBaySDK读取本地数据，立即使用Pharos进行可视化，无需登陆和上传即可使用数据可视化插件所有功能，把握数据质量，具体操作请查看[SDK帮助文档](https://tensorbay-python-sdk.graviti.com/en/latest/features/visualization.html)
{% hint style="info" %}
通过SDK使用Pharos仅支持对数据和标注进行可视化，如要查看标签分布的可视化，需将数据上传至TensorBay
{% endhint %}
# Pharos 使用指南
## Pharos 数据可视化插件
**格物钛**数据可视化插件提供对多种数据类型和标注类型的可视化支持，帮助AI开发者快速、直观的掌握数据及其标注信息的内容和质量，减少鉴别数据的时间消耗。
* **支持的数据及标注类型**
| 数据类型 | 文件类型与格式 | 标注类型 |
| ---- | ------------------- | ------------------------- |
| 图像类 | 图片（jpg、jpeg、png） | 2D矩形框、2D多边形、2D折线、2D关键点、分类 |
| | 点云（bin、pcd、ply、las） | 3D框、分类 |
| | 连续帧数据 | 2D框追踪、3D框追踪 |
| | 视频（MP4） | 分类 |
| 语音类 | 音频（mp3、wav、flac） | 转录、分类 |
| 文本类 | 文本（txt） | 分类 |
### 图像类数据可视化
* **选择文件**
支持包含多传感器数据和连续数据在内的多种图像类数据可视化，左上角选择需要查看标注类型和文件名。如果是多传感器数据，则选择需要查看的帧（frame）。右侧为**主视图**，会将选中的数据与对应的标注类型内容可视化显示。
* **选择标注**
左侧为**标注列表**，支持**同时查看多种标注类型**。
有按标注（Annotation）和按类别（Category）查看两种模式，按标注可查看单个标注框的信息，按类别可查看各类别下所有标注框的统计信息。选中一条标注信息后，可展开显示此标注对应的属性信息，对应标注会在主视图中高亮显示
* **切换模式、全屏**
右下角的操作区按钮从左到右分别是切换深浅色模式和全屏。
{% hint style="info" %}
当数据无标注信息时，列表显示“No Annotation”表示此数据已标注，但无可标注的对象；若列表显示“Not Labeled”表示此数据未经标注。
{% endhint %}
* **选择传感器（融合数据可视化）**
在可视化多传感器数据时，可在主视图左下角选择需要查看的目标传感器数据；在可视化同时包含点云文件和图片文件的多传感器数据时，会将图片文件放入小窗口显示，点击小窗口即可将其显示内容与主视窗显示内容调换。
* **播放/ 暂停（连续数据可视化）**
对于连续数据，包含连续帧数据和视频数据的可视化，主视窗左下角的操作区可进行播放/暂停，上一帧/下一帧操作。
###
### 语音类数据可视化
支持音频文件及其标注的可视化。先在左上角选择需要查看的数据，标注信息会展示在右侧主视窗中。
* 左下角的操作区可操作播放/暂停、上一个文件/下一个文件以及播放倍速和音量。
###
### 文本类数据可视化
文本类数据可视化模式功能与图像类相似，用户可在左上角选择需要查看的数据；在左侧标注列表展示标注信息，右侧主视图展示原数据信息。
## Pharos 标签分布可视化插件
支持图像类数据集的**标签数据与属性数据的统计信息**可视化，便于快速掌握数据集种标签和属性信息的分布情况。
### 查看标注标签种类的分布情况
您可在左上角选择需要查看的标注类型。
* 在左侧操作区域选中标签查看模式（Category）。
* 右侧主视窗即会展示当前数据集在此标注类型下的所有标签统计信息。
### 查看属性信息的分布情况
在左侧操作区域选中标签查看模式右侧主视窗，切换至【属性信息】查看模式。
* 在右侧列表选择需要查看的数据层级，“ALL“ 表示查看所有数据；在右上角的下拉框中选择需要查看的属性类别，主视窗展示此属性类别下所有的属性值的分布数据。
### 切换查看模式
支持列表、条形图和饼图3种查看模式，点击左侧操作区的【模式切换按键】，即可切换不同的展示模式。
* **列表模式**
* **条形图模式**
* **饼图模式**
{% hint style="info" %}
当数据标签类型过多时，标签分布可视化插件将不支持饼图展示模式
{% endhint %}
# 团队协作
TensorBay支持团队协同数据管理，通过团队成员角色、数据集权限的灵活设置，安全的同步与分享数据，避免数据的反复复制与迁移，高效协作加速算法开发。
开发者用户可免费创建团队，即刻拥有团队社区版100GB的免费数据托管容量及团队权益，权益详情请查看 [产品定价](https://www.graviti.com/price)。
{% content-ref url="/pages/-MWU9NDPoGxjbX8fN1vH" %}
[创建团队空间](/guide/tensorbay/collaboration/create)
{% endcontent-ref %}
{% content-ref url="/pages/-MWUAA1fBV9ISayqDQ9M" %}
[资料/成员管理](/guide/tensorbay/collaboration/manage)
{% endcontent-ref %}
# 创建团队空间
## 新建团队信息
* 登录GAS首页，在导航模块【团队协同】中点击【新建团队】，或顶部导航栏中点击空间下拉列表中选择【新建团队】，进入团队创建流程。
* 点击【新建团队】进入团队创建页面。
* 填写团队信息：依次填写团队名称、团队空间名称，联系邮箱及团队简介，并确认《**用户协议**》和《**个人信息隐私政策**》。
{% hint style="info" %}
团队空间名称一经创建后暂不支持修改，填写时请确认。
{% endhint %}
* 点击【下一步】完成团队创建去邀请成员加入。
## 邀请成员加入
* 提交团队信息后，进入邀请成员界面，可通过添加**手机号**以邀请成员加入，邀请时可选择每一位成员的权限（管理员/ 普通成员）。
* 填写完成员信息并确定成员身份后，点击【邀请成员】，系统会发送邀请链接至手机，受邀成员需要在**24小时**内完成注册并接受邀请，如果超过时限则需要重新邀请。
* 也可以跳过这一步，之后在团队空间 -【设置】-【成员管理】中添加新成员。
## 进入团队空间
* 完成团队创建后，自动进入该团队的工作空间。
* 在GAS主页右上角，下拉选择进行空间切换。
{% hint style="info" %}
不同工作空间的数据、成员和权限互相独立。
{% endhint %}
# 资料/成员管理
## 进入团队管理
在GAS首页右上角选择团队名称右侧【团队管理】图标，进入团队管理界面
## 团队资料管理
团队资料更新**仅限该团队的超级管理员和管理员操作**。
可变更的信息为：
* **团队名称：**团队名称不能为空且不能重复。
* **空间URL：**如处于未设置的状态，可进行设置，**空间URL仅可被修改一次**。
* **团队简介：**字数不超过400字。
* **联系邮箱：**联系邮箱将在团队主页展示，便于社区用户联系，同时也将用于接收系统的重要消息，请务必确保所填写邮箱的准确性。
* **所在地区**
以上信息变更完成后，选择【更新团队资料】完成更新。
完成信息变更后，点击左上角【团队主页】，回到团队主页检查和确认团队资料变更的展示效果。团队主页用于对团队成员、社区用户展示您的团队信息。
## 团队成员管理
### 成员角色
* **超级管理员：**团队创建者默认为该团队的超级管理员，拥有团队权限中的所有权限。每个团队的超级管理员有且只有1个，超级管理员身份只能转让，不能修改角色或离开团队。
* **管理员：**除不能任命、修改管理员外，团队管理权限与超级管理员一致。
* **普通成员：**可通过超管或管理员的邀请加入团队，可自行退出团队。
### 成员列表
在【团队成员】列表中，可查看已加入该团队的成员数量、成员信息、成员加入时间以及该成员的角色权限（如超级管理员、管理员或普通成员），具体操作权限和设置规则可点击右上角【角色权限说明】。
### 添加成员
**仅限超级管理员和管理员操作**。点击【邀请成员】进入成员邀请界面。
通过添加**手机号**邀请团队成员加入，同时对邀请成员的团队身份进行设置。其中，超级管理员可选择管理员或者普通成员，管理员仅可选择普通成员。
点击【邀请】后，系统会发送短信至被邀请人手机。如果一个手机号被重复添加，系统默认只发送一次信息。受邀成员需要在24小时内完成注册并接受邀请，如果超过时限则需要重新邀请。
### 移除成员
**仅限超级管理员和管理员操作。**点击某位团队内成员的身份设置，下拉选择【移除成员】即可将该成员从团队中移除。其中，超级管理员可以移除管理员和普通成员，管理员仅可移除普通成员。移除成员后，该成员将无法查看和使用团队内的任何数据，请谨慎操作。
### 修改团队成员角色
**仅限超级管理员操作。**点击某位团队内成员的身份设置，在下拉框中选择转换的身份。选择【设为管理员】或【设为普通成员】对团队成员的身份进行变更。
选择【设为超级管理员】则将**转让超管身份**，设置后原超管降为普通成员，请谨慎操作；如果超级管理员需要注销账号，必须先将超管权限转让给该团队内其他成员才能进行注销操作。
### 退出团队
**仅限管理员和普通成员操作，超级管理员不允许退出团队。**
在顶部导航栏中选择【个人空间】进入开发者账号管理界面，点击【我的团队】可查看当前已加入的团队列表。选择想要退出的团队并点击【退出】，即可退出该团队。
{% hint style="danger" %}
退出团队后，将无法查看和使用团队数据。
{% endhint %}
# 数据集管理
## 创建团队数据集
* 团队内所有成员可以在团队空间创建数据集。
* 数据集的创建者为【所有者】
## 数据集成员管理
* **公开数据集**将对所有平台用户公开，不占用团队存储空间；
* **私有数据集**需要邀请团队内成员加入，成为团队数据集协作者后，根据不同的权限（可查看/ 可使用/ 可修改/ 可管理）协作者可以对数据集进行不同级别的操作。
* 超级管理员默认对团队内所有数据集拥有“可管理“权限。
### 数据集权限说明
* **可预览**
团队成员对团队内所有数据集的**默认权限。**可查看团队私有数据集的详情页、预览数据，无法查看数据列表和版本记录。
* **可查看**
在【可预览】的基础上，允许可查看团队私有数据集的详情页、数据列表和版本记录。
* **可使用**
在【可查看】的基础上，允许对团队私有数据集进行筛选新建数据集、合并新建数据集、创建标注任务、开发者工具读取等操作（需要配合AccessKey使用）。
* **可编辑**
在【可使用】的基础上，允许查看draft数据（未commit），编辑数据集信息、上传数据并commit新版本、删除数据等涉及数据修改的操作。并允许对数据进行修改tag、切换版本、删除版本等版本管理操作。
* **可管理**
在【可编辑】的基础上，允许修改数据集名称、删除数据集、设置数据集可见性（公开/ 私有）、配置授权信息。另外还能进行数据集成员的管理，如：添加成员、设置成员权限、移除成员等。
* **所有者**
在【可管理】的基础上，拥有数据集成员申请的审批权限。
### 邀请数据集成员
* 右上角下拉空间列表，选择需要进入的团队空间。
* 进入团队空间后，进入【成员管理】模块。
* 邀请成员，同时设定成员的数据集权限。
* 下拉团队成员列表，添加已加入团队的用户到数据集。
* 填写成员邮箱，回车确认。邀请您团队内（未加入TensorBay团队协作）的用户注册、加入团队。
* 复制链接，转发至需要加入数据集的团队成员。已登陆用户点击链接即可加入团队数据集。未注册/未登陆用户点击链接，完成注册/登陆后即可加入团队。
{% hint style="info" %}
【可管理、所有者】以外权限的成员邀请新用户加入数据集，需要通过**数据集所有者**的审批，审批通过即可加入数据集；
{% endhint %}
* 任何成员邀请**非团队成员（暂未加入TensorBay团队空间）用户加入数据集**，受邀者需要按提示提交权限申请，经过团队**超级管理员**审批（在消息中心查看申请并审批），通过后同时加入团队和数据集。
### 更改成员权限/ 移除成员
* 进入数据集详情页 -【设置】-【成员管理】模块。
* 找到需要移除的成员，点击右侧的权限按钮，更改权限或移除。
{% hint style="info" %}
只有【可管理】、【所有者】能进行权限更改/ 移除成员的操作。
{% endhint %}
### 删除数据集
* 进入数据集详情页的【设置】-【基本设置】-【谨慎操作】模块。
* 选择【删除数据集】。
{% hint style="danger" %}
只有【可管理】和【所有者】有删除数据集的权限。删除操作不可逆，删除后将导致使用此数据集的任务将不可用
{% endhint %}
# 团队活动日志
## 活动日志是什么？
团队活动日志包括团队管理日志和数据集管理日志，记录团队协作管理数据过程中的活动历史，随操作实时生成，团队内部公开透明，方便清晰溯源。
* **团队管理日志：**包括成员加入、成员权限变更等团队管理活动记录。
* **数据活动日志：**包括团队空间数据集创建、数据集可见性变更、commit记录、数据集成员加入以及成员权限变更等团队数据相关的活动记录。
## 活动日志查看
### GAS团队空间主页
切换到团队空间后，下拉页面，即可查看团队管理活动日志 和 **所有团队数据集**的活动日志。
### 团队数据集主页
进入团队数据集详情页，在【活动】模块可以查看**该数据集相关**的管理活动日志。
# Action 流程自动化
通过Action，您可以高效便捷地自动化搭建数据使用流程
**入口界面**
在您的**【**数据集详情页面】点击【自动化】进入【Action自动化页面】
{% content-ref url="/pages/-MhCaUKSYxusElombWu5" %}
[新建工作流](/guide/tensorbay/action/xin-jian-gong-zuo-liu)
{% endcontent-ref %}
{% content-ref url="/pages/-MhCcqaD\_wpYchBc6AS9" %}
[运行工作流](/guide/tensorbay/action/yun-hang-gong-zuo-liu)
{% endcontent-ref %}
{% content-ref url="/pages/-MhCdSj6fuF1tFXmft\_Z" %}
[管理工作流](/guide/tensorbay/action/guan-li-gong-zuo-liu)
{% endcontent-ref %}
{% content-ref url="/pages/av3KPx5mCnIAd4Kbvj56" %}
[自动化配置](/guide/tensorbay/action/secret)
{% endcontent-ref %}
# 新建工作流
## 1 创建工作流名称
{% hint style="info" %}
注：名称只能包含**小写英文字母**，**数字以及减号“-”** ，名称**不得少于2个字符**且**首位不能为减号**。
{% endhint %}
## 2 **设置工作流条件**
### **2-1 设置运行参数**
在【Parameters】栏，点击【添加】,进行参数设置
在【Name】栏填写**参数名称**（注意：名称只能包含英文字母，数字以及下划线“\_”，名称不得少于2位字符且首位不能为数字）**，**在【Type】栏填写相应的**数据类型**并在【Default】栏填写相应**默认值**
### **2-2 设置环境参数**
在【Environment】栏，点击【添加】,分别在**【Key】**（注意：Key名称只能包含英文字母，数字以及下划线“\_”，名称不得少于2位字符且首位不能为数字）和**【Value】**栏输入相应参数。
### **2-3 设置实例参数**
在【Instances】栏，分别选择【实例配置】与【实例个数】
## **3. 输入YAML文件**
在【YAML File】部分，输入您已写好的YAML代码
{% content-ref url="/pages/-MgyqAlKRRJaxL4yE2yb" %}
[YAML语法说明](/guide/tensorbay/action/action-syntax)
{% endcontent-ref %}
## **4 发布工作流**
全部设置完毕之后，您可点击【发布】来创建或更新工作流，也可点击【取消编辑】来退回自动化详情界面，但所做修改将不会保存
# 运行工作流
## **1 运行工作流**
在【自动化详情页面】，点击选定工作流，进入**\[**工作流管理页面】
在【工作流管理页面】，点击【管理工作流】，并点击【运行工作流】，进入【参数设置界面】
在【参数设置页面】输入相应**参数**和**实例个数**，并点击【运行】，开启工作流的运行工作
## **2 查看运行参数**
在【工作流详情页】，您可以看到之前的所有运行记录，并通过**状态**和**排序**两个按钮对运行记录进行筛选和排序
点击最新选定运行记录，进入该次运行的【运行详情页面】
在【运行详情页面】，您可查看**运行时长**、**有效时长**，**运行状态**等记录，也可点击【日志】查看详细运行代码记录。点击【运行参数】，进入【运行参数详情页面】
在**【**参数详情页面】，你可以查看该次运行的**参数配置**、**YAML文件**等详情，点击【编辑】，可修改并更新整个工作流的最新参数。
# 管理工作流
## **1 编辑工作流**
在**【**工作流详情页】，点击**工作流名称**，进入【工作流参数查看页】
在**【**工作流查看页】，点击**编辑**按钮，进入编辑状态
在【工作流编辑页】，依次对**工作流名称**，**运行参数**，**环境参数**，**实例参数**和**YAML文件**进行修改
修改完毕便可点击**发布**将修改更新至工作流，若点击**取消编辑**，则将返回至【自动化页面】，且作所修改不会保存
## **2 禁用工作流**
在**【**工作流管理页面】，选择**管理工作流**并点击**禁用工作流**，该工作流便处于禁用状态
若想解除禁用状态，可以回到**管理工作流**按钮，点击**开启工作流**，该工作流便可重新运行
# YAML语法说明
## **相关概念**
**Job**是Action工作流的基本组成单位，通过定义多个job，并且设置job的依赖关系，可以生成一个[**DAG**](https://en.wikipedia.org/wiki/Directed_acyclic_graph)，TensorBay Workflow Engine通过执行这个DAG来实现任务的自动化。通过以下YAML文件为例：
```
tasks:
hello-world:
container:
image: alpine:latest
command: [echo]
args: ["hello world!"]
```
1. 【tasks】: 定义该workflow下所有的job
2. 【tasks.hello-world】: 定义了一个task，task的名字叫做"hello-world"
3. 【tasks.hello-world.container】: 这个job执行环境是docker container
4. 【tasks.hello-world.container.image】: docker container使用的image是alpine:latest
5. 【tasks.hello-world.container.command】: docker container里执行的命令是echo
6. 【tasks.hello-world.container.args】: echo的参数是"hello world"
## **1 Job的运行环境**
job支持以下3种运行环境，每个job有且仅有一个运行环境：
**1.Container：**在docker container里执行任意命令，使用指定的image，生成一个container并执行，任务内容由image定义。
```
tasks:
hello-world:
container:
image: alpine:latest
command: [echo]
args: ["hello world!"]
env:
- name: GAS-URL
value: https://gas.graviti.cn
```
**2.Script：**在docker container里执行指定的脚本
```
tasks:
hello-script-task:
script:
image: python:alpine3.8
command: [python]
source: |
import logging
import os
import sys
import time
logging.basicConfig(level=logging.INFO)
logging.info('environment was:')
for key, value in os.environ.items():
logging.info(f'\t{key} = {value}')
args = sys.argv
count = 20
if len(args) > 1:
count = int(args[1])
logging.info(f'count was {count}')
idx = 0
while idx < count:
logging.info(f'loop at index {idx}.')
idx += 1
time.sleep(1)
logging.info('complete')
```
**3.Git：**在docker container内执行一个git repo的代码
```
tasks:
hello:
git:
image: python:3.9.5-buster
command: ["python3"]
args: ["main.py"]
repo: https://github.com/username/repository.git@reversion
```
## **2 Job的依赖关系**
**Dependencies：**job可以通过dependencies关键字来定义他们的依赖关系
```
tasks:
taskA:
container:
image: johngraviti/count_down:v0.1
command: [python]
args: [/root/main.py, 40]
taskB:
dependencies:
- taskA
container:
image: johngraviti/count_down:v0.1
command: [python]
args: [/root/main.py, 60]
taskC:
dependencies:
- taskA
container:
image: johngraviti/count_down:v0.1
command: [python]
args: [/root/main.py, 120]
taskD:
dependencies:
- taskB
- taskC
container:
image: johngraviti/count_down:v0.1
command: [python]
args: [/root/main.py, 70]
```
**执行效果：**菱形DAG图，taskA先执行，然后taskB和taskC并发执行，taskD等到taskB和taskC都结束才开始运行
## **3 Job的参数设置**
### **3-1 参数的属性**
**Name:** 参数名称，用来在workflow代码中引用该参数
**Type:** 参数类型，指定该参数的数据类型，支持三种简单类型
* string: 字符串
* number: 数字，包括整型，浮点型
* boolean：布尔值，true/false
**Default:** 参数的默认值，启动workflow时，如果没有显式指定，则会取这里预定义的默认值
### **3-2 参数的定义**
支持通过TensorBay控制台设置及查看详细参数
### **3-3 参数的设定**
**手动式：**如果workflow启动方式为手动式，那么value可以通过TensorBay控制台动态设置
**自动式：**如果workflow启动方式为自动式，那么value取默认值
### **3-4 参数的引用方式**
在workflow中通过参数**name**使用参数
```
tasks:
hello-world:
container:
image: alpine:latest
command: [echo]
args: ["{{workflow.parameters.foo}}" "{{workflow.parameters.bar}}"]
```
1. 引用的参数要用**{{}}**包围
2. 参数的前缀必须是**workflow\.parameters**.
3. 参数的名称必须跟**预定义**的一致
## **4 Job的环境设置**
**Environment**定义了**container**的环境变量，环境变量的引用方式跟普通的**docker container**环境变量一致
# Crontab语法说明
Action自动化工作流支持通过crontab创建定时工作流
Crontab是用来定期执行程序的命令，您可以通过**设定时间参数**从而在固定时间、日期、间隔下，运行定期任务。
在crontab中，共有五个字段，每个参数字段代表一项时间设置（分钟，小时，日，月，周），五个字段共同表示一组时间，作为执行自动化工作流的时间表。当参数设定完成之后，便会按照您设置的时间表自动运行您的工作流。
```
# Crontab格式如下：
* * * * *
- - - - -
| | | | |
| | | | +----- 一周中的第几天 (0 - 7) (Sunday=0 or 7)
| | | +---------- 月份 (1 - 12)
| | +--------------- 一个月中的第几日 (1 - 31)
| +-------------------- 小时 (0 - 23)
+------------------------- 分钟 (0 - 59)
# 例子：
0 0 1 * * # 每个月的1号
10 6 * * 1-5 # 每周一到周五的早上6点10分
```
您也可以通过下列网址，进入crontab在线编辑器，获取更多cron语法和转译示例。
{% embed url="