docs: add Server Expert AI documentation
CLAUDE.md: - Add server-agent.ts to Core Services table - Add Server Expert AI Flow architecture section - Document session management (KV-based, 1hr TTL) - Add search_trends/lookup_framework_docs tools - Update KV Namespace and Bindings tables README.md: - Add server recommendation AI consultation to features - Add SESSION_KV creation command Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
12
README.md
12
README.md
@@ -21,8 +21,8 @@
|
||||
* 🛠 **Function Calling**: 날씨, 검색, 계산, 시간 등 다양한 도구를 자연어로 호출
|
||||
* 💰 **예치금 시스템**: 은행 SMS 자동 파싱(AI 폴백 지원) 및 양방향 매칭을 통한 자동 충전
|
||||
* 🌐 **도메인 관리**: 도메인 검색, 추천(AI), 가격 조회, 등록, DNS 관리 통합
|
||||
* 🖥️ **서버 관리 (Queue 기반)**: Linode/Vultr 인스턴스 검색, 비교, 주문, 비동기 프로비저닝
|
||||
* ⚡ **서버리스**: Cloudflare Workers + Queues로 긴 작업도 안정적 처리
|
||||
* 🤖 **서버 추천 AI 상담**: 30년 경력 전문가 페르소나 기반 대화형 서버 추천, 최신 트렌드 검색 지원 (KV 세션 관리)
|
||||
* ⚡ **서버리스**: Cloudflare Workers + KV로 긴 작업도 안정적 처리
|
||||
* 🌐 **웹 채팅 UI**: 브라우저와 API로 봇 테스트 가능 ([telegram-cli](./telegram-cli/README.md))
|
||||
|
||||
### 🚀 성능 최적화
|
||||
@@ -57,6 +57,10 @@ npx wrangler d1 execute telegram-conversations --file=schema.sql
|
||||
```bash
|
||||
# Rate Limiting용 KV Namespace 생성 (필수)
|
||||
npx wrangler kv:namespace create RATE_LIMIT_KV
|
||||
|
||||
# 서버 상담 세션 저장용 KV Namespace 생성 (서버 추천 기능 사용 시 필수)
|
||||
npx wrangler kv:namespace create SESSION_KV
|
||||
|
||||
# 출력된 id를 wrangler.toml의 [[kv_namespaces]] 섹션에 입력
|
||||
```
|
||||
|
||||
@@ -166,8 +170,8 @@ curl "https://<YOUR_WORKER_URL>/setup-webhook?token=${BOT_TOKEN}&secret=${WEBHOO
|
||||
#### ⚠️ 주의사항
|
||||
|
||||
- **WEBHOOK_SECRET 필수**: 미설정 시 모든 webhook 요청이 거부됩니다.
|
||||
- **KV Namespace 필수**: 미생성 시 Rate Limiting이 비활성화되어 DoS 공격에 취약합니다.
|
||||
- **Queue 필수 (서버 기능 사용 시)**: 미생성 시 서버 프로비저닝 기능이 동작하지 않습니다.
|
||||
- **RATE_LIMIT_KV 필수**: 미생성 시 Rate Limiting이 비활성화되어 DoS 공격에 취약합니다.
|
||||
- **SESSION_KV 필수 (서버 추천 기능 사용 시)**: 미생성 시 서버 상담 세션 관리가 동작하지 않습니다.
|
||||
- **환경변수 기본값**: 대부분의 외부 API URL은 기본값이 설정되어 있습니다. 프로덕션 환경에서는 기본값을 그대로 사용하거나, 필요시에만 override하세요.
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user