すべてのプロダクト
Search
ドキュメントセンター

Qoder CN シリーズ:ナレッジベースファイルのバッチアップロード

最終更新日:Mar 27, 2026

この OpenAPI オペレーションを使用して、複数のファイルをナレッジベースにアップロードします。

サポートされているエディション

Enterprise Dedicated Edition

サービスエンドポイント

サービスエンドポイントを取得し、API リクエスト構文の {domain} をご利用の エンドポイント に置き換えます。

認証情報

プロダクト

リソース

必要な権限

Lingma

ナレッジベースファイル

読み取り/書き込み

リクエスト構文

POST https://{domain}/oapi/v1/lingma/organizations/{organizationId}/knowledgeBases/{kbId}/files/batchUpload

リクエスト

curl -X 'POST' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/lingma/organizations/99d1****71d4/knowledgeBases/1f23ea7459c45e1f04c3****/files/batchUpload' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --form 'files=@"/D:/lingma/file1.md"' \
  --form 'files=@"/D:/lingma/file2.md"'

リクエストヘッダー

x-yunxiao-token string (必須)

アクセストークンです。詳細については、「 アクセストークン 」をご参照ください。

例: pt-0fh3****0fbG_35af****0484。

リクエストパラメーター

kbId string (必須)

ナレッジベース ID です。この ID は、ListKnowledgeBases オペレーションを呼び出すことで取得できます。

files array[File] (必須)

ナレッジベースにアップロードするファイルです。

  • サポートされているフォーマット: PDF、CSV、DOCX、TXT、および Markdown。

  • 単一のリクエストには、最大 10 個のファイルを含めることができます。各ファイルは 10 MB を超えることはできません。

  • ファイル名は 200 文字を超えることはできません。

レスポンス

[
    {
        "fileId": "aefb0ce3924fc778260cc274",
        "operateUserId": "bf2fce4f-7048-4017-a734-1c346e68****",
        "success": true
    },
    {
        "fileId": "51b47ec207ed09ee2ee288a5",
        "operateUserId": "bf2fce4f-7048-4017-a734-1c346e68****",
        "success": true
    }
]

fileId string

ファイル ID です。

operateUserId string

オペレーターの ID です。

success boolean

個々のファイルが正常にアップロードされたかどうかを示します。

  • true: アップロードに成功しました。

  • false: アップロードに失敗しました。

failedMessage string

エラーメッセージです。このパラメーターは、success が false の場合にのみ返されます。

エラーコード

詳細については、「エラーコード」をご参照ください。