Mengkueri daftar file dalam basis pengetahuan.
Coba sekarang
Test
RAM authorization
Sintaks permintaan
POST HTTP/1.1Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID wilayah. |
cn-beijing |
| KnowledgeBaseId |
string |
Yes |
ID unik basis pengetahuan. |
pkb-xxxxx |
| PageNumber |
integer |
No |
Nomor halaman. |
1 |
| PageSize |
integer |
No |
Jumlah rekaman per halaman. |
20 |
| SourceType |
string |
No |
Tipe sumber. |
OSS |
| Keyword |
string |
No |
Kata kunci yang digunakan untuk memfilter nama file. |
Laporan keuangan |
| FileIds |
string |
No |
Daftar ID file, dipisahkan dengan koma (,). |
doc_a,doc_b |
| LinkId |
string |
No |
ID unik tautan sinkronisasi. |
pkbl-2ze123456789abc |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Skema respons. |
||
| RequestId |
string |
ID permintaan. |
CED079B7-A408-41A1-BFF1-EC608E****** |
| PageNumber |
integer |
Nomor halaman. |
1 |
| PageSize |
integer |
Jumlah rekaman per halaman. Nilai valid: 30, 50, dan 100. Nilai default: 30. |
30 |
| TotalRecordCount |
integer |
Jumlah total rekaman. |
9 |
| PageRecordCount |
integer |
Jumlah rekaman pada halaman saat ini. |
9 |
| Items |
array<object> |
Daftar file. |
|
|
array<object> |
Detail file. |
||
| FileId |
string |
ID file. |
5b2dbb13-xxxx-xxxx-xxxx-a55fe8daec8f |
| KnowledgeSpaceId |
string |
ID ruang pengetahuan. |
pks-xxxxxx |
| KnowledgeBaseId |
string |
ID basis pengetahuan. |
pkb-xxxxxx |
| FileName |
string |
Nama file. |
Financial_report.pdf |
| OSSPath |
string |
Jalur file OSS. |
oss://test-bucket-example/pks-xxxx/pkb-xxxx/Financial_report.pdf |
| FileSize |
integer |
Ukuran file, dalam byte. |
318881 |
| FileType |
string |
Tipe file. |
|
| ShardCount |
integer |
Jumlah shard. |
10 |
| ShardingStrategyConfig |
object |
Konfigurasi strategi pemecahan yang saat ini berlaku untuk dokumen. Nilai ini mungkin kosong jika konfigurasi lengkap tidak disimpan untuk objek yang ada. |
|
| DefaultStrategy |
object |
Tipe strategi pemecahan default. Nilai valid: hybrid dan hierarchical. |
|
| Type |
string |
Tipe strategi pemecahan default. Nilai valid: hybrid dan hierarchical. |
hybrid |
| Parameters |
object |
Daftar parameter. |
|
| MaxTokens |
integer |
Jumlah token maksimum per shard. |
512 |
| MergePeers |
boolean |
Apakah akan menggabungkan shard kecil yang berdekatan di bawah judul yang sama. |
true |
| Rules |
array<object> |
Daftar aturan penggantian yang dicocokkan berdasarkan Pesanan. |
|
|
array<object> |
Detail aturan. |
||
| Match |
object |
Tipe konten. Saat ini, table didukung. |
|
| ContentType |
string |
Tipe konten. Saat ini, table didukung. |
table |
| Strategy |
object |
Strategi pemecahan. |
|
| Type |
string |
Tipe strategi pemecahan yang diterapkan setelah aturan dicocokkan. |
hierarchical |
| Parameters |
object |
Daftar parameter. |
|
| MaxTokens |
integer |
Jumlah token maksimum per shard untuk konten yang cocok. |
512 |
| MarkdownTables |
string |
Mode pemrosesan tabel Markdown. Nilai valid: auto, on, dan off. |
auto |
| InheritSpaceStrategy |
boolean |
Menunjukkan apakah strategi pemecahan diwarisi dari ruang pengetahuan. |
true |
| Status |
string |
Status. |
COMPLETED |
| ErrorMessage |
string |
Paket error. |
Not Support |
| Metadata |
object |
Metadata dokumen. |
{} |
| SourceType |
string |
Tipe sumber. |
OSS |
| UploadTime |
string |
Pengatur waktu unggah. |
2026-06-15T22:28:53Z |
| UpdatedAt |
string |
Pengatur waktu pembaruan. |
2026-06-15T22:28:53Z |
Contoh
Respons sukses
JSONformat
{
"RequestId": "CED079B7-A408-41A1-BFF1-EC608E******",
"PageNumber": 1,
"PageSize": 30,
"TotalRecordCount": 9,
"PageRecordCount": 9,
"Items": [
{
"FileId": "5b2dbb13-xxxx-xxxx-xxxx-a55fe8daec8f",
"KnowledgeSpaceId": "pks-xxxxxx",
"KnowledgeBaseId": "pkb-xxxxxx",
"FileName": "财报.pdf",
"OSSPath": "oss://test-bucket-example/pks-xxxx/pkb-xxxx/财报.pdf",
"FileSize": 318881,
"FileType": "pdf",
"ShardCount": 10,
"ShardingStrategyConfig": {
"DefaultStrategy": {
"Type": "hybrid",
"Parameters": {
"MaxTokens": 512,
"MergePeers": true
}
},
"Rules": [
{
"Match": {
"ContentType": "table"
},
"Strategy": {
"Type": "hierarchical",
"Parameters": {
"MaxTokens": 512,
"MarkdownTables": "auto"
}
}
}
]
},
"InheritSpaceStrategy": true,
"Status": "COMPLETED",
"ErrorMessage": "Not Support.",
"Metadata": {},
"SourceType": "OSS",
"UploadTime": "2026-06-15T22:28:53Z",
"UpdatedAt": "2026-06-15T22:28:53Z"
}
]
}Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.