建立知識庫
建立知識庫
可透過此介面,為 API Key 綁定的 Agent 建立一個新的知識庫。
請求方法
POST
請求 URL
https://api-${endpoint}.gptbots.ai/v1/bot/knowledge/base/create
請求驗證
請參閱總覽以瞭解驗證相關細節。
請求
請求範例
curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/bot/knowledge/base/create' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
"name": "產品知識庫",
"desc": "用於存放產品說明、FAQ 與業務資料的知識庫",
"graph_enable": false,
"access_control_enabled": false
}'
curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/bot/knowledge/base/create' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
"name": "產品知識庫",
"desc": "用於存放產品說明、FAQ 與業務資料的知識庫",
"graph_enable": false,
"access_control_enabled": false
}'
此代碼塊在浮窗中顯示
請求標頭
| 欄位 | 類型 | 說明 |
|---|---|---|
| Authorization | Bearer ${API Key} | 使用 Authorization: Bearer ${API Key} 進行驗證。API Key 可在 API Key 頁面取得。 |
請求參數
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
| name | String | 是 | 知識庫名稱。 |
| desc | String | 是 | 知識庫描述。 |
| graph_enable | Boolean | 否 | 是否啟用知識圖譜。 |
| kg_ner_extraction_user_prompt | String | 否 | 三元組擷取提示詞。為空時使用系統預設設定。 |
| access_control_enabled | Boolean | 否 | 是否啟用存取控制,即角色或文件層級的權限過濾。 |
回應
回應範例
{
"knowledge_base_id": "6a475ee61d276b3d062a1bcb"
}
{
"knowledge_base_id": "6a475ee61d276b3d062a1bcb"
}
此代碼塊在浮窗中顯示
成功回應
| 欄位 | 類型 | 說明 |
|---|---|---|
| knowledge_base_id | String | 新建立的知識庫 ID。 |
失敗回應
| 欄位 | 類型 | 說明 |
|---|---|---|
| code | Integer | 錯誤代碼。 |
| message | String | 錯誤詳細資訊。 |
