Discourse 챗봇 🤖

[merefield (Robert)]

최근 PR 요약 — 2026년 8월 1일~3일

Discourse Chatbot 및 그 확장 플러그인 전반에서 여러 관련 PR이 병합되었습니다.

주요 내용

• verify-and-revise, best-of-two, 불확실성 기반 추론을 포함한 고급 로컬 추론 전략을 도입했습니다.
• 최신 OpenAI 모델과 새로운 최대 추론 노력(max reasoning effort)을 추가했습니다.
• 임베딩 유사도를 활용한 의미론적 차단 질문 게이트를 추가했습니다.
  • LLM 토큰 비용 없이 봇이 처리하지 않기를 원하는 주제를 임베딩을 통해 차단하므로 상당한 비용 절감 효과가 있습니다.
• 기본 구현과 RAG 구현을 단일 DiscourseChatbot::Bot으로 통합했습니다.
• 봇 모드 설정을 신뢰 수준 내장 도구 선택자로 대체했습니다.
• 확장 API 명칭을 “Function”에서 “Tool”로 변경했습니다.
• SafeRuby 기반 계산기 도구를 제약된 Dentaku 표현식 평가기로 대체했습니다 - 이름과는 달리 SafeRuby에는 취약점이 존재하므로 보안 측면에서 큰 개선 사항입니다.
• Chatbot 및 그 확장 플러그인 전반에 걸쳐 Zeitwerk 로딩을 채택했습니다.
• 위치 관련 도구를 Locations Early Access 플러그인으로 이동했습니다 (접근 권한 재획득을 위해 스폰서를 해주세요)
• 계산기 오류 복구 및 일반 π/e 표기법에 대한 지원을 개선했습니다.
• README를 갱신했습니다.
• 메인 플러그인 버전을 1.8.0에서 2.4.1로 업데이트했습니다.

Discourse Chatbot

• #162 — 수정: Responses API 추론 상태 보존 (FIX: Preserve Responses API reasoning state - Pull Request #162 - merefield/discourse-chatbot - GitHub)
  Responses API의 추론 및 도구 연속성을 안정화하고, 구성 가능한 반복 및 토큰 한도를 도입했으며, URL 출처 검증을 개선하고 유용한 부분 응답을 보존하며, 빈 응답이나 형식이 잘못된 응답이 수용되는 것을 방지했습니다.

• #163 — 기능: 고급 로컬 추론 전략 추가 (FEATURE: Add advanced local reasoning strategies - Pull Request #163 - merefield/discourse-chatbot - GitHub)
  Chat Completions을 위한 단순, verify-and-revise, best-of-two, 불확실성 기반 추론 전략을 추가했으며, 보조 요청에 한계를 두었고 스태프가 볼 수 있는 감사 기록을 도입했습니다.

• #164 — 기능: 최신 OpenAI 모델 추가 (FEATURE: Add current OpenAI models - Pull Request #164 - merefield/discourse-chatbot - GitHub)
  모델 선택기에 최신 GPT-5.x 및 Pro 변형을 업데이트하고, 적절한 모델을 Responses API로 라우팅하며, 최대 추론 노력을 추가했습니다.

• #165 — 수정: 계산기 재시도 가이드 개선 (FIX: Improve calculator retry guidance - Pull Request #165 - merefield/discourse-chatbot - GitHub)
  모델이 계산기 구문과 복구 가이드를 더 명확하게 이해할 수 있도록 하여, 수정 가능한 실패가 적절히 재시도되도록 했습니다.

• #166 — 기능: 의미론적 차단 질문 게이트 추가 (FEATURE: Add semantic blocked-question gate - Pull Request #166 - merefield/discourse-chatbot - GitHub)
  관리자가 정의한 차단된 주식을 식별하고 메인 모델을 호출하기 전에 표준 응답을 반환할 수 있는 선택적 임베딩 기반 게이트를 추가했습니다. 캐싱, 스태프 감사, 실패 시 개방(fail-open) 동작, 사용자 정의 임베딩 모델 지원을 포함합니다.

• #167 — 개발: SafeRuby 대체 및 Zeitwerk 로딩 채택 (DEV: Replace SafeRuby and adopt Zeitwerk loading - Pull Request #167 - merefield/discourse-chatbot - GitHub)
  벤더링된 SafeRuby 평가기를 Dentaku로 대체하고, 네임스페이스와 파일명을 Zeitwerk와 정렬했으며, 플러그인의 로딩 및 린트 구성을 현대화했습니다. SafeRuby에 취약점이 있었던 것으로 밝혀져 이 마이그레이션이 이루어졌습니다.

• #168 — 개발: Chatbot에서 Locations 함수 추출 (DEV: Extract Locations functions from Chatbot - Pull Request #168 - merefield/discourse-chatbot - GitHub)
  메인 플러그인에서 위치 관련 도구와 설정을 제거하여, discourse-locations가 독립적으로 제공할 수 있도록 했습니다.

• #169 — 기능: 봇 모드를 신뢰 수준 도구 선택으로 대체
  (FEATURE: Replace bot modes with trust-level tool selection - Pull Request #169 - merefield/discourse-chatbot - GitHub)
  이는 주요 아키텍처 합리화 작업이었습니다:

  • 개별 기본 및 RAG 봇을 DiscourseChatbot::Bot으로 대체했습니다.
  • 각 신뢰 수준에 대한 내장 도구 선택자를 추가했습니다.
  • 빈 선택자를 도구 없이 단순한 봇과 동등하게 취급하도록 했습니다.
  • 비전(Vision) 및 페인팅을 도구 선택 시스템에 통합했습니다.
  • 외부에서 공급되는 플러그인 도구는 내장 선택자 외부에 두었습니다.
  • Function 용어, 설정 및 클래스를 Tool로 변경했습니다.
  • 설정을 재배치, 인접 배치 및 조건부로 숨겼습니다.
  • 기존 구성을 위한 마이그레이션 처리를 추가했습니다.
  • 할당량 차감을 동시성 안전하도록 만들었습니다.
  • 응답 문자 수 제한, 로깅 선택, 바이너리 PDF 읽기를 수정했습니다.

• #170 — 수정: 계산기 도구 복구 개선 (FIX: Improve calculator tool recovery - Pull Request #170 - merefield/discourse-chatbot - GitHub)
  Math::PI, Math.PI, Math::E, Math.E, π와 같은 친숙한 표현식을 Dentaku 호환 구문으로 정규화했습니다.
  변경되지 않은 잘못된 호출이 반복될 경우 실행 가능한 가이드와 함께 거부됩니다.

• #171 — 개발: 챗봇 문서 갱신 (DEV: Refresh chatbot documentation - Pull Request #171 - merefield/discourse-chatbot - GitHub)
  통합된 봇 및 도구 아키텍처, 추론 전략, 차단된 질문, 계산기 동작, 한도, 할당량, 사용자 정의 엔드포인트, 이미지/PDF 지원, 현재 설정에 대해 README를 업데이트했습니다. 비전 지원은 더 이상 실험적이라고 설명되지 않습니다.

동반 플러그인

• discourse-locations #4 — 수정: 도구 API에 맞게 Chatbot 위치 확장 업데이트 (https://github.com/merefield/discourse-locations-early-access/pull/4)
  추출된 위치 통합을 DiscourseChatbot::Tool로 마이그레이션하고, Locations::Chatbot::Tools 아래에 배치했으며, 통합된 봇에 맞게 업데이트했습니다.

• Function 확장 예제 #1 — 수정: Chatbot 도구 API에 맞게 예제 확장 업데이트 (FIX: Update example extension for Chatbot tool API - Pull Request #1 - merefield/discourse-chatbot-function-extension-example - GitHub)
  예제 플러그인을 DiscourseChatbot::Tool, Zeitwerk 로딩, 도구 지향 설정 및 번역, 레거시 호환성 코드 없이 초점을 맞춘 동작 테스트를 시연하도록 업데이트했습니다.