코파일럿 관리 콘솔

코파일럿 화면과 같은 주소의 /admin 에 관리자만 여는 콘솔이 있습니다. 여기서 사람과 권한을 정하고, AI 가 쓸 모델 · 도구를 연결하고, 설비 등급 · 알림 채널 · 브랜드 같은 운영 값을 다루고, 누가 무엇을 바꿨는지 봅니다.

관리 콘솔이 둘입니다 — 헷갈리기 쉽습니다

	어디	무엇을 보나
코파일럿 관리 콘솔 (이 문서)	코파일럿과 같은 주소의 `/admin`	사람 · 권한 · LLM · 프롬프트 · 운영 스위치 · 감사
AI 관리 콘솔	`admin.*` 또는 `:5959`(HTTPS `:5960`)	GPU · LLM 응답 속도 · RAG 색인 · 서비스 헬스 · 디지털 스레드 연동 지도 · MCP 게이트웨이(AI 가 쓰는 도구 켬/끔)

앞쪽은 AI 를 어떻게 쓸지, 뒤쪽은 스택이 살아 있는지를 봅니다.

들어가기

사이드바 아래 프로필 줄을 눌러 위로 열리는 메뉴에서 관리를 누릅니다. 주소로는 https://<서버>/admin 입니다.

코파일럿과 같은 계정입니다. 따로 로그인하지 않습니다.
관리 항목은 관리 콘솔을 열 수 있는 사람에게만 보입니다. 열 수 없는 사람이 주소로 오면 «관리 콘솔은 관리자만 열 수 있습니다.» 가 뜹니다.
관리 콘솔을 열 수 있는지는 사람마다 사용자 › 관리 콘솔 열기 스위치 하나로 정합니다.
관리자가 아니면서 감사 기록 보기 권한이 있는 사람(감사 · 품질 보증 담당 등)에게는 프로필 메뉴에 감사가 따로 보입니다(/audit). 관리자는 관리 콘솔 안의 감사 로그를 씁니다.

화면 지도

관리 홈 — ① 사람과 권한 ② AI ③ 운영 ④ 기록

관리 홈은 「계정·권한, AI 연결, 운영 스위치, 감사 기록을 관리합니다.」 로 시작하고, 화면 열여섯이 네 묶음으로 나뉩니다. 넓은 화면(1024px 이상)에서는 왼쪽에 목록이 보이고, 줄을 눌러 오른쪽에 상세가 열리면 목록은 접힙니다. 아래 «한 줄» 은 화면에 적힌 설명 그대로입니다.

묶음	화면	한 줄
사람과 권한	사용자	계정 · 관리 콘솔 · 역할 묶음
	역할 묶음	권한 · 범위 · 열람 등급의 묶음
	문서 등급	문서마다 열람 등급
	담당자	조치 통보 · SOP 메일 받는 사람
	API 키	외부 연동 키 발급 · 폐기
AI	LLM 설정	AI 모델 연결
	프롬프트	시스템 프롬프트 · 기본값 복원
	답변 품질	정기 시험 점수
	운영 현황	사용 · 제안 · 이상 접수 · 자동화 통계
운영	현장 알림 미리 보기	설비 이상 · 고장 위험 알림을 켜기 전에 기록만 하기
	설비 중요도 등급	알림 심각도의 입력
	정확도 튜닝	설비별 임계 조정 승격
	알림 채널	자동화가 보낼 Teams · Slack 채널, 메일 허용 도메인
	브랜드	고객사 이름 · 로고 · CI 색
	시스템 설정	전역 설정 값
기록	감사 로그	변경 · 열람 기록

오른쪽 편집 칸에서 고치던 것을 저장하지 않고 닫거나 다른 줄 · 다른 화면으로 가려 하면 「저장하지 않은 변경이 있습니다」 — 「지금 나가면 고친 내용이 사라집니다.」 로 한 번 묻습니다. 저장하지 않고 나가기를 눌러야 떠납니다.

옛 관리 화면에서 사라진 것

세션 관리 · 실행 로그 · 시스템 모니터는 새 콘솔에 없습니다. 사용 통계는 운영 현황에서 봅니다(옛 «AI 사용 통계» 와 칸이 다릅니다). 옛 «알림 선반·중요도»(/admin/alerts)의 일은 현장 알림 미리 보기 · 설비 중요도에서, 옛 «권한 관리»(/admin/roles)의 일은 역할 묶음에서 합니다. 옛 관리 주소는 넘어가지 않습니다 — 없는 관리 주소와 같이 「찾는 화면이 없습니다」 를 보입니다. 서비스 상태 · 로그는 AI 관리 콘솔에서 봅니다.

사람과 권한

사용자 — /admin/users

목록에 이름(아래에 아이디) · 이메일 · 관리 콘솔(「열 수 있음」) · 상태(사용 중 · 비활성)가 보이고, 이름 · 아이디 · 이메일로 찾습니다. 줄을 누르면 오른쪽에 편집 칸이 열립니다. 칸은 다섯 묶음입니다.

묶음	칸
기본	이름 · 이메일 · 휴대폰 · 내 업무(작업자 · 반장 · 정비 · 품질 · 공장장) · 관리 콘솔 열기 · 새 비밀번호(비워 두면 바꾸지 않습니다, 8자 이상)
역할 묶음	묶음을 여러 개 체크합니다. 묶음의 내용은 역할 묶음 화면에서 고칩니다
범위·등급	전체 범위 스위치 — 끄면 종류(설비·라인·사이트 · 프로젝트 · 고객 PO · 협력사)와 키를 적어 범위 더하기. 그리고 열람 등급
위임·만료	고른 묶음마다 기한(비우면 기한 없음), 그리고 기간 위임(대행)
플랫폼 연결	플랫폼 사용자 — 플랫폼 로그인 아이디와 잇습니다

사용자 추가 — 아이디(나중에 바꿀 수 없습니다) · 비밀번호(8자 이상) · 이름 · 이메일 · 내 업무 · 관리 콘솔 열기, 그 아래로 역할 묶음 · 범위·등급 · 위임·만료 · 플랫폼 연결이 편집과 같은 칸으로 이어집니다(휴대폰과 기간 위임은 만든 뒤 편집에서 넣습니다). 아무것도 고르지 않으면 작업자 묶음 · 전체 범위 · 대외비로 시작합니다.
내 업무를 바꾸면 업무 역할 묶음(작업자 · 반장 · 정비 · 품질 · 공장장)이 그 하나로 바뀌고, 관리자 · 협력사 같은 다른 묶음은 그대로입니다.
관리 콘솔 열기 스위치와 «관리자» 묶음은 같은 것입니다 — 한쪽을 바꾸면 다른 쪽도 바뀝니다.
저장은 계정 정보 → 내 업무 → 권한(묶음 · 범위 · 등급) 순으로 넣습니다. 중간에 거절되면 「저장됨: … / 저장 안 됨: … — 이유」 로 어디까지 들어갔는지 알려 주고, 고치던 칸은 그대로 남습니다. 기간 위임만은 저장과 따로, 위임을 누르는 즉시 적용됩니다.
그만둔 사람은 비활성으로 바꿉니다. 삭제는 없습니다 — 기록이 그 사람 이름으로 남아 있어야 하기 때문입니다. 다시 사용으로 되살립니다.
🔴 자기 계정은 비활성으로 바꿀 수 없습니다. 관리 콘솔을 열 수 있는 사람을 적어도 두 명 두십시오.

칸마다의 뜻과 규칙(범위가 비면 아무것도 안 보임 · 협력사 만료일 필수 등)은 권한 — 사람에게 붙이기에 있습니다.

역할 묶음 — /admin/bundles

기본 묶음 다섯(작업자 · 반장 · 정비 · 공장장 · 관리자)과 그 밖의 묶음이 나뉘어 보이고, 직접 만든 묶음에는 「직접 만든 것」 표시가 붙습니다. 열은 묶음 · 권한 수 · 기본 열람 등급 · 사람 수 · 마지막 변경입니다.

묶음을 열어 권한 · 범위 종류 · 기본 열람 등급을 고치고 저장하면 그 묶음을 가진 사람 모두에게 곧바로 적용되고 감사에 남습니다. 관리자 묶음에서 «관리 콘솔» 권한은 뺄 수 없습니다 — 아무도 관리 콘솔에 못 들어가는 일을 막습니다. 옛 리포트 화면만 여닫던 권한(menu:report)은 새 화면에서 아무것도 막지 않아 이 편집 칸에 보이지 않습니다(묶음에 들어 있던 값은 저장해도 그대로 남습니다).

문서 등급 — /admin/grades

문서마다 열람 등급(일반 · 사내 · 대외비 · 통제)을 정합니다. 관리자이면서 문서 등급 지정 권한이 있어야 합니다.

목록은 처음 300건까지 보입니다. 넘으면 «설비 아이디로 좁히기» 로 좁힙니다.
문서 서버가 거절하면 «범위 밖이거나 내 열람 등급보다 높은 등급» 입니다 — 내 등급보다 높은 문서의 등급은 바꿀 수 없습니다.

담당자 — /admin/employees

이상 접수 조치(담당자 통보 · 현장 점검)와 AI 가 낸 SOP · 보고서를 메일로 받을 사람의 목록입니다. 로그인 계정과는 별개입니다 — 코파일럿에 로그인하지 않는 사람도 담당자로 둘 수 있습니다.

칸	넣는 것
이름 · 이메일	필수
조직 · 직책	적어 두는 글입니다. 받는 사람을 고르는 데 쓰지 않습니다
통보 역할	없음 (자동으로 받지 않음) · 정비 · 운영 · 안전
담당 사이트 · 담당 설비	이 사람이 맡는 곳입니다. 비우면 전체이고, 여럿이면 쉼표로 나눕니다

목록에는 이름과 함께 통보 역할과 담당 범위(「사이트 … · 설비 …」 또는 「전체」)가 보입니다.

받는 사람은 이렇게 정해집니다. AI 조치안의 역할(정비 · 운영 · 안전)과 통보 역할이 같고, 담당 범위가 그 이상 접수의 사이트를 품고 설비와 하나라도 겹치는 사람이 딱 한 명이면 그 사람이 받습니다. 없거나 여럿이면 조치를 실행하는 사람이 화면에서 고릅니다 → 제안 — 조치 실행 — 받는 사람

설치 · 업그레이드 뒤 통보 역할 · 담당 범위를 채우십시오

통보 역할이 «없음» 인 담당자는 저절로 받지 않습니다. 이전 판에서 넘어온 담당자는 이 칸이 비어 있습니다. 비워 두면 모든 통보 · 점검에서 실행하는 사람이 매번 받는 사람을 골라야 합니다. 조치가 저절로 맞는 사람에게 가게 하려면 담당자마다 통보 역할과 담당 사이트 · 담당 설비를 정하십시오. 같은 역할 · 같은 범위에 두 사람을 두면 저절로 고르지 않습니다.

담당자 통보는 메일로 나갑니다. 메일 서버(SMTP) 를 시스템 설정에서 정하지 않으면 통보 조치는 실행되지 않습니다.

API 키 — /admin/api-keys

외부 시스템이 코파일럿의 공개 API(/api/v1)와 MCP(/mcp)를 부를 때 쓰는 키를 발급하고 폐기합니다. 요청 헤더 X-API-Key 에 싣습니다.

발급 — 이 키를 쓸 곳의 이름을 적습니다(80자 이내, 예: 설비관리시스템).
키 값이 뜹니다. 🔴 이때 한 번만 보입니다. 코파일럿은 키를 해시로만 저장하므로 관리자도 다시 볼 수 없습니다.
쓰지 않는 키는 폐기합니다. 되돌릴 수 없고, 그 키를 쓰던 곳은 즉시 끊깁니다.

«마지막 사용» 이 «쓴 적 없음» 인 키는 폐기 후보입니다. 이 키로는 공개 API · MCP 만 열리고 관리 콘솔에는 닿지 않습니다 → API 연동 가이드

AI

LLM 설정 — /admin/llm

채팅이 쓰는 AI 모델의 연결입니다.

칸	넣는 것
주소	OpenAI 호환 주소 — `http(s)://…/v1` 까지
모델	이름을 적거나, 연결 시험 뒤 받은 목록에서 고릅니다
API 키	새로 적을 때만 바뀝니다. 화면에는 «키가 설정돼 있습니다» 처럼 상태만 보입니다

연결 시험은 응답 시간과 모델 수를 보여 줍니다. 저장하면 모든 사람의 다음 질문부터 새 연결을 씁니다.

AI 가 쓰는 도구 — 이 콘솔이 아니라 MCP 게이트웨이에서 켭니다

2026.10 재릴리즈(2026-10-20) 부터 이 콘솔에는 도구 서버(MCP) 화면(/admin/mcp)이 없습니다. 코파일럿은 MCP 서버를 직접 붙이지 않고 MCP 게이트웨이 주소 하나만 봅니다. 서버 등록 · 도구 켬/끔 · 연결 확인은 모두 AI 관리 콘솔 › MCP 게이트웨이 에서 합니다 → AI 관리 콘솔 — MCP 게이트웨이

옛 판에서 이 화면으로 켜고 끈 값(mcp_server · mcp_tool_pref)은 옮겨지지 않습니다. 코파일럿이 기동할 때 그 표를 지우고, 처음 켬/끔은 게이트웨이의 정책을 따릅니다 → MCP 도구 지도 — 처음 켜 두는 것
코파일럿에 남는 것은 승인 게이트 · 사람 단위 감사 기록 · 역할 묶음의 범위입니다. 쓰기 도구를 승인 없이 부르지 않는 것은 여전히 코파일럿이 지킵니다.

외부 시스템 커넥터는 MCP 게이트웨이가 아니라 연동 지도에서 붙입니다

MES · SCM · PLM · QM 같은 외부 시스템 커넥터는 AI 관리 콘솔 → 디지털 스레드 → 연동 지도에서 등록합니다. 게이트웨이에 서버로 붙이면 커넥터 도구(mes_ · erp_ …)는 켤 수 없습니다 → 디지털 스레드

프롬프트 — /admin/prompts

AI 의 시스템 프롬프트를 분류별로 보고 고칩니다(이름 · 판 · 길이 · 마지막 변경).

편집 탭에서 고치고 저장하면 판이 올라갑니다.
이력 탭에 처음 만듦 · 수정 · 제품 업그레이드 · 지움이 남고, 옛 판을 편집기로 불러오기 할 수 있습니다.
기본값 복원은 확인을 받은 뒤 제품 기본값으로 덮어씁니다. 덮기 전 판은 이력에 남습니다.

답변 품질 — /admin/quality

정기 시험(벤치)의 점수를 최근 90일 동안 보여 줍니다 — 도구 호출 · 온톨로지 · 답변 근거 · 데일리 · what-if. 회차마다 중앙값 · 폭 · 횟수로 요약하고, 재는 동안 뒷단이 흔들려 못 잰 회차는 점수에서 뺍니다. 읽기 전용입니다 → 정확도 · 벤치마크

같은 화면 아래 진단 정확도 절은 이상 접수의 AI 진단을 사람이 «맞음 · 틀림» 으로 판정한 비율입니다.

보이는 것	뜻
기간	30일 · 90일 · 180일(기본 90일). 접수한 날 기준입니다
맞음 비율	판정한 것 가운데 맞음 — 「판정 N건 중 맞음 N건」. 판정이 하나도 없으면 «모름» 입니다(0% 가 아닙니다)
판정 표본	진단 가운데 판정한 것
결과 모름	판정이 없는 진단. 맞음 비율의 분모에 들지 않고 따로 셉니다
표본 부족	판정이 20건보다 적으면 비율 옆에 붙습니다. 숫자는 그대로 보입니다
나눠 보기	이상 종류별(센서 이상 · 알람 · 전조) · 모델별 · 설비별 상위 10 · 주 단위 추세(월요일 시작, 최근 주가 위) · 실제 원인 · 조치별

판정은 이상 접수의 결과 기록(「진단이 맞았나요?」)과 조치안 거절(«진단이 틀림» 이면 틀림으로)에서 옵니다 → 제안 — 조치안 검토
모델별은 그 진단을 실제로 답한 모델의 이름입니다. 모델을 기록하기 전의 진단은 «모델 모름» 입니다. 모델 이름이 같으면(가중치만 바꿈) 같은 모델로 셉니다 — 판 교체 전후는 주 단위 추세로 봅니다.
보는 관리자의 데이터 범위 안의 이상 접수만 셉니다.

운영 현황 — /admin/ops-stats

코파일럿을 얼마나 쓰고, 제안 · 이상 접수 · 자동화가 어떻게 처리됐는지를 한 화면에 셉니다. 읽기 전용이고, 코파일럿이 스스로 기록한 것만 셉니다.

기간은 7일 · 30일 · 90일(기본 7일)입니다. 오늘을 포함해 공장 시간대의 날로 셉니다. 머리말에 「(시작일) ~ (끝일)(공장 시간대) 동안 copilot 이 기록한 것만 셉니다」 가 보입니다.

절	보이는 것
사용	대화 · 활성 사용자(질문한 사람 수만) · 도구 호출(오류 · 거부 · 없는 도구) · 응답 시간 중앙값 · p90 · 실패한 응답 · 도구 오류율 · 일별 추세(날별 질문 수 막대)
제안	이상 발견이 낸 제안 카드 — 생성 · 수락 · 무시(거절) · 결정 없음 · 처리(결과 기록) · 결정까지(중앙값)
이상 접수	접수 · 확인까지(중앙값) · 닫힘까지(중앙값) · 사람 판정(진단 판정을 남긴 접수 비율) · 종류별(이상 감지 · 알람 · 전조 · 예측 · 감시 · 자동화)
자동화	회차(미리 보기는 빼고) · 성공 · 판정 못 함 · 실패 · 중단 · 건너뜀 · 진행 중 · 자동 멈춤 · 실패 상위 원인

기록이 없는 칸은 «기록 없음» 입니다 — 0 이 아닙니다.
응답 시간은 도구 호출을 포함한 턴 전체입니다. LLM 토큰 · 모델 지연은 이 화면이 세지 않습니다(Phoenix LLM 트레이스가 맡습니다).
제안 절은 이상 발견이 낸 카드만 셉니다 — 수행 제안(계획) 카드와 자동화 카드는 들지 않습니다.
진단 정확도는 이 화면이 아니라 답변 품질에서 봅니다.
🔴 설비 범위가 정해진 관리자에게는 제안 · 이상 접수만 범위 안의 것을 셉니다(「설비 범위로 거른 숫자입니다」). 설비에 묶이지 않는 사용 · 자동화는 «모름» 으로 보입니다 — 공장 전체 범위 관리자만 봅니다.

운영

현장 알림 미리 보기 — /admin/field-modes

새 판정(설비 이상 알림 · 단기 고장 위험)을 현장에 알리기 전에 기록만 해 보는 스위치입니다. «그림자» 는 기록만, «현장» 은 현장에 알립니다. 현장으로 켤 때는 이유를 적어야 하고 감사에 남습니다.

이상 감시는 자동화로 옮겨 갑니다

무엇을 언제 지켜볼지는 앞으로 자동화로 정합니다. 이 화면과 아래 정확도 튜닝은 이후 판에서 자동화 템플릿으로 대체될 예정이니, 새로 시작하는 감시는 자동화로 만드십시오.

설비 중요도 등급 — /admin/criticality

설비마다 치명 · 중요 · 일반 · 낮음을 정합니다. 이 등급이 알림 · 제안의 심각도에 들어갑니다. 등급이 없으면 «일반» 입니다.

바꿀 때 메모가 필수(200자 이내)이고 감사에 남습니다.
아래 최근 바뀐 등급에 마지막 50건이 보입니다.

정확도 튜닝 — /admin/tuning

설비별 센서 이상 판정 임계의 자율 조정을 승격하거나 되돌립니다. 관리자이면서 임계 조정 승격·되돌리기 권한이 있어야 합니다. 바꾸는 것은 판정 임계뿐이고 설비 · 공정에는 아무것도 하지 않습니다. 위 안내대로 이후 판에서 자동화로 대체될 예정입니다.

알림 채널 — /admin/channels

알림 채널 — ① 채널 등록 ② 등록된 채널 ③ 메일 허용 도메인

자동화가 결과를 메신저와 메일로 내보낼 곳을 관리자가 미리 정해 두는 화면입니다. 화면 머리말은 「Teams·Slack 채널을 등록하면 자동화의 «보내기» 에서 고를 수 있습니다.」 이고, 아래에 메일 허용 도메인 칸이 함께 있습니다. 관리 콘솔을 열 수 있는 사람이면 다룰 수 있습니다(따로 드는 권한은 없습니다).

메신저 채널

Teams 나 Slack 의 그 채널에서 수신 웹훅을 만들어 주소를 받습니다.
채널 등록을 눌러 채널 이름(60자 이내, 예: 정비팀 Teams)과 웹훅 주소를 넣고 저장합니다.
자동화를 만드는 사람은 «보내기» 의 메신저 채널에서 이 이름을 고릅니다.

무엇	규칙
받는 주소	`https` 로 시작하는 Teams · Slack 웹훅만 — Slack `hooks.slack.com`, Teams `…webhook.office.com` · `outlook.office.com` · `…logic.azure.com` · `…api.powerplatform.com`. 다른 호스트 · IP 주소 · 기본(443) 밖의 포트는 등록이 거절됩니다
종류	따로 고르지 않습니다. 주소의 호스트로 Teams 인지 Slack 인지 정해지고, 목록에 「Teams · 호스트」 처럼 보입니다
주소가 보이는 곳	🔴 이 화면뿐입니다. 자동화 화면에는 채널의 이름 · 종류만 보이고, 감사 기록에도 주소가 아니라 호스트만 남습니다
줄마다 단추	끄기 · 켜기(꺼진 채널에는 「꺼짐」 표시) · 고치기 · 지우기
개수	설치 하나에 30개까지

채널을 끄거나 지우면 그 채널로 보내던 자동화는 더 보내지 못하고 다음 실행에서 멈춥니다(지울 때 화면이 같은 말로 확인을 받습니다).
메신저 채널로 보내는 자동화는 «승인 — 이상 접수 조치 실행» 권한이 있는 사람(기본 묶음으로는 반장 · 정비 · 공장장 · 관리자)만 만들 수 있습니다. 협력사 · 감사 묶음의 사람이 만든 자동화는 메일 · 메신저로 나가지 않고 앱 알림을 자기에게만 보냅니다.
이 화면에 시험 보내기 단추는 없습니다. 자동화의 «미리 돌려 보기» 는 「이렇게 보냅니다」 로 받을 곳만 보여 주고 보내지 않습니다. 실제로 가는지는 그 채널을 고른 자동화를 지금 실행해 실행 기록의 「보낸 곳」 에서 확인합니다.

메일 허용 도메인

자동화 메일은 여기 적힌 도메인의 주소로만 나갑니다. 쉼표로 나눠 적고 저장합니다(예: plant.example, group.example, 20개까지).

🔴 비어 있으면 자동화 메일은 꺼져 있습니다 — 화면에 「도메인이 없어 자동화 메일이 꺼져 있습니다.」 가 뜨고, 자동화의 «보내기» 에서 사내 메일을 고를 수 없습니다.
도메인은 정확히 같아야 합니다. plant.example 을 적어도 mail.plant.example 주소로는 나가지 않습니다 — 하위 도메인은 따로 적습니다.
받는 사람은 사내 사용자 · 역할로만 고르고, 주소는 사용자 명부의 이메일에서 옵니다. 명부의 주소가 허용 도메인 밖이면 그 사람에게는 보내지 않고 실행 기록에 「사내 메일 주소가 아닙니다」 로 남습니다.
메일 서버(smtp.*)는 시스템 설정에서 정합니다. 서버가 없으면 도메인을 적어도 메일은 나가지 않습니다.
같은 값이 시스템 설정에도 «메일 허용 도메인»(automation.mail.allowed-domains)으로 보입니다 — 어느 쪽에서 고쳐도 같은 값입니다.

하루 발송 상한(시스템 설정에서 고칩니다, 괄호 안이 기본)

키	뜻
`automation.deliver.mail.daily-max` (6)	자동화 하나가 한 사람에게 하루에 보내는 메일 수
`automation.deliver.webhook.daily-max` (12)	자동화 하나가 채널 하나에 하루에 보내는 메신저 건수
`automation.deliver.role.max-members` (50)	받는 사람을 역할로 골랐을 때 펼쳐지는 인원

넘은 것은 실행 기록에 「오늘 보낼 수 있는 수를 넘었습니다」 로, 같은 내용을 그날 이미 보냈으면 「같은 내용을 오늘 이미 보냈습니다」 로 남습니다.

감사 — 채널의 등록 · 고치기 · 끄기 · 지우기는 notify_channel:…, 허용 도메인은 automation.mail.allowed-domains 로 감사 로그에 남습니다. 자동화가 실제로 보낸 기록은 그 자동화의 agent:… 줄에 남습니다 → 자동화 — 보내는 곳

이상 · 이상 접수의 메일 · Slack 알림은 다른 설정입니다

이 화면은 자동화가 보내는 곳만 다룹니다. AI 이상 진단과 이상 접수가 직접 보내는 메일 · Slack 알림은 종전대로 시스템 설정의 anomaly.notify.* · incident.notify.* 키를 씁니다.

브랜드 — /admin/brand

로그인 화면과 코파일럿 화면을 고객사 이름 · 로고 · 색으로 바꿉니다. 관리자이면서 브랜드 바꾸기 권한이 있어야 하고, 이 권한은 관리자 묶음에만 기본으로 들어 있습니다.

칸은 네 묶음입니다.

묶음	칸
기본	제품 이름(60자 이내의 한 줄, 비우면 기본 이름) · 브라우저 탭 제목 · CI 색 · 주색(둘 다 `#rrggbb`, 비우면 기본값) · 로고 라이트 화면용 · 다크 화면용 · 파비콘
로그인	로그인 머리에 보일 것(로고와 이름 · 로고만 · 이름만) · 머리 제목(한국어 · 영어, 60자 — 비우면 제품 이름) · 부제(한국어 · 영어, 120자 — 비우면 보이지 않음) · 바닥 저작권 문구(120자 — 비우면 기본 문구) · 로그인 배경
문의	고객 문서 주소(`https://` 로 시작하는 주소만, 비우면 기본 문서) · 지원 이메일 · 지원 전화(숫자와 `+ - ( )` · 공백) — 도움말 화면과 오류 화면의 «문의» 에, 적은 것만 보입니다
메일	보내는 사람 표시 이름(60자 — 비우면 기본 이름) · 메일 머리에 로고 넣기(스위치) — 자동화 메일 · 보고서 메일에 쓰입니다

브라우저 탭 제목은 자리표시를 적는 칸이 아니라 셋 가운데 고르는 칸입니다 — 화면 이름과 제품 이름을 « · » 로 잇는 순서입니다.

고르는 것	묻기 화면에서 보이는 탭 제목
화면 이름 · 제품 이름(기본)	`묻기 · 제품 이름`
제품 이름 · 화면 이름	`제품 이름 · 묻기`
제품 이름만	`제품 이름`

그림의 형식과 한도입니다.

그림	형식	크기 한도
로고(라이트 · 다크)	PNG · WEBP, 투명 배경	512 KB, 긴 변 2048px. 머리줄 로고 자리가 정사각이라 심볼형을 권합니다. 다크용이 없으면 라이트용을 씁니다
파비콘	정사각 PNG 만	256 KB, 한 변 32~1024px. 탭(32) · 홈 화면(180) · 앱 아이콘(192 · 512) 크기로 줄여 씁니다. 올리지 않으면 PNG 로고에서 만듭니다
로그인 배경	PNG · WEBP	3 MB, 긴 변 4096px(가로 1920px 안팎 권장). 사진 위에 CI 색 덮개가 깔립니다
메일 머리 로고	—	따로 올리지 않습니다. 스위치를 켜면 라이트 화면용 로고를 메일 맨 위에 넣습니다

🔴 앱 화면은 무채색입니다. CI 색은 로그인 배경 덮개와 묻기 첫 화면의 옅은 빛에만 쓰입니다 — 앱 안의 글자 · 단추가 CI 색으로 물들지 않습니다. 주색은 주 단추 · 선택된 탭 · 전송 단추의 색이고, 기본(검정 톤)을 그대로 두기를 권합니다.
SVG · HTML · GIF 는 받지 않습니다(SVG 는 PNG 로 내보내 올립니다). 형식은 파일 이름이 아니라 파일 내용으로 판정합니다.
글자를 읽을 수 있게 색을 지킵니다 — 주색 위 글자는 흰색 · 검정 가운데 대비가 큰 쪽을 쓰고, 대비가 4.5 : 1 보다 낮으면 경고합니다. 주색이 바탕(라이트 · 다크)과 너무 비슷하면(3 : 1 미만) 그 모드에서만 자동으로 진하게 · 밝게 맞춥니다.
그림은 고르는 즉시 올라가고(올리기 · 바꾸기, 되돌릴 때는 기본으로), 글자 칸은 저장을 눌러야 들어갑니다. 저장 전에 미리보기에서 브라우저 탭 · 로그인 화면 · 묻기 첫 화면 · 메일 머리를 라이트 · 다크로 봅니다.
기본값으로 복원은 제품 이름 · 색 · 로고 · 로그인 배경을 모두 되돌리고 올린 그림을 지웁니다.
바꾼 칸은 칸마다 brand.… 이름으로 감사에 남습니다(누가 · 이전 값 → 바뀐 값).

화이트라벨 납품이면 이 화면 하나로 로그인 · 탭 · 도움말 · 메일까지 고객사 이름으로 맞춥니다. Windows 데스크톱 앱의 아이콘 · 이름은 이 화면이 아니라 설치 파일을 구울 때 정합니다 → 코파일럿 여는 법

시스템 설정 — /admin/config

서버가 아는 전역 설정을 이름 · 설명 · 기본값과 함께 보고 고칩니다. 화면 머리말은 「서버가 아는 설정과 저장된 값입니다. 정하지 않은 설정은 기본값으로 돌고, 고치면 그 값이 저장됩니다. 바꾸면 감사에 남습니다. 비밀 값은 가려서 보입니다.」 입니다.

보이는 것	뜻
줄	설정 이름과 그 아래 키(예: «자동화 최소 주기(분)» · `agentdef.min.interval.minutes`), 그리고 지금 쓰이는 값. 켜고 끄는 설정은 「켜짐」 · 「꺼짐」
「기본값」 표시	아직 정한 적이 없어 기본값으로 돌고 있는 설정입니다
「비밀 값 · 설정됨」	비밀 값입니다. 다시 보여 주지 않고, 바꿀 때만 새 값을 넣습니다
키·값 검색	설정 이름 · 키 · 값으로 좁힙니다

🔴 자동화 상한(agentdef.*) · 발송 상한(automation.deliver.*) · 2인 승인 도구(access.two_person.tools) · 이상 접수 스위치(incident.*) · 이상 · 이상 접수 알림(anomaly.notify.* · incident.notify.*) · 푸시(push.*) 처럼 한 번도 고친 적 없는 설정도 기본값과 함께 늘 목록에 있습니다. 줄을 눌러 값을 넣고 저장하면 그때부터 그 값으로 고정됩니다.
줄을 누르면 오른쪽에 편집 칸이 열립니다. 설정의 종류에 맞는 칸이 나옵니다 — 스위치, 고르는 목록, 숫자 · 글 칸. 칸 아래에 설명과 넣을 수 있는 범위(「5~1440.」 같은 것)가 보이고, 아직 정하지 않은 설정에는 「아직 정하지 않아 기본값으로 돌고 있습니다. 저장하면 이 값으로 고정됩니다.」, 정한 설정에는 「기본값: …」 이 적혀 있습니다.
기본값으로 — 정해 둔 값을 지우고 기본값으로 되돌립니다. 「«이름» 을 기본값으로 되돌릴까요?」 로 한 번 묻고 감사에 남습니다. 값을 정한 적이 있는 설정에만 보입니다.
값이 형식 · 범위에 맞지 않으면 저장되지 않고 칸 아래에 사유가 뜹니다 — 「정수를 넣으세요.」 · 「5~1440 사이의 값을 넣으세요.」 · 「도구 이름은 소문자·숫자·밑줄로, 쉼표로 나눠 적습니다.」 · 「http:// 또는 https:// 로 시작하는 주소를 넣으세요.」 같은 말입니다. 값을 비워 없애려 하면 「값을 넣으세요. 저장된 값을 없애려면 «기본값으로» 를 누릅니다.」 입니다.
전용 화면이 따로 있는 설정에는 「이 값은 전용 화면에서도 바꿉니다(같은 값).」 과 그 화면 열기가 붙습니다(메일 허용 도메인 → 알림 채널).
새 키를 지어 더하는 칸은 없습니다. 목록에 있는 설정만 고칩니다.
이 판이 이름을 모르는 저장된 줄(옛 판이 남긴 값)은 목록 아래 「카탈로그에 없는 저장된 줄 N개」 로 접혀 있습니다. 펼치면 「이 앱이 이름을 모르는 줄입니다 — 옛 판이 남긴 값이라 지금 코드는 읽지 않을 수 있습니다.」 가 붙습니다.
저장하면 이전 값과 함께 감사에 남습니다(비밀 값은 가려서 남습니다).
메일 서버(smtp.host · smtp.port · smtp.username · smtp.password · smtp.starttls)와 링크용 바깥 주소(app.base.url)도 이 목록에 있습니다.

기록

감사 로그 — /admin/audit

설정 · 권한 변경과 대외비 · 통제 문서의 열람 기록입니다.

시작일 · 끝일 · 아이디 · 종류(변경 · 열람)로 거릅니다. 기본은 최근 7일, 한 번에 2,000건까지 — 넘으면 기간을 좁힙니다.
열은 시각 · 종류 · 사용자 · 대상 · 내용(이전 → 이후)입니다. 목록에는 사람이 읽는 말로 옮긴 것이 보입니다.
줄을 누르면 오른쪽에 상세가 열리고, 원문 보기를 펼치면 저장된 그대로의 대상 키와 이전 · 이후 값이 보입니다.
CSV 내려받기로 고른 기간을 받습니다.

남는 변경의 대상 이름은 권한 — 감사 화면에 있습니다.

들어가기​

화면 지도​

사람과 권한​

사용자 — /admin/users​

역할 묶음 — /admin/bundles​

문서 등급 — /admin/grades​

담당자 — /admin/employees​

API 키 — /admin/api-keys​

AI​

LLM 설정 — /admin/llm​

AI 가 쓰는 도구 — 이 콘솔이 아니라 MCP 게이트웨이에서 켭니다​

프롬프트 — /admin/prompts​

답변 품질 — /admin/quality​

운영 현황 — /admin/ops-stats​

운영​

현장 알림 미리 보기 — /admin/field-modes​

설비 중요도 등급 — /admin/criticality​

정확도 튜닝 — /admin/tuning​

알림 채널 — /admin/channels​

브랜드 — /admin/brand​

시스템 설정 — /admin/config​

기록​

감사 로그 — /admin/audit​

관련 문서​