이 가이드는 3rd party LLM 키가 필요한 Discourse AI 기능을 활성화하기 위해 Amazon Bedrock의 API 키를 구성하는 방법을 설명합니다.
필요한 사용자 권한: 관리자
이 예시에서는 Amazon Bedrock을 사용하여 키를 생성합니다.
참고: 유료 플랜과 구성된 API 키가 필요합니다.
플랫폼은 항상 변하므로 이 가이드가 100%의 프로세스를 반영하지 않을 수 있습니다.
API 키 얻기
Amazon Bedrock에서 키를 구성하는 것은 다른 대부분의 프로바이더보다 다소 복잡합니다. IAM 역할과 같은 개념에 익숙해야 할 가능성이 높습니다. 키를 얻는 방법에 대한 설명은 다음 링크에서 확인할 수 있습니다:
Discourse AI가 지원 하는 Bedrock 모델은?
Discourse AI는 모든 Anthropic Claude 모델과 모든 Nova 언어 모델(Micro / Lite 및 Pro)을 지원합니다.
이 모델들은 이미지, 비디오 및 도구 호출(xml 및 native)을 지원합니다.
주요 모델 ID는 다음과 같습니다:
Nova:
- amazon.nova-pro-v1:0
- amazon.nova-lite-v1:0
- amazon.nova-micro-v1:0
Claude:
- anthropic.claude-sonnet-4-6
- anthropic.claude-opus-4-6-v1
- anthropic.claude-haiku-4-5-20251001-v1:0
- 그 외 많은 모델
지원되는 Claude 모델 ID의 전체 및 최신 목록은 소스 코드의 bedrock_model_id 메서드를 참조하십시오. 또한, 명시적으로 매핑되지 않은 모든 모델 이름은 그대로 전달되므로 더 새로운 모델 ID를 직접 사용할 수 있습니다.
모든 모델이 모든 지역에서 사용 가능한 것은 아니므로, Bedrock 구성 페이지를 확인하십시오.
Discourse AI용 API 키 사용
Admin→Plugins→AI→LLMs탭으로 이동- "Manual configuration"의 Set up 버튼을 클릭
- 모든 모델 설정을 입력:
Discourse AI는 Bedrock에 대해 두 가지 인증 방법을 지원합니다:
- 정적 액세스 키: API 키(비밀 액세스 키), 액세스 키 ID 및 리전을 제공합니다.
- IAM 역할 기반 인증: 역할 ARN과 리전을 제공합니다. 이는 AWS STS AssumeRole을 사용하여 자격 증명 자동 로테이션을 수행합니다.
인증을 위해 액세스 키 ID 또는 역할 ARN(리전 포함) 중 하나를 구성해야 합니다.
토크나이저로는 Nova의 경우 OpenAiTokenizer, Claude 기반 모델의 경우 AnthropicTokenizer를 사용할 수 있습니다.
네이티브 도구 지원을 비활성화해야 하나요?
Discourse는 네이티브 도구 및 XML 도구 기반 구성을 제공합니다. 일부 경우 XML 도구가 네이티브 도구 구현보다 우수한 성능을 보일 수 있으므로, 자신에게 가장 잘 맞는 구성을 찾기 위해 실험해 보시기 바랍니다.