이 가이드는 Discourse AI 플러그인과 Discourse Automation을 결합하여 AI 트리아지 기능을 사용해 주제를 자동으로 분류하는 방법을 설명합니다.
필요한 사용자 권한: 관리자
AI를 사용하여 주제 자동 분류
이 자동화 기능은 LLM을 사용하여 주제 내용을 읽고, 선택된 카테고리가 적절한지 판단하며, AI 에이전트가 다른 카테고리가 주제에 더 적합하다고 판단하면 해당 카테고리를 업데이트합니다.
사전 요구 사항
- Discourse AI와 Discourse Automation 플러그인이 활성화되어 있어야 합니다.
- 최소 하나의 LLM이 구성되어야 합니다. 설정 지침은 LLM 설정 가이드를 참고하세요.
- 적절한 시스템 프롬프트가 포함된 에이전트가 구성되어야 합니다.
참조용 에이전트 구성
- 시스템 프롬프트:
You are an expert content classifier for this forum.
Your task is to analyze posts and suggest the appropriate category based on content, images, and the list of categories available.
Guidelines:
- Be conservative - only categorize what you're confident about
- Consider both content topic and post intent
- 기본 언어 모델: 사전 요구 사항 섹션에서 구성한 LLM을 선택합니다.
Discourse 호스팅 고객은 AI 에이전트를 구성할 때 CDCK Hosted Small LLM을 선택할 수 있습니다. - 활성화된 도구: Read, Categories, Edit Categories
- 강제 도구: Read, Categories
- 강제 도구 전략: 첫 번째 답변에만 적용
- 실행 모드: 기본 (고정 한도)
- (선택 사항) ‘모더레이션 도구 승인 필요’ 옵션을 켜기
- 사용자: 사용자 생성
자동화 구성
- 관리자 → 플러그인 → 자동화로 이동합니다.
- + 자동화 추가를 클릭합니다.
- AI 에이전트를 사용하여 게시글 트리아지 스크립트를 선택합니다.
- When/What 섹션의 설정을 원하는 대로 구성합니다.
- 스크립트 옵션 섹션의
AI Agent설정에서 이 자동화에 정의된 에이전트를 선택합니다. Silent Mode설정을 활성화합니다.- 자동화 업데이트 버튼을 클릭합니다.
- 자동화를 활성화합니다.
모범 사례
- 좁은 범위로 시작하세요: 확장하기 전에 특정 카테고리나 신규 사용자(신뢰 수준 0 또는 1)의 첫 번째 게시글에만 자동화를 적용하세요. 이를 통해 LLM 비용을 절감하고 광범위한 오분류 위험을 줄일 수 있습니다.
- 프롬프트에 명확한 카테고리 설명을 작성하세요: 각 카테고리의 의미를 설명하는 것이 정확할수록 LLM이 올바르게 분류할 가능성이 높아집니다.
- 오탐과 미탐을 모니터링하세요: LLM은 100% 정확하지 않습니다. 잘못 분류된 주제를 검토하고 수정하는 워크플로우를 구축하고, 시간이 지나면서 프롬프트를 조정하세요.
- 토큰 한도를 적절히 유지하세요: “Max Post Tokens” 설정은 LLM에 전송되는 게시글의 양을 제한합니다. 대부분의 자동 분류 작업에서는 게시글의 처음 몇 백 토큰(게시글의 도입부)이면 충분합니다.
일반적인 문제 및 해결 방법
- 자동화가 적절한 카테고리를 적용하지 않음
카테고리의 보안 설정을 검토하세요. 적용되어야 할 카테고리가 비공개 카테고리인 경우, 에이전트 설정에서Read private도구 옵션이 활성화되어 있는지 확인하세요. - 자동화는 실행되지만 주제를 분류하지 않음
사이트 로그를 검토하여 Discourse AI 또는 Discourse Automation 플러그인과 관련된 오류를 식별하세요.