콘텐츠로 이동

LLM 구성 빠른 목록



GET /api/v1/llm_cfg/quick_list

개요

현재 워크스페이스의 LLM 애플리케이션 요약 목록을 조회합니다.

호출 전 준비 및 사용 단계

현재 Key 권한은 routine.defaultAccess 또는 llm.llmCfgManage 중 하나를 충족해야 하며, 현재 워크스페이스에만 적용됩니다. 내장 Agent 모니터링 애플리케이션은 이 그룹 목록에서 숨겨지고, 상세 조회 시 대상이 없거나 내장 대상이면 404를 반환합니다. 이 6개 인터페이스로 전용 내장 애플리케이션을 관리하지 마세요. 공개 인터페이스는 appType 또는 워크스페이스 간 파라미터를 허용하지 않으며, 프런트엔드/AI 진입점의 추가 필터링과 응답 프로젝션을 그대로 적용할 수 없습니다.

appId/appType/jsonContent/uuid/workspaceUUID만 반환하며 Token, 통계 또는 페이지네이션은 포함하지 않습니다. 베어 배열의 각 비어 있지 않은 항목에는 declaration이 추가됩니다. uuid는 appId와 같습니다.

요청 헤더

파라미터 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

Query 요청 파라미터

파라미터 이름 유형 필수 설명
appId commaArray 선택적 쉼표 구분 문자열입니다. 전체 문자열의 앞뒤 공백을 제거한 후 분할하며, 각 항목은 개별적으로 trim하지 않습니다. 생략하거나 비어 있으면 ID로 필터링하지 않습니다. JSON 배열이 아닙니다.
null 허용: False
예: payment_llm,assistant_llm
가져오기 또는 입력 방법: LLM 애플리케이션 요약 목록의 content[].appId(uuid는 동일한 공개 별칭) 또는 페이지네이션 목록의 content.data[].appId에서 가져옵니다.
search string 선택 사항이며 앞뒤 공백을 제거하고 SQL ILIKE 퍼지 매칭을 수행합니다. %/_는 와일드카드 의미를 유지합니다.
null 허용: False
예: 支付
가져오기 또는 입력 방법: 애플리케이션 jsonContent.name을 기준으로 검색합니다.
type string 선택적 정확한 유형이며, 생략하면 필터링하지 않습니다. 공개 열거형은 Langfuse뿐입니다.
null 허용: False
선택 가능한 값: ['Langfuse']
예: Langfuse
가져오기 또는 입력 방법: 현재 공개적으로 필터링 가능한 유형은 Langfuse입니다.

파라미터 추가 설명

appId는 공개 애플리케이션 식별자이고 uuid는 이에 대한 호환 별칭입니다. 이 페이지의 실제 Token, 통계 및 오류 경계에 따라 사용하며, 프런트엔드/AI 인터페이스의 추가 파라미터를 그대로 적용하지 않습니다.

요청 예시

curl --get 'https://openapi.guance.com/api/v1/llm_cfg/quick_list' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-urlencode type=Langfuse

응답

HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.

필드 유형 설명
content array<object> 현재 워크스페이스의 애플리케이션 요약 목록이며, 일치하는 항목이 없으면 []입니다.
content[].uuid string 공개 호환 별칭으로 appId와 같으며, 내부 실제 LlmCfg UUID가 아닙니다.
content[].workspaceUUID string 현재 Key가 속한 워크스페이스입니다.
content[].appId string 공개 애플리케이션 ID이며, 기본적으로 llmcfg_ 접두사 값이 자동 생성됩니다.
content[].appType string 애플리케이션 패밀리 표시자로, 공개 생성 시 일반적으로 비어 있습니다. 기존 데이터에는 llm/agent/obsyTeam 등이 있을 수 있으나, 이 공개 입력에서는 appType을 허용하지 않습니다.
content[].jsonContent object 애플리케이션 표시/연동 구성이며, 선언되지 않은 추가 최상위 하위 키를 포함하여 쓸 수 없습니다.
content[].jsonContent.name string 애플리케이션 표시 이름이며, 통계는 이 이름을 기준으로 매칭합니다.
content[].jsonContent.type string 공개 쓰기는 Langfuse만 가능하며, 기존 유형은 다를 수 있으나 공개적으로 다시 쓸 수 있다는 의미는 아닙니다.
content[].jsonContent.site string 선택적으로 저장되는 사이트 주소입니다. 서버는 이 필드로 인해 제3자 프로젝트를 자동 생성하거나 연결 가능 여부를 검증하지 않습니다.
content[].jsonContent.extend object 선택적 동적 확장 객체이며, 제공되지 않으면 키를 생략할 수 있습니다.
content[].jsonContent.extend.사용자 정의 키 JSON 그대로 저장되는 JSON 값이며, 추가 실행/인증 구성을 보장하지 않습니다.
content[].declaration object 또는 null 현재 워크스페이스의 공통 선언입니다.
{
  "code": 200,
  "content": [
    {
      "uuid": "payment_llm",
      "appId": "payment_llm",
      "appType": "",
      "jsonContent": {
        "name": "支付助手",
        "type": "Langfuse",
        "site": "https://llm.example.com",
        "extend": {
          "team": "payment"
        }
      },
      "workspaceUUID": "wksp_example",
      "declaration": {}
    }
  ],
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하세요.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 선언되지 않은 Query 파라미터를 사용했거나 파라미터가 규칙을 위반함 파라미터 파싱 실패 Query 파라미터 표와 예시를 확인하세요.
500 ft.InternalServerError 데이터베이스 읽기, 기존 jsonContent/appType 형태 또는 경량 목록 프로젝션 등에서 처리되지 않은 예외 발생 내부 오류 현재 워크스페이스의 애플리케이션 구성과 traceId를 확인한 후 백오프 재시도하세요. 이 진입점은 통계나 페이지네이션을 조회하지 않습니다.

문서 평가

이 페이지가 도움이 되었나요?