ERP-node/frontend/docs/AI_어시스턴트_메뉴_등록_가이드.md

AI 어시스턴트 메뉴 등록 가이드 (VEXPLOR)

AI 어시스턴트는 VEXPLOR와 같은 서비스/같은 포트로 동작합니다.
프론트는 /api/ai/v1 로 호출하고, backend-node가 AI 서비스(기본 3100 포트)로 프록시합니다.

서비스 기동

• AI API: ERP-node/ai-assistant 에서 npm install 후 npm start (포트 3100)
• backend-node: npm run dev (8080)
• frontend: npm run dev (9771)

별도 포트/도메인 설정 없이 브라우저에서는 localhost:9771 만 사용하면 됩니다.

---

VEXPLOR 메뉴 URL 목록 (전체 탑재)

대메뉴 예: AI 서비스 / AI
소메뉴는 아래 표의 메뉴명과 URL로 등록하면 됩니다. (메뉴명에 "AI", "어시스턴트", "챗봇", "LLM" 포함 시 사이드바에 Bot 아이콘 표시)

일반 메뉴

메뉴명	URL (메뉴 관리에 입력할 값)
AI 채팅	/admin/aiAssistant/chat
대시보드	/admin/aiAssistant/dashboard
API 키 관리	/admin/aiAssistant/api-keys
API 테스트	/admin/aiAssistant/api-test
내 사용량	/admin/aiAssistant/usage
대화 이력	/admin/aiAssistant/history
설정	/admin/aiAssistant/settings

관리자 메뉴

메뉴명	URL (메뉴 관리에 입력할 값)
사용자 관리	/admin/aiAssistant/admin/users
LLM 관리	/admin/aiAssistant/admin/providers
LLM 사용량 통계	/admin/aiAssistant/admin/usage-stats

---

등록 순서 예시

1. 대메뉴: 메뉴명 AI 서비스, URL은 비우거나 # (자식만 사용할 경우)
2. 소메뉴: 위 표에서 필요한 것만 추가
   • 예: 메뉴명 대시보드, URL /admin/aiAssistant/dashboard
   • 예: 메뉴명 API 키 관리, URL /admin/aiAssistant/api-keys

이렇게 등록하면 VEXPLOR 사이드바에서 각 메뉴 클릭 시 해당 AI 어시스턴트 화면이 열립니다.