POST
/
api
/
datasets
curl --request POST \
  --url https://app.pathors.com/api/datasets \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{}'

​
建立資料集

建立並將新資料集嵌入到您指定的知識庫中。

​
上傳資料集

​
路徑參數

​
knowledgebaseId
string
required

要添加資料集的知識庫 ID

​
請求頭

​
x-api-key
string
required

用於認證的專案 API 金鑰

​
請求體

請求應以 multipart/form-data 格式發送，包含以下欄位：

​
dataset
file
required

要上傳和嵌入的資料集檔案

請求範例：

curl -X POST \
  -H "x-api-key: your-api-key" \
  -F "dataset=@/path/to/your/file.pdf" \
  https://api.pathors.com/api/datasets

​
回應

成功的請求將返回 201 狀態碼，表示資料集已成功建立。

​
處理流程

當資料集上傳後：

  1. 檔案被安全存儲
  2. 內容被分割成可管理的片段
  3. 使用知識庫配置的嵌入模型對每個片段進行嵌入
  4. 嵌入向量被存儲以供後續查詢

​
支援的檔案類型

支援以下檔案擴展名：

  • PDF (.pdf)
  • 文本檔案 (.txt)

​
錯誤回應

狀態碼描述
400無效請求或不支援的檔案類型
401無效的 API 金鑰
404未找到知識庫
413檔案過大
500內部伺服器錯誤

​
使用說明

  • 大檔案可能需要更長的處理時間，這是由於嵌入過程所致
  • 檔案大小上限為 10MB
  • 檔案處理是非同步的 - 使用 獲取資料集 端點檢查處理狀態
  • 每個資料集會自動被分割成適合檢索的片段