Discourse 챗봇 🤖

[merefield (Robert)]

	요약	Discourse용 원본 AI 챗봇
	리포지토리 링크	GitHub - merefield/discourse-chatbot: An AI bot with RAG capability for Topics, Chat & Customer Support in Discourse, currently powered by OpenAI · GitHub
	설치 가이드	Discourse에 플러그인 설치 방법
	스폰서십	이 플러그인이 마땅히 받아야 할 유지보수를 받고 향후에도 사용자의 사이트에서 계속 작동할 수 있도록, 사용자의 조직과 개인의 자원 및 필요에 맞는 수준으로 저의 오픈소스 작업에 대한 정기적인 스폰서가 되어 주십시오.

이 플러그인을 즐기고 계신가요? GitHub에서 를 눌러 주세요!

이는 독립적으로 기여된 플러그인이므로, 지원, 버그, UX, 기능 요청은 이 토픽에서 해 주십시오. 참고: 이 플러그인은 Discourse.org 호스팅에서는 사용할 수 없습니다. 셀프 호스팅을 하고 있거나, 제3자 호스팅을 사용 중이라면(단, 제공업체와 확인 필요) 설치할 수 있습니다.

Discourse용 원본 AI 챗봇

Chatbot은 토픽, 개인 메시지, 채팅 채널, 채팅 스레드에 설정 가능한 AI 대화를 제공합니다. 커뮤니티에 적합한 캐릭터를 봇에 부여하고, 어떤 그룹이 이를 사용할 수 있는지 결정하며, 신뢰도가 낮거나 중간이거나 높은 사용자를 위해 서로 다른 모델과 도구를 선택할 수 있습니다.

다음과 같은 기능을 수행할 수 있습니다:

• 현재 대화에서 정상적으로 답변;
• 선택된 포럼 콘텐츠를 시맨틱 또는 하이브리드 검색으로 탐색;
• 위키백과, 최신 뉴스, 웹 검색;
• 원격 페이지 크롤링 및 종일 시장 데이터 조회;
• 신뢰할 수 있는 식기 기반 계산 수행;
• 업로드된 이미지 보기 및 선택적으로 PDF 읽기;
• 이미지 생성 및 편집;
• 비공개 대화에서 미입력된 편집 가능한 사용자 필드 수집;
• 비공개 채팅 대화를 설정된 스태프 그룹으로 에스컬레이션;
• 선택된 카테고리에서 새로운 토픽에 자동으로 응답; 그리고
• 다른 플러그인이 제공하는 추가 도구 수용.

실용적인 지원 워크플로우에 대해서는 기술 지원 챗봇 구축하기를 참고하십시오.

로컬 포럼 검색이 활성화되면, 봇은 커뮤니티의 콘텐츠에 기반하여 답변을 뒷받침할 수 있습니다:

더 단순한 대화를 위해, 호출 횟수, 지연 시간, 비용을 줄이려면 도구를 적게 노출하거나 노출하지 마십시오:

프로바이더 지원

응답, 임베딩, 비전, 이미지 생성을 위해 프로바이더를 독립적으로 선택하십시오. 각 기능은 선택된 프로바이더에 속한 API 키를 재사용합니다.

기능	OpenAI	Anthropic	Google Gemini	xAI
LLM 응답 및 도구
임베딩		—
비전
이미지 생성		—
이미지 편집	GPT Image 모델	—	—
PDF 대화 입력		—	—	—

커스텀 URL이 설정되지 않은 경우, Chatbot은 선택된 프로바이더의 내장된 공식 엔드포인트를 사용합니다. 커스텀 모델 이름과 URL은 지원되는 프로바이더의 API 형식을 구현하는 Azure OpenAI, Ollama, 프록시 및 기타 서비스를 지원합니다.

프로바이더별 모델 드롭다운은 해당 프로바이더가 활성화된 경우에만 표시됩니다. 응답 모델은 신뢰 수준에 따라 달라질 수 있으며, 임베딩, 비전, 이미지 생성은 각각 고유한 프로바이더와 모델 선택기를 가집니다.

전체 프로바이더 및 커스텀 엔드포인트 가이드 보기

액세스, 할당량 및 도구

Chatbot의 낮은, 중간, 높은 신뢰 수준 그룹 설정에 그룹을 할당하기 전까지는 아무도 액세스할 수 없습니다. 사용자는 가장 높은 일치하는 Chatbot 신뢰 수준의 할당량, 모델, 도구 허용 목록을 상속받습니다. 할당량은 쿼리 또는 토큰으로 측정할 수 있습니다.

내장 도구는 각 신뢰 수준별로 독립적으로 선택됩니다. 자격 증명 및 지원 설정은 여전히 런타임 가용성을 제어하므로, API 키 없이 웹 도구를 선택해도 노출되지 않습니다.

액세스 및 할당량과 신뢰 수준별 도구에 대해 읽어보세요.

로컬 포럼 검색 및 개인정보 보호

로컬 포럼 검색을 활성화하기 전에 임베딩 범위를 이해하십시오.

기본 benchmark_user 전략은 구성된 신뢰 수준에서 적합한 사용자에게 보이는 콘텐츠를 임베딩합니다. categories 전략은 명시적으로 선택된 카테고리의 콘텐츠를 임베딩합니다. 시맨틱 검색은 속도를 최적화하도록 설계되어 봇에게 질문하는 모든 사람에게 가시성 검사를 반복하지 않으므로, 범위에 제한된 콘텐츠가 포함되면 원래 대상 밖으로 공유될 수 있습니다.

개인 메시지는 절대 임베딩되지 않습니다. 벤치마크 신뢰 수준을 낮게 유지하고, 콘텐츠가 모든 Chatbot 사용자에게 공개될 수 있는 경우를 제외하고는 비공개 카테고리를 피하며, 사용하지 않아야 하는 신뢰 수준에서 local_forum_search를 제거하십시오.

선택된 프로바이더는 대화 콘텐츠, 업로드, 임베딩된 검색 결과, 도구 결과를 받을 수 있습니다. 해당 프로바이더의 보유 및 데이터 사용 약관을 검토하고, 포럼의 약관 및 개인정보 보호 고지에 이 처리를 명시하십시오.

전체 임베딩, 범위 및 개인정보 보호 가이드 보기

빠른 시작

1. 일반적인 셀프 호스팅 플러그인 절차를 사용하여 플러그인을 설치하십시오.
2. chatbot_llm_provider를 선택하고 해당 프로바이더의 API 키를 입력한 후, 각 신뢰 수준에 대한 모델을 선택하십시오.
3. 낮은, 중간, 또는 높은 신뢰 액세스 설정에 그룹을 추가하고 할당량을 구성하십시오.
4. 각 신뢰 수준에서 사용할 수 있는 내장 도구를 선택하십시오.
5. local_forum_search를 활성화하는 경우, 그 임베딩 프로바이더를 구성하고 범위를 신중하게 검토하십시오.
6. 봇을 멘션하거나, 봇에게 답장하거나, 빠른 액세스 버튼을 사용하거나, 카테고리 자동 응답 프롬프트를 구성하십시오.

빠른 OpenAI 예시

1. OpenAI API 키를 생성하고 API 결제가 활성화되어 있는지 확인하십시오.
2. chatbot_llm_provider를 OpenAI로 설정하고 키를 chatbot_open_ai_token에 붙여넣으십시오.
3. 커스텀 URL을 비워 두고, 사용하려는 각 신뢰 수준에 OpenAI 모델을 선택한 후, 테스트 그룹을 일치하는 Chatbot 액세스 설정에 추가하십시오.
4. 허용된 토픽, 개인 메시지, 채팅에서 봇을 멘션하여 테스트하십시오.

리포지토리 README는 사전 요구 사항, 모든 주요 설정 그룹, 프로바이더별 동작, 커스텀 엔드포인트, 임베딩 유지보수, 프롬프트 커스터마이징, 디버깅, 확장 개발, 언인스톨링에 대한 사실의 원천입니다:

전체 README 열기

선택된 UI 기능

카테고리는 새로운 토픽을 환영하고 봇이 관련 커뮤니티 콘텐츠를 검색하도록 요청할 수 있습니다:

선택적인 빠른 액세스 버튼은 봇과의 직접적인 채팅 또는 개인 메시지를 열 수 있습니다:

사용자 필드 도구는 지원되는 빈 필드를 비공개로 수집할 수 있습니다:

지원 및 스폰서십

지원 요청, 버그, UX 피드백, 기능 아이디어를 이 Meta 토픽에서 보고해 주십시오. API 키와 비공개 콘텐츠를 제거한 상태에서 프로바이더, 모델 이름, 관련 설정, HTTP 상태 및 프로바이더 응답 본문을 포함하십시오.

이 작업은 커뮤니티의 지원에 의존합니다. 이 플러그인이 사용자의 사이트에 가치 있다면, 지속적인 유지보수를 스폰서해 주십시오.

프로젝트 스폰서

스폰서	레벨	웹사이트
Surety	Silver Plus	suretyhome.com

면책 조항

LLM은 설득적이지만 잘못된 출력을 생성할 수 있습니다. 플러그인을 커뮤니티의 필요에 맞게 테스트하고, 개인정보 보호 및 비용 영향을 이해하며, 적절한 모더레이션을 적용하십시오. 생성된 출력에 대한 약관은 프로바이더와 관할권에 따라 다르며, 활성화하는 모든 프로바이더의 약관을 검토하십시오.