コンテンツにスキップ

LLM 設定をクイック一覧表示¶

GET /api/v1/llm_cfg/quick_list

概要¶

現在のワークスペース配下の LLM アプリケーションの簡易設定情報を一覧表示します。ドロップダウンオプション、軽量エコー、一括事前検証に適しています。

Query パラメータ¶

パラメータ名	型	必須	説明
search	string		アプリケーション名であいまい検索します。空を許可: False
type	string		アプリケーションタイプ、現在は `Langfuse` のみサポートします。空を許可: False 選択可能な値: ['Langfuse']
appId	commaArray		appId でフィルタリングします。複数指定可能、カンマ区切りです。空を許可: False

パラメータ補足説明¶

API 説明¶

現在のワークスペース配下の LLM アプリケーション簡易一覧を返します。ドロップダウンオプション、基本エコー、軽量列挙に適しています。

適用シナリオ¶

外部システムで登録済みの LLM アプリケーションを選択する場合
appId をもとにアプリケーション基本情報を一括補完する場合
ページネーションや統計指標が不要で、クイッククエリを行う場合

レスポンスの特徴¶

アプリケーションの基本設定のみを返し、clientToken は返しません。
jsonContent は元の設定構造です。
本 API は AK が所属するワークスペース配下のデータのみをクエリし、ワークスペースをまたいだクエリはサポートしません。

jsonContent の現在の主要フィールドは以下の通りです。

フィールド	説明
`name`	アプリケーション名
`type`	アプリケーションタイプ、現在は `Langfuse` のみサポート
`site`	サイトアドレス
`extend`	拡張設定

使用上の推奨¶

appId + name のみを取得してセレクターとして使用する場合は、本 API を優先的に使用してください。
ページネーション、トークン情報、統計情報が必要な場合は、GET /api/v1/llm_cfg/list をご利用ください。

リクエスト例¶

curl 'https://openapi.guance.com/api/v1/llm_cfg/quick_list?appId=llm_app_demo' \
  -H 'Content-Type: application/json' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --compressed

レスポンス¶

{
    "code": 200,
    "content": [
        {
            "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"
        }
    ],
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-68EEEB4A-9ABC-4DDB-A72B-40F07F2699A5"
}