EMS Builder AI 설정 Skills
Skills를 AI Agent에 제공하고 대상 장치 연결 정보, 계정 및 설정 요구 사항을 전달하면 패키지에 포함된 자료를 바탕으로 현재 Edge-EMS Builder를 설정할 수 있습니다. 스킬 패키지에는 인터페이스 필드, 열거형, 전체 절차, 요청 예제 및 호출 도구가 포함되어 있어 백엔드 소스 코드에 접근할 필요가 없습니다.
시작 위치
섹션 제목: “시작 위치”처음 사용할 때는 전체 패키지를 다운로드하고 Agent가 aems-configure로 요구 사항을 분해하도록 하는 것이 좋습니다. 이 스킬은 별도로 다운로드할 수도 있으며, 모든 설정 분야의 가이드와 현재 등록된 인터페이스 196개의 계약을 포함합니다.
- 스킬 폴더의 압축을 풉니다. Claude Code는 프로젝트의
.claude/skills/에, Codex는.agents/skills/에 배치합니다. - Edge-EMS Builder 기본 주소를 제공합니다. LAN에서는
http://<장치_주소>:8988(/api없음), 프록시에서는https://<장치_UUID>.proxy.jelina.wise-iot-cloud.com/api를 사용합니다. 포트는 장치 설정을 기준으로 합니다. - 현재 환경에서 로그인 정보 또는 Token을 제공하고 목표, 범위 및 기존 장치/데이터 포인트를 설명합니다.
- Agent는 먼저 현재 상태와 의존성을 조회하고 요청을 검증한 후 순서대로 설정하고 결과를 다시 읽습니다. 비동기 작업은 최종 상태까지 추적합니다.
자격 증명을 스킬 파일에 작성할 필요는 없습니다. 각 설정 스킬에는 해당 분야의 계약과 호출 도구가 포함되어 있으므로 하나만 다운로드해도 다른 스킬 폴더에 의존하지 않습니다. 도구는 오프라인 필드 조회와 검증을 지원합니다. 실제 HTTP 호출에는 Python 3.10+ 표준 라이브러리를 사용하며, 실시간 읽기/쓰기용 Node.js 22+ 클라이언트도 제공합니다.
전체 기능 진입점
섹션 제목: “전체 기능 진입점”| Skill | 용도 | 다운로드 |
|---|---|---|
aems-configure |
모든 인터페이스, 분야별 가이드 및 호출 도구를 포함하는 전체 설정 오케스트레이션 | ZIP |
데이터 및 장치 템플릿
섹션 제목: “데이터 및 장치 템플릿”| Skill | 용도 | 다운로드 |
|---|---|---|
point-table-to-commbridge-excel |
포인트 목록을 CommBridge 가져오기용 Excel로 변환하며, 현재 Modbus Client에 중점 | ZIP |
aems-collection-config |
수집 설정 동기화, 식별자, 별칭, 단위 및 정리 범위 관리 | ZIP |
aems-add-aggregation |
집계 표현식, 초기값 및 런타임 변수 설정 | ZIP |
aems-time-schedule |
날짜별로 변경되거나 매일 반복되는 시간대별 계획 설정 | ZIP |
aems-data-groups |
트리 구조 그룹, 데이터 포인트 매핑, 정렬 및 이동 관리 | ZIP |
aems-ude |
유형, 인스턴스, 집계/그룹/공유 템플릿 및 실체화의 전체 설정 | ZIP |
aems-ude-placeholders |
규칙 집합, 자리표시자, 매칭 규칙 설정, 시험 계산, 영향 미리 보기 및 정합성 확인 | ZIP |
전략 및 통신
섹션 제목: “전략 및 통신”| Skill | 용도 | 다운로드 |
|---|---|---|
aems-lua-script |
집계, 트리거, MQTT 및 알람 스크립트 작성 및 검증 | ZIP |
aems-add-trigger-plan |
트리거, 조건, 동작, 후처리 및 시작/중지 설정 | ZIP |
aems-alarm-lifecycle |
알람 유형, 기록 및 이벤트 복구/해결 절차 관리 | ZIP |
aems-add-mqtt |
연결, 발행, 구독 및 응답 설정 | ZIP |
aems-device-sharing |
장치, 공유 대상 및 여러 공유 설정의 바인딩 설정 | ZIP |
aems-write-data |
실시간 구독, 읽기/쓰기 및 원격 제어 결과 확인 | ZIP |
분석 및 보존
섹션 제목: “분석 및 보존”| Skill | 용도 | 다운로드 |
|---|---|---|
aems-history-chart |
상세 데이터, 통계 및 제한된 추세 그래프 조회 | ZIP |
aems-forecast |
Agent 측에서 추세를 추정하고 방법과 오차 설명 | ZIP |
aems-history-export |
비동기 이력 데이터 내보내기 생성, 추적 및 다운로드 | ZIP |
aems-history-archive |
여러 아카이브 계획, 저장 대상 및 실패 시 재시도 관리 | ZIP |
계정 및 운영 관리
섹션 제목: “계정 및 운영 관리”| Skill | 용도 | 다운로드 |
|---|---|---|
aems-account-management |
사용자 생성, 역할 할당, 계정 및 암호 관리 | ZIP |
aems-runtime-config |
지원되는 실행 매개변수 수정, 환경 재정의 및 보존 정책 확인 | ZIP |
aems-backup-restore |
설정 백업, 유지보수 잠금 상태에서 복원 및 유형별 정리 | ZIP |
aems-display-config |
기존 프런트엔드 구조에 따라 표시 설정 JSON 읽기/쓰기 | ZIP |
aems-system-maintenance |
용량, 설정, 유지보수 상태 및 제어 로그 통합 점검 | ZIP |
설정 및 검증 범위
섹션 제목: “설정 및 검증 범위”스킬은 대상 장치에 구현된 API와 계정 권한을 기준으로 작동합니다. 프로토콜 드라이버 설정은 외부 CommBridge 영역이며, 표시 설정에는 실제 프런트엔드 형식이 필요합니다. 아직 제공되지 않은 인터페이스는 사용 가능한 기능으로 취급하지 않습니다. 전략, 제어 및 데이터 정리는 명확한 범위에서 검증해야 하며, 요청 수락이 장치 작업이나 비동기 작업의 완료를 의미하지는 않습니다.
공개 패키지에는 일반적인 예제만 포함되며 고객의 포인트 목록, 전략 또는 자격 증명은 포함되지 않습니다. 다음 문서를 참조하세요. UDE, 알람, 이력 및 아카이브, 시스템 유지보수.