이 가이드는 Discourse AI 플러그인과 Discourse Automation을 결합하여 AI 분류(AI triage) 기능을 사용해 주제를 자동으로 태그하는 방법을 설명합니다.
필요한 사용자 권한: 관리자
AI를 사용하여 주제에 태그 부여
이 자동화 기능은 LLM을 사용하여 주제 내용을 읽고 특정 태그를 적용할지 결정합니다. 자동화 설정에서 구성한 경우, 사이트의 모든 태그를 고려할 수도 있습니다.
사전 요구 사항
- Discourse AI 및 Discourse Automation 플러그인이 활성화되어 있어야 합니다.
- 최소 하나의 LLM이 구성되어야 합니다. 설정 지침은 LLM 설정 가이드를 참고하세요.
- 적절한 시스템 프롬프트가 구성된 에이전트가 있어야 합니다.
에이전트 구성 예시
- 시스템 프롬프트:
당신은 이 포럼을 위한 전문적인 콘텐츠 분류 및 태그링 어시스턴트입니다.
당신의 임무는 제공된 콘텐츠, 이미지 및 사용 가능한 태그 목록을 기반으로 게시물을 분석하고 적절한 태그를 제안하는 것입니다.
지침:
- 제공된 사용 가능한 태그 목록에 있는 태그만 제안하십시오.
- 보수적으로 접근하십시오 - 확신이 있는 것만 태그를 지정하십시오.
- 콘텐츠 주제와 게시물 의도를 모두 고려하십시오.
다음의 정확한 형식으로 항상 유효한 JSON을 응답해야 합니다:
{"tags": ["tag1", "tag2"], "confidence": 85}
- tags: 사용 가능한 목록의 태그 이름 배열
- confidence: 0에서 100 사이의 정수로, 확신 수준을 나타냅니다.
적절한 태그가 없으면 다음을 사용하십시오: {"tags": [], "confidence": 0}
- 에이전트 JSON 응답 형식:
{
"tags": "[string]",
"confidence": "integer"
}
- 기본 언어 모델: 사전 요구 사항 섹션에서 구성한 LLM을 선택합니다.
Discourse 호스팅 고객은 AI 에이전트를 구성할 때 CDCK Hosted Small LLM을 선택할 수 있습니다. - 활성화된 도구: 태그(Tags)
- 강제 도구: 태그(Tags)
- 강제 도구 전략: 첫 번째 답변에만 적용
- 실행 모드: 기본(고정 한계)
자동화 구성
- 관리자 → 플러그인 → 자동화로 이동합니다.
- + 자동화 추가를 클릭합니다.
- AI를 사용하여 주제에 태그 부여 스크립트를 선택합니다.
- When/What 섹션의 설정을 원하는 대로 구성합니다.
- 스크립트 옵션 섹션의
AI 에이전트설정에서 이 자동화를 위해 정의된 에이전트를 선택합니다. 태그 선택 모드설정에서 AI가 태그를 선택하는 방법을 지정합니다.- 특정 태그 목록 사용(
사용 가능한 태그설정에서 구성) - AI가 사이트 태그를 발견하고 사용하도록 허용.
- 특정 태그 목록 사용(
- 자동화 업데이트 버튼을 클릭합니다.
- 자동화를 활성화합니다.
모범 사례
- 좁은 범위로 시작하세요: 확장하기 전에 특정 카테고리나 신규 사용자(신뢰 수준 0 또는 1)의 첫 게시물에만 자동화를 적용하십시오. 이는 LLM 비용을 제한하고 광범위한 잘못된 태그 지정의 위험을 줄입니다.
- 프롬프트에 명확한 태그 설명을 작성하세요: 각 태그의 의미를 설명하는 것이 càng 정확할수록 LLM이 올바르게 분류할 가능성이 높아집니다.
- 오류(거짓 양성/음성)를 모니터링하세요: LLM은 100% 정확하지 않습니다. 잘못 태그된 주제를 검토하고 수정하기 위한 워크플로우를 구축하고, 시간이 지남에 따라 프롬프트를 조정하십시오.
- 토큰 한계를 합리적으로 유지하세요: “최대 게시물 토큰” 설정은 LLM으로 전송되는 게시물 양을 제한합니다. 대부분의 태그링 작업에서는 게시물 앞부분의 몇백 토큰이면 충분합니다.
일반적인 문제 및 해결 방법
- 자동화에 의해 태그가 적용되지 않는 경우
태그의 권한을 검토하십시오. 적용되어야 하는 제한된 태그가 있는 경우,제한된 태그 허용자동화 설정이 활성화되어 있는지 확인하십시오. - 자동화가 실행되지만 주제가 태그되지 않는 경우
Discourse AI 또는 Discourse Automation 플러그인과 관련된 오류를 식별하기 위해 사이트 로그를 검토하십시오.