이 문서에서는 Discourse AI 플러그인의 일부인 AI 검색 기능, AI 번역, AI 관련 주제 기능을 활성화하고 구성하는 방법을 소개합니다. 이는 공식 튜토리얼과 이 사이트의 실제 운영 경험을 기반으로 한 중국어 사이트의 AI 기능 활성화를 위한 가이드입니다.
데모 사이트: https://bbs.eeclub.top/
이 사이트는 제가 구축한 Discourse 포럼으로, Discourse AI 플러그인을 활성화하여 다국어 지원이 가능합니다. 게시물을 작성하면 자동으로 AI를 사용해 여러 국가 언어로 번역되며, 신규 사용자의 게시물은 자동으로 AI 검토를 통해 스팸 콘텐츠를 줄입니다.
- 웹사이트 구축 튜토리얼 시리즈: https://blog.zeruns.com/category/web/
- Yuyun RCA 클라우드 애플리케이션(K8s 기반) PHP 웹사이트 구축 튜토리얼: https://blog.zeruns.com/archives/869.html
- Flarum 포럼 구축 트레이닝, 초보자를 위한 포럼 커뮤니티 웹사이트 구축: https://blog.zeruns.com/archives/866.html
일정 시간이 지난 후 Discourse 포럼 구축 튜토리얼도 제공할 예정입니다.
웹사이트 관리자 커뮤니티 그룹: 767557452
준비 작업
이 문서에서 사용하는 AI 인터페이스는 SiliconFlow(硅基流动)의 것입니다. 제 링크를 통해 등록하시면 2,000만 토큰(약 14위안 상당)을 무료로 받을 수 있습니다.
- 초대 등록 링크: https://cloud.siliconflow.cn/i/hSviAP2x
- 초대 코드: hSviAP2x
SiliconFlow 계정을 등록한 후 API 키를 생성하세요. 콘솔 왼쪽 메뉴에서 「API 키」→「새로운 API 키 생성」→ 생성된 sk-xxxxxxxxxx 키를 복사합니다.
다음 두 개의 일반 엔드포인트를 기록해 두세요(나중에 사용됨):
- LLM 대화: https://api.siliconflow.cn/v1/chat/completions
- 임베딩: https://api.siliconflow.cn/v1/embeddings
SiliconFlow는 OpenAI 형식과 호환되므로 공식 AI 플러그인의 OpenAI 설정 페이지를 그대로 사용할 수 있습니다.
ChatGPT, Claude, Gemini, 두바이(Doubao), 원심(Wenxin), 360, Grok 등 다양한 모델을 사용하려면 DMXAPI 플랫폼을 확인해 보세요.
- 할인 등록 주소: https://www.dmxapi.cn/register?aff=iu7m
- 초대 코드: iu7m
Discourse AI 플러그인 소개
Discourse AI는 커뮤니티 관리에 초점을 맞춘 AI 어시스턴트로, 핵심 가치는 운영 시간 절약, 커뮤니티 안전 및 질서 유지, 사용자 참여도와 관리 통찰력 향상입니다.
1. 검토 및 관리(Moderation & Management)
- 자동 검토: 유해한 콘텐츠 정확하게 탐지, NSFW 게시물 표시, 99% 정확도의 스팸 필터링, 단 한 번의 클릭으로 활성화 및 세부 조정 가능
- 전용 AI 어시스턴트: 사용자 정의 시스템 프롬프트 및 파라미터 지원, 포럼 검색, 웹 페이지 방문, 업로드된 문서 호출을 통해 채팅/개인 메시지를 통해 사용자에게 서비스 제공
- 실용적인 도구 모음: 문법 교정, 번역, 콘텐츠 최적화 기능 내장, 요약문, 제목, 스마트 날짜 생성 가능
2. 참여도 및 콘텐츠 발견(Engagement & Discovery)
- 의미 기반 검색: 키워드 제약을 넘어선 문맥적 관련 콘텐츠 정확한 매칭, 검색 효율성 향상
- 관련 주제 추천: 심층 의미 유사성 분석 기반으로 주제 말미에 관련 토론 추천, 지속적인 상호작용 촉진
- 빠른 요약: 긴 대화의 핵심 정보 축소, 사용자가 빠르게 내용 파악 가능, 정보 지연 감소
3. 통찰력 및 분석(Insights & Analysis)
- 커뮤니티 감정 모니터링: 토론 콘텐츠에 대한 감정 및 감정 점수, 사용자 태도 트렌드 파악
- 자동 보고서 생성: 포럼 활동 수준, 인기 토론, 사용자 행동 등의 데이터 보고서 생성, 관리 결정 지원
- AI 사용 모니터링: 다양한 모델 및 기능의 토큰 소비량, 요청량 추적, 비용 및 사용량 명확히 파악
4. 데이터 보안 및 유연성(Data Security)
- 데이터 소유권: AI 데이터와 커뮤니티 콘텐츠가 함께 저장되며, 사용자는 자신의 데이터를 영구히 소유
- 개인정보 보호: 오픈소스 가중치 LLM 사용, 사용자 데이터로 모델 훈련하지 않아 콘텐츠 안전하고 통제 가능
- 다중 공급자 지원: OpenAI, Anthropic, Microsoft Azure 등 10개 이상의 AI 서비스 공급자 선택 가능, 사용자 정의 모델 적응 지원
LLM 대형 언어 모델 구성
\u003e LLM 모델이란: LLM(Large Language Model, 대형 언어 모델)은 자연어 이해 및 응답 생성(번역 결과, 검색 요약 등)을 담당하는 AI 기능의 "두뇌"입니다. SiliconFlow는 OpenAI 인터페이스와 호환되는 다양한 LLM 모델을 제공합니다.
【Discourse 관리자 대시보드】에서 【Discourse AI】 플러그인을 활성화하려면 먼저 플러그인을 활성화해야 LLM 모델 설정 항목이 나타납니다.
AI 플러그인의 【설정】 페이지로 이동하여 【LLM】을 클릭한 후 아래로 스크롤하여 【구성되지 않은 LLM 템플릿】에서 【사용자 정의 - 수동 구성】 아래의 【설정】을 클릭합니다.
- 【공급자】에서 OpenAI 선택
- 【LLM API 엔드포인트】에 위의 주소 입력:
https://api.siliconflow.cn/v1/chat/completions(SiliconFlow의 API 주소 변경 시 SiliconFlow 개발 문서에서 최신 주소 확인) - 【호스팅 모델 서비스 API 키】에 위에서 복사한 【API Key】 입력
- 【모델 이름】은 임의로 설정
- 【모델 ID】는 SiliconFlow 모델 광장에서 모델을 선택하고 ID를 복사(일부 모델은 무료 크레딧을 사용할 수 없음에 주의), 예시:
Pro/deepseek-ai/DeepSeek-V3.2-Exp
【토크나이저】는 일반적으로 OpenAiTokenizer를 선택, 【컨텍스트 창 크기】는 모델 설명 페이지에 명시되어 있습니다. 예시 모델은 160K이므로 160000을 입력합니다. 설정 완료 후 【제출】을 클릭하고 【테스트 실행】을 통해 문제가 없는지 확인합니다.
여러 번 위 단계를 반복하여 다양한 모델이나 AI 공급자를 추가할 수 있습니다.
기능 설정에서 각 기능에 다른 모델을 할당할 수 있습니다. 일부 간단한 기능에는 무료 모델을 따로 설정하는 것도 좋습니다.
임베딩 모델 구성
\u003e 임베딩 모델이란: 임베딩 모델은 텍스트를 컴퓨터가 이해할 수 있는 "의미 벡터"로 변환하는 역할을 합니다. 이는 AI 검색, 관련 주제 추천의 핵심입니다(예: "Discourse 이메일 설정"과 "Discourse 이메일 알림 설정 방법"이 같은 의미임을 인식).
【임베딩 벡터】→【새 임베딩 벡터 생성】 클릭
- 【공급자】에서
OpenAI선택 - 【임베딩 서비스 URL】에 위의 임베딩 API 엔드포인트 입력:
https://api.siliconflow.cn/v1/embeddings(SiliconFlow API 주소 변경 시 개발 문서에서 확인) - 【임베딩 서비스 API 키】에 위에서 복사한 【API Key】 입력
- 【모델 이름】은 임의로 설정
- 【토크나이저】에서
BgeM3Tokenizer선택 - 【모델 ID】에
BAAI/bge-m3입력 (SiliconFlow에서 무료 제공) - 【거리 함수】에서
음의 내적(Negative Inner Product)선택 - 【시퀀스 길이】에 8000 입력
설정 완료 후 【저장】 클릭, 그리고 【테스트 실행】을 통해 문제가 없는지 확인합니다.
AI 기능 설정
AI 플러그인 설정 페이지에서 AI 기본 LLM 모델 설정 항목에서 기본 모델을 선택합니다.
아래로 스크롤하여 AI 어시스턴트 활성화 설정 항목에서 AI 어시스턴트를 활성화할 수 있습니다. 이 설정 아래에서 사용자 그룹 권한을 지정할 수 있습니다. 이 AI 어시스턴트는 토픽 작성 시 편집기에서 사용할 수 있으며, 번역, 문법 교정, 마크다운 테이블 생성, 제목 생성 등의 기능을 제공합니다.
아래로 스크롤하여 AI 임베딩 활성화 설정 항목에서 임베딩 기능을 활성화하고, AI 임베딩 선택 모델에서 위에서 추가한 BAAI/bge-m3 모델을 선택합니다.
아래로 스크롤하여 AI 요약 활성화 설정 항목에서 요약 기능을 활성화할 수 있으며, 토픽(게시물)에 대한 요약문을 생성할 수 있습니다.
다른 AI 기능 설정 항목은 여기서 생략하며, 직접 확인해 보세요.
포럼의 모든 콘텐츠를 사용자의 선호 언어로 자동 번역하는 AI 번역 기능도 있습니다.
추천 읽기
- 고성능 대비 저렴한 VPS/클라우드 서버 추천: https://blog.vpszj.cn/archives/41.html
- 마인크래프트 서버 구축 튜토리얼: https://blog.zeruns.com/tag/mc/
- 선전 필가산(筆架山) 등반기, 선전 일몰\u0026야경 사진: https://blog.zeruns.com/archives/916.html
- DJI Mini 2 드론 분해 분석: https://blog.zeruns.com/archives/912.html
- 벤큐 RD280U 모니터 간단 리뷰, 전문 프로그래밍 모니터, 3:2 비율 + 28인치 4K 해상도: https://blog.zeruns.com/archives/915.html
- [오픈소스] UC3842 기반 24V3A 플라이백 스위칭 전원 공급 장치(회로 및 트랜스 설계 계산 포함): https://blog.zeruns.com/archives/910.html
영문 버전 문서: https://blog.zeruns.top/archives/78.html