릴리즈 노트
2026.10 재릴리즈 — 2026-10-20 · LLM 모델 aura-lite · 화면 용어 «이상 접수» · MCP 게이트웨이
호환 깨짐 — 외부 API 호출의
model 값을 바꿔야 합니다LLM 모델 이름이 aura-35b → aura-lite 로 바뀝니다. 옛 이름의 별칭은 두지 않으므로 aura-35b 로 부르면 404 입니다.
게이트웨이(LiteLLM)를 직접 부르는 외부 연동은 요청의 "model": "aura-35b" 를 "aura-lite" 로 바꾸십시오 → API 연동 가이드
매뉴얼은 이 판 기준으로 aura-lite 를 적습니다. 이 판을 올리기 전의 설치는 아직 aura-35b 입니다.
LLM 모델 — aura-35b → aura-lite
- 이름만이 아니라 모델이 바뀝니다 — AURA-35B 대신 AURA-Lite(MoE · 문맥 256K · 이미지 입력 겸용)가 돕니다.
- 가중치 폴더 이름도
Aura-35B-A3B-NVFP4→Aura-Lite-NVFP4로 바뀝니다(/opt/kopens/models/Aura-Lite-NVFP4, 번들 모델 파일Aura-Lite-NVFP4.tar.zst). - 설치 ·
bin/update.sh가Aura-Lite-NVFP4.tar.zst를 새로 받습니다(SHA256SUMS와 대조하고, 받을 수 없으면 거기서 멈춥니다). - 폐쇄망은 인터넷이 되는 장비에서
MODELS="Aura-Lite-NVFP4 …"로 받아 반입합니다 — 번들 굽기는 모델을 받지 않습니다 → 폐쇄망 설치 - vLLM 이
v0.31.0으로 오르고, 기동 인자(LLM_MODEL_ARGS)가 새 모델에 맞는 파서(gemma4)로 바뀝니다. - 옛
Aura-35B-A3B-NVFP4폴더는 더 쓰지 않습니다 — 새 판이 뜬 것을 확인한 뒤 지워도 됩니다. aura-vision·aura-embedding-4b·aura-reranker-0.6b는 그대로입니다.- 코파일럿 · 관리 콘솔 · 문서 검색 · 비전 · 문서 이해는
bin/update.sh뒤 새 이름을 스스로 씁니다 — 코파일럿은 기동 때 DB 에 저장된 모델 이름을 배선에 맞춥니다.
화면 용어 변경 — 고장 접수 → 이상 접수
- 코파일럿 화면의 «고장 접수» 가 «이상 접수» 로 바뀝니다(영어 화면은 «Incident»). 고장만이 아니라 알람 · 이상 신호로도 열리는 건이기 때문입니다 → 이상탐지 · 이상 접수 대응
- 코드 · API · 설정 키 · DB 의 이름(
incident)은 그대로입니다. 연동은 고칠 것이 없습니다. - 실제 고장을 가리키는 말(설비 고장 · 고장 전조 · 상태
FAULT)은 그대로 «고장» 입니다.
도구 관리 — 코파일럿 «도구 서버(MCP)» → AI 관리 콘솔 «MCP 게이트웨이»
- 코파일럿 관리 콘솔의 도구 서버(MCP)(
/admin/mcp)가 없어집니다. MCP 서버 등록 · 도구 켬/끔 · 연결 확인은 새 서비스 MCP 게이트웨이(plantpulse-mcp-gateway-api, 내부 7160)가 맡고, 화면은 AI 관리 콘솔 › MCP 게이트웨이 입니다 → MCP 게이트웨이 - 코파일럿은 MCP 서버를 직접 붙이지 않고 게이트웨이 주소 하나만 봅니다. 승인 게이트 · 사람 단위 감사 기록은 코파일럿에 남습니다.
- 🔴 처음 켜 두는 도구가 많아집니다 — 시계열 인사이트 34종 · 디지털 스레드 9종 · 공학 계산 4종 · RAG 2종 · 문서 이해 2종 · 비전 5종 · 플랫폼 전부. 외부 서버만 꺼진 채입니다 → MCP 도구 지도
- 도구 검색이 기본으로 켜집니다(예산 20) — 질문마다 맞는 도구만 골라 모델에 싣습니다.
- 채팅의 문서 검색은 게이트웨이의
rag_search한 길이 됩니다(코파일럿 내장 문서 검색은 없어집니다). 게이트웨이가 응답하지 않거나rag_search가 꺼져 있으면 매뉴얼 · 도면 · 절차 질문에 답을 짓지 않고 그 사유를 알립니다 → RAG - AI 관리 콘솔 › MCP 게이트웨이 › 도구 에서 도구마다 검색어를 보고 덮어씁니다. 호출 기록은 «도구 실패» 와 «전송 실패» 를 갈라 보이고 거릅니다 → MCP 게이트웨이
- 디지털 스레드에 도구 둘이 더해집니다 —
thread_impact_range(늦은 PO · 불량 로트가 어디까지 닿나) ·thread_interval_production(이상 구간에 무엇을 만들고 있었나).
이상 접수 · 제안 · 자동화
- 채팅에 파일 넣기 — 묻기 입력칸의 파일 넣기 · 끌어다 놓기 · 붙여넣기로 PDF · 엑셀(xlsx · xls · csv) · 워드 · 파워포인트 · DXF 도면 · TIFF 스캔본을 올려 그 대화에서 바로 묻습니다. 파일당 50MB, 대화당 20개, 앞 100쪽까지 읽습니다. 영상(mp4 · mov · mkv · webm) · 음성(m4a · mp3 · wav)도 1GB · 60분까지 넣습니다 — 받아 적은 말 · 자막으로 답하고, 답이 적은 시각이 그 장면을 트는 근거 카드가 됩니다(5분 · 200MB 이하는 바로, 그보다 길면 뒤에서 받아 적고 끝나면 알립니다. 설치 스위치
PI_MEDIA_ENABLED가 켜진 설치에서). 대화 주인만 보고 재생하며, 대화를 지우면 함께 지워지고, 회사 문서고(RAG)에는 들어가지 않습니다 → 묻기 — 파일 넣기 - 조치안 검토 — 승인 대기 중인 이상 접수의 «제안» 카드에서 조치안 승인 · 고쳐서 승인 · 거절 을 고릅니다. 거절은 사유(진단이 틀림 · 이상 아님(헛경보) 등 여섯)를 고르고 건을 닫습니다 → 제안 — 조치안 검토
- 통보 받는 사람 — 관리 › 담당자의 통보 역할(정비 · 운영 · 안전)과 담당 범위(사이트 · 설비)에 맞는 사람이 딱 한 명일 때만 자동으로 정하고, 아니면 실행하는 사람이 고릅니다. SMTP 가 없는 설치는 «담당자 통보» 를 사유와 함께 막습니다 → 제안 — 조치 실행
- 운영 현황 — 관리 › AI › 운영 현황(
/admin/ops-stats)에서 최근 7 · 30 · 90일의 사용 · 제안 · 이상 접수 · 자동화를 봅니다 → 코파일럿 관리 - 진단 정확도 — 모델별 묶음이 실제로 답한 모델 기준이 되고, 원인은 이상 접수 한 건에 한 번만 셉니다.
- 자동화 회차 — 서버 재시작으로 끊긴 회차는 «중단됨» 으로 남습니다(보고서 · 발송 없음, 이어 돌지 않음). 업무형 자동화의 산출물 저장 실패는 회차 결과에 경고로 보이고, 발송 상태는 «보냄» 으로 정확히 남습니다 → 자동화
- 자동화 보고서 제목 — 보고서 · 실행 기록 · PDF · 엑셀 · 메일 · 알림 · 메신저의 제목이 «자동화 이름 · 회차 시각»(공장 시간대)이 되고, 모델이 쓴 제목은 부제가 됩니다. 코드가 쓰는 보고서 문구는 설치 언어(
PP_LANG)를 따릅니다 → 자동화 — 보고서의 제목 - 자동화 «전체» 탭 — 끄기 · 켜기 · 지우기 단추가 카드 안 아래 줄로 옮겨졌습니다(지우기는 확인 뒤).
- 영상 장면 칩 — 칩의 시각과 재생 시작이 구간의 처음이 아니라 맞은 장면입니다 → 동영상 RAG
- 디지털 스레드 근거 패널 — 노드를 누르면 이 객체의 이력(30일, 이전 30일 보기)과 원 시스템의 지금 값을 보고, 관리자가 커넥터에 링크 틀을 넣었으면 원 시스템 화면을 엽니다 → 디지털 스레드
- 자동화 샌드박스 — AI 관리 콘솔에 따로 레일이 생겨 실행 이력 · 상한을 봅니다 → 자동화 샌드박스
그 밖에 이 판에 실리는 것
- 생각 모드 기본 켬 — compose 의
CO_LLM_THINKING_ENABLED기본값이true가 됩니다(AURA-Lite 는 비우면 생각하지 않습니다) → 환경 변수 설정 - «생각 정도» 고르기 — 묻기 입력칸의 뇌 아이콘으로 끔 · 낮음 · 보통 · 높음을 고르고, 관리자는 관리 › 시스템 설정에서 채팅 · 자동화 · 이상 진단 · 수행제안별 기본값을 정합니다 → 묻기 — 생각 정도
- 대화 주소 — 새 대화는
/chat/new, 연 대화는/chat/<id>입니다. 옛/chat?session=<id>는 받지 않습니다 → 묻기 — 대화 주소 - 공학 계산 MCP — 새 서비스
plantpulse-engcalc-api와 도구 넷(eng_list_formulas·eng_formula·eng_unit_convert·eng_calc_eval). 공식 29종을 단위 · 대입 단계 · 출처와 함께 계산합니다 → MCP 도구 지도 - 설치 기본 언어
ko— env 템플릿의PP_LANG이ko입니다. 값은ko·en둘뿐이고, 비었거나 그 밖의 값이면 서비스가 기동하지 않습니다 → 환경 변수 설정 - vLLM
v0.31.0(생성 · 임베딩 · 리랭크 · 녹취) - 디지털 스레드 커넥터 최소 판 —
mes-mcp/0.7·erp-mcp/0.4·ehs-mcp/0.3· 나머지0.2보다 낮은 판을 선언한 커넥터는 동기화 · 판정에 쓰이지 않습니다. 올린 뒤 도구 발견 → 적합성 → 켜기를 다시 밟습니다(bin/reregister-connectors.sh) → 디지털 스레드 커넥터
업그레이드할 때
- 호스트 env 에
LLM_NAME·LLM_MODEL_PATH·LLM_MODEL_ARGS줄이 있으면 지우십시오. 옛 값이면 새 모델이 뜨지 않고, 새 기본값과 같은 값이면 기동 전 판정이redundant로 기동을 막습니다. - 코파일럿의 옛 도구 표(
mcp_server·mcp_tool_pref·mcp_tool_call_log)는 기동이 지웁니다. 옛 판에서 켜고 끈 값은 옮겨지지 않고 게이트웨이 정책으로 다시 시작합니다. 일부러 꺼 두었던 도구가 있으면 올린 뒤 MCP 게이트웨이 › 도구 에서 다시 끄십시오. 코파일럿에 직접 붙여 두었던 외부 MCP 서버는 게이트웨이 서버 에 다시 등록하고 인증 값을 다시 넣습니다.
2026.10 재릴리즈 8 — 2026-10-13 · 코파일럿 화면 전면 교체
같은 2026.10 태그로 다시 공개한 번들입니다. 코파일럿의 화면이 통째로 바뀝니다 — 데이터 · 권한 · 설정은 그대로 이어집니다.
이미 2026.10 으로 올린 설치는 bin/update.sh 로 받습니다. 관리 콘솔 · 인사이트 · 문서 검색(RAG) · 비전 · 디지털 스레드 · 문서 이해 · 프록시의 수정도 함께 들어 있습니다.
옛 화면은 이 판에서 없어집니다
이 판으로 올리면 코파일럿은 새 화면만 냅니다. 옛 화면으로 되돌리는 스위치는 없습니다 — 올리기 전에 아래 «없어진 화면과 옛 주소» 와 «업그레이드할 때» 를 읽으십시오.
정체성 — 현장 판단 앱
«공장의 문제를 찾아 근거와 함께 제안하고, 사람이 승인해 닫고, 모르면 묻고, 반복되는 일은 자동화에 맡기는 현장 판단 앱» 입니다. MES · ERP · BI 대시보드 · 챗봇 · 작업자 실행 단말이 아닙니다. 재릴리즈 7 의 «숍플로어 AI 어시스턴트 · 메뉴 여섯» 을 대체합니다.
세 가지로 씁니다 — 묻기 · 제안 · 자동화
- 사이드바 — 위에서부터 새 대화 · 제안 · 자동화, 그 아래 최근 대화(검색), 맨 아래 프로필 메뉴(설정 · 관리 · 감사 · 도움말 · 테마 · 로그아웃), 머리에 알림 종. «묻기» 줄은 따로 없습니다 — 새 대화와 처음 열리는 화면이 묻기입니다. 화면은 무채색이고 색은 상태 점에만 씁니다 → 화면 지도
- 묻기(첫 화면) — 인사 · 입력칸 · 오늘 할 일 · 질문 칩. «오늘 할 일» 은 「오늘 할 일 N건」 한 줄로 접혀 있고 누르면 펼쳐집니다(할 일이 없으면 줄이 없습니다). 답 본문의 표는 둥근 테두리 상자에 담기고, 답 안의 색 표시는 상태 점으로 보입니다 → 묻기
- 제안 — 할 일 · 진행 중 · 완료. 계획(수행 제안)과 돌발(확인할 이상 · 고장 접수)이 한 목록에 있고, 한 상세에서 감지 · 접수 → 승인 → 조치 → 결과 → 재발 검증까지 닫습니다. «해결» 메뉴는 없어졌습니다 → 제안
- 자동화(옛 «에이전트 빌더») — 말로 만들기 · 미리 돌려 보기 · 공유 · 실행 기록 · 보고서 · 버전 이력과 되돌리기 → 자동화
- 설정과 내 정보가 한 화면(
/settings)이 됐습니다. - 처음 온 사람에게는 브라우저 언어로 뜨고(한국어 · 영어가 아니면 설치 기본 언어), 로그인 전에 연 주소는 로그인 뒤 그 화면으로 돌아갑니다. 없는 주소는 「찾는 화면이 없습니다」 로 안내합니다.
오른쪽 패널과 도면 뷰어
- 문서 원문 · 도면 · 영상이 같은 오른쪽 패널에서 열립니다. 대화나 제안 상세를 둔 채 옆에서 보고, 가장자리를 끌어 폭을 바꿉니다.
- 제안의 근거도 패널로 열립니다. 상세 위에 하나 더 쌓여 열리고 머리줄의 뒤로로 상세에 돌아옵니다.
- 화면이 좁아 나란히 설 자리가 없으면 패널이 본문을 덮는 시트로 열리고, 폰에서는 전체 화면으로 열립니다.
- 도면 뷰어 — 도면 카드를 누르면 패널에 미리보기가 열리고, 뷰어로 열기(새 탭) 로 새 탭 뷰어를 엽니다: 확대 · 축소, 쪽 목록, 판 비교(나란히 · 겹쳐서, 바뀐 곳 표시), 도면 위를 끌어 고른 뒤 이 영역으로 묻기 → 도면으로 묻기
자동화 — 받는 곳과 템플릿
- 보내기 — 결과를 앱 알림 · 사내 메일 · 메신저 채널(Teams · Slack)로 받습니다. 받는 사람은 사내 사용자 · 역할로만 고르고 주소는 적지 않습니다. 받는 곳은 만들 때 고정되고, 실행 중에 AI 가 바꾸지 못합니다.
- 첨부 — 메일에 Excel · CSV 를 붙입니다. PDF 는 PDF 변환 서비스(
CO_GOTENBERG_URL)가 설정된 설치에서만 고를 수 있고, 없으면 화면에 꺼진 채로 보입니다. - 발송 상한 — 자동화 하나가 한 사람에게 메일 하루 6통, 채널 하나에 메신저 하루 12건, 역할로 고른 받는 사람은 50명까지(시스템 설정으로 바꿉니다). 같은 내용은 그날 다시 보내지 않습니다.
- 승인 행동 — 자동화가 카드에 제안할 수 있는 행동이 다섯으로 늘었습니다(정비 요청 초안 · 발주 독촉 초안 · 작업 지시 초안 · 제안 올리기 · 고장 접수 올리기). 모두 사람이 카드에서 승인해야 나갑니다.
- 템플릿 14개 — 조건 감시(「…넘으면 알려 줘」) · 미결 고장 접수 독촉 · 도면 개정 알림이 더해졌습니다. 디지털 스레드에 기대는 템플릿 셋 (납기 위험 PO · 품질 이상 추적 · 도면 개정 알림)은 그 도구가 있을 때만 갤러리에 보입니다.
- 말로 만들기 · 미리 돌려 보기 · 지금 실행은 뒤에서 돌고 화면이 끝날 때까지 「실행 중…」 으로 기다립니다. 요청이 몰리면 잠시 뒤 다시 하라고 알려 줍니다.
묻기 · 자동화 · 관리의 그 밖의 변화
- 묻기 — 도구를 쓰는 동안 단계가 보이고(생각하는 중 → 도구 실행 중 → 답 정리), 글은 도구가 끝난 뒤 흐릅니다. 응답 멈추기는 서버의 생성까지 멈춥니다. 다시 만들기가 생겼고, 근거 카드에는 답이 실제로 쓴 도구 결과만 남습니다. 한 대화에서는 답 하나가 끝나야 다음 질문을 보냅니다.
- 자동화 — «조건 감시» 는 조건에 닿지 않으면 AI 모델을 부르지 않고 5분 주기부터 둘 수 있습니다. 템플릿은 받는 곳이 «나 + 앱 알림» 으로 열리고, 역할 · 메일 · 메신저는 직접 고릅니다. 앱 알림은 알림 목록과 종에 남습니다. 관리자 · 공장장에게는 전체 탭이 보입니다(끄기 · 지우기는 관리자만).
- 제안 — 완료 탭에 닫힌 계획 카드가 함께 보이고, 두 사람이 같은 카드를 동시에 처리하면 「다른 사람이 먼저 처리했습니다」 로 알리고 목록을 새로 받습니다.
- 관리 — 시스템 설정에 알려진 설정 키가 이름 · 설명 · 기본값과 함께 늘 보이고 기본값으로 되돌릴 수 있습니다. 감사 로그에서 원문 보기.
- PDF 내려받기 · 첨부는 설치의 PDF 변환 서비스가 응답할 때만 켜집니다.
- 답의 도구 줄 — 펼치면 도구 이름 · 걸린 시간 · 건수만 보입니다. 도구의 원래 결과는 관리자에게만 접힌 채 보입니다.
- 차트 캡션 — 물은 기간이 아니라 실제로 그린 자료의 기간과 건수를 적고, 자료가 잘렸으면 「일부만」 을 붙입니다.
- 문서 인용 구절 — 원문의 문장이거나 표의 한 줄입니다. 표의 한 줄은 칸을 이은 글 한 줄로 보입니다.
- 대화 지우기가 질문 · 답 · 도구 실행의 원문까지 지웁니다(승인된 행동 카드와 감사 기록은 남습니다).
- 자동화 — 미리 돌려 보지 않은 자동화는 지금 실행 단추가 꺼진 채 사유를 보입니다. 앱 알림을 누르면 그 회차가 낸 보고서 · 제안 카드 · 실행 기록이 열리고, 자동화를 지우면 그 자동화가 보낸 앱 알림도 함께 지워집니다. 범위의 설비와 감시 태그는 이름으로 보입니다.
바뀐 이름
| 옛 이름 | 새 이름 |
|---|---|
| 인시던트 | 고장 접수 |
| 에이전트 · 에이전트 빌더 | 자동화 |
API 경로 · 설정 키 · 감사 기록의 이름(incident · agent)은 그대로입니다.
없어진 화면과 옛 주소
오늘 · 이상 진단 · 해결 · 리포트 · 대시보드 · 네트워크 · 예측 · 스레드 화면과 모바일 전용 판(/m), 채팅의 역할 탭 · 맥락 칩은 없어졌습니다.
🔴 옛 주소는 새 자리로 넘어가지 않습니다. 북마크 · 예전 메일 · 푸시의 옛 링크는 「찾는 화면이 없습니다」 를 보입니다 → 옛 주소
- 대시보드 · 예측 · 스레드에서 보던 것은 묻기에서 물으면 같은 답이 나옵니다(도구는 그대로입니다).
- 🔴 와치는 없어졌습니다. 화면뿐 아니라 와치를 돌리던 실행기 · API 도 빠졌습니다 — 지켜볼 것은 자동화로 만듭니다(템플릿 «조건 감시») → 자동화
- AI 정확도 숫자는 관리 콘솔의 정확도 튜닝 · 답변 품질에서 봅니다 → AI 발견과 정확도
- 디지털 스레드는 선택 연동입니다. 전용 화면 없이, 연결되면 묻기 · 자동화의 도구와 제안의 근거가 늘어납니다 → 디지털 스레드
관리 콘솔
화면이 네 묶음(사람과 권한 · AI · 운영 · 기록)으로 다시 짜였습니다 → 코파일럿 관리 콘솔
- 알림 채널(새 화면,
/admin/channels) — 자동화가 보낼 Teams · Slack 채널을 등록하고 메일 허용 도메인을 정합니다. 🔴 도메인이 비어 있으면 자동화 메일은 꺼져 있습니다. - 사용자 편집 — 한 화면에서 내 업무 · 관리 콘솔 열기 · 역할 묶음 · 데이터 범위 · 열람 등급 · 묶음 기한 · 기간 위임(대행) · 협력사 만료일 · 플랫폼 사용자 잇기를 정합니다 → 권한 — 사람에게 붙이기
- 브랜드(새 화면) — 고객사 이름 · 탭 제목 · 로고 · 파비콘 · CI 색 · 로그인 화면 · 문의처 · 메일 표시 이름.
- 역할 묶음 편집에서 옛 리포트 권한(
menu:report)은 보이지 않습니다 — 새 화면에서 아무것도 막지 않기 때문입니다. - 세션 관리 · AI 사용 통계 · 실행 로그 · 시스템 모니터 · 알림 선반 화면은 없어졌습니다. 좁은 화면에서는 관리 표의 일부 열이 접힙니다.
운영
- 로그인 세션이 세션 저장소에 저장됩니다. 앞선 판에서는 세션이 코파일럿의 메모리에만 있어 재시작 · 재배포 때마다 모두 로그아웃됐습니다. 이 판부터는 유지됩니다 — 이 판으로 올리는 그 한 번은 다시 로그인해야 합니다.
- 관리 콘솔도 올린 뒤 한 번 다시 로그인합니다 — 관리 콘솔의 세션 형식이 바뀌어 올리기 전의 로그인은 이어지지 않습니다.
- 프록시가 응답을 압축(gzip)하고 보안 헤더를 붙입니다. 손댈 것은 없습니다.
- 지표 —
GET /actuator/prometheus(Prometheus 형식). 🔴 API 키(X-API-Key)로만 열립니다 — 로그인 세션으로는 관리자도 열 수 없고(403), 키가 없으면 401 입니다. 키는 공개 API(/api/v1)와 같은 키입니다 → 로그 및 모니터링 - 로그가 JSON 한 줄이 됐습니다(컨테이너 로그와 파일
/app/logs/system.log모두). 비밀번호 · 토큰 · 키 · 이메일의 앞부분은 가려서 남깁니다. 옛 글자 형식을 긁던 수집 규칙이 있으면 고칩니다. - PDF 변환 서비스(Gotenberg)는 스택 안에서만 쓰는 컨테이너로 함께 뜹니다(밖으로 포트를 열지 않습니다). 선택입니다 —
CO_GOTENBERG_URL이 비어 있으면 PDF 내려받기 · PDF 첨부만 꺼지고 나머지는 그대로입니다 → 환경 설정
업그레이드할 때
| 무엇 | 할 일 |
|---|---|
| 화면 | 따로 켤 것이 없습니다. 올리면 새 화면이 뜨고, 옛 화면으로 되돌릴 수 없습니다 |
| 로그인 | 올린 직후 모두 한 번 다시 로그인합니다 — 코파일럿과 관리 콘솔 둘 다 |
| 북마크 · 옛 링크 | 옛 화면 주소는 「찾는 화면이 없습니다」 로 끝납니다. 사내 포털 · 위키에 걸어 둔 링크는 새 주소(/chat · /tasks · /automations)로 바꿉니다 |
| 이미 만들어 둔 와치 | 🔴 올린 뒤에는 돌지 않습니다. 와치의 표는 지우지 않고 그대로 두지만 자동화로 자동으로 옮겨지지 않습니다 — 계속 지켜봐야 하는 것은 같은 문장으로 자동화를 새로 만듭니다. 와치가 이미 올린 고장 접수는 제안에 그대로 남습니다 |
| 자동화 메일 | 쓰려면 관리 콘솔 › 알림 채널에서 메일 허용 도메인을 적습니다(비어 있으면 꺼짐). 메일 서버는 시스템 설정의 smtp.* |
| 권한 · 묶음 | 손댈 것이 없습니다. 새로 생긴 권한은 없습니다 |
여는 법
웹 브라우저 · 홈 화면 앱(PWA) · Windows 데스크톱 앱 → 코파일럿 여는 법
2026.10 재릴리즈 7 — 2026-10-09
같은 2026.10 태그의 다시 공개한 번들입니다. 포트는 그대로이고, 새 표(에이전트)는 기동 때 자동으로 만들어집니다. 이미 2026.10 으로
올린 설치는 bin/update.sh 로 받으면 됩니다 — 손으로 할 일은 없습니다.
코파일럿 — 숍플로어 AI 어시스턴트
- 메뉴 여섯 — 오늘 · 수행 제안 · 이상 진단 · 해결 · 리포트 · 묻기. 일이 들어오는 입구는 둘(계획 = 수행 제안, 돌발 = 이상 진단)이고, 둘 다 해결 한 목록에서 배정 → 조치 → 결과 → 재발 검증까지 닫힙니다. 레일 아이콘 아래에 짧은 이름이 붙습니다.
- 이상 진단 — 확인할 이상을 설비마다 한 장으로 보이고, 카드마다 확인 → 인시던트로 · 무시 단추 하나씩. 이전의 이상 탐지 표는 운영 콘솔로 옮겼습니다.
- 오늘(홈) — 지금 가장 급한 것 띠 · 지표 타일 · 수행 제안 / 이상 진단 발견 / 해결 7일 추이 · 긴급 목록. 역할 카드는 아래 접기로.
- 리포트 — 탭 셋(개요 · AI 정확도 · 통계). AI 정확도 화면이 리포트의 탭이 됐습니다.
- 공장 현황 · 모니터링 · 상관관계 · 예측 · 디지털 스레드는 메뉴에서 빠졌지만 주소와 링크로 그대로 열립니다. 주간 브리핑 화면은 없어졌고
(
/briefing→ 홈),/incidents→ 해결,/accuracy→ 리포트 › AI 정확도로 넘어갑니다. - 폰의 아래쪽 막대와 모바일 앱도 다섯 칸(오늘 · 제안 · 진단 · 해결 · 묻기)입니다.
코파일럿 — 에이전트 빌더
- 한 문장으로 적으면 AI 가 다섯 칸(언제 · 어디를 · 무엇으로 · 어떻게 · 어디에) 초안을 만들고, 미리 보기로 확인한 뒤 켭니다. 결과는 수행 제안 카드로 나옵니다. 템플릿 셋 — 아침 교대 브리핑 · 반복 고장 원인 · 자재 PO 지연.
- 만든 사람의 권한 · 범위 안에서 읽기 도구만 씁니다. 공장장 · 관리자(권한 «에이전트 만들기 · 관리»)가 만듭니다.
→ 에이전트 빌더
바뀐 동작 — 역할 다섯
- 관리 화면에 기본으로 보이는 역할 묶음이 작업자 · 반장 · 정비 · 공장장 · 관리자 다섯입니다. 나머지 여덟은 고급 역할 접기 안에 있고 권한 · 붙은 사람은 그대로입니다.
- 현장 묶음의 기본 메뉴를 줄였습니다 — 작업자는 오늘 · 수행 제안 · 해결 · 묻기, 정비는 거기에 이상 진단. 기동이 앞선 기본값 그대로인 묶음만 한 번 바꾸고, 관리자가 고친 묶음은 그대로 둡니다. 감사 기록에 «시스템(이관)» 으로 남습니다.
- 인시던트 조치 «실행» 이 새 권한 «인시던트 조치 실행» 으로 좁혀졌습니다 — 기본 반장 · 정비 · 공장장 · 관리자. 작업자 · 품질은 더는 실행하지 못합니다.
바뀐 동작 — 2인 승인 · 대행 · 협력사 계정
- 물어본 사람은 자기 채팅 행동 카드를 승인하지 못합니다. 승인 권한이 있는 다른 사람이 수행 제안 왼쪽의 승인 대기에서 승인 · 거절합니다.
- 자재 독촉 요청은 서로 다른 두 사람이 승인해야 보냅니다(설정
access.two_person.tools). 정비 요청은 한 사람 승인 그대로입니다. - 기간 위임 — 사용자 편집에서 다른 사람의 묶음을 날짜까지 빌려줍니다. 묶음마다 기한을 둘 수 있습니다.
- 협력사 계정 — 협력사 묶음은 범위
supplier:만 · 만료일 필수 · 통제 등급 불가. 만료되면 세션이 끊깁니다.
고친 것
- 음성 질문 — 녹음 띠가 입력창 위에 겹쳐 떠서 단추가 움직이지 않고, 띠의 녹음 멈추기로 멈춥니다. 마이크 단추는 전송 단추와 같은 크기입니다.
- 권한 화면 — 문서 등급의 등급 선택 칸이 보이고, 사용자 편집 창의 입력 폭이 맞고, 감사 표의 종류 · 내용이 화면 언어로 나옵니다.
- 화면 머리(제목 · 부제)를 한 규칙으로 맞췄습니다.
운영
PI_USER_CONTEXT_MODE의 권장 운영값은log입니다.enforce는 뒷단을 바깥 고객 클라이언트에 열지 않은 설치에서만 켭니다 → 운영 — 뒷단의 사용자 정보 점검 모드
2026.10 재릴리즈 6 — 2026-10-08
같은 2026.10 태그의 다시 공개한 번들입니다. 포트는 그대로이고, DB 표는 기동 때 자동으로 만들어집니다. 이미 2026.10 으로
올린 설치는 bin/update.sh 로 받으면 됩니다 — 손으로 할 일은 없습니다.
코파일럿 — 권한
- 역할 묶음 — 권한이 사람이 아니라 묶음에 붙습니다. 관리자 콘솔 › 역할 묶음에 기본 묶음 13개(관리자 · 작업자 · 반장 · 정비 · 품질 · 공장장 · 설계 · 구매 · 생산관리 · EHS · 협력사 · 감사 · 외부 API)가 있고, 사람마다 여러 개를 붙입니다.
- 데이터 범위 — 사람마다 사이트 · 라인 · 설비(또는 프로젝트 · 고객 PO · 협력사)를 지정하면 화면 · 채팅 · 문서 답 · API 어디서나 그 범위만 보입니다.
- 문서 등급 — 일반 · 사내 · 대외비 · 통제. 관리자 콘솔 › 문서 등급에서 지정하고, 사람마다 열람 등급을 정합니다. 대외비 도면 쪽 미리보기에는 보는 사람 · 시각 워터마크가 찍히고, 통제 문서는 원본을 내려받을 수 없으며 열람이 기록됩니다.
- 감사 화면(
/audit) — 설정 · 권한 변경과 대외비 · 통제 문서의 열람 기록을 기간 · 사용자 · 종류로 거르고 CSV 로 내려받습니다. - 업그레이드해도 동작은 같습니다. 기존 사용자는 업무 역할의 묶음(관리자는 관리자 묶음도) · 범위 전체 · 열람 등급 대외비로 옮겨집니다. 달라지는 것은 통제 문서뿐입니다 — 사람마다 열람 등급을 통제로 지정해야 열립니다.
바뀐 동작 — 외부 연동은 API 키로만
외부 연동 주소 /api/v1/** 와 /mcp 는 이제 API 키(X-API-Key)로만 열립니다. 로그인한 브라우저 세션으로 부르면
403 입니다. API 키로 연동하던 외부 시스템은 그대로 동작합니다.
운영
- 새 환경 변수
PI_USER_CONTEXT_MODE(off·log·enforce, 기본off) — 뒷단이 사용자 정보 없이 들어온 호출을 어떻게 다룰지 정합니다..env에 넣지 않아도 됩니다. 모르는 값을 넣으면 설치 점검(lint-env)이 막습니다 → 운영 — 뒷단의 사용자 정보 점검 모드 - 문서 등급을 지정했거나 범위가 지정된 사람의 문서 답은 거른 근거로만 지어서 조금 늦어질 수 있습니다.
- 감사 로그 조회가 500 을 내던 것, 볼 수 없는 도면 미리보기가 연결을 끊던 것(이제 «없음» 404)을 고쳤습니다.
- 시계열 인사이트가 플랫폼 DB 가 멈췄을 때 오래 붙잡히지 않도록 연결 제한 시간을 두었습니다.
→ 정확도는 이 판의 공개 파이프라인 값으로 고쳤습니다 — 정확도 · 벤치마크
2026.10 재릴리즈 5 — 2026-10-07
같은 2026.10 태그의 다시 공개한 번들입니다. 포트 · DB 이전 · 환경 변수는 재릴리즈 4 와 같습니다. 이미 2026.10 으로 올린
설치는 bin/update.sh 로 받으면 됩니다.
코파일럿 — 채팅 행동 카드
- «부품이 N일 늦으면» 질문이 문서 검색보다 회복 계산을 먼저 부릅니다. 회복 계산이 독촉을 제안하면 답 밑에 자재 독촉 행동 카드가 붙고, 본문은 독촉 문안 대신 「초안은 아래 카드에서 승인할 수 있습니다」 로 알립니다.
- 새 카드 정비 요청 — 답에 열린 고장 위험 발견이 있으면 MES 정비 요청 초안 카드가 붙습니다. 반장 · 정비 · 공장장 · 관리자가 승인합니다(할 일 › 수행제안의 제안 카드는 그대로 관리자만). MES 커넥터가 정비 요청 도구를 낼 때만 나옵니다.
→ AI Chat Web — 행동 카드 · 사용자 권한과 업무 역할
코파일럿 — 도면
- 채팅 도면 카드가 도면 번호 · 판마다 한 장입니다. 같은 판의 DXF · PDF 가 따로 카드로 나오던 것을 묶고, 카드에 「파일 N개」 가 붙으며, 누르면 대표 파일(DXF 가 있으면 DXF)로 엽니다. 관리 콘솔 도면 대장도 같은 규칙으로 한 줄에 파일 칩을 보입니다.
- 「○ 판과 ○ 판 차이」 를 물으면 «비교할 수 없습니다» 대신 판 비교 결과(표제란 · 치수 · 부품표 · 주기 변경)로 답합니다.
- 판 비교 목록의 공차가 JSON 원문 대신 사람 말로, 표제란 항목이 한국어로 나옵니다.
→ 도면으로 묻기 · 관리 콘솔 — 도면 대장
코파일럿 — 화면 · 답
- 반장 시작 화면의 오늘 작업 목록이 카드 안에서 스크롤됩니다 — 공정이 12줄이어도 첫 질문과 예시 질문이 첫 화면에 보입니다.
- 「오늘 작업 뭐 있어?」 표 아래 꼬리가 하나입니다(「외 N건」 또는 「M줄 중 N줄만 보입니다」). 두 숫자가 어긋나던 것을 고쳤습니다.
- 답에
**가 그대로 보이던 것(강조 끝에 조사가 붙을 때)을 고쳤습니다. - 관리 콘솔 동영상 목록에서 «말 없음» 아래 영어 «no speech» 가 겹쳐 보이던 것을 고쳤습니다.
운영
- 플랫폼 DB 연결이 끊겼다 돌아오면 코파일럿이 스스로 회복합니다. 5분 넘게 연결을 못 얻으면 컨테이너가 스스로 재시작합니다.
- 예측(insight) 이 결측이 많은 설비에서 오류 대신 「데이터 부족」 으로 답합니다.
2026.10 재릴리즈 4 — 2026-10-06
같은 2026.10 태그의 최종 공개 번들입니다. 포트 · DB 이전 · 환경 변수는 재릴리즈 3 과 같습니다. 이미 2026.10 으로 올린
설치는 bin/update.sh 로 받으면 됩니다.
코파일럿 — 반장 «오늘 작업»
- 카드의 공정 상태 · 플랫폼 주문 상태가 코드(
in_progress·planned·START…)가 아니라 한국어 라벨(계획 · 진행 중 · 가동 중 …)로 나옵니다. 플랫폼 주문은 「주문 설비 시작 시각」 으로 짧게 보입니다. - 고객 PO 의 여유가 「계획 여유 N일」 로 바뀌었습니다 — 작업지시 계획 끝 기준이라 부품 지연이 들어가지 않습니다. 부품 지연을 반영한 값은 회복 계산의 영향받는 고객 PO 표에 「(지연 반영)」 으로 나옵니다.
- 「오늘 작업 뭐 있어?」 의 답에 표가 두 번 나오던 것을 고쳤습니다 — 서버가 만든 오늘 작업 표 한 장만 남고, 그 표에 막힌 이유 칸이 생겼습니다. 열 이름은 고객 PO 계획 여유 입니다.
- 디지털 스레드가 플랫폼에서 도는 주문을 플랫폼 주문 목록의 외부 주문 번호로 공정에 잇습니다.
→ AI Chat Web — 반장 카드 · 디지털 스레드
코파일럿 — 채팅 답
- 영상 · 음성 카드는 채팅 답이 본문에 번호를 달지 않았어도 보입니다(접히는 것은 문서 · 도면 카드뿐). 새 대화의 첫 질문은 사용자가 쓴 문장 그대로 문서를 찾습니다 → 영상 · 음성으로 묻기
- 공차 질문(「Ø35 H7 공차 범위?」)의 답이 도면 치수 표의 상 · 하한으로 시작합니다 — 앞 판에서는 값을 받고도 «확인되지 않습니다» 로 답하는 일이 있었습니다 → 도면으로 묻기
- «부품이 N일 늦으면» 같은 what-if 질문은 늘 회복 계산으로 답하고, 질문의 가정(부품 · 일수)으로 계산합니다. 답은 가정과 지금 지연을 함께 밝힙니다.
- 모델이 같은 말을 되풀이해 끊기면 한 번 다시 쓰고, 그래도 안 되면 문서 검색 결과를 출처 카드와 함께 보여 줍니다.
코파일럿 — 화면
- 영어 화면에서 메뉴 · 제목이 문구 키(
nav.main.today등) 그대로 나오던 결함을 고쳤습니다. - 검증 대기(
/review)의 안내가 「업무 역할은 관리자가 사용자 관리에서 바꿉니다」 로 바뀌었습니다(앞 판은 «프로필에서»). - 사용자 편집 창에 부제 「사용자 정보와 업무 역할을 고칩니다」 가 붙고, 2열 입력칸이 창 밖으로 넘치던 것을 고쳤습니다.
- 가로 스크롤바가 세로처럼 얇아졌고, 오른쪽 위 알림(토스트)의 닫기 단추가 제자리에서 눌립니다.
RAG · 영상
- 관리 콘솔 문서 표에서 플랫폼 원장 도면을 «코퍼스에서 제외 / 다시 포함» 할 수 있습니다. 직접 올린 도면은 그대로 제외할 수
없고, 단추의 풍선말이 이유를 말합니다. 도면
409문구도 대상별(수동 도면 · 원장 도면)로 바뀌었습니다 → 관리자 콘솔 · 문제 해결 - 녹취가 무음 · 소음 뒤에 붙은 첫 문장을 버리던 것을 고쳤고, 남긴 문장의 시각을 실제 말소리로 당깁니다. 이미 녹취한 영상은
저절로 다시 하지 않습니다 — 관리 콘솔 동영상에서 다시 녹취 하면 처리 시간대(비워 두면
20:00-06:00)에 다시 받아 적습니다.
2026.10 재릴리즈 3 — 2026-10-06
같은 2026.10 태그를 다시 구웠습니다. 포트와 DB 이전은 바뀌지 않았고, 새 표 · 칸은 기동할 때 저절로 생깁니다. 이미
2026.10 으로 올린 설치는 bin/update.sh 로 받으면 됩니다.
다시 받기 전에 볼 것
- 호스트 env 에
MEDIA_INGEST_ENABLED·ASR_URL을 손으로 적어 영상 · 음성을 켜 두었다면 그대로 올려도 멈추지 않습니다 — 옛 이름은 이번 릴리즈 동안 별칭이고, 운영 스크립트가 처음 돌 때PI_MEDIA_ENABLED로 옮깁니다. 기동 전 판정의[warn]이 정리할sed를 찍어 줍니다. 별칭은 2026.11 에 걷어 냅니다. - ERP 커넥터를
erp-mcp/0.3으로 올리면 도구 목록이 바뀌어, 다시 발견할 때 커넥터가 꺼집니다. 적합성 시험을 다시 돌리고 켭니다 → 디지털 스레드
영상 · 음성 — 이제 켤 수 있습니다
- 호스트 env 한 줄
PI_MEDIA_ENABLED=true가 녹취 서빙을 띄우고, rag-api 가 영상 · 음성을 받고, 문서 이해가 녹취 입구를 열고,bin/fetch-models.sh가 녹취 모델Aura-ASR-Turbo(약 1.5 GB)를 받게 합니다. 기본은 꺼짐입니다. - 새 일회성 서비스
plantpulse-asr-audio가 녹취 서빙에 오디오 라이브러리를 옮겨 줍니다 — 앞 판에서 녹취 서빙이unhealthy로 남던 원인을 고친 것입니다. «Exited (0)» 이 정상이고bin/status.sh도 정상으로 셉니다(켠 설치는 23/23). - 채팅의 음성으로 묻기도 켠 설치에서 동작합니다.
- 관리 콘솔 RAG › 색인 › 동영상 화면이 생겼습니다(영상 올리기 · 처리 상태 · 녹취 · 다시 시도). 꺼진 설치에서는 켜는 법만 안내합니다.
- 폐쇄망은 이미지가 번들에 늘 실려 있고, 녹취 모델만
PI_MEDIA_ENABLED=true MODEL_BASE=… bin/fetch-models.sh로 받아 옮깁니다. MEDIA_PROCESSING_WINDOW를 비우면20:00-06:00(PP_TZ)에만 처리를 시작합니다. 늘 처리하려면always입니다.
→ 영상 · 음성 수집 · 동영상 · 음성 검색 · 폐쇄망 설치
설치 · 설정
- 인바운드 키가 비었을 때 멈추는 자리가 compose 에서 기동 전 판정(
[fail] PI_INBOUND_API_KEY is empty …)으로 옮겼습니다. 개발 · 시험에서만 쓰는 무인증 스위치PI_INBOUND_AUTH_DISABLED(기본false)가 생겼고, 키가 있으면 무시됩니다. - 새 손잡이(모두 기본값 그대로가 정상) —
RAG_S3_BUCKET(rag-api 버킷, 기본plantpulse-rag) · 디지털 스레드 커넥터 주기 동기화DT_CONNECTOR_SYNC_ENABLED(기본 켬) ·DT_CONNECTOR_SYNC_INTERVAL_S·DT_CONNECTOR_MAX_AGE·DT_LINK_HISTORY_DAYS. bin/doctor.sh가 옛 이름 · 중복 줄을 «bad» 가 아니라 «old or redundant lines» 로 따로 보여 줍니다.- 자체 이미지가 열셋(
pi/plantpulse-asr-audio추가), docling-serve 가v1.36.0입니다.bin/backup.sh는 녹취 오디오 라이브러리 볼륨을 받지 않습니다.
코파일럿 — 화면
- 왼쪽 레일 순서가 오늘 · AI 에게 묻기 · 현장 · 할 일 · 해결 · 리포트 로, 모바일 아래 막대가 오늘 · AI 에게 묻기 · 현장 · 할 일 로 바뀌었습니다. 「현장」의 탭은 상관관계 · 예측 순입니다.
- 업무 역할은 관리자만 바꿉니다(바꿀 때마다 감사 로그에 남습니다). 프로필의 「내 업무」는 읽기 전용이 되고, 대신 본인이 고르는 「시작 화면」 이 생겼습니다.
- 채팅 시작 화면의 반장 탭이 「오늘 작업」 으로 바뀌었습니다 — 오늘 공정마다 준비도 · 설비 상태 · 고객 PO 여유 ·
자재 PO · 도면 판을 보여 줍니다. 「오늘 작업 뭐 있어?」 로 물으면 답 끝에 오늘 작업 표가 붙습니다(새 도구
thread_today_work, 기본 켬). - what-if 도구
thread_explain_recovery가 기본 켬이 되어, 답에 「할 수 있는 행동」 카드가 붙습니다. 승인할 수 있는 사람은 업무 역할로 정해집니다 → 업무 역할 - 할 일(
/tasks) — 묶인 발견이 모두 닫힌 긴급 카드를 숨기고, 같은 설비 · 같은 종류 발견을 하루 한 장으로 묶습니다. 「관련 SOP 문서」 패널은 그 설비의 문서만 근거로 씁니다. - 이상 탐지의 「판정 불가」 상자가 기본 접힘 한 줄이 되었고, 디지털 스레드 화면의 준비도 점에 툴팁이 붙고 이유가 화면 언어로 나옵니다.
관리 콘솔
- 폭 1024px 미만에서 메뉴가 서랍(☰)으로 접힙니다.
- 업로드 대화상자가 여러 파일을 받고, 도면 대장에 「도면 올리기」 가 생겼습니다(PDF 는 파일마다 문서 · 도면을 고름).
- 도면 판독 시험에 치수 상 · 하한 열과 「기하공차 틀 검사」 카드가 더해졌습니다.
- 연동 지도의 「지금 동기화」 가 사라진 연결을 닫습니다(수집이 잘리면 닫지 않았다고 알립니다).
→ AI 관리 콘솔
디지털 스레드 · RAG
- 디지털 스레드가 PO 중심으로 잇습니다 — 자재 PO → 작업지시 → 고객 주문 줄 → 고객. ERP 커넥터
erp-mcp/0.3이 구매 · 입고 · 수주 도구를 내고, 고객 주문의 여유일과 위험을 계산합니다. 새 APIGET /api/v1/today와 MCP 도구today_work(디지털 스레드 도구 일곱)가 생겼습니다. - 켜진 커넥터를 주기적으로 다시 동기화합니다(기본 켬).
- 도면 수집을 켠 설치에서 플랫폼 자산 문서의 도면(
.dxf, 문서 종류가DRAWING인 PDF)도 들어옵니다. - 공차 · 범위를 물으면 도면 치수 표로 답하고, 끼워맞춤 공식으로 계산한 값을 쓰면 «공식 추정» 단서를 붙입니다.
시계열 인사이트
- 건강지수의 비가동 감점은 계획 외 비가동만 셉니다. 이력이 짧은 도메인은 0점이 아니라 판정 보류입니다.
- 오더 미달 발견은 근거가 모자라면 보류합니다.
→ 시계열 인사이트
고친 것
- 채팅 도중 연결만 끊기면 「오류가 발생했습니다」 대신 「연결이 끊겼습니다. 서버는 답을 계속 만들고 있어…」 를 띄우고, 데스크톱 화면이 최대 5분 동안 답을 되찾아 옵니다.
- 빈 답은 「답을 만들지 못했습니다…」 로, 반복에 빠진 답은 「⚠ 같은 내용이 반복되어 답변 생성을 중단했습니다…」 로 끝납니다. 「LLM 호출 실패: finish_reason is null」 과 인용 번호 어긋남을 고쳤습니다.
- 올린 도면이 문서 목록에 안 보이던 것, DXF 미리보기 글자가 빈 상자로 나오던 것, 한국어 화면에 영어가 남던 것을 고쳤습니다.
→ 문제 해결
구성 요소 버전
| 구성 요소 | 버전 |
|---|---|
| docling-serve | v1.36.0 |
나머지는 아래 「2026.10」 과 같습니다.
2026.10 재릴리즈 — 2026-10-05
같은 2026.10 태그를 다시 구웠습니다(월 태그는 움직이는 태그입니다). 설치 절차와 포트는 바뀌지 않았습니다. 이미
2026.10 으로 올린 설치는 bin/update.sh 로 받으면 되고, 2026.09 이하에서 올린다면 아래 「2026.10」의 손으로 할 일을
그대로 따릅니다.
다시 받기 전에 볼 것 둘
PI_INBOUND_API_KEY가 비어 있지 않은지 — 이제 비어 있으면 뒷단 서비스가 뜨지 않습니다(아래 「보안」). 설치기가 만든 env 면 이미 값이 있습니다.- 호스트 env 에
TS_GPU_UTIL을 적었다면 지웁니다 — 시계열 추론 서버의 GPU 몫이 하드웨어 프로파일로 옮겨져, 호스트 env 의 줄은 기동 전 판정이profile로 세웁니다.
보안 — 뒷단 인바운드 키는 «비면 멈춤»
- RAG · 시계열 인사이트 API · 문서 이해 · 비전 · 디지털 스레드가 인바운드 키가 비면 기동을 거부합니다. 예전에는
키가 비면 인증 없이 열린 채 healthy 로 떴습니다. compose 도
PI_INBOUND_API_KEY를 필수로 받습니다. - 서비스마다 키 없이 여는 스위치(
*_INBOUND_AUTH_DISABLED)가 생겼지만, 이 판의 compose 는 넘기지 않았습니다. 재릴리즈 3 부터는 호스트 스위치PI_INBOUND_AUTH_DISABLED로 넘기고, 빈 키는 compose 가 아니라 기동 전 판정이 막습니다(위).
관측 — 지표와 요청 id
- 파이썬 뒷단 다섯이
GET /metrics(Prometheus 텍스트 형식)를 냅니다. 새 포트는 없고, 인바운드 키 뒤에 있습니다. - 같은 다섯이 요청마다
X-Request-ID를 응답에 돌려주고 그 요청의 로그 줄에request_id로 싣습니다.
→ 로그 및 모니터링 · API 연동 가이드
도면 — 기본 꺼짐, 켤 수 있게 됐습니다
DRAWING_INGEST_ENABLED(기본false)를 compose 가 rag-api 에 넘깁니다 — 예전에는 켤 방법이 없었습니다.- 켠 설치에서 두 판의 차이를 냅니다 — rag-api
GET /api/v1/drawings/{asset_id}/{doc_name}/diff?lang=(색인된 도면의 앞 판과) · 문서 이해POST /api/v1/drawings/diff(파일 두 개).
문서 · 사진 도구
FETCH_ALLOWED_HOSTS를 compose 가 문서 이해 · 비전에 넘깁니다. 사내 파일 서버의 URL 을 허용 목록에 적어 열 수 있습니다(예전 판은 넘기지 않아 사내 URL 이 늘 거절됐습니다).vision_ocr가 서빙 중인 LLM 으로 읽습니다(세 번 중 두 번 일치해야 답함). 한국어 명판 · 라벨을 읽습니다. 예전의 docling OCR 로 되돌리려면VISION_OCR_ENGINE=docling입니다.
영상 · 음성 — 손잡이가 들어왔습니다(이 판에서는 녹취가 동작하지 않았습니다)
- compose 에 영상 · 음성 수집 손잡이(
MEDIA_*·ASR_*·OCR_*)와 녹취 서빙plantpulse-asr(프로필media, 기본 꺼짐)가 들어왔고, 그 GPU 몫(ASR_GPU_UTIL)이 하드웨어 프로파일의 합에 미리 들어갑니다. - 이 판에서는 녹취 서빙이 쓰는 vLLM 이미지에 오디오 디코더가 없어 녹취가 동작하지 않았습니다. 재릴리즈 3 에서
고쳤고, 이제
PI_MEDIA_ENABLED=true한 줄로 켭니다(위).
설치 · 설정
install.sh가 남은 자리표시자를 같은 이름의 환경 변수로 채웁니다(… | sudo PP_API_TOKEN=… bash). 이미 넣은 값은 덮지 않습니다.- 기동 전 판정이 옛
CH_*줄을 «지우라» 가 아니라renamed— 이름만 바꾸는sed로 안내합니다. 지워서 값이 기본값으로 돌아가는 일이 없어졌습니다. - 하드웨어 프로파일이 다섯 몫(LLM · EMB · RERANK · TS · ASR)을 듭니다 — GB10
0.4 · 0.10 · 0.08 · 0.13 · 0.03(합 0.74), g7e0.53 · 0.13 · 0.10 · 0.15 · 0.04(합 0.95).
코파일럿 · 데이터
- 관리자가 채팅 시작 화면의 설치 기본 역할(설정
chat.home.default_role)을 정할 수 있습니다 — 사원에게 업무 역할이 없을 때만 쓰이고, 비면 시작 화면이 역할을 고르게 합니다 → 코파일럿 관리자 콘솔 - 새 표 · 칸(
chat_action·chat_turn_metric·chat_bench_run·chats.context·agent_tool_call_log.approved_by, Aster TSDBPI_NAVIGATOR_ACTION_CHECK)은 기동할 때 저절로 생깁니다. 손으로 돌릴 이전은 없습니다.
2026.10
2026.09 이하에서 올린다면 — 손으로 할 일 다섯
설치기는 이미 있는 /etc/kopens/plantpulse-ai.env 를 다시 만들지 않고 새 줄도 더하지 않습니다. 아래는
직접 해야 합니다.
- 플랫폼 자격증명 받기 설정 —
PP_DATALAKE_ADMIN_URL·PP_DATALAKE_ADMIN_API_KEY를 넣고, 플랫폼 신뢰 앵커를/etc/kopens/ca/root.crt(같은 내용을CA.crt로도)에 둡니다. AI 호스트 IP 가 플랫폼 허용목록에 있어야 합니다. 없으면 자격증명을 쓰는 컨테이너들이 FATAL 로 멈춥니다 → 설치 개요 - 저장 자격증명 암호화 키 —
PI_COPILOT_SECRET_KEY·PI_DT_SECRET_KEY줄을 넣습니다(openssl rand -base64 32).PI_COPILOT_SECRET_KEY가 없으면 코파일럿이 뜨지 않습니다 → 환경 변수 설정 CH_*→CO_*개명 — 코파일럿 환경 변수의 접두사가 바뀌었고 폴백이 없습니다. 옛 줄을 지우지 말고 값 그대로 이름만 옮깁니다(재릴리즈부터는 기동 전 판정이renamed로 잡아 이름만 바꾸는sed를 찍어 줍니다) → 환경 변수 설정- 호스트 env 정리 — 호스트 env 에는 이제 사이트 값과 비밀만 둡니다. 옛 env 에 남은 이미지 참조 · GPU 몫 ·
compose 기본값과 같은 값 ·
PP_HOST· 플랫폼 계정 · 비밀번호(PP_PG_*·PP_CASSANDRA_*·PP_REDIS_PASSWORD·PP_S3_*등) ·LITELLM_IMAGE줄은 기동 전 판정이 기동을 세웁니다.bin/lint-env.sh가 찍는sed로 지우고PP_HW_PROFILE=gb10(AWS g7e 는g7e)을 더합니다. 1 · 3 을 먼저 하십시오 → 환경 변수 설정 - 관리 콘솔 주소 —
9080이 닫히고5959(HTTP) ·5960(HTTPS)이 열립니다. 북마크와 방화벽 규칙을 옮깁니다.
코파일럿 — 화면
- 왼쪽 레일이 여섯 메뉴로 정리됐습니다 — 오늘 · 현장 · 할 일 · 해결 · AI 에게 묻기 · 리포트. 메뉴를 누르면 첫 화면으로 가고, 메뉴 안의 화면은 본문 머리의 탭으로 바꿉니다(오늘: 요약 · 주간 브리핑 / 현장: 공장 현황 · 모니터링 · 이상 탐지 · 예측 · 상관관계). 이름도 바뀌었습니다 — 홈 → 요약, 플랜트 상태 → 공장 현황, 와치 → 모니터링, 연관 분석 → 상관관계, AI 채팅 → AI 에게 묻기.
- 업무 역할별 시작 화면 —
/로 들어오면 작업자 · 반장 · 품질은 「오늘」, 정비는 「할 일」, 공장장은 「리포트」로 갑니다. - 모바일 탭이 넷이 됐습니다 — 오늘 · 현장 · 할 일 · AI 에게 묻기.
- 모니터링 탭(
/watch)의 경보 쪽이 두 단으로 바뀌었습니다 — 왼쪽 와치 경보 → AI 발견, 오른쪽 주의 설비 · 수리 후 확인. - 기본 테마는 라이트입니다. OS 가 다크여도 사용자가 다크 모드를 고르지 않으면 켜지지 않습니다.
- 알림 구독이 한동안 조용하면 프록시가 끊던 것을 고쳤습니다(코파일럿의 하트비트, 프록시는 그 경로만 1시간까지 기다림).
→ 코파일럿 화면
코파일럿 — AI 가 찾고 사람이 판정한다
- AI 발견 수신 — 시계열 인사이트가 찾은 발견을 받아 알림 · 아침 브리핑 · 「AI 발견」 조각으로 보여 주고, 오더 미달 제안을 냅니다(기본 켬). 처방형 발견 카드와 수리 후 자동 확인이 함께 들어왔습니다.
- 주의 설비 — 「오늘 먼저 볼 설비」(기본 켬).
- 휴먼 인 더 루프 — 이상 한 건에 맞음 · 헛경보 · 모르겠음을 달고, 놓친 이상을 신고하고, 제안을 수락 · 거절하고
결과를 남깁니다. 그 표시는 공개 API
GET /api/v1/ai-feedback로 읽습니다. - AI 정확도(
/accuracy, 관리자) — 정지 · 고장 규칙과 대조한 정확도, 설비별 센서 임계의 자율 조정. - 검증 대기(
/review) — 반장 · 정비 · 관리자용. 기본 꺼짐입니다. - 공개 채팅 API 가
session_id없이 오면 새 대화를 엽니다(예전 판은 500).X-API-Key로 부른 채팅도 고쳐졌습니다.
→ 시계열 인사이트 · API 연동 가이드
디지털 스레드
plantpulse-digital-thread-api가 스택에 기본으로 들어왔습니다 — 공장 그래프 거울과 커넥터 등록부의 주인입니다. 거울은 전용 Neo4j(plantpulse-digital-thread-neo4j)에 두고, LightRAG 의 그래프와 한 DB 를 나누지 않습니다. 둘 다 호스트에 포트를 열지 않습니다.- 관리 콘솔에 연동 지도(
/thread/)와 그래프 거울(/thread/mirror/) 화면이 생겼습니다. - 코파일럿 채팅에 디지털 스레드 도구(
thread_get_timeline·thread_trace_links, 기본 켬)가 붙습니다. 제안 카드에서 관리자가 승인하면 MES · SCM 에 초안 · 요청 하나를 만드는 승인 → 초안이 들어왔습니다. - 커넥터 가족에 PLM(
plm-mcp/0.1— 설계 변경 지시 · 설계 BOM)과 QM(qm-mcp/0.1— 검사 · 부적합)이 더해졌고,mes-mcp/0.5의 SCM 은 협력사 공급 능력을 냅니다. 모두 읽기 전용입니다. - what-if 도구
thread_explain_recovery(기본 꺼짐)의 답에 설계 변경 · 부적합 한 건마다 더한 지연과, 늦은 부품을 협력사에서 당겨 받을 수 있는지가 더해졌습니다(해당 커넥터가 켜져 있을 때).
설치 · 설정
- 플랫폼 자격증명은 시작할 때 받습니다 — PG · Aster TSDB · Redis · RustFS 의 계정 · 비밀번호 · 포트를 호스트 env 에 두지 않습니다. 컨테이너도, 기동 전 DB 프로비저닝 같은 호스트 스크립트도 같은 API 에서 받습니다. 받기에 실패하면 FATAL 로 멈추고, 인증서 검증을 끄는 길은 없습니다.
- 설치기는 플랫폼 호스트 · 계정 대신
PP_DATALAKE_ADMIN_URL·PP_DATALAKE_ADMIN_API_KEY를 묻습니다.START=1이면 이미지를 받기 전에 자격증명을 한 번 받아 보고, 실패하면 아무것도 띄우지 않습니다. - 호스트 env 에는 사이트 값과 비밀만 — 제품 기본값은 compose, vLLM 의 GPU 몫은 하드웨어 프로파일
(
compose/profiles/<PP_HW_PROFILE>.env)로 옮겼습니다. 이미지 핀은 호스트 env 에 둘 수 없고, 비상시 한 번만 셸 환경으로 줍니다. - 설치기가 방화벽을 연 뒤 이 스택 밖의 프로세스가 이미 쥔 포트를 경고합니다.
- 코파일럿 환경 변수 접두사
CH_→CO_(위 「손으로 할 일」). - 저장 자격증명 암호화 키
PI_COPILOT_SECRET_KEY·PI_DT_SECRET_KEY— 첫 설치에 설치기가 만듭니다. 교체는_PREVIOUS로 하고passwd.sh대상이 아닙니다 → 비밀번호 · API 키 변경 - AI 앱 PG 가 DB
pi로 — 코파일럿은 스키마co, 디지털 스레드는dt를 씁니다. 옛 DBch는 기동할 때pi.co로 옮겨집니다. PI_NEO4J_PASSWORD는 Neo4j 두 인스턴스의 계정입니다.bin/passwd.sh가 둘을 함께 바꿉니다.- 설치기가
PP_TZ하나를 골라 호스트 OS 시간대까지 맞춥니다.HOST_TUNING=skip|plan이면 패키지 설치와 nvidia 런타임 등록(도커 재시작)도 하지 않습니다. env 에 이미 적힌 TLS SAN 은 다시 설치해도 유지됩니다. - LiteLLM 호스트 포트를
PI_LITELLM_PORT(기본4000)로 바꿀 수 있습니다.
폐쇄망
bin/up.sh도 자리표시자가 남으면 띄우지 않습니다 — 예전에는START=1경로만 막아, 반입 뒤 손으로 띄운 스택이 공개 템플릿의 비밀번호로 열릴 수 있었습니다.- 반입이
START없이 끝나면 다음 순서(자리표시자 채우기 → 모델 두기 →bin/up.sh)를 찍어 줍니다. - vLLM 모델은 인터넷 쪽에서
bin/fetch-models.sh로 받아 옮깁니다(출시 가중치 · 체크섬 대조). 시계열 추론 모델은 이미지 안에 있어 반입할 것이 없습니다.
→ 폐쇄망 설치
접속 · 포트
- 관리 콘솔
9080→5959(HTTP,PI_ADMIN_WEB_PORT) ·5960(HTTPS,PI_ADMIN_WEB_TLS_PORT, 프록시 경유). 둘 다 열리고 같은 콘솔을 부릅니다. - 콘솔 뒤 서비스가 콘솔의 인바운드 키를 거절하면 로그인 화면으로 되돌리지 않고
502·upstream_auth와 볼 변수 이름을 보여 줍니다. LLM 읽기 화면은 게이트웨이(또는 그 DB)의 5xx 를502·llm_upstream으로 옮깁니다 (예전에는500) → 문제 해결 - 입구 프록시가 비root 가 되면서 컨테이너 안쪽 포트가
8080·9443·8443으로 바뀌었습니다. 호스트의 80 · 443 · 5960 은 그대로입니다.
→ 서비스 포트 맵
운영
- 컨테이너가 비root 로 돕니다 — compose 의 모든 서비스가 실행 사용자를 명시하고(우리 이미지와 입구 프록시 ·
vLLM 은 uid
10001, gid0), root 예외는 GPU 지표의plantpulse-dcgm하나입니다. 옛 설치의 root 소유 쓰기 볼륨 (프록시 인증서 · Qdrant · Neo4j 포함)은up.sh·restart.sh·update.sh가 기동 전에 한 번 맞춥니다(bin/volumes-nonroot.sh) → 서비스 운영 - 새 볼륨
pi-digital-thread-neo4j-data(공장 그래프 거울) ·pi-ttm-tuned-models(설치별 시계열 파인튜닝 가중치).
이미지
- 자체 이미지가 열둘이 됐습니다 — 디지털 스레드가 더해지고, LightRAG · LiteLLM 이 우리가 감싼 이미지
(
pi/plantpulse-lightrag·pi/plantpulse-litellm)로 바뀌었습니다. 둘 다 월 태그를 따르고, 비상시 하나만 고정할 때는PI_IMAGE_TAG_LIGHTRAG·PI_IMAGE_TAG_LITELLM을 셸 환경으로 줍니다.LITELLM_IMAGE는 없어졌습니다. - 자체 이미지의 기본 태그는
2026.10입니다.
구성 요소 버전
| 구성 요소 | 버전 |
|---|---|
| vLLM | v0.29.0 |
| LightRAG | v1.5.7 (감싼 이미지의 바탕) |
| docling-serve | v1.34.0 |
| LiteLLM | v1.103.0 (감싼 이미지의 바탕) |
| Neo4j | 5.26.28 (두 인스턴스) |
| Qdrant | v1.18.2 |
2026.09 (2026-09-25)
2026.08 이하에서 올린다면 — 손으로 할 일 둘
설치기는 이미 있는 /etc/kopens/plantpulse-ai.env 를 다시 만들지 않습니다. 아래 둘은 직접
고쳐야 기동합니다.
- 객체 저장소 키 개명 —
PP_MINIO_PORT·PP_MINIO_ACCESS_KEY·PP_MINIO_PASSWORD를PP_S3_PORT·PP_S3_ACCESS_KEY·PP_S3_PASSWORD로 이름만 바꿉니다(값은 그대로). 옛 이름만 있으면 기동 전 판정이 멈추고 옮길 줄을 알려 줍니다 → 환경 변수 설정 - LiteLLM 관리 화면 비밀번호 —
PI_LITELLM_UI_PASSWORD=<비밀번호>줄을 넣습니다. 없으면 compose 가 기동을 거부합니다 → 초기 비밀번호 변경
외부 연동이 모델을 gpt-4o · gpt-4o-mini 로 부르고 있었다면 새 이름(aura-35b 등 — 재릴리즈(2026-10-20) 부터는 aura-lite)으로 바꿔야 합니다(아래).
모델 이름
- 게이트웨이에 등록되는 이름이
aura-35b(재릴리즈(2026-10-20) 에aura-lite로 다시 바뀜) ·aura-vision(비전 별칭) ·aura-embedding-4b·aura-reranker-0.6b로 바뀌었습니다. gpt-4o·gpt-4o-mini같은 호환 별칭을 없앴습니다.VLM_NAME도 없어졌습니다 — 비전 별칭은 게이트웨이 설정이 갖습니다.
설치
- 내부 비밀은 설치기가 만듭니다 — 게이트웨이 마스터 키 · 솔트 · vLLM 키 · 인바운드 키 · RAG 키 ·
콘솔 세션 비밀. 사람에게는 사람만 아는 값(관리자 비밀번호)과 플랫폼 값(
PP_*)만 묻습니다. - TLS 인증서 SAN 을 묻습니다(
PP_PROXY_CERT_SAN). 비대화식이면 호스트 주소로 잡고 경고합니다. START=1인데 자리표시자가 남아 있으면 기동을 거부합니다(예전에는 경고만 했습니다).START=1이면 빠진 모델을 자동으로 받고 SHA256 을 검증합니다(폐쇄망은 제외).- 기동 뒤
bin/verify-install.sh가 「떴는가」가 아니라 「동작하는가」(모델 · 게이트웨이 키 · 플랫폼 토큰)를 잽니다. FAIL 이면 설치가 실패로 끝납니다. - NVIDIA 드라이버 · container toolkit 을 설치기가 깝니다(
SKIP_GPU=1로 건너뜀). HOST_TUNING=skip|plan|apply— 다른 컨테이너가 도는 호스트에서는 기본이plan(출력만)입니다.ALLOW_DOCKER_RECONFIGURE=1— 원래 있던 Docker 는 저장소를 그대로 두고 재시작하지 않는 것이 기본이 됐습니다.- env 템플릿과 기계의 아키텍처가 어긋나면 멈춥니다(
ENV_TEMPLATE_SKIP_ARCH_CHECK=1로 넘김).
→ 설치 개요
폐쇄망
- 번들 서명 검증(
verify-bundle.sh)이 반입의 첫 단계가 됐습니다. 검증되지 않거나 번들을 못 찾으면 멈춥니다. 폐쇄망용 cosign 을 번들이 싣고 다닙니다. - 형제 저장소 둘이 번들 안에 함께 들어갑니다. Docker 오프라인 패키지 종류는 아키텍처를 따릅니다
(
arm64→ deb,amd64→ rpm).
→ 폐쇄망 설치
접속 · 포트
- 기본 호스트에
/llm/(OpenAI 호환 게이트웨이)와/mcp/rag/·/mcp/timeseries/·/mcp/parser/·/mcp/vision/경로가 생겼습니다 — 도메인 하나로 쓸 수 있습니다. - Phoenix(6006)를 호스트에 발행하지 않습니다. 기본 기동은 그대로이고, 진단할 때만
PP_DEBUG_PORTS=1로 엽니다. - LiteLLM 관리 화면 계정(
PI_LITELLM_UI_USERNAME·PI_LITELLM_UI_PASSWORD, 기본admin/admin123!)이 생겼습니다. 예전에는 마스터 키를 비밀번호로 쳐야 했습니다.
→ 서비스 포트 맵
설정
- 객체 저장소 키
PP_MINIO_*→PP_S3_*(위 「손으로 할 일」). - 설비 알람 채널 Kafka → MQTT(1884, TLS).
PP_KAFKA_PORT는 없어졌습니다. - GPU 몫 합 검사 — 서비스별 GPU 몫의 합이
PP_GPU_BUDGET_CEILING(기본0.75)을 넘으면 기동 전에 멈춥니다. CH_API_V1_KEY— 공개 API(/api/v1)의 기계 인증 키. 비우면 이 키로는 들어올 수 없습니다.- LightRAG 개체 추출 제한
LIGHTRAG_LLM_TIMEOUT기본3600초 — 큰 문서 색인이 중간에 실패하던 것.
→ 환경 변수 설정
운영
bin/passwd.sh --generate— 회전할 값을 도구가 만듭니다. 만든 키는 계열 접두사 (ppin_·ppvl_·pprg_·sk-pplm_)로 무엇인지 스스로 말합니다.bin/backup.sh가 compose 볼륨 전부(로그 · 캐시 제외)를 받습니다 — TLS 인증서와 Phoenix 데이터가 새로 들어갔습니다.--list로 판정을 봅니다. → 데이터베이스 관리
관리 콘솔
- 한국어를 고를 수 있습니다(로그인 화면의 언어 전환).
- LLM 메뉴에 채팅 시험 · 모델 등록(외부 OpenAI 호환 엔드포인트) · API 키(가상 키 발급) · 업스트림 상태가 생겼습니다.
→ AI 관리 콘솔
코파일럿
- 와치(
/watch) — 지켜볼 것을 적어 두면 경보로 알려 줍니다 → 자동화 - 왼쪽 레일의 화면 순서를 일의 흐름대로 다시 놓았습니다 → 코파일럿 화면
- 대화 제목 검색, 근거 보기에 실리는 도구 인자의 비밀값 가림
- 코파일럿 관리 화면의 API 키 발급과 공개 API
/api/v1→ API 연동 가이드 - 시계열 예측 기본 모델 TTM R3, 설비 센서 이상탐지의 보정 점수 기본 임계 5.0 → 시계열 인사이트
구성 요소 버전
| 구성 요소 | 버전 |
|---|---|
| vLLM | v0.29.0 |
| LightRAG | v1.5.6 |
| docling-serve | v1.34.0 |
| LiteLLM | v1.102.0 |
| Neo4j | 5.26.28 |
| Qdrant | v1.18.2 |
| Arize Phoenix | 19.6.0 |
2026.08 (2026-08-23)
plantpulse-proxy도입 — 외부 진입점을 80 / 443 하나로 모으고 TLS 를 겁니다.- 운영 공통 동사 —
bin/up.sh·down.sh·restart.sh·logs.sh·shell.sh·update.sh·remove.sh·doctor.sh. bin/passwd.sh— 비밀번호 · API 키 변경(platform · ai · studio 공통 규약).- 설정 정본을
/etc/kopens/plantpulse-ai.env로 옮겼습니다(compose/.env는 읽지 않습니다). - 내부 서비스(vLLM · 임베딩 · 리랭커 · docling · Qdrant · 시계열 추론 · admin-api)의 호스트 포트 발행을
멈췄습니다. 뒷단 네 서비스의 인바운드 키를 한 값으로 합쳤습니다(당시 이름
PP_INBOUND_API_KEY, 지금PI_INBOUND_API_KEY). - 릴리즈를
arm64·amd64두 갈래로 굽습니다. env 템플릿 이름이env.gb10.example이 됐습니다.
v2.0.0 (2026-07) — 아키텍처 대개편
정보
아래 v1.x 항목은 개편 이전 아키텍처를 기준으로 한 과거 기록입니다. 현재 아키텍처는 본 v2.0.0 항목을 참고하세요.
채팅 오케스트레이션 내재화 (Langflow 제거)
- 채팅/에이전트 실행이 AI Chat Web 내장 에이전트(
AgentOrchestrator+ToolRegistry)로 일원화되었습니다. - Langflow 엔진 및 15개 커스텀 컴포넌트, Jupyter가 스택에서 제거되었습니다. Arize Phoenix 도 이때 빠졌지만 2026-07-27 에 LLM 트레이스용으로 돌아와 지금은 기본으로 뜹니다(2026.09 부터 호스트 포트는 닫혀 있습니다).
- LLM 추론은 LiteLLM(:4000) 게이트웨이를 경유합니다. 당시 모델 이름은
gpt-4o였고, 2026.09 에aura-35b, 2026.10 재릴리즈(2026-10-20) 에aura-lite로 바뀌었습니다. 에이전트 실행 흐름은 채팅 화면의 "작업 보기"에서 확인합니다.
MCP / 온톨로지 통합
- 구 독립 서비스
plantpulse-mcp-server(:50000)와plantpulse-ontology(:8888)가 아카이브되고, 플랫폼 server-web 통합 MCP(/api/v5/mcp, api_key 인증)로 대체되었습니다. 온톨로지 도구는 통합 MCP에 흡수되었습니다. - 내장 에이전트의
ToolRegistry가tools/list로 도구를 동적 발견합니다.
RAG → LightRAG 전환
- 자체 개발 RAG 서버(구
plantpulse-rag)가 공식 LightRAG 서버(당시 1.5.4, 2026.09 에 1.5.6)로 대체되었습니다. 문서 관리는 LightRAG WebUI(/webui)에서 수행합니다.
인프라 공용화
- PostgreSQL·Aster TSDB·Redis·RustFS는 PlantPulse 플랫폼 설치본을 공용으로 사용합니다 (AI 스택 내장 구동 폐지).
v1.4.0 (2026-03-29)
문서
- 질문 예제 178개로 확대 (피처 스토어 세분화, 복합 질문 강화, 비즈니스 시나리오 추가)
- 트러블슈팅 가이드 추가
- API 연동 가이드 추가
- 릴리즈 노트 페이지 추가
- README에 GitBook 온라인 메뉴얼 URL 추가
v1.3.0 (2026-03-29)
문서
- 질문 예제 170개로 확대 (도메인별 세분화)
- 부록 알고리즘 가이드 3개 추가:
- RAG 알고리즘 이해하기 (청킹, 임베딩, 하이브리드 검색, 리랭킹)
- AI 모델 알고리즘 이해하기 (TSPulse 이상탐지, TTM 예측, 피처 스토어)
- 온톨로지(지식 그래프) 이해하기 (그래프 DB, 서브그래프 탐색)
- 트러블슈팅 가이드 추가
- API 연동 가이드 추가
- 릴리즈 노트 페이지 추가
v1.2.0 (2026-03-29)
문서
- 부록 알고리즘 가이드 3개 추가
v1.1.0 (2026-03-29)
문서
- 질문 예제 페이지 추가 (130개)
v1.0.0 (2026-03-29)
초기 릴리즈
PlantPulse AI 제품 메뉴얼 GitBook 초기 구축.
플랫폼 구성
- 151개 MCP 도구 통합
- PlantPulse MCP Server: 116개 읽기 전용 API
- TimeSeries-Insight: 27개 AI 분석 도구
- Ontology: 5개 그래프 도구
- RAG: 3개 검색 도구
- 15개 커스텀 Langflow 컴포넌트
- AURA LLM — 산업 특화 자체 모델 (LLM + Embedding + Reranker)
AI 모델
| 모델 | 용도 |
|---|---|
| AURA LLM | 대화/분석/보고서 생성 |
| AURA Embedding | 벡터 임베딩 (2560차원) |
| AURA Reranker | 검색 결과 재순위화 |
| IBM Granite TSPulse | 시계열 이상 탐지 |
| TinyTimeMixer (TTM) | 시계열 예측 |
인프라
| 구성 요소 | 기술 |
|---|---|
| 백엔드 | Java 21 / Spring Boot 3.4, Python / FastAPI |
| 그래프 DB | Neo4j |
| 벡터 DB | Qdrant |
| 관계형 DB | PostgreSQL 18 |
| 시계열 DB | Apache Cassandra |
| 캐시 | Valkey (Redis 호환) |
| 오브젝트 스토리지 | RustFS (S3 호환) |
| LLM 프록시 | LiteLLM |
| AI 워크플로우 | Langflow |
| AI 관찰성 | Arize Phoenix |
| 실험 환경 | Jupyter Notebook |
모듈별 주요 기능
AI Chat Web
- 자연어 기반 공장 데이터 조회
- SSE 실시간 스트리밍 응답
- ECharts/Mermaid 리치 시각화
- 멀티 AI Flow 관리
MCP Server
- OPC-UA/ISA-95 기반 116개 읽기 전용 API
- 10개 데이터 도메인: 설비, OPC, 작업지시, 사이트, 태그, OEE, 캘린더, 시스템, RAM, EMS, 알람, 포인트 등
- KST 네이티브 시간 처리
TimeSeries-Insight
- 7개 도메인 이상 탐지 (IBM Granite TSPulse)
- 7개 도메인 예측 (TinyTimeMixer TTM)
- 알람 심층 분석 (통계, 지속시간, 상관관계)
- 피처 스토어 (시간별/일별 자동 계산, 벡터 임베딩, LLM 컨텍스트)
- 설비 건강 점수 (0~100)
Ontology
- 14종 노드 타입의 공장 지식 그래프
- 서브그래프 탐색 (depth 지정)
- PlantPulse DB ↔ Neo4j 60초 자동 동기화
RAG
- 4가지 검색 모드 (hybrid, naive, local, global)
- 하이브리드 검색 (Dense + Sparse)
- 멀티모달 지원 (텍스트 + 이미지 + 테이블)
- Docling 문서 파서, 리랭커
AI Studio
- Langflow 비주얼 플로우 프로그래밍
- 15개 PlantPulse 전용 컴포넌트
- LiteLLM LLM 프록시
- Arize Phoenix AI 평가/모니터링
- Jupyter Notebook 실험 환경