콘텐츠로 이동

LLM 구성 목록 빠르게 조회¶

GET /api/v1/llm_cfg/quick_list

개요¶

현재 워크스페이스의 LLM 애플리케이션 간단 구성 정보를 조회합니다. 드롭다운 옵션, 간단한 표시, 일괄 사전 검증에 적합합니다.

Query 요청 파라미터¶

파라미터명	유형	필수	설명
search	string		애플리케이션 이름으로 검색 허용: False
type	string		애플리케이션 유형, 현재 `Langfuse`만 지원 허용: False 선택 가능 값: ['Langfuse']
appId	commaArray		appId로 필터링, 여러 개 입력 가능, 쉼표로 구분 허용: False

파라미터 추가 설명¶

인터페이스 설명¶

현재 워크스페이스의 LLM 애플리케이션 간단 목록을 반환합니다. 드롭다운 옵션, 기본 표시, 간단한 열거에 적합합니다.

사용 사례¶

외부 시스템에서 등록된 LLM 애플리케이션 선택
appId를 기준으로 애플리케이션 기본 정보 일괄 표시
페이징 및 통계 지표가 필요하지 않을 때 빠른 조회

반환 특징¶

애플리케이션 기본 구성만 반환하며 clientToken은 반환하지 않음
jsonContent는 원본 구성 구조
현재 인터페이스는 AK가 속한 워크스페이스의 데이터만 조회하며, 워크스페이스 간 조회는 지원하지 않음

jsonContent의 주요 필드는 다음과 같습니다.

필드	설명
`name`	애플리케이션 이름
`type`	애플리케이션 유형, 현재 `Langfuse`만 지원
`site`	사이트 주소
`extend`	확장 구성

사용 제안¶

선택기에서 appId + name만 필요한 경우 본 인터페이스를 우선 사용
페이징, 토큰 정보 또는 통계 정보가 필요한 경우 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"
}