콘텐츠로 이동

LLM 구성 추가¶

POST /api/v1/llm_cfg/add

개요¶

새로운 LLM 애플리케이션 구성을 생성하고, 실제로 적용된 appId와 clientToken을 반환합니다.

Body 요청 매개변수¶

매개변수명	유형	필수	설명
appId	string		사용자 정의 appId, 최대 128자 (문자 길이 기준). 영문자, 숫자, 밑줄만 지원. 전달하지 않으면 자동 생성 빈 값 허용: False 빈 문자열 허용: True $maxCharacterLength: 128
jsonContent	json	Y	JSON 형식 내용 빈 값 허용: False
jsonContent.name	string	Y	애플리케이션 이름, 동일 워크스페이스 내에서 고유 빈 값 허용: False 최대 길이: 256
jsonContent.type	string	Y	애플리케이션 유형, 현재는 `Langfuse`만 지원 빈 값 허용: False 사용 가능한 값: ['Langfuse']
jsonContent.site	string		사이트 주소 (예: `https://cloud.langfuse.com`) 빈 값 허용: False
jsonContent.extend	json		기타 확장 설정, `jsonContent.extend`에 그대로 저장 빈 값 허용: False
clientToken	string		사용자 정의 clientToken, 전달하지 않으면 자동 생성. 전달 시 시스템에 이미 존재하는 경우 기존 token 기록을 재사용 빈 값 허용: False 빈 문자열 허용: True

매개변수 추가 설명¶

인터페이스 설명¶

새로운 LLM 애플리케이션 구성을 생성합니다.

생성 규칙¶

appId는 선택 사항이며, 전달하지 않으면 백엔드에서 자동 생성합니다.
clientToken은 선택 사항이며, 전달하지 않으면 백엔드에서 자동 생성합니다.
appId를 전달할 경우 영문자, 숫자, 밑줄만 지원합니다.
동일 워크스페이스 내에서 appId는 중복을 허용하지 않습니다.
동일 워크스페이스 내에서 jsonContent.name은 중복을 허용하지 않습니다.

`jsonContent` 필드 설명¶

필드	설명
`name`	애플리케이션 이름, 외부에 표시되는 이름
`type`	애플리케이션 유형, 현재는 `Langfuse`로 고정
`site`	사이트 주소 (예: `https://cloud.langfuse.com`)
`extend`	확장 구성, 비즈니스 요구에 따라 구조를 그대로 전달

호출 성공 후¶

애플리케이션 구성이 영구 저장됩니다.
애플리케이션에 clientToken이 바인딩되거나 재사용됩니다.
하위 LLM 통계/연동 측에 애플리케이션 정보 갱신이 통지됩니다.

오류 의미¶

ft.InvalidLlmAppId: appId에 허용되지 않는 문자가 포함됨
ft.SignNameRepeat: appId 중복
ft.LlmCfgNameRepeat: 애플리케이션 이름 중복

요청 예시¶

curl 'https://openapi.guance.com/api/v1/llm_cfg/add' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  --data-raw '{"appId":"llm_app_demo","jsonContent":{"name":"Langfuse Prod","type":"Langfuse","site":"https://cloud.langfuse.com","extend":{"service":"prod"}}}' \
  --compressed

응답¶

{
    "code": 200,
    "content": {
        "appId": "llm_app_demo",
        "createAt": 1690813059,
        "creator": "acnt_xxxx32",
        "deleteAt": -1,
        "id": 1,
        "jsonContent": {
            "name": "Langfuse Prod",
            "type": "Langfuse",
            "site": "https://cloud.langfuse.com",
            "extend": {
                "service": "prod"
            }
        },
        "status": 0,
        "updateAt": 1690813059,
        "updator": "acnt_xxxx32",
        "uuid": "llm_app_demo",
        "workspaceUUID": "wksp_xxxx32",
        "clientToken": "token_xxx"
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-68EEEB4A-9ABC-4DDB-A72B-40F07F2699A5"
}