AI 엣지 어시스턴트
게이트웨이 화면 안에서 엣지 데이터를 우리말로 물어볼 수 있습니다. 「지금 수집 안 되는 연결 있어?」처럼 묻고, AI 가 필요한 조회를 스스로 골라 답합니다.
ai.enabled 가 false 입니다. 쓰려면 설정에서 켜고 모델 주소와 키를 넣어야 합니다
(아래 켜는 법).
무엇을 물어볼 수 있나
엣지 안에 있는 것 — 엣지 상태 · OPC 연결 · 태그 · 수집 현황 입니다. 상위 플랫폼의 설비 계층이나 알람은 이 어시스턴트의 범위가 아닙니다.
| 이렇게 물으면 | AI 가 쓰는 것 |
|---|---|
| 「연결 목록 보여 줘」 | 연결 목록 조회 |
| 「3번 연결 지금 어때?」 | 연결 상세 · 수집 현황 |
| 「이 태그 지금 값이 뭐야」 | 태그 현재값 (여러 개 한 번에) |
| 「아까부터 값이 이상한데 최근 한 시간 보여 줘」 | 태그 이력 |
| 「상위로 잘 올라가고 있어?」 | 전송 큐 상태 |
| 「지금 게이트웨이 부하가 어때」 | 모니터링 지표 |
사진도 붙일 수 있습니다 — 계기나 화면을 찍어 함께 물어보십시오.
🔴 제어는 «승인» 을 받습니다
AI 가 쓸 수 있는 도구 중 셋은 상태를 바꿉니다.
| 도구 | 하는 일 |
|---|---|
start_opc | 연결을 시작한다 |
stop_opc | 연결을 멈춘다 |
write_tag | 태그에 값을 쓴다 |
이 셋은 AI 가 혼자 실행하지 않습니다. 「이 제어 작업을 승인할까요?」가 뜨고, 사람이 승인을 눌러야 실행됩니다. 취소하면 아무 일도 일어나지 않습니다.
승인 요청을 띄워 두고 한참 뒤에 누르면 **「승인이 만료되었거나 유효하지 않습니다」**가 나옵니다. 그때는 다시 물어보십시오.
client_access 가 R 인 태그는 AI 가 승인을 받아도 쓰지 못합니다. 어시스턴트가
쓰는 통로가 기존 API 와 같아서, 거기 걸린 가드가 그대로 걸립니다 →
태그 추가
조회 도구(목록·값·이력·상태)는 상태를 바꾸지 않으므로 승인 없이 바로 실행됩니다.
켜는 법
app.properties 에서 설정합니다 → 웹 UI 환경 설정
| 설정 | 기본값 | 무엇 |
|---|---|---|
ai.enabled | false | 켬/끔 |
ai.api.base_url | (빈 값) | 모델 서버 주소 — 사내 게이트웨이나 로컬 서버 |
ai.api.key | (빈 값) | 그 서버의 키 |
ai.model | gpt-4o-mini | 모델 이름 |
ai.max_tool_steps | 8 | 한 질문에 도구를 최대 몇 번까지 부를지 |
ai.timeout_ms | 30000 | 응답 대기 |
ai.bulk_read_limit | 50 | 한 번에 읽을 태그 수 상한 |
「AI 어시스턴트가 비활성화되어 있습니다. 설정에서 ai.enabled 와 ai.api.base_url 을
지정하세요.」 — 둘 다 있어야 동작합니다.
ai.api.base_url 이 바깥 인터넷을 가리키면 현장 데이터가 밖으로 나갑니다.
폐쇄망이거나 데이터 반출이 막힌 현장이라면 사내 게이트웨이나 게이트웨이 안에서 도는
로컬 모델을 가리키게 하십시오. 키는 로그에 남지 않습니다.
안 될 때
| 증상 | 원인 |
|---|---|
| 「비활성화되어 있습니다」 | ai.enabled 가 꺼져 있거나 ai.api.base_url 이 비었습니다 |
| 「응답하지 못했습니다」 | 모델 서버에 닿지 않습니다 — 주소·키·방화벽 |
| 「너무 복잡합니다」 | 한 번에 답하기 어려운 질문입니다. 범위를 좁혀 다시 물으십시오 |
| 「승인이 만료되었거나 유효하지 않습니다」 | 승인 요청이 오래됐습니다. 다시 물어보십시오 |
| 제어가 거부됨 | 태그의 client_access 가 R 입니다 |