콘텐츠로 이동

LLM 구성 수정¶

POST /api/v1/llm_cfg/{appid}/modify

개요¶

지정된 LLM 애플리케이션 구성을 수정합니다. 이름 변경, appId 변경, 사이트 변경, 확장 구성 변경 및 토큰 교체를 지원합니다.

경로 매개변수¶

매개변수명	유형	필수	설명
appid	string	Y	수정할 LLM 애플리케이션의 appId

본문 요청 매개변수¶

매개변수명	유형	필수	설명
newAppId	string		새 appId, 전달하지 않으면 원래 값 유지, 영문자, 숫자, 밑줄만 지원 빈 값 허용: False 빈 문자열 허용: True $maxCharacterLength: 128
jsonContent	json		JSON 형식 콘텐츠
jsonContent.name	string		애플리케이션 이름, 동일한 워크스페이스 내에서 고유 빈 값 허용: False 최대 길이: 256
jsonContent.type	string		애플리케이션 유형, 현재 `Langfuse`만 지원 빈 값 허용: False 선택 가능 값: ['Langfuse']
jsonContent.site	string		사이트 주소 빈 값 허용: False
jsonContent.extend	json		기타 확장 설정, `jsonContent.extend`에 원래대로 저장 빈 값 허용: False
clientToken	string		새 clientToken, 전달하지 않으면 원래 토큰 유지 빈 값 허용: False 빈 문자열 허용: True

매개변수 추가 설명¶

인터페이스 설명¶

지정된 appid에 해당하는 LLM 애플리케이션을 수정합니다.

수정 규칙¶

newAppId는 선택 사항이며, 전달하지 않으면 원래 appId 유지
jsonContent는 부분 업데이트
clientToken은 선택 사항이며, 전달하지 않으면 원래 토큰 유지
newAppId를 전달하는 경우 영문자, 숫자, 밑줄만 지원

현재 업데이트를 지원하는 jsonContent 필드는 다음과 같습니다.

필드	설명
`name`	애플리케이션 이름
`type`	애플리케이션 유형
`site`	사이트 주소
`extend`	확장 구성

반환 설명¶

성공 후 수정된 전체 객체 반환
clientToken은 실제 토큰 문자열 반환
새 토큰을 전달하지 않은 경우, 반환 값의 clientToken은 여전히 원래 토큰

일반적인 시나리오¶

표시 이름 조정
연결 사이트 주소 변경
client token 교체
appId 정규화

오류 의미¶

ft.InvalidLlmAppuuid : 원래 appid가 존재하지 않음
ft.InvalidLlmAppId : newAppId에 잘못된 문자가 포함됨
ft.SignNameRepeat : newAppId가 다른 애플리케이션과 중복됨
ft.LlmCfgNameRepeat : 새 이름이 중복됨

요청 예시¶

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

응답¶

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