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

51 lines
2.1 KiB
Markdown
Raw Permalink Normal View History

# 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 어시스턴트 화면이 열립니다.