コンテンツにスキップ

LLM 設定を一覧表示¶

GET /api/v1/llm_cfg/list

概要¶

現在のワークスペースにおける LLM アプリケーション設定を一覧表示します。ページネーション、フィルタリング、および統計指標の集計に対応しています。

Query リクエストパラメータ¶

パラメータ名	型	必須	説明
search	string		アプリケーション名による曖昧検索空を許可: False
type	string		アプリケーションタイプ。現在は `Langfuse` のみサポート空を許可: False 選択可能な値: ['Langfuse']
pageIndex	int		ページ番号空を許可: False $default: 1
pageSize	int		1ページあたりの件数（最大 100）空を許可: False $default: 20
timeRange	array		統計情報の時間範囲（ミリ秒のタイムスタンプ配列）。未指定の場合はデフォルトで直近 24 時間。例: `[1711900800000,1711987200000]` 空を許可: False

パラメータ補足説明¶

インターフェース説明¶

現在のワークスペースにおける LLM アプリケーション設定のリストを返します。ページネーション、フィルタリング、および統計指標の集計に対応しています。

`quick_list` との違い¶

本インターフェースはページネーションに対応
本インターフェースは clientToken を返す
本インターフェースは ifTokenExpired を返す
本インターフェースは LLM 呼び出し統計情報をマージする

統計情報フィールド¶

フィールド	説明
`statisticalInfo.callCount`	呼び出し回数
`statisticalInfo.errorCount`	エラー回数
`statisticalInfo.tokensCount`	トークン総数
`statisticalInfo.p50`	リクエストレイテンシ p50
`statisticalInfo.p75`	リクエストレイテンシ p75

時間範囲の説明¶

timeRange で統計クエリの時間範囲を指定できます。形式はミリ秒のタイムスタンプ配列 [start, end] です。
未指定の場合はデフォルトで直近 24 時間を取得します。
統計サービスが一時的に利用できない場合でも、インターフェースは設定リストを返しますが、統計フィールドは空になる可能性があります。

フィルタリングルール¶

search は jsonContent.name に対して曖昧一致
type は jsonContent.type に対して完全一致

リクエスト例¶

curl 'https://openapi.guance.com/api/v1/llm_cfg/list?pageIndex=1&pageSize=20&type=Langfuse' \
  -H 'Content-Type: application/json' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --compressed

レスポンス¶

{
    "code": 200,
    "content": {
        "data": [
            {
                "appId": "llm_app_demo",
                "jsonContent": {
                    "name": "Langfuse Prod",
                    "type": "Langfuse",
                    "site": "https://cloud.langfuse.com",
                    "extend": {
                        "service": "prod"
                    }
                },
                "uuid": "llm_app_demo",
                "workspaceUUID": "wksp_xxxx32",
                "clientToken": "token_xxx",
                "ifTokenExpired": false,
                "statisticalInfo": {
                    "callCount": 12,
                    "errorCount": 0,
                    "tokensCount": 456,
                    "p50": 10,
                    "p75": 15
                }
            }
        ],
        "pageInfo": {
            "count": 1,
            "pageIndex": 1,
            "pageSize": 20,
            "total": 1
        }
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-68EEEB4A-9ABC-4DDB-A72B-40F07F2699A5"
}