Resource 계약 기반 Agent 도구

변경

• 리소스마다 등록하던 App 도구를 고정된 범용 데이터 도구로 전환합니다. 탐색 응답에 생성·수정 입력과 업무 동작의 경로, 권한, 효과, 업무 설명을 제공합니다. data.catalog는 cursor 순회를 지원하며 data.detail은 App 상세 DTO를, data.preview는 읽기 전용 업무 검사를 사용합니다.

• 리포트와 프로세스 탐색·작업 도구를 통합하면서 작업별 권한과 확인 정책을 유지합니다. 대시보드 초안 구성은 하나의 도구를 사용합니다. 내부 전송과 중복 위젯 도구는 모델 메뉴에서 제외합니다.

• 앱 탐색에서 업무 안내 요약과 특정 안내의 단계를 조회할 수 있습니다. 테넌트 설정 메뉴의 에이전트 도구 진입점을 제거하며 사용량, 한도와 운영 기록은 유지합니다.

• 데이터 센터 선택과 조직도 가져오기 미리보기에 공통 UI 컴포넌트를 적용하고, App 개발자를 위한 NxSpreadsheetEditor 실행 예제를 추가합니다.

적용 시 필요한 작업

기존 Agent 도구 계약을 변경하는 릴리스입니다. SDK 0.4.0와 composer.lock에 고정된 App 태그를 함께 적용하세요. 전환된 App은 Core 0.4.0이 필요하므로 이 Core 릴리스와 함께 설치해야 합니다. 기존 Resource 작업 정책 키의 의미는 유지합니다. 호출자는 정식 범용·리포트·프로세스·대시보드 도구 계약을 사용해야 하며 제거된 모델 도구 이름의 별칭은 제공하지 않습니다.

조정된 패키지 잠금 파일을 포함한 Core를 먼저 배포한 뒤 해당 Gateway를 시작하세요. 기존 운영 배포 워크플로는 새 Core 릴리스를 확인한 뒤 Gateway를 갱신합니다. Resource API, 권한 검사, 사용량 집계, 한도와 운영 기록은 유지합니다. 이번 전환에 따른 데이터 마이그레이션은 없습니다.

포함된 모든 App은 Core 0.4.0과 SDK 0.4.0을 명시적으로 요구합니다. App 프런트엔드 peer는 설치된 SDK 버전과 같아야 하며 새 App 생성 결과에도 같은 계약을 적용합니다. composition DTO import를 Nexia\Laravel\ResourceComposition\AuthorizedCompositionQuery와 Nexia\Laravel\ResourceComposition\CompositionQueryContext로 갱신하세요. 이전 네임스페이스는 제거합니다.

일반 로컬 개발에서는 App 검사 시 Core 개발 브랜치 표기를 해당 릴리스 계열의 기준 버전으로 비교하며, Composer의 개발 브랜치 식별은 유지합니다. 실제 출시된 Core 버전에는 App의 정확한 버전 요구사항을 그대로 적용합니다. 선택한 로컬 SDK 소스는 package.json 버전을 사용해 이전 버전 대체 없이 고정된 SDK 의존성을 해석합니다.