从 OSS 批量导入 - Knowledge Studio

从已授权的阿里云 OSS Bucket 批量导入文件到数据中心

POST

/api/v1/connector/dash/addFilesFromAuthorizedOss

cURL

curl -X POST "https://{workspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/connector/dash/addFilesFromAuthorizedOss" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "categoryId": "cate_abc123",
    "categoryType": "UNSTRUCTURED",
    "ossBucket": "my-docs-bucket",
    "ossRegionId": "cn-beijing",
    "fileDetails": [
      {"fileName": "product-guide.pdf", "ossKey": "docs/product-guide.pdf"},
      {"fileName": "faq.docx", "ossKey": "docs/faq.docx"}
    ]
  }'

{
  "code": "Success",
  "status_code": 200,
  "data": {},
  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

使用前需要通过**服务关联角色（SLR）**授权百炼平台访问您的 OSS Bucket。请在阿里云 RAM 控制台确认已创建 AliyunServiceRoleForBailian 服务关联角色，否则调用将返回权限错误。

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://rag.console.aliyun.com/settings/apikey）获取。

Body

application/json

string

required

类目 ID，通过 listCategory 获取。

enum<string>

default"UNSTRUCTURED"

required

类目类型。

Available options:UNSTRUCTURED,SESSION_FILE

string

required

OSS Bucket 名称。

string

required

OSS 所在地域，如 cn-beijing。

Example:cn-beijing

object[]

required

要导入的文件详情列表。

Required range:items: 1–10

Show child attributes

string

required

导入后的文件名称。

Required range:length: 1–500

string

required

OSS 对象 Key（文件在 Bucket 中的路径）。

Required range:length: 1–256

Response

200-application/json

string

响应码，成功时为 Success。

integer

HTTP 状态码。

string

请求唯一标识，排查问题时请提供此 ID。

object

导入结果。

Show child attributes

string[]

导入成功的文件 ID 列表。