콘텐츠로 이동

LLM 구성 조회



GET /api/v1/llm_cfg/{appid}/get

개요

LLM 애플리케이션 상세를 조회하고 수집 Token과 통계를 확인합니다.

호출 전 권한 및 사용 단계

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

목록/상세는 Client Token 평문을 반환하며, 이는 수집 접속 자격 증명에 해당하므로 권한이 부여된 접속 측에만 전달해야 하고 DF-API-KEY를 클라이언트 수집 Token으로 간주해서는 안 됩니다. ifTokenExpired는 상태 호환 힌트일 뿐이며, 동일 워크스페이스 소속 여부/실제 사용 가능 여부를 증명하지 못합니다. 레코드가 누락된 경우 목록에서 오히려 false일 수 있으므로, 먼저 현재 워크스페이스의 활성 Token과 실제 수집 여부를 확인하십시오.

이 공개 get은 timeRange를 선언/전달하지 않으며, 통계는 기본 최근 24시간으로 고정됩니다. 프론트엔드 get의 조정 가능한 기간을 그대로 적용하지 마십시오. statisticalInfo는 애플리케이션 이름으로 매칭되며, 예외/데이터 없음/비 LLM 애플리케이션인 경우 모두 null이고, HTTP 200이 데이터 수집 완료를 보장하지는 않습니다.

라우트 파라미터

파라미터名 유형 필수 설명
appid string Y 현재 Key 워크스페이스의 공개 appId이며, 내부 실제 LlmCfg UUID가 아닙니다. 경로는 원본 그대로 URL 인코딩됩니다.
예시: payment_llm
조회 또는 입력 방법: LLM 애플리케이션 요약 목록에서 content[].appId를 가져오거나(uuid는 동일한 공개 별칭), 페이지네이션 목록의 content.data[].appId를 사용합니다.

요청 헤더

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

파라미터 추가 설명

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

요청 예시

curl --get 'https://openapi.guance.com/api/v1/llm_cfg/payment_llm/get' \
  -H 'DF-API-KEY: <DF-API-KEY>'

응답

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

필드 유형 설명
content object 애플리케이션 상세와 Token 평문/통계.
content.id integer 또는 null 데이터베이스 행 ID이며 경로 지정에 사용되지 않습니다. 제출 전 스냅샷에서는 null일 수 있습니다.
content.uuid string 공개 호환 별칭으로 appId와 같으며, 내부 실제 LlmCfg UUID가 아닙니다.
content.status integer 리소스 상태로 일반적으로 0이며, 소프트 삭제된 3은 조회에서 제외됩니다.
content.creator string 생성 주체 UUID이며, 현재 OpenAPI는 일반적으로 Key 리소스 wsak_입니다.
content.updator string 최근 갱신 주체이며, 갱신되지 않은 경우 비어 있을 수 있습니다.
content.createAt integer Unix 초 단위 생성 시간.
content.updateAt integer Unix 초 단위 갱신 시간이며, 갱신되지 않은 경우 일반적으로 -1입니다.
content.deleteAt integer Unix 초 단위 삭제 시간이며, 삭제되지 않은 경우 일반적으로 -1입니다.
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 선택적으로 저장되는 사이트 주소이며, 서버는 이 필드로 인해 타사 프로젝트를 자동 생성하거나 연결 가능 여부를 검증하지 않습니다.
content.jsonContent.extend object 선택적 동적 확장 객체이며, 제공되지 않으면 키가 생략될 수 있습니다.
content.jsonContent.extend.사용자 정의 키 JSON 그대로 저장되는 JSON 값이며, 추가 실행/인증 구성을 보장하지 않습니다.
content.clientToken string 목록/상세/생성 시 Client Token 평문입니다. 수정 시 생략/빈 파라미터인 경우 내부 wctn_ UUID 호환 분기가 있으니 해당 페이지를 참고하십시오.
content.ifTokenExpired boolean Token 상태 호환 힌트입니다. 목록: 레코드가 존재하고 status3이면 true, 레코드가 누락되면 오히려 false입니다. 상세: 동일한 평문에 삭제되지 않은 레코드가 임의로 존재하는지로 판단합니다. false는 현재 워크스페이스의 Token이 수집 가능하거나 이미 적용되었음을 보장하지 않습니다.
content.statisticalInfo object 다운스트림 집계 통계이며 jsonContent.name으로 매칭됩니다. 데이터가 없거나 비 LLM 애플리케이션이거나 집계 예외 시 모두 null이며, 0으로 간주해서는 안 됩니다.
content.statisticalInfo.callCount number 또는 null 기간 내 호출 수.
content.statisticalInfo.errorCount number 또는 null 기간 내 오류 수.
content.statisticalInfo.tokensCount number 또는 null 기간 내 Token 총량.
content.statisticalInfo.inputTokens number 또는 null 기간 내 입력 Token 양.
content.statisticalInfo.outputTokens number 또는 null 기간 내 출력 Token 양.
content.statisticalInfo.p50 number 또는 null 요청 지연 50분위이며, Studio는 집계 값을 그대로 전달하고 단위를 변환하지 않습니다. 사용 시 수집/집계 소스의 단위와 일치시켜야 합니다.
content.statisticalInfo.p75 number 또는 null 요청 지연 75분위이며 p50과 동일한 단위 기준입니다.
content.declaration object 또는 null 현재 워크스페이스의 공개 선언.
{
  "code": 200,
  "content": {
    "id": 7,
    "uuid": "payment_llm",
    "status": 0,
    "creator": "wsak_example",
    "updator": "",
    "createAt": 1785427200,
    "updateAt": -1,
    "deleteAt": -1,
    "workspaceUUID": "wksp_example",
    "appId": "payment_llm",
    "appType": "",
    "jsonContent": {
      "name": "支付助手",
      "type": "Langfuse",
      "site": "https://llm.example.com",
      "extend": {
        "team": "payment"
      }
    },
    "clientToken": "<LLM-CLIENT-TOKEN>",
    "ifTokenExpired": false,
    "statisticalInfo": {
      "callCount": null,
      "errorCount": null,
      "tokensCount": null,
      "inputTokens": null,
      "outputTokens": null,
      "p50": null,
      "p75": null
    },
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방식
404 ft.NotFoundLlmSet 애플리케이션이 존재하지 않거나/삭제되었거나/현재 워크스페이스에 없거나, 숨겨진 Agent 모니터링 내장 애플리케이션에 속함 지정한 LLM 설정을 찾을 수 없음 이 그룹의 요약 목록에서 공개 appId를 다시 선택하십시오. 내장 애플리케이션은 제품 전용 관리 진입점을 사용하십시오.
500 ft.InternalServerError 데이터베이스/Token 읽기, 이력 jsonContent/appType 또는 다운스트림 rollup 응답 형태 구성 등 처리되지 않은 예외 내부 오류 애플리케이션/Token 구성과 traceId를 확인하고 백오프하며 재시도하십시오. 집계 쿼리 예외는 일반적으로 모두 null로 허용 처리되며 호출 수가 0임을 의미하지 않습니다.

문서 평가

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