콘텐츠로 이동

LLM 설정 삭제



POST /api/v1/llm_cfg/delete

개요

LLM 애플리케이션을 일괄 소프트 삭제하고 다운스트림에 새로 고침을 알립니다.

호출 전 및 사용 단계

현재 Key에는 llm.llmCfgManage 권한이 필요합니다. appIds 값은 요약 목록에서 공개 appId를 가져오며, 생략하거나 []이면 일치 항목이 없어 {}를 반환합니다. 현재 워크스페이스에서 삭제되지 않은 애플리케이션만 선택하며, 알 수 없거나 다른 워크스페이스에 속하거나 이미 삭제된 항목은 무시합니다. 보호된 내장 Agent 애플리케이션과 하나라도 일치하면 InvalidAction이 발생하며 자동으로 건너뛰지 않습니다.

애플리케이션을 소프트 삭제한 후 항목별로 다운스트림에 동기화 알림을 보냅니다. 공유 Client Token을 삭제하거나 취소하지 않으며, 과거 LLM 텔레메트리도 삭제하지 않습니다. 실패 시 일부 알림이 완료되고 데이터베이스가 모두 커밋되었을 수 있으므로 먼저 요약 목록/상세 정보로 확인하고, HTTP 오류만으로 삭제되지 않았다고 판단하지 마십시오. 공개 복구 API가 없으므로 삭제 전에 설정을 저장해야 합니다. 재생성한다고 해서 과거 통계나 Token 권한이 자동으로 복구되는 것은 아닙니다.

요청 헤더

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

Body 요청 매개변수

매개변수 이름 유형 필수 설명
appIds[*] string appId 문자열 하나입니다. 내부 UUID가 아니며, uuid는 공개 별칭으로 사용할 수 있지만 appId와 일치해야 합니다.
예: payment_llm
획득 또는 입력 방법: LLM 애플리케이션 요약 목록에서 content[].appId를 가져오거나(uuid는 동일한 공개 별칭임), 페이지네이션 목록의 content.data[].appId를 사용합니다.
appIds array 선택적 공개 appId 배열이며, 생략하거나 []이면 대상이 없습니다. 알 수 없는 항목은 무시하며 항목별 오류/카운트를 반환하지 않습니다.
null 허용: False
예: ["payment_llm"]
획득 또는 입력 방법: LLM 애플리케이션 요약 목록에서 content[].appId를 가져오거나(uuid는 동일한 공개 별칭임), 페이지네이션 목록의 content.data[].appId를 사용합니다.

매개변수 추가 설명

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

요청 예

curl --request POST 'https://openapi.guance.com/api/v1/llm_cfg/delete' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  -H 'Content-Type: application/json' \
  --data-raw '{"appIds":["payment_llm"]}'

응답

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

필드 유형 설명
content object 실제 삭제된 appId→이름 매핑이며, 일치 항목이 없으면 {}입니다.
content.애플리케이션 식별자 string 실제 삭제된 특정 애플리케이션의 표시 이름입니다.
content.declaration object 또는 null 비어 있지 않은 매핑에만 공통 선언을 자동으로 추가합니다. appId 이름은 declaration 예약 키와 충돌하지 않도록 지정합니다.
{
  "code": 200,
  "content": {
    "payment_llm": "支付助手",
    "declaration": {}
  },
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}
{
  "code": 200,
  "content": {},
  "errorCode": "",
  "message": "",
  "success": true,
  "traceId": "TRACE-EXAMPLE"
}

오류 응답

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

주 데이터베이스가 먼저 커밋된 후 설정 변경 알림을 동기적으로 호출합니다. 다운스트림 비즈니스 4xx는 실제 HTTP/errorCode/message에 따라 반환될 수 있으며, 전달되지 않은 >=500 응답은 일괄 500으로 처리됩니다. 어떤 후속 오류도 데이터베이스 롤백을 보장하지 않으므로 먼저 다시 읽어 확인하십시오. 통계 쿼리 예외는 일반적으로 전체 null로 내결함 처리되며, 쓰기 알림 오류와 혼동하지 않습니다.

HTTP 상태 errorCode 트리거 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반했습니다 매개변수 구문 분석 실패 매개변수 위치, 필드 이름, 유형 및 값을 확인하십시오.
400 ft.RequestJsonFormatError 요청 JSON 구문이 유효하지 않습니다 요청 JSON 형식 오류 content.reason, line, column에 따라 JSON을 수정하십시오.
400 ft.JsonFormatError JSON 최상위가 객체가 아닙니다 일부 json 파일 형식 오류 appIds 객체를 제출하십시오.
400 ft.InvalidAction 보호된 Agent 모니터링 내장 애플리케이션과 일치했습니다 Agent monitor builtin applications cannot be modified or deleted 현재 공개 요약 목록에서 일반 애플리케이션을 선택하고, 전용 관리 프로세스를 사용하십시오.
500 ft.InternalServerError 데이터베이스/Token/과거 설정, 커밋 후 설정의 다운스트림 알림 또는 응답 구성 중 예외가 발생했습니다 내부 오류 먼저 appId/이름/Token 바인딩과 다운스트림의 실제 연결을 다시 읽어 확인하십시오. 주 데이터가 이미 커밋되었을 수 있으므로 무작정 다시 생성하거나 Token을 교체하지 마십시오. traceId를 보관하여 추적하십시오.

문서 평가

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