指定されたワークスペース内の 1 つ以上のナレッジベースの詳細を取得します。
操作説明
この操作を呼び出す前に、RAM ユーザーは Alibaba Cloud Model Studio に必要な API 権限 を持っている必要があります。 sfm:ListIndex 権限を含む
AliyunBailianDataFullAccessポリシーが必要です。 Alibaba Cloud アカウントは、認証なしでこの操作を呼び出すことができます。 この操作は、Alibaba Cloud Model Studio SDK の最新バージョンを使用して呼び出すことができます。この操作は冪等です。
スロットリング この操作の呼び出しは、頻度によってスロットルされます。 1 秒あたり 10 回を超えないでください。 呼び出しがスロットルされた場合は、後で再試行してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
sfm:ListIndex |
list |
*All Resource
|
なし | なし |
リクエスト構文
GET /{WorkspaceId}/index/list_indices HTTP/1.1リクエストパラメーター
|
パラメーター |
タイプ |
必須 / 任意 |
説明 |
例 |
| IndexName |
string |
任意 |
ナレッジベースの名前。名前でナレッジベースを検索できます。名前は 1 ～ 20 文字で、英語、中国語、数字などの Unicode 標準の文字を含めることができます。 また、コロン（:）、アンダースコア（_）、ピリオド（.）、またはハイフン（-）を含めることもできます。 デフォルト値は空です。このパラメータが空の場合、指定されたワークスペース内のすべてのナレッジベースがクエリされます。 |
idx_status_score |
| PageNumber |
string |
任意 |
ページ番号。値は 1 から始まります。デフォルト値：1。 |
1 |
| PageSize |
string |
任意 |
各ページに返すナレッジベースの数。値は制限されていません。 デフォルト値：10。 |
10 |
| WorkspaceId |
string |
必須 |
ナレッジベースが属するワークスペースの ID。 詳細については、「ワークスペースの使い方」をご参照ください。 |
llm-3shx2gu255oq6xxxx |
レスポンスパラメーター
|
パラメーター |
タイプ |
説明 |
例 |
|
object |
レスポンススキーマ。 |
||
| RequestId |
string |
リクエスト ID。 |
17204B98-xxxx-4F9A-8464-2446A84821CA |
| Data |
object |
返されたデータ。 |
|
| PageNumber |
integer |
返されたページ番号。 |
1 |
| PageSize |
integer |
各ページに返されるエントリの数。 |
10 |
| TotalCount |
integer |
返されたエントリの総数。 |
48 |
| Indices |
array<object> |
ナレッジベースのリスト。 |
|
|
object |
ナレッジベースオブジェクト。 |
||
| Id |
string |
ナレッジベースの ID。 これは、CreateIndex 操作によって返される |
lecxr5xxxx |
| Name |
string |
ナレッジベースの名前。 |
XXXX产品清单 |
| Description |
string |
ナレッジベースの説明。 |
清单中产品主要面向海外客户。 |
| StructureType |
string |
ナレッジベースの構造タイプ。有効な値：
|
UNSTRUCTURED |
| ChunkSize |
integer |
各チャンクの推定長。値の範囲は 1 ～ 2048 です。 |
5 |
| OverlapSize |
integer |
チャンク間の重複の長さ。値の範囲は 0 ～ 1024 です。 |
10 |
| Separator |
string |
文の区切り文字。複数の区切り文字を指定する場合は、縦棒（|）を使用して区切ります。有効な値：
|
\n |
| EmbeddingModelName |
string |
埋め込みモデルの名前。有効な値：
|
conv-rewrite-qwen-1.8b |
| RerankModelName |
string |
再ランク付けモデルの名前。有効な値：
|
gte-rerank-hybrid |
| RerankMinScore |
string |
類似度のしきい値。値の範囲は 0.01 ～ 1.00 です。 |
0.01 |
| SourceType |
string |
Alibaba Cloud Model Studio アプリケーションデータ 内のアプリケーションデータのデータ型。非構造化ナレッジベースの場合、有効な値は次のとおりです。
構造化ナレッジベースの場合、有効な値は次のとおりです。
|
DATA_CENTER_FILE |
| DocumentIds |
array |
ドキュメント ID のリスト。 |
|
|
string |
ドキュメント ID。 |
file_8c67b438043848199ffaa903d29addd4_xxxxxxxx |
|
| SinkType |
string |
ナレッジベースのベクトルストレージタイプ。有効な値：
|
BUILT_IN |
| SinkInstanceId |
string |
ベクトルストアのインスタンス ID。 |
gp-bp1gq62t1788yxxxx |
| SinkRegion |
string |
ベクトルストアインスタンスのリージョン。 |
cn-hangzhou |
| ConfgModel |
string |
||
| EnableRewrite |
boolean |
||
| Code |
string |
エラーコード。 |
Index.InvalidParameter |
| Message |
string |
エラーメッセージ。 |
Required parameter(%s) missing or invalid, please check the request parameters. |
| Success |
boolean |
API 呼び出しが成功したかどうかを示します。有効な値：
|
true |
| Status |
string |
返された HTTP ステータスコード。 |
200 |
例
成功レスポンス
JSONJSON
{
"RequestId": "17204B98-xxxx-4F9A-8464-2446A84821CA",
"Data": {
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 48,
"Indices": [
{
"Id": "lecxr5xxxx",
"Name": "XXXX产品清单",
"Description": "清单中产品主要面向海外客户。",
"StructureType": "UNSTRUCTURED",
"ChunkSize": 5,
"OverlapSize": 10,
"Separator": "\\n",
"EmbeddingModelName": "conv-rewrite-qwen-1.8b",
"RerankModelName": "gte-rerank-hybrid",
"RerankMinScore": "0.01",
"SourceType": "DATA_CENTER_FILE",
"DocumentIds": [
"file_8c67b438043848199ffaa903d29addd4_xxxxxxxx"
],
"SinkType": "BUILT_IN",
"SinkInstanceId": "gp-bp1gq62t1788yxxxx",
"SinkRegion": "cn-hangzhou",
"ConfgModel": "",
"EnableRewrite": true
}
]
},
"Code": "Index.InvalidParameter",
"Message": "Required parameter(%s) missing or invalid, please check the request parameters.",
"Success": true,
"Status": "200"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。