# Discourse AI - 관련 주제

**URL:** https://meta.discourse.org/t/discourse-ai-related-topics/281807
**Category:** Site Management
**Tags:** how-to, ai, related-topics
**Created:** [10월 10, 2023, 8:35오후 UTC](https://meta.discourse.org/t/discourse-ai-related-topics/281807 "2023-10-10T20:35:51Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [10월 10, 2023, 8:35오후 UTC](https://meta.discourse.org/t/discourse-ai-related-topics/281807/1 "2023-10-10T20:35:51Z")

</div>

> 🔖 이 가이드는 [Discourse AI](https://meta.discourse.org/t/discourse-ai/259214) 플러그인의 관련 주제(Related topics) 기능을 활성화하고 구성하는 방법을 설명합니다.
> 
> 🙋 필요한 사용자 권한: 관리자

관련 주제 기능은 사용자가 현재 읽고 있는 주제와 의미적으로 유사한 주제를 제안하여 관련 콘텐츠 탐색을 돕습니다. 이를 통해 콘텐츠 탐색이 향상되고 사용자 참여도가 높아집니다.

## 기능

- 의미론적 텍스트 유사도: 키워드 매칭을 넘어 실제로 관련이 있는 콘텐츠를 찾습니다.
- “제안(Suggested)” 주제와 “관련(Related)” 주제 간 전환 가능
- 익명 사용자 및 로그인된 사용자 모두 사용 가능

## 관련 주제 활성화

> ℹ Discourse AI 플러그인이 활성화된 모든 Discourse 호스팅 고객에게는 관련 주제 기능이 기본적으로 켜져 있습니다.

### 사전 요구 사항

관련 주제 기능은 [임베딩(Embeddings)](https://meta.discourse.org/t/discourse-ai-embeddings/259603)이 작동해야 합니다.

당사의 호스팅 서비스를 사용하는 경우, 임베딩은 오픈소스 모델을 통해 제공되며 추가 설정이 필요하지 않습니다.

셀프호스팅 인스턴스의 경우, 지원되는 제공자를 통해 임베딩 모델을 구성해야 합니다.

### 구성

1. 관리자 → 플러그인 → Discourse AI → AI 기능으로 이동합니다.
2. **임베딩(Embeddings)** 모듈을 찾아 다음을 구성합니다:
  - `ai_embeddings_selected_model`을 구성한 임베딩 정의 값으로 설정합니다.
  - `ai_embeddings_enabled`을 활성화하여 임베딩을 활성화합니다.

3. `ai_embeddings_semantic_related_topics_enabled`을 활성화하여 관련 주제 기능을 켭니다.

### 임베딩 모델 설정

임베딩을 활성화하기 전에 임베딩 모델을 구성해야 합니다. 관리자 → 플러그인 → Discourse AI → 임베딩으로 이동하여 새로운 임베딩 정의를 생성하세요. 다음 프리셋 중 하나를 선택할 수 있습니다:

- **Open AI** : `text-embedding-3-small` 또는 `text-embedding-3-large` (대부분의 사이트에 권장)
- **Google** : `gemini-embedding-001`
- **Hugging Face** (셀프호스팅 추론): `multilingual-e5-large` (비영어 또는 다국어 사이트에 권장), `bge-large-en`, 또는 `bge-m3`

선택한 제공자를 위해 API 키(또는 AI Secret 연결)와 엔드포인트 URL을 제공해야 합니다.

### 추가 설정

다음 설정을 통해 관련 주제 기능을 세밀하게 조정할 수 있습니다:

- `ai_embeddings_semantic_related_topics`: 관련 주제 섹션에 표시할 최대 주제 수 (기본값: 5)
- `ai_embeddings_semantic_related_include_closed_topics`: 관련 결과에 폐쇄된 주제를 포함할지 여부 (기본값: true)
- `ai_embeddings_semantic_related_age_penalty`: 새로운 콘텐츠가 선호되도록 오래된 주제에 페널티를 적용합니다 (기본값: 0.0, 범위: 0.0–2.0)
- `ai_embeddings_semantic_related_age_time_scale`: 연령 페널티에 사용할 시간 규모(일 단위) (기본값: 365)

## 기술적 FAQ

> **관련 주제 아키텍처 다이어그램 보기**
>
> 개요는 다음과 같습니다. 주제가 생성/업데이트되면 다음이 발생합니다:
> 
> ```mermaid
> sequenceDiagram
> User->>Discourse: 주제 생성
> Discourse-->>Embedding Microservice: 임베딩 생성
> Embedding Microservice-->>Discourse: 
> Discourse-->>PostgreSQL: 임베딩 저장 
> 
> ```
> 
> 그리고 주제 방문 시:
> 
> ```mermaid
> sequenceDiagram
> User->>Discourse: 주제 방문
> Discourse-->>PostgreSQL: 가장 가까운 주제 쿼리
> PostgreSQL-->>Discourse: 
> Discourse->>User: 관련 주제 표시 
> 
> ```

**관련 주제 기능은 어떻게 작동하나요?**

- 사용자가 주제를 방문하면, Discourse는 임베딩된 표현을 기반으로 가장 의미적으로 유사한 주제를 데이터베이스에서 쿼리합니다. 이렇게 찾은 관련 주제는 사용자에게 표시되어 커뮤니티 콘텐츠에 대한 추가 탐색을 장려합니다.

**주제/게시물 데이터는 어떻게 처리되나요?**

- Discourse 호스팅 사이트의 경우, 데이터는 우리의 안전한 가상 개인 데이터센터 내에서 처리됩니다. 셀프호스팅 사이트의 경우, 데이터 처리는 선택한 제3자 제공자에 따라 달라집니다.

**임베딩 데이터는 어디에 저장되나요?**

- 임베딩 데이터는 주제, 게시물, 사용자 등 기타 포럼 데이터와 함께 Discourse 데이터베이스에 저장됩니다.

**사용 가능한 임베딩 모델은 무엇인가요?**

- Discourse AI는 OpenAI(`text-embedding-3-small`, `text-embedding-3-large`), Google(`gemini-embedding-001`), Hugging Face 호환 엔드포인트(`bge-large-en`, `bge-m3`, `multilingual-e5-large`), 그리고 Cloudflare Workers AI의 모델을 지원합니다. 관리자 UI를 통해 사용자 정의 임베딩 모델도 구성할 수 있습니다.

---

_[View the full topic](https://meta.discourse.org/t/discourse-ai-related-topics/281807)._