플러그인 구성 설정

요약

제품 메뉴를 선택하고 System Console을 선택한 다음 Plugins를 선택하여 System Console에서 다음 플러그인 구성 옵션을 검토하고 관리하세요: 자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 다음 표에 설명된 대로 config.json 파일을 편집할 수 있습니다.

사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced

제품 제품 메뉴 아이콘을 사용하여 채널, 협업 플레이북, 보드 사이를 이동합니다. 메뉴를 선택하고 System Console을 선택한 다음 Plugins를 선택하여 System Console에서 다음 플러그인 구성 옵션을 검토하고 관리하세요:

플러그인 관리
Calls
AI 에이전트
GitLab
GitHub
Jira
법적 보존
Microsoft 캘린더 통합
MS Teams
성능 지표
협업 플레이북
사용자 만족도 설문
Zoom
config.json 전용 설정

Tip

자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 다음 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일의 값에 접근할 수 있는 JSON 경로가 포함되어 있습니다. 예를 들어, Enable 값은 PluginSettings 아래에 있습니다.

jq와 같은 도구를 사용하는 경우 cat config/config.json | jq '.PluginSettings.Enable'을 입력합니다.
config.json 파일을 수동으로 편집할 때는 PluginSettings와 같은 객체를 찾은 뒤 그 안에서 Enable 키를 찾으세요.

플러그인 관리#

System Console에서 Plugins > Plugin Management로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

true: (기본값) Mattermost 서버에서 플러그인을 활성화합니다. 자세한 내용은 Mattermost에서 플러그인 사용하기 문서를 참조하세요.
false: Mattermost 서버에서 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > Enable > true
환경 변수: MM_PLUGINSETTINGS_ENABLE

Note

대규모 배포에서 이 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다:

리소스 소비: 플러그인은 CPU, 메모리, 디스크와 같은 시스템 리소스를 소비합니다. 플러그인을 비활성화하면 이러한 리소스가 해제되어 핵심 Mattermost 애플리케이션이 더 효율적으로 실행될 수 있습니다.
복잡성 감소: 각 플러그인은 추가적인 로직과 처리 요구 사항을 더할 수 있습니다. 활성 플러그인의 수를 줄이면 시스템의 복잡성과 잠재적인 오류 지점이 줄어듭니다.
빠른 로드 시간: 플러그인을 비활성화하면 시스템이 초기화하고 관리해야 하는 구성 요소가 줄어들어 서버 시작이 빨라지고 사용자 상호작용 시 지연 시간이 낮아질 수 있습니다.
안정성: 일부 플러그인은 Mattermost 인스턴스의 전반적인 성능과 안정성에 영향을 미칠 수 있는 버그나 성능 문제가 있을 수 있습니다. 문제가 있거나 사용 빈도가 낮은 플러그인을 비활성화하면 시스템의 안정성이 향상될 수 있습니다.
유지 관리 및 업데이트: 더 적은 수의 플러그인을 관리하면 이를 유지 관리하고 업데이트하는 데 필요한 오버헤드가 줄어들어 더 원활한 운영과 적은 다운타임에 기여할 수 있습니다.
그러나 플러그인은 Mattermost를 다른 서비스 및 워크플로와 연동하는 데 종종 필수적입니다. 성능 향상과 조직 및 사용자의 요구 사항 간에 균형을 맞추는 것이 중요합니다.

플러그인 서명 요구#

true: 관리형 및 비관리형 플러그인에 대해 플러그인 서명 유효성 검사를 활성화합니다.
false: (기본값) 관리형 및 비관리형 플러그인에 대해 플러그인 서명 유효성 검사를 비활성화합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > RequirePluginSignature > false
환경 변수: MM_PLUGINSETTINGS_REQUIREPLUGINSIGNATURE

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - Mattermost 서버 v10.11부터 사전 패키지 플러그인은 시작 시 서명 유효성 검사가 필요합니다. 커스텀 사전 패키지 플러그인을 번들로 제공하는 배포판은 서명을 검증하기 위해 PluginSettings.SignaturePublicKeyFiles를 통해 커스텀 공개 키를 구성해야 합니다. - Mattermost 서버 v10.10 이하: 사전 패키지 플러그인은 서명 유효성 검사 대상이 아닙니다. - 마켓플레이스를 통해 설치된 플러그인은 다운로드 시 항상 서명 유효성 검사 대상입니다. - 이 구성을 활성화하면 System Console에서 플러그인 파일 업로드가 비활성화됩니다.

자동 사전 패키지 플러그인#

true: (기본값) Mattermost가 활성화된 사전 패키지 플러그인을 자동으로 설치하고 업그레이드합니다. 더 최신 버전이 설치되어 있으면 변경하지 않습니다.
false: Mattermost가 사전 패키지 플러그인을 자동으로 설치하거나 업그레이드하지 않습니다. 오프라인 상태에서도 마켓플레이스에서 사전 패키지 플러그인을 수동으로 설치할 수 있습니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > AutomaticPrepackagedPlugins > true
환경 변수: MM_PLUGINSETTINGS_AUTOMATICPREPACKAGEDPLUGINS

Note

사전 패키지 플러그인 설치 동작: 시스템 관리자가 플러그인 파일(및 .sig 서명 파일)을 prepackaged_plugins 디렉터리에 넣으면 플러그인이 자동으로 설치되지 않습니다. 사전 패키징은 플러그인을 "오프라인" 설치에 사용할 수 있도록 만듭니다. 플러그인은 시스템 관리자가 해당 플러그인이 활성화된 상태로 config.json을 사전 구성한 경우에만 자동으로 설치됩니다.

플러그인 업로드#

true: 로컬 컴퓨터에서 Mattermost 서버로 플러그인을 업로드할 수 있습니다.
false: (기본값) 로컬 컴퓨터에서 Mattermost 서버로 플러그인을 업로드할 수 없습니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > EnableUploads > false
환경 변수: MM_PLUGINSETTINGS_ENABLEUPLOADS

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 플러그인 업로드가 활성화된 상태에서 플러그인 파일을 업로드할 때 Received invlaid response from the server 오류가 발생하면, 일반적으로 MaxFileSize 구성 설정이 플러그인 파일 업로드를 지원하기에 충분히 크지 않다는 뜻입니다. 추가 프록시 설정 업데이트도 필요할 수 있습니다. - 플러그인 서명 요구 구성 설정이 활성화된 경우 플러그인 파일 업로드 기능이 비활성화됩니다.

마켓플레이스 활성화#

true: (기본값) 모든 시스템 관리자에 대해 Mattermost 서버에서 플러그인 마켓플레이스를 활성화합니다.
false: 모든 시스템 관리자에 대해 Mattermost 서버에서 플러그인 마켓플레이스를 비활성화합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > EnableMarketplace > true
환경 변수: MM_PLUGINSETTINGS_ENABLEMARKETPLACE

원격 마켓플레이스 활성화#

true: (기본값) Mattermost가 Marketplace URL에 설정된 엔드포인트에 연결을 시도합니다. 연결에 실패하면 오류가 표시되며, 마켓플레이스에는 사전 패키지 플러그인과 설치된 플러그인만 표시됩니다.
false: Mattermost가 원격 마켓플레이스에 연결을 시도하지 않습니다. 마켓플레이스에는 사전 패키지 플러그인과 설치된 플러그인만 표시됩니다. Mattermost 서버가 인터넷에 연결할 수 없는 경우 이 설정을 사용하세요.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > EnableRemoteMarketplace > true
환경 변수: MM_PLUGINSETTINGS_ENABLEREMOTEMARKETPLACE

Note

- Mattermost v9.1부터 구성된 원격 마켓플레이스 URL에 접근하려면 이 구성 설정 값을 true로 설정하세요. - Mattermost v9.0의 경우 구성된 원격 마켓플레이스 URL에 접근하려면 MM_FEATUREFLAGS_STREAMLINEDMARKETPLACE 기능 플래그를 false로 설정하고 이 구성 설정을 true로 설정해야 합니다. - 각 Mattermost 호스트는 MarketplaceURL에 설정된 엔드포인트에 대한 네트워크 접근 권한이 있어야 합니다.

마켓플레이스 URL#

이 설정은 원격 마켓플레이스의 URL을 저장합니다.

문자열 입력입니다. 기본값은 https://api.integrations.mattermost.com입니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > MarketplaceURL
환경 변수: MM_PLUGINSETTINGS_MARKETPLACEURL

설치된 플러그인 상태#

이 설정은 설치된 플러그인 목록과 각 플러그인의 활성화 또는 비활성화 상태입니다.

config.json 설정은 객체입니다. 객체 키는 플러그인 ID(예: com.mattermost.apps)입니다. 각 키는 true 또는 false로 설정할 수 있는 Enable 키를 포함하는 객체에 대응합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > PluginStates
환경 변수: MM_PLUGINSETTINGS_PLUGINSTATES

플러그인 설정#

이 설정은 플러그인별 데이터를 포함합니다.

config.json 설정은 객체입니다. 객체 키는 플러그인 ID(예: com.mattermost.apps)입니다. 각 키는 플러그인별 데이터를 포함하는 객체에 대응합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > Plugins
환경 변수: MM_PLUGINSETTINGS_PLUGINS

Calls#

System Console에서 Plugins > Calls로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

true: (기본값) Mattermost 워크스페이스에서 Calls 플러그인을 활성화합니다.
false: Mattermost 워크스페이스에서 Calls 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > PluginStates > com.mattermost.calls > Enable
환경 변수: MM_PLUGINSETTINGS_PLUGINSTATES_COM_MATTERMOST_CALLS

RTC 서버 주소 (UDP)#

이 설정은 RTC 서버가 UDP 연결을 수신 대기하는 IP 주소를 제어합니다. 모든 통화 UDP 트래픽은 이 IP를 통해 처리됩니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다. 설정하지 않은 상태(기본값)로 두면 서비스가 사용 가능한 모든 인터페이스에서 수신 대기합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings Plugins > com.mattermost.calls > udpserveraddress
환경 변수: MM_CALLS_UDP_SERVER_ADDRESS

Note

이 설정은 자체 호스팅 배포에만 적용되며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 경우에만 적용됩니다.

RTC 서버 주소 (TCP)#

이 설정은 RTC 서버가 TCP 연결을 수신 대기하는 IP 주소를 제어합니다. 모든 통화 TCP 트래픽은 이 IP를 통해 처리됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > tcpserveraddress
환경 변수: MM_CALLS_TCP_SERVER_ADDRESS

Note

이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

RTC 서버 포트 (UDP)#

이 설정은 RTC 서버가 수신 대기하는 UDP 포트를 제어합니다. 모든 통화 UDP 트래픽은 이 포트를 통해 처리됩니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

기본값은 8443입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > udpserverport
환경 변수: MM_CALLS_UDP_SERVER_PORT

Note

이 설정은 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

RTC 서버 포트 (TCP)#

이 설정은 RTC 서버가 수신 대기하는 TCP 포트를 제어합니다. 모든 통화 TCP 트래픽은 이 포트를 통해 처리됩니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

기본값은 8443입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > tcpserverport
환경 변수: MM_CALLS_TCP_SERVER_PORT

Note

이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

특정 채널에서 활성화#

Mattermost v7.7부터 관리자는 이 설정을 구성할 수 없습니다. 이 설정은 숨겨져 있으며 자체 호스팅 배포에서는 항상 활성화된 상태입니다

true: 채널 관리자가 특정 채널에서 통화를 활성화하거나 비활성화할 수 있습니다. DM/GM 참가자도 통화를 활성화하거나 비활성화할 수 있습니다.
false: 시스템 관리자만 특정 채널에서 통화를 활성화하거나 비활성화할 수 있습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > allowenablecalls
환경 변수: MM_CALLS_ALLOW_ENABLE_CALLS

테스트 모드#

이 설정은 Mattermost v7.7 이전에는 "모든 채널에서 활성화(Enable on all channels)"라고 불렸습니다. 코드에서는 defaultenabled로, 제품 내에서는 테스트 모드(Test Mode)로 이름이 변경되었으며 자체 호스팅 배포에만 적용됩니다.

false: 테스트 모드가 활성화되며 시스템 관리자만 채널에서 통화를 시작할 수 있습니다.
true: 라이브 모드가 활성화되며 모든 팀 구성원이 채널에서 통화를 시작할 수 있습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > defaultenabled
환경 변수: MM_CALLS_DEFAULT_ENABLED

Note

시스템 관리자는 이 설정을 사용하여 통화가 예상대로 작동하는지 확인하세요. false로 설정하면 통화를 시작하려는 사용자에게 시스템 관리자에게 문의하라는 메시지가 표시되고, 시스템 관리자에게는 라이브 모드로 전환하기 전에 통화가 예상대로 작동하는지 확인하라는 메시지가 표시됩니다.

ICE 호스트 재정의#

이 설정은 통화에 연결할 때 클라이언트에 알려지는 호스트 주소를 재정의하는 데 사용할 수 있습니다. 허용되는 형식은 다음과 같습니다:

단일 IP 주소(예: 10.0.0.1).
단일 호스트명 또는 FQDN(예: calls.myserver.tld).
(v0.17.0부터) externalAddr/internalAddr 매핑을 쉼표로 구분한 목록(예: 10.0.0.1/172.0.0.1,10.0.0.2/172.0.0.2).

선택 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > icehostoverride
환경 변수: MM_CALLS_ICE_HOST_OVERRIDE

Note

- 이 설정은 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다. - 네트워크 인프라(예: NAT 장치 뒤의 인스턴스)에 따라 클라이언트가 연결하려면 이 필드를 클라이언트가 접속하는 외부 IP로 설정해야 할 수 있습니다. 비어 있거나 설정되지 않은 경우 RTC 서비스는 STUN을 통해 인스턴스의 공인 IP를 찾으려고 시도합니다. - 이 설정에 호스트명(예: 도메인 이름)을 지정할 수 있지만 클라이언트에는 IP 주소가 전달됩니다. 이는 Mattermost 인스턴스에서 DNS 해석이 이루어지며, 그 결과가 클라이언트가 보는 IP 주소와 달라 연결에 실패할 수 있다는 뜻입니다. 확신이 없을 때는 IP 주소를 직접 사용하거나 호스트 측의 해석 결과가 클라이언트 측과 일치하는지 확인하는 것을 권장합니다.

ICE 호스트 포트 재정의#

이 설정은 통화에 연결할 때 클라이언트에 알려지는 ICE 호스트 후보에서 사용하는 포트를 재정의하는 데 사용할 수 있습니다.

RTC 서버 앞에 통화 트래픽을 다른 포트로 라우팅할 수 있는 네트워크 구성 요소(예: NLB)가 추가로 있는 경우에 유용할 수 있습니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > icehostportoverride
환경 변수: MM_CALLS_ICE_HOST_PORT_OVERRIDE

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 이 값은 UDP 및 TCP 호스트 후보 모두에 적용됩니다.

RTCD 서비스 URL#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화를 호스팅하는, 실행 중인 rtcd 서비스 인스턴스의 URL입니다.

값을 설정하면(비어 있지 않으면) 모든 통화를 이 외부 서비스가 처리합니다.

선택 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > rtcdserviceurl
환경 변수: MM_CALLS_RTCD_SERVICE_URL

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 환경 변수 MM_CALLS_RTCD_URL은 MM_CALLS_RTCD_SERVICE_URL로 대체되어 더 이상 사용되지 않습니다. - 클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않으면 Mattermost 설치의 진단 ID가 사용됩니다. - 서비스 URL은 http://clientID:authKey@hostname 형식의 자격 증명을 지원합니다. 또는 Mattermost 서버의 환경 재정의인 MM_CALLS_RTCD_CLIENT_ID 및 MM_CALLS_RTCD_AUTH_KEY를 통해 전달할 수도 있습니다 - 클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않으면 Mattermost 설치의 진단 ID가 사용됩니다. - 서비스 URL은 http://clientID:authKey@hostname 형식의 자격 증명을 지원합니다. 또는 Mattermost 서버의 환경 재정의인 MM_CALLS_RTCD_CLIENT_ID 및 MM_CALLS_RTCD_AUTH_KEY를 통해 전달할 수도 있습니다

최대 통화 참가자 수#

이 설정은 하나의 통화에 참여할 수 있는 참가자 수를 제한합니다.

기본값은 0(제한 없음)입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > maxcallparticipants
환경 변수: MM_CALLS_MAX_CALL_PARTICIPANTS

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 환경 변수 MM_CALLS_MAX_PARTICIPANTS는 MM_CALLS_MAX_CALL_PARTICIPANTS로 대체되어 더 이상 사용되지 않습니다. - 이 설정은 선택 사항이지만 권장되는 최대 참가자 수는 50명입니다. 통화 참가자 수 제한은 인스턴스 리소스에 크게 좌우됩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.

ICE 서버 구성#

이 설정은 서비스에서 사용할 ICE 서버(STUN/TURN) 목록을 JSON 형식으로 저장합니다.

선택 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 할 수 있습니다.

기본값은 [{"urls": ["stun:stun.global.calls.mattermost.com:3478"]}]입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > iceserversconfigs
환경 변수: MM_CALLS_ICE_SERVERS_CONFIGS

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - STUN 및 TURN 서버가 포함된 위 구성은 클라이언트에 전송되어 로컬 후보를 생성하는 데 사용됩니다. - 플러그인을 통해 통화를 호스팅하는 경우(즉, RTCD 서비스를 사용하지 않는 경우) ICE 호스트 재정의 옵션으로 IP가 제공되지 않으면, 구성된 STUN 서버를 인스턴스의 공인 IP를 찾는 데 사용할 수도 있습니다.

예시

[
 &#123;
    "urls":[
       "stun:stun.global.calls.mattermost.com:3478"
    ]
 &#125;,
 &#123;
    "urls":[
       "turn:turn.example.com:3478"
    ],
    "username":"webrtc",
    "credentials":"turnpassword"
 &#125;
]

예시(생성된 TURN 자격 증명 사용)

[&#123;
    "urls": ["turn:turn.example.com:443"]
&#125;]

Note

TURN 생성 자격 증명이 작동하려면 아래 TURN 정적 인증 시크릿 설정을 통해 시크릿을 제공해야 합니다.

TURN 정적 인증 시크릿#

TURN 서버용 단기 자격 증명을 생성하는 데 사용하는 정적 시크릿입니다.

선택 필드입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > turnstaticauthsecret
환경 변수: MM_CALLS_TURN_STATIC_AUTH_SECRET

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

TURN 자격 증명 만료#

TURN 서버용으로 생성된 단기 자격 증명의 만료 시간(분 단위)입니다.

기본값은 1440(하루)입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > turncredentialsexpirationminutes
환경 변수: MM_CALLS_TURN_CREDENTIALS_EXPIRATION_MINUTES

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

서버 측 TURN#

true: RTC 서버가 서버에서 시작하는 연결에 구성된 TURN 후보를 사용합니다.
false: TURN을 클라이언트 측에서만 사용합니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > serversideturn
환경 변수: MM_CALLS_SERVER_SIDE_TURN

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

화면 공유 허용#

true: 통화 참가자가 화면을 공유할 수 있습니다.
false: 통화 참가자가 화면을 공유할 수 없습니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > allowscreensharing
환경 변수: MM_CALLS_ALLOW_SCREEN_SHARING

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

화면 공유에 시뮬캐스트 활성화 (실험적)#

true: 화면 공유에 시뮬캐스트를 활성화합니다. 화면 공유 품질을 개선하는 데 도움이 될 수 있습니다.
false: 화면 공유에 시뮬캐스트를 비활성화합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablesimulcast
환경 변수: MM_CALLS_ENABLE_SIMULCAST

Note

이 실험적 설정은 자체 호스팅 배포에만 적용됩니다.
이 기능은 Calls 플러그인 버전 >= v0.16.0 및 (사용하는 경우) rtcd 버전 >= v0.10.0이 필요합니다.
이 실험적 구성 설정과 AV1 활성화 실험적 구성 설정을 동시에 활성화하지 마세요.

통화 녹음 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

true: 통화 호스트가 회의 영상과 오디오를 녹화할 수 있습니다.
false: (기본값) 호스트가 통화 녹음 기능을 사용할 수 없습니다.

녹음에는 전체 통화 창 화면과 함께 참가자의 오디오 트랙 및 공유된 화면 영상이 포함됩니다. 녹음 파일은 Mattermost에 저장됩니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablerecordings
환경 변수: MM_CALLS_ENABLE_RECORDINGS

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

작업 서비스 URL#

사용 가능 플랜: Enterprise, Enterprise Advanced

녹음과 관련된 모든 처리가 이루어지는, 실행 중인 작업 서비스의 URL입니다. 생성된 녹음 파일은 Mattermost에 저장됩니다.

필수 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > jobserviceurl
환경 변수: MM_CALLS_JOB_SERVICE_URL

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.
클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않으면 Mattermost 설치의 진단 ID가 사용됩니다.
서비스 URL은 http://clientID:authKey@hostname 형식의 자격 증명을 지원합니다. 또는 Mattermost 서버의 환경 재정의인 MM_CALLS_JOB_SERVICE_CLIENT_ID 및 MM_CALLS_JOB_SERVICE_AUTH_KEY를 통해 전달할 수도 있습니다.
Calls v0.25부터 각각 MM_CALLS_RECORDER_SITE_URL 또는 MM_CALLS_TRANSCRIBER_SITE_URL 환경 변수를 설정하여 작업이 연결에 사용하는 사이트 URL을 재정의할 수 있습니다. 이는 작업이 Mattermost에 구성된 공개 사이트 URL을 통해 연결하여 공개 네트워크를 우회할 가능성을 방지하는 데 도움이 될 수 있습니다.

최대 통화 녹음 시간#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화 녹음의 최대 길이(분 단위)입니다.

기본값은 60이고 최댓값은 180입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > maxrecordingduration
환경 변수: MM_CALLS_MAX_RECORDING_DURATION

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

통화 녹음 품질#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화 녹음의 오디오 및 비디오 품질입니다. 사용 가능한 옵션은 낮음(Low), 중간(Medium), 높음(High)입니다.

기본값은 중간(Medium)입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > recordingquality
환경 변수: MM_CALLS_RECORDING_QUALITY

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 품질 설정은 작업 서비스의 성능과 녹음 파일 크기에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.

통화 전사 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

true: 통화의 자동 전사를 활성화합니다.
false: (기본값) 통화 전사 기능이 비활성화됩니다.

전사 결과는 통화 참가자의 오디오 트랙에서 생성되며, 녹음이 끝나면 생성된 파일이 통화 스레드에 첨부됩니다. 자막은 녹음 파일 비디오 플레이어 위에 선택적으로 표시할 수 있습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enabletranscriptions
환경 변수: MM_CALLS_ENABLE_TRANSCRIPTIONS

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - Mattermost 통화에서 통화 전사를 활성화하는 기능은 현재 베타 단계에 있습니다. - 이 서버 측 구성 설정은 플러그인 버전 0.22부터 사용할 수 있습니다. - 통화 전사를 사용하려면 통화 녹음이 활성화되어 있어야 합니다.

전사기 모델 크기#

사용 가능 플랜: Enterprise, Enterprise Advanced

사용할 음성 인식(speech-to-text) 모델의 크기입니다. 더 큰 모델은 처리 시간과 리소스 사용량이 늘어나는 대신 더 정확한 결과를 생성합니다. 사용 가능한 옵션은 Tiny, Base, Small입니다.

기본값은 Base입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > transcribermodelsize
환경 변수: MM_CALLS_TRANSCRIBER_MODEL_SIZE

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 이 설정은 플러그인 버전 0.22부터 사용할 수 있습니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요.

통화 전사기 스레드#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화 후 전사기가 사용하는 스레드 수입니다. 값은 [1, numCPUs] 범위 안에 있어야 합니다.

기본값은 2입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > transcribernumthread
환경 변수: MM_CALLS_TRANSCRIBER_NUM_THREADS

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 통화 전사기 스레드 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 Calls 배포 가이드 문서를 참조하세요. 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다.

실시간 자막 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

true: 통화의 실시간 자막을 활성화합니다.
false: (기본값) 실시간 자막 기능이 비활성화됩니다.

실시간 자막은 통화 참가자의 오디오 트랙에서 생성되며, 통화 클라이언트에서 [cc] 옵션을 선택하여 생성된 자막을 선택적으로 표시할 수 있습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablelivecaptions
환경 변수: MM_CALLS_ENABLE_LIVE_CAPTIONS

Note

- Mattermost 통화에서 실시간 통화 자막을 활성화하는 기능은 현재 베타 단계에 있습니다. - 이 서버 측 구성 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. - 실시간 자막을 사용하려면 통화 녹음 및 통화 전사가 활성화되어 있어야 합니다.

실시간 자막: 모델 크기#

사용 가능 플랜: Enterprise, Enterprise Advanced

실시간 자막에 사용할 음성 인식(speech-to-text) 모델의 크기입니다. 더 큰 모델은 더 정확한 결과를 생성할 수 있지만, 실시간 자막은 전사기가 최대 10초 분량의 오디오를 2초 안에 처리해야 합니다. 따라서 최대 base 크기까지를 권장합니다. 사용 가능한 옵션은 Tiny, Base, Small입니다.

기본값은 Tiny입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsmodelsize
환경 변수: MM_CALLS_LIVE_CAPTIONS_MODEL_SIZE

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 모델 크기 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막: 통화당 사용할 전사기 수#

사용 가능 플랜: Enterprise, Enterprise Advanced

각 통화에 사용하는 별도의 실시간 자막 전사기 수입니다. 전사기는 각각 한 번에 하나의 오디오 스트림을 전사합니다. LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber의 곱은 [1, numCPUs] 범위 안에 있어야 합니다.

기본값은 1입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumtranscribers
환경 변수: MM_CALLS_LIVE_CAPTIONS_NUM_TRANSCRIBERS

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 실시간 자막의 전사기 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막: 전사기당 스레드 수#

사용 가능 플랜: Enterprise, Enterprise Advanced

실시간 자막 전사기당 스레드 수입니다. LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber의 곱은 [1, numCPUs] 범위 안에 있어야 합니다.

기본값은 2입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumthreadspertranscriber
환경 변수: MM_CALLS_LIVE_CAPTIONS_NUM_THREADS_PER_TRANSCRIBER

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 이 설정은 플러그인 버전 0.26.2부터 사용할 수 있습니다. 실시간 자막의 전사기당 스레드 수 설정은 작업 서비스의 성능에 영향을 미칩니다. 자세한 내용은 성능 및 확장성 권장 사항 문서를 참조하세요.

실시간 자막 언어#

사용 가능 플랜: Enterprise, Enterprise Advanced

실시간 자막 전사기에 전달되는 언어입니다. 'en'과 같은 2글자 ISO 639 Set 1 언어 코드여야 합니다.

비워 두면 기본값인 'en'(영어)으로 설정됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionslanguage
환경 변수: MM_CALLS_LIVE_CAPTIONS_LANGUAGE

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

IPv6 활성화 (실험적)#

true: RTC 서비스가 듀얼 스택 모드로 작동하여 IPv4 후보에 더해 IPv6 연결을 수신 대기하고 IPv6 후보를 생성합니다.
false: (기본값) RTC 서비스가 IPv4 연결만 수신 대기합니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableipv6
환경 변수: MM_CALLS_ENABLE_IPV6

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 경우에만 적용됩니다.

통화 벨소리 활성화#

true: 벨소리 기능이 활성화됩니다. 다이렉트 메시지 및 그룹 메시지 참가자는 통화가 시작되면 데스크톱 앱 알림과 벨소리 알림을 받습니다.
false: (기본값) 벨소리 기능이 비활성화됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableringing
환경 변수: MM_CALLS_ENABLE_RINGING

Note

Mattermost 통화에서 통화 벨소리를 활성화하는 기능은 베타 단계에 있습니다.

AV1 활성화 (실험적)#

true: 화면 공유 트랙을 인코딩하는 데 AV1 코덱을 사용할 수 있습니다. AV1 인코딩을 지원하는 클라이언트에서는 화면 공유 품질이 개선될 수 있습니다.
false: (기본값) 화면 공유 트랙에 AV1 코덱이 비활성화됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableAV1
환경 변수: MM_CALLS_ENABLE_AV1

Note

이 실험적 구성 설정과 화면 공유에 시뮬캐스트 활성화 실험적 구성 설정을 동시에 활성화하지 마세요.

다이렉트 메시지에서 화상 통화 활성화 (실험적)#

true: 다이렉트 메시지(DM) 채널에서 실험적 화상 통화를 활성화합니다.
false: (기본값) 화상 통화가 비활성화됩니다.

DM 통화의 화상 기능은 데스크톱 앱과 웹 앱에서만 지원됩니다. 모바일 사용자는 화상 통화를 시작할 수 없으며, 화상이 포함된 DM 통화에 참여하면 음성과 화면 공유만 수신합니다. 통화 녹음에는 음성과 화면 공유만 기록되며 화상은 녹화되지 않습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablevideo
환경 변수: MM_CALLS_ENABLE_VIDEO

Note

다이렉트 메시지에서 화상 통화를 활성화하는 기능은 현재 실험적 단계에 있습니다.

Note

배포가 통화를 RTCD 서비스로 오프로드하는 경우, DM 통화의 화상 기능을 사용하려면 rtcd v1.2.2 이상이 필요합니다. Calls 플러그인 릴리즈와 함께 제공되는 rtcd 버전(Calls v1.12.0의 경우 rtcd v1.2.5)을 실행하고, 플러그인과 함께 rtcd를 최신 상태로 유지하는 것을 권장합니다. 플러그인에 내장된 RTC 서버(RTCD 미사용)를 사용하는 배포에서는 추가 구성 없이 화상 기능을 지원합니다.

DC 신호 활성화 (실험적)#

true: 클라이언트가 미디어 트랙(예: 음성, 화면)의 신호 전달에 WebRTC 데이터 채널을 사용합니다. 특히 네트워크 연결 상태가 좋지 않을 때 더 효율적이고 경합 상태(race condition)가 덜 발생하는 처리 방식이 될 수 있습니다.
false: (기본값) 클라이언트가 미디어 트랙의 신호 전달에 WebSocket을 사용합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enabledcsignaling
환경 변수: MM_CALLS_ENABLE_DC_SIGNALING

Note

전용 WebRTC 서비스를 통해 통화를 호스팅할 때 이 기능이 작동하려면 RTCD 서비스 v0.18.0 이상이 필요합니다.
이 실험적 구성 설정은 WebRTC 기반 통화 설정의 일부를 시스템이 처리하는 방식을 결정하므로 활성화할 때 주의하세요. 이 구성 설정을 활성화하면 특정 상황에서 통화 설정이 조금 더 빨라지거나 더 안정적으로 이루어질 수 있습니다.

AI 에이전트#

Note

Mattermost Agents는 이전에 Mattermost Copilot으로 알려져 있었습니다.

System Console에서 Plugins > Agents로 이동하여 다음 Mattermost Agents 구성 설정에 접근하세요.

플러그인 활성화#

true: Mattermost 워크스페이스에서 Agents 플러그인을 활성화합니다.
false: (기본값) Agents 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > Agents
config.json 설정: 해당 없음
환경 변수: 해당 없음

표시 이름#

시스템의 다른 봇과 구별하기 위해 Mattermost에서 사용하는 봇의 표시 이름입니다.

문자열 입력입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

에이전트 사용자명#

채널에서 봇을 @멘션하는 데 사용할 수 있는 봇의 사용자명입니다.

문자열 입력입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

에이전트 아바타#

Mattermost에서 에이전트의 아바타로 사용할 이미지를 업로드합니다.

이미지 업로드 인터페이스입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

서비스#

AI 지원에 사용할 LLM 서비스 제공업체를 선택합니다.

사용 가능한 옵션: OpenAI, OpenAI Compatible, Azure, Anthropic, Ask Sage.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

사용자 이름#

Ask Sage LLM 서비스에 인증할 때 사용하는 사용자 이름입니다.

문자열 입력이 필요합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

비밀번호#

Ask Sage LLM 서비스에 인증할 때 사용하는 비밀번호입니다.

문자열 입력이 필요합니다. 이 값은 저장될 때 암호화됩니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

API URL#

Mattermost가 LLM의 API와 통신할 때 사용하는 엔드포인트입니다. OpenAI Compatible 및 Azure LLM 서비스에 필요합니다.

문자열 입력(URL 형식)입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

API 키#

LLM의 API에 대한 요청을 인증할 때 사용하는 키입니다. OpenAI, OpenAI Compatible, Anthropic LLM 서비스에 필요합니다.

문자열 입력입니다. 이 값은 저장될 때 암호화됩니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

조직 ID#

해당하는 경우 요청이 올바른 조직으로 청구되고 처리되도록 합니다. OpenAI, OpenAI Compatible, Azure LLM 서비스에서 지원됩니다.

문자열 입력입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

사용자 ID 전송#

true: 분석, 개인화, 감사 목적으로 LLM에 보내는 API 요청에 고유 사용자 식별자를 포함합니다.
false: (기본값) 사용자 식별자를 포함하지 않습니다.

이 설정을 활성화하기 전에 LLM 데이터 개인정보 보호 정책을 검토하세요.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

조직의 규정 체계 안에서 사용자 정보를 전송하는 것이 허용되고 안전한지 확인하려면 LLM 데이터 개인정보 보호 정책을 검토하시기 바랍니다. 사용자를 식별할 수 있는 데이터를 외부 서비스와 공유하는 것을 제한하는 엄격한 개인정보 보호 규정(예: GDPR)을 준수해야 하는 경우에는 활성화하지 마세요.

기본 모델#

다른 모델을 명시적으로 선택하지 않은 경우 쿼리를 처리하는 데 사용할 특정 LLM입니다. 모든 LLM 서비스에서 지원됩니다.

문자열 입력(모델 이름)입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

입력 토큰 제한#

선택한 LLM이 단일 프롬프트 또는 요청에서 처리할 수 있는 최대 토큰 수(단어, 문장 부호, 특수 문자를 포함한 텍스트 조각)입니다.

숫자 값입니다. 처리할 수 있는 사용자 쿼리의 크기에 직접 영향을 줍니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

출력 토큰 제한#

LLM이 쿼리에 대한 응답에서 생성할 수 있는 최대 토큰 수(단어, 문장 부호, 특수 문자를 포함한 텍스트 조각)입니다.

숫자 값입니다. Anthropic LLM 서비스에서는 0보다 커야 합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

스트리밍 타임아웃#

스트리밍(실시간) 출력 모드를 사용할 때 시스템이 LLM의 응답을 기다리는 시간을 결정합니다. OpenAI, OpenAI Compatible, Azure LLM 서비스에서 지원됩니다.

숫자 값(초 단위)입니다. LLM이 설정된 타임아웃보다 오래 걸리면 연결이 종료됩니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

스트리밍은 LLM이 응답을 생성하면서 점진적으로 표시할 수 있게 하여 사용자에게 더 부드럽고 상호작용적인 경험을 제공합니다.

사용자 지정 지침#

LLM에 대한 특정 맥락 또는 행동 지침을 미리 설정합니다. 모델의 응답을 조직의 요구 사항, 어조 또는 기대에 맞게 조정하는 데 도움이 됩니다. 모든 LLM 서비스에서 지원됩니다.

텍스트 입력입니다. 모델이 모든 상호작용에서 암묵적으로 따르는 지침으로, 일관성과 적응성을 제공합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

사용자 지정 지침에는 행동 지침, 어조 선호도, 맥락 기능, 조직의 선호 사항을 포함할 수 있습니다. 이를 통해 응답이 조직의 언어 및 어조 지침을 따르도록 하고 모델의 동작을 특정 역할이나 목적에 맞출 수 있습니다.

비전 활성화#

true: LLM이 이미지 관련 입력 또는 출력을 포함하는 응답을 처리하고 생성할 수 있도록 합니다. OpenAI, OpenAI Compatible, Azure, Anthropic LLM 서비스에서 지원됩니다.
false: (기본값) 비전 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

이 기능은 베타 단계에 있습니다. 활성화하면 LLM은 이미지 분석, 시각적 관련 지원, 시각적 출력과 같은 이미지 관련 입력이 포함된 프롬프트와 상호작용할 수 있습니다(지원되는 경우).

도구 활성화#

true: LLM이 추가 도구 또는 플러그인을 활용하여 기능을 확장할 수 있도록 합니다. OpenAI, OpenAI Compatible, Azure, Anthropic LLM 서비스에서 지원됩니다.
false: (기본값) 도구 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

활성화하면 기본 쿼리 처리를 넘어서는 고급 기능을 통해 LLM이 데이터 검색, 외부 API 연동, 계산 수행과 같은 특수한 작업을 수행할 수 있습니다(지원되는 경우).

채널 접근#

봇이 특정 채널의 콘텐츠를 활용하여 해당 채널에서 확인할 수 있는 콘텐츠만으로 답변을 제공할 수 있는지 결정합니다. 모든 LLM 서비스에서 지원됩니다.

사용 가능한 옵션: 모든 채널 허용, 선택한 채널 허용, 선택한 채널 차단, 모든 채널 차단.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

사용자 접근#

이 봇과 대화하는 사용자가 자신이 접근할 수 있는 모든 채널의 콘텐츠에 대해 비공개로 도움을 받을 수 있는지 결정합니다. 모든 LLM 서비스에서 지원됩니다.

사용 가능한 옵션: 모든 사용자 허용, 선택한 사용자 허용, 선택한 사용자 차단.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

기본 에이전트#

여러 에이전트가 구성된 경우 AI 기능에 사용할 기본 봇을 선택합니다. 정의된 에이전트를 기준으로 합니다.

시스템 구성 경로: Plugins > Agents > AI Functions
config.json 설정: N/A
환경 변수: N/A

허용된 업스트림 호스트 이름#

도구를 사용할 때 LLM이 접속할 수 있도록 허용된 호스트 이름의 쉼표로 구분된 목록입니다. *.mydomain.com과 같은 와일드카드를 지원합니다.

예: JIRA 도구 사용을 허용하려면 mattermost.atlassian.net을 입력합니다.

시스템 구성 경로: Plugins > Agents > AI Functions
config.json 설정: N/A
환경 변수: N/A

LLM 추적 활성화#

true: LLM 요청 추적을 활성화하고 전체 대화 데이터를 로그로 출력합니다. 모든 LLM 서비스에서 지원됩니다.
false: (기본값) LLM 요청 추적을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Debug
config.json 설정: N/A
환경 변수: N/A

Note

이 설정은 디버깅 목적으로만 사용하세요. 활성화하면 민감한 대화 데이터가 로그에 기록될 수 있습니다.

임베딩 검색 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

복합: pgvector와 OpenAI 호환 엔드포인트를 사용하여 Mattermost 콘텐츠 전반에 대한 시맨틱 검색을 위한 실험적 임베딩 검색 기능을 활성화합니다.
비활성화: (기본값) 임베딩 검색 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

Note

임베딩 검색에는 Enterprise 라이선스가 필요하며 실험적 기능으로 제공됩니다. 또한 PostgreSQL 데이터베이스에서 pgvector 확장을 활성화해야 합니다. 대용량 데이터 세트에서는 성능이 달라질 수 있습니다.

임베딩 제공업체 유형#

시맨틱 검색을 위한 임베딩을 생성할 제공업체를 선택합니다. 사용 가능한 옵션: OpenAI, OpenAI Compatible.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

API 키#

임베딩 제공업체의 API에 대한 요청을 인증할 때 사용하는 API 키입니다. OpenAI Compatible 임베딩 제공업체에 필요합니다.

문자열 입력입니다. 이 값은 저장될 때 암호화됩니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

모델#

콘텐츠의 벡터 표현을 생성하는 데 사용할 특정 임베딩 모델입니다. 선택한 임베딩 제공업체와 호환되어야 합니다.

문자열 입력(모델 이름)입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

API URL#

OpenAI-compatible 임베딩 API의 엔드포인트 URL입니다.

필수 문자열 입력(URL 형식)입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

차원 수#

임베딩 벡터의 차원 수로, 선택한 임베딩 모델과 일치해야 합니다. 일반적인 값으로는 OpenAI text-embedding-ada-002의 1536, text-embedding-3-large의 3072가 있습니다.

숫자 입력입니다. 모델에 따라 일반적인 값은 768, 1024 또는 1536입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

청킹 전략#

임베딩 생성을 위해 콘텐츠를 더 작은 청크로 나누는 방법입니다. 사용 가능한 옵션: 문장, 단락, 고정 크기.

콘텐츠 유형과 검색 요구 사항에 따라 선택하세요.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

청크 크기#

각 콘텐츠 청크의 최대 크기(문자 수)입니다. 권장 범위는 512-1024자입니다. 최적 값은 청킹 전략에 따라 달라집니다.

숫자 입력입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

청크 중첩#

맥락의 연속성을 높이기 위해 연속된 청크가 공유하는 토큰 수입니다. 고정 크기 청킹의 권장 범위는 20-50자입니다.

숫자 입력입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

최소 청크 크기 비율#

문장 및 단락 청크가 크기 요구 사항을 충족하는지 확인하기 위한 청크 크기 검증의 최소 비율입니다. 설정된 청크 크기에 비해 너무 작은 청크를 걸러내는 데 사용됩니다.

숫자 입력(소수 비율)입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

모든 게시물 재색인#

게시물 재색인을 선택하면 임베딩 검색을 위한 모든 게시물의 전체 재색인이 시작됩니다. 임베딩 제공업체, 모델 또는 청킹 구성을 변경할 때 검색 색인을 다시 구축하려면 이 컨트롤을 사용하세요.

재색인 과정에서 색인 진행 상황을 모니터링하세요.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

GitLab#

GitLab을 Mattermost에 연결 제품 문서에서 자세한 내용을 확인하세요.

GitHub#

GitHub를 Mattermost에 연결 제품 문서에서 자세한 내용을 확인하세요.

Jira#

사용 가능한 Mattermost 구성 옵션은 Jira를 Mattermost에 연결 제품 문서를 참조하세요.

법적 보존#

사용 가능 플랜: Enterprise, Enterprise Advanced

자세한 내용은 법적 보존 제품 문서를 참조하세요.

Microsoft Calendar Integration#

사용 가능한 Mattermost 구성 옵션은 Microsoft Calendar Integration을 Mattermost에 연결 제품 문서를 참조하세요.

Microsoft Teams Meetings#

사용 가능한 Mattermost 구성 옵션은 Microsoft Teams Meetings를 Mattermost에 연결 제품 문서를 참조하세요.

MS Teams#

Mattermost for Microsoft Teams를 사용하면 Teams의 실시간 채팅 알림을 Mattermost로 전달하여, Mattermost와 Teams가 혼합된 환경에서 업무 영역 간의 장벽을 허물 수 있습니다.

Tip

Mattermost for Microsoft Teams 데이터시트를 다운로드하여 Mattermost가 조직에서 Microsoft 도구를 더욱 효과적으로 활용하는 데 어떻게 도움이 되는지 알아보세요.

System Console에서 Plugins > MS Teams로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

모든 Mattermost 팀에 대해 Mattermost for Microsoft Teams 플러그인을 활성화합니다.

true: Mattermost 워크스페이스에서 MS Teams 플러그인을 활성화합니다.
false: (기본값) MS Teams 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

Note

활성화된 팀 구성 옵션을 사용하여 Microsoft Teams 채팅과 다이렉트 메시지 및 그룹 메시지를 동기화할 Mattermost 팀을 지정하세요.

테넌트 ID#

Azure 포털에서 확인한 Microsoft Teams 테넌트 ID를 지정합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

클라이언트 ID#

Azure 포털에 등록한 OAuth 앱의 Microsoft Teams 클라이언트 ID를 지정합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

클라이언트 시크릿#

Azure 포털에 등록한 OAuth 앱의 클라이언트 시크릿을 지정합니다.

영숫자 값입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

저장 데이터 암호화 키#

새 암호화 시크릿을 다시 생성합니다. 이 암호화 시크릿은 OAuth 토큰을 암호화하고 복호화하는 데 사용됩니다.

영숫자 값입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

Note

재생성을 선택하여 새 키를 생성하세요.

웹훅 시크릿#

Microsoft Teams가 Mattermost로 메시지를 보낼 때 사용할 웹훅 시크릿을 생성합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

Note

재생성을 선택하여 새 키를 생성하세요.

평가용 API 요금 모델 사용#

테스트 목적으로만 활성화하세요. 실제 환경에서 충분한 수의 메시지 알림을 지원하려면 요금 모델이 필요합니다.

true: 평가용 API 요금 모델을 활성화합니다.
false: (기본값) 평가용 API 요금 모델을 비활성화합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

알림 동기화#

Microsoft Teams에서 채팅 또는 그룹 채팅을 수신하면 Mattermost에서 연결된 사용자에게 알립니다.

true: (기본값) 이 기능을 활성화한 연결된 모든 사용자에 대해 채팅 메시지 알림을 동기화합니다.
false: 알림을 동기화하지 않습니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

한 번에 전체 다운로드를 지원할 첨부 파일의 최대 크기#

메모리에 로드할 수 있는 첨부 파일의 최대 파일 크기를 메비바이트(MiB) 단위로 지정합니다. 이 값보다 큰 첨부 파일은 Microsoft Teams에서 Mattermost로 스트리밍됩니다.

숫자 값입니다. 기본값은 20 MiB입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

파일 스트리밍 버퍼 크기#

Microsoft Teams에서 Mattermost로 첨부 파일을 스트리밍할 때 사용하는 버퍼 크기를 메비바이트(MiB) 단위로 지정합니다.

숫자 값입니다. 기본값은 20 MiB입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

성능 메트릭#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

사용 가능한 Mattermost 구성 옵션은 성능 메트릭 모니터링 제품 문서를 참조하세요.

협업 플레이북#

Mattermost의 협업 플레이북을 사용하면 Mattermost 플랫폼과 통합된 반복 가능한 팀 기반 프로세스에 구조, 모니터링, 자동화를 제공할 수 있습니다.

System Console에서 Plugins > Collaborative playbooks로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

true: (기본값) Mattermost 워크스페이스에서 협업 플레이북을 활성화합니다.
false: Mattermost 워크스페이스에서 협업 플레이북을 비활성화합니다.

시스템 구성 경로: Plugins > Collaborative playbooks
config.json 설정:
환경 변수:

활성화된 팀#

모든 Mattermost 팀 또는 선택한 팀에 대해서만 협업 플레이북을 활성화합니다.

시스템 구성 경로: Plugins > Collaborative playbooks
config.json 설정:
환경 변수:

실험적 기능 활성화#

true: Mattermost 워크스페이스에서 실험적 플레이북 기능을 활성화합니다.
false: Mattermost 워크스페이스에서 실험적 플레이북 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Collaborative playbooks
config.json 설정:
환경 변수:

Zoom#

사용 가능한 Mattermost 구성 옵션은 Zoom을 Mattermost에 연결 제품 문서를 참조하세요.

config.json 전용 설정#

다음 셀프 호스팅 배포 설정은 config.json 파일에서만 구성할 수 있으며 System Console에서는 사용할 수 없습니다.

서명 공개 키 파일#

이 설정은 System Console에서 사용할 수 없으며 config.json에서만 설정할 수 있습니다.

서버에 내장된 Mattermost 플러그인 서명 키 외에도, 여기에 지정한 각 공개 키는 플러그인 서명을 검증하는 데 신뢰됩니다.

Important

Mattermost v10.11부터 사전 패키징된 플러그인은 시작 시 서명 검증이 필요합니다. 사용자 지정 사전 패키징 플러그인을 번들로 포함하는 배포판은 서명된 플러그인이 올바르게 검증되도록 이 설정에 사용자 지정 공개 키를 반드시 구성해야 합니다. 사용자 지정 플러그인 서명 키를 정의하려면 PluginSettings.SignaturePublicKeyFiles를 사용하세요.

사용자 지정 플러그인을 번들로 포함할 때는 다음을 수행하세요.

플러그인 파일과 해당 .sig 서명 파일을 모두 prepackaged_plugins 디렉터리에 넣습니다.
서명을 검증하려면 이 구성 설정을 사용하여 사용자 지정 공개 키를 추가합니다.

이 기능의 config.json 설정은 "SignaturePublicKeyFiles": {}이며, 서명 파일의 상대 경로 또는 절대 경로로 구성된 문자열 배열을 입력합니다.

Chimera OAuth 프록시 URL#

이 설정은 System Console에서 사용할 수 없으며 config.json에서만 설정할 수 있습니다.

Mattermost 플러그인이 미리 생성된 OAuth 애플리케이션에 연결할 때 사용하는 Chimera URL을 지정합니다.

이 기능의 config.json 설정은 "ChimeraOAuthProxyUrl": {}이며, 문자열을 입력합니다.

플러그인 구성 설정

Mattermost v12.0

원문 보기

번역일: 2026-10-19

요약

사용 가능 플랜: Entry, Professional, Enterprise, Enterprise Advanced

플러그인 관리
Calls
AI 에이전트
GitLab
GitHub
Jira
법적 보존
Microsoft 캘린더 통합
MS Teams
성능 지표
협업 플레이북
사용자 만족도 설문
Zoom
config.json 전용 설정

Tip

jq와 같은 도구를 사용하는 경우 cat config/config.json | jq '.PluginSettings.Enable'을 입력합니다.
config.json 파일을 수동으로 편집할 때는 PluginSettings와 같은 객체를 찾은 뒤 그 안에서 Enable 키를 찾으세요.

플러그인 관리#

System Console에서 Plugins > Plugin Management로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

true: (기본값) Mattermost 서버에서 플러그인을 활성화합니다. 자세한 내용은 Mattermost에서 플러그인 사용하기 문서를 참조하세요.
false: Mattermost 서버에서 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > Enable > true
환경 변수: MM_PLUGINSETTINGS_ENABLE

Note

대규모 배포에서 이 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다:

리소스 소비: 플러그인은 CPU, 메모리, 디스크와 같은 시스템 리소스를 소비합니다. 플러그인을 비활성화하면 이러한 리소스가 해제되어 핵심 Mattermost 애플리케이션이 더 효율적으로 실행될 수 있습니다.
복잡성 감소: 각 플러그인은 추가적인 로직과 처리 요구 사항을 더할 수 있습니다. 활성 플러그인의 수를 줄이면 시스템의 복잡성과 잠재적인 오류 지점이 줄어듭니다.
빠른 로드 시간: 플러그인을 비활성화하면 시스템이 초기화하고 관리해야 하는 구성 요소가 줄어들어 서버 시작이 빨라지고 사용자 상호작용 시 지연 시간이 낮아질 수 있습니다.
안정성: 일부 플러그인은 Mattermost 인스턴스의 전반적인 성능과 안정성에 영향을 미칠 수 있는 버그나 성능 문제가 있을 수 있습니다. 문제가 있거나 사용 빈도가 낮은 플러그인을 비활성화하면 시스템의 안정성이 향상될 수 있습니다.
유지 관리 및 업데이트: 더 적은 수의 플러그인을 관리하면 이를 유지 관리하고 업데이트하는 데 필요한 오버헤드가 줄어들어 더 원활한 운영과 적은 다운타임에 기여할 수 있습니다.
그러나 플러그인은 Mattermost를 다른 서비스 및 워크플로와 연동하는 데 종종 필수적입니다. 성능 향상과 조직 및 사용자의 요구 사항 간에 균형을 맞추는 것이 중요합니다.

플러그인 서명 요구#

true: 관리형 및 비관리형 플러그인에 대해 플러그인 서명 유효성 검사를 활성화합니다.
false: (기본값) 관리형 및 비관리형 플러그인에 대해 플러그인 서명 유효성 검사를 비활성화합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > RequirePluginSignature > false
환경 변수: MM_PLUGINSETTINGS_REQUIREPLUGINSIGNATURE

Note

자동 사전 패키지 플러그인#

true: (기본값) Mattermost가 활성화된 사전 패키지 플러그인을 자동으로 설치하고 업그레이드합니다. 더 최신 버전이 설치되어 있으면 변경하지 않습니다.
false: Mattermost가 사전 패키지 플러그인을 자동으로 설치하거나 업그레이드하지 않습니다. 오프라인 상태에서도 마켓플레이스에서 사전 패키지 플러그인을 수동으로 설치할 수 있습니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > AutomaticPrepackagedPlugins > true
환경 변수: MM_PLUGINSETTINGS_AUTOMATICPREPACKAGEDPLUGINS

Note

플러그인 업로드#

true: 로컬 컴퓨터에서 Mattermost 서버로 플러그인을 업로드할 수 있습니다.
false: (기본값) 로컬 컴퓨터에서 Mattermost 서버로 플러그인을 업로드할 수 없습니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > EnableUploads > false
환경 변수: MM_PLUGINSETTINGS_ENABLEUPLOADS

Note

마켓플레이스 활성화#

true: (기본값) 모든 시스템 관리자에 대해 Mattermost 서버에서 플러그인 마켓플레이스를 활성화합니다.
false: 모든 시스템 관리자에 대해 Mattermost 서버에서 플러그인 마켓플레이스를 비활성화합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > EnableMarketplace > true
환경 변수: MM_PLUGINSETTINGS_ENABLEMARKETPLACE

원격 마켓플레이스 활성화#

true: (기본값) Mattermost가 Marketplace URL에 설정된 엔드포인트에 연결을 시도합니다. 연결에 실패하면 오류가 표시되며, 마켓플레이스에는 사전 패키지 플러그인과 설치된 플러그인만 표시됩니다.
false: Mattermost가 원격 마켓플레이스에 연결을 시도하지 않습니다. 마켓플레이스에는 사전 패키지 플러그인과 설치된 플러그인만 표시됩니다. Mattermost 서버가 인터넷에 연결할 수 없는 경우 이 설정을 사용하세요.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > EnableRemoteMarketplace > true
환경 변수: MM_PLUGINSETTINGS_ENABLEREMOTEMARKETPLACE

Note

마켓플레이스 URL#

이 설정은 원격 마켓플레이스의 URL을 저장합니다.

문자열 입력입니다. 기본값은 https://api.integrations.mattermost.com입니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > MarketplaceURL
환경 변수: MM_PLUGINSETTINGS_MARKETPLACEURL

설치된 플러그인 상태#

이 설정은 설치된 플러그인 목록과 각 플러그인의 활성화 또는 비활성화 상태입니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > PluginStates
환경 변수: MM_PLUGINSETTINGS_PLUGINSTATES

플러그인 설정#

이 설정은 플러그인별 데이터를 포함합니다.

config.json 설정은 객체입니다. 객체 키는 플러그인 ID(예: com.mattermost.apps)입니다. 각 키는 플러그인별 데이터를 포함하는 객체에 대응합니다.

시스템 구성 경로: Plugins > Plugin Management
config.json 설정: PluginSettings > Plugins
환경 변수: MM_PLUGINSETTINGS_PLUGINS

Calls#

System Console에서 Plugins > Calls로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

true: (기본값) Mattermost 워크스페이스에서 Calls 플러그인을 활성화합니다.
false: Mattermost 워크스페이스에서 Calls 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > PluginStates > com.mattermost.calls > Enable
환경 변수: MM_PLUGINSETTINGS_PLUGINSTATES_COM_MATTERMOST_CALLS

RTC 서버 주소 (UDP)#

이 설정은 RTC 서버가 UDP 연결을 수신 대기하는 IP 주소를 제어합니다. 모든 통화 UDP 트래픽은 이 IP를 통해 처리됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings Plugins > com.mattermost.calls > udpserveraddress
환경 변수: MM_CALLS_UDP_SERVER_ADDRESS

Note

이 설정은 자체 호스팅 배포에만 적용되며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 경우에만 적용됩니다.

RTC 서버 주소 (TCP)#

이 설정은 RTC 서버가 TCP 연결을 수신 대기하는 IP 주소를 제어합니다. 모든 통화 TCP 트래픽은 이 IP를 통해 처리됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > tcpserveraddress
환경 변수: MM_CALLS_TCP_SERVER_ADDRESS

Note

이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

RTC 서버 포트 (UDP)#

이 설정은 RTC 서버가 수신 대기하는 UDP 포트를 제어합니다. 모든 통화 UDP 트래픽은 이 포트를 통해 처리됩니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

기본값은 8443입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > udpserverport
환경 변수: MM_CALLS_UDP_SERVER_PORT

Note

이 설정은 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

RTC 서버 포트 (TCP)#

이 설정은 RTC 서버가 수신 대기하는 TCP 포트를 제어합니다. 모든 통화 TCP 트래픽은 이 포트를 통해 처리됩니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

기본값은 8443입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > tcpserverport
환경 변수: MM_CALLS_TCP_SERVER_PORT

Note

이 설정은 플러그인 버전 0.17부터 사용할 수 있으며, 독립형 rtcd 서비스를 통해 통화를 실행하지 않는 자체 호스팅 배포에만 적용됩니다.

특정 채널에서 활성화#

Mattermost v7.7부터 관리자는 이 설정을 구성할 수 없습니다. 이 설정은 숨겨져 있으며 자체 호스팅 배포에서는 항상 활성화된 상태입니다

true: 채널 관리자가 특정 채널에서 통화를 활성화하거나 비활성화할 수 있습니다. DM/GM 참가자도 통화를 활성화하거나 비활성화할 수 있습니다.
false: 시스템 관리자만 특정 채널에서 통화를 활성화하거나 비활성화할 수 있습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > allowenablecalls
환경 변수: MM_CALLS_ALLOW_ENABLE_CALLS

테스트 모드#

false: 테스트 모드가 활성화되며 시스템 관리자만 채널에서 통화를 시작할 수 있습니다.
true: 라이브 모드가 활성화되며 모든 팀 구성원이 채널에서 통화를 시작할 수 있습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > defaultenabled
환경 변수: MM_CALLS_DEFAULT_ENABLED

Note

ICE 호스트 재정의#

이 설정은 통화에 연결할 때 클라이언트에 알려지는 호스트 주소를 재정의하는 데 사용할 수 있습니다. 허용되는 형식은 다음과 같습니다:

단일 IP 주소(예: 10.0.0.1).
단일 호스트명 또는 FQDN(예: calls.myserver.tld).
(v0.17.0부터) externalAddr/internalAddr 매핑을 쉼표로 구분한 목록(예: 10.0.0.1/172.0.0.1,10.0.0.2/172.0.0.2).

선택 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > icehostoverride
환경 변수: MM_CALLS_ICE_HOST_OVERRIDE

Note

ICE 호스트 포트 재정의#

이 설정은 통화에 연결할 때 클라이언트에 알려지는 ICE 호스트 후보에서 사용하는 포트를 재정의하는 데 사용할 수 있습니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > icehostportoverride
환경 변수: MM_CALLS_ICE_HOST_PORT_OVERRIDE

Note

- 이 설정은 자체 호스팅 배포에만 적용됩니다. - 이 값은 UDP 및 TCP 호스트 후보 모두에 적용됩니다.

RTCD 서비스 URL#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화를 호스팅하는, 실행 중인 rtcd 서비스 인스턴스의 URL입니다.

값을 설정하면(비어 있지 않으면) 모든 통화를 이 외부 서비스가 처리합니다.

선택 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > rtcdserviceurl
환경 변수: MM_CALLS_RTCD_SERVICE_URL

Note

최대 통화 참가자 수#

이 설정은 하나의 통화에 참여할 수 있는 참가자 수를 제한합니다.

기본값은 0(제한 없음)입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > maxcallparticipants
환경 변수: MM_CALLS_MAX_CALL_PARTICIPANTS

Note

ICE 서버 구성#

이 설정은 서비스에서 사용할 ICE 서버(STUN/TURN) 목록을 JSON 형식으로 저장합니다.

선택 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 할 수 있습니다.

기본값은 [{"urls": ["stun:stun.global.calls.mattermost.com:3478"]}]입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > iceserversconfigs
환경 변수: MM_CALLS_ICE_SERVERS_CONFIGS

Note

예시

[
 &#123;
    "urls":[
       "stun:stun.global.calls.mattermost.com:3478"
    ]
 &#125;,
 &#123;
    "urls":[
       "turn:turn.example.com:3478"
    ],
    "username":"webrtc",
    "credentials":"turnpassword"
 &#125;
]

예시(생성된 TURN 자격 증명 사용)

[&#123;
    "urls": ["turn:turn.example.com:443"]
&#125;]

Note

TURN 생성 자격 증명이 작동하려면 아래 TURN 정적 인증 시크릿 설정을 통해 시크릿을 제공해야 합니다.

TURN 정적 인증 시크릿#

TURN 서버용 단기 자격 증명을 생성하는 데 사용하는 정적 시크릿입니다.

선택 필드입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > turnstaticauthsecret
환경 변수: MM_CALLS_TURN_STATIC_AUTH_SECRET

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

TURN 자격 증명 만료#

TURN 서버용으로 생성된 단기 자격 증명의 만료 시간(분 단위)입니다.

기본값은 1440(하루)입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > turncredentialsexpirationminutes
환경 변수: MM_CALLS_TURN_CREDENTIALS_EXPIRATION_MINUTES

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

서버 측 TURN#

true: RTC 서버가 서버에서 시작하는 연결에 구성된 TURN 후보를 사용합니다.
false: TURN을 클라이언트 측에서만 사용합니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > serversideturn
환경 변수: MM_CALLS_SERVER_SIDE_TURN

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

화면 공유 허용#

true: 통화 참가자가 화면을 공유할 수 있습니다.
false: 통화 참가자가 화면을 공유할 수 없습니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > allowscreensharing
환경 변수: MM_CALLS_ALLOW_SCREEN_SHARING

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

화면 공유에 시뮬캐스트 활성화 (실험적)#

true: 화면 공유에 시뮬캐스트를 활성화합니다. 화면 공유 품질을 개선하는 데 도움이 될 수 있습니다.
false: 화면 공유에 시뮬캐스트를 비활성화합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablesimulcast
환경 변수: MM_CALLS_ENABLE_SIMULCAST

Note

이 실험적 설정은 자체 호스팅 배포에만 적용됩니다.
이 기능은 Calls 플러그인 버전 >= v0.16.0 및 (사용하는 경우) rtcd 버전 >= v0.10.0이 필요합니다.
이 실험적 구성 설정과 AV1 활성화 실험적 구성 설정을 동시에 활성화하지 마세요.

통화 녹음 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

true: 통화 호스트가 회의 영상과 오디오를 녹화할 수 있습니다.
false: (기본값) 호스트가 통화 녹음 기능을 사용할 수 없습니다.

녹음에는 전체 통화 창 화면과 함께 참가자의 오디오 트랙 및 공유된 화면 영상이 포함됩니다. 녹음 파일은 Mattermost에 저장됩니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablerecordings
환경 변수: MM_CALLS_ENABLE_RECORDINGS

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

작업 서비스 URL#

사용 가능 플랜: Enterprise, Enterprise Advanced

녹음과 관련된 모든 처리가 이루어지는, 실행 중인 작업 서비스의 URL입니다. 생성된 녹음 파일은 Mattermost에 저장됩니다.

필수 필드입니다. 이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > jobserviceurl
환경 변수: MM_CALLS_JOB_SERVICE_URL

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.
클라이언트는 서비스에 처음 연결할 때 자동으로 등록되고 인증 키를 데이터베이스에 저장합니다. 클라이언트 ID가 명시적으로 제공되지 않으면 Mattermost 설치의 진단 ID가 사용됩니다.
서비스 URL은 http://clientID:authKey@hostname 형식의 자격 증명을 지원합니다. 또는 Mattermost 서버의 환경 재정의인 MM_CALLS_JOB_SERVICE_CLIENT_ID 및 MM_CALLS_JOB_SERVICE_AUTH_KEY를 통해 전달할 수도 있습니다.
Calls v0.25부터 각각 MM_CALLS_RECORDER_SITE_URL 또는 MM_CALLS_TRANSCRIBER_SITE_URL 환경 변수를 설정하여 작업이 연결에 사용하는 사이트 URL을 재정의할 수 있습니다. 이는 작업이 Mattermost에 구성된 공개 사이트 URL을 통해 연결하여 공개 네트워크를 우회할 가능성을 방지하는 데 도움이 될 수 있습니다.

최대 통화 녹음 시간#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화 녹음의 최대 길이(분 단위)입니다.

기본값은 60이고 최댓값은 180입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > maxrecordingduration
환경 변수: MM_CALLS_MAX_RECORDING_DURATION

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

통화 녹음 품질#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화 녹음의 오디오 및 비디오 품질입니다. 사용 가능한 옵션은 낮음(Low), 중간(Medium), 높음(High)입니다.

기본값은 중간(Medium)입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > recordingquality
환경 변수: MM_CALLS_RECORDING_QUALITY

Note

통화 전사 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

true: 통화의 자동 전사를 활성화합니다.
false: (기본값) 통화 전사 기능이 비활성화됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enabletranscriptions
환경 변수: MM_CALLS_ENABLE_TRANSCRIPTIONS

Note

전사기 모델 크기#

사용 가능 플랜: Enterprise, Enterprise Advanced

기본값은 Base입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > transcribermodelsize
환경 변수: MM_CALLS_TRANSCRIBER_MODEL_SIZE

Note

통화 전사기 스레드#

사용 가능 플랜: Enterprise, Enterprise Advanced

통화 후 전사기가 사용하는 스레드 수입니다. 값은 [1, numCPUs] 범위 안에 있어야 합니다.

기본값은 2입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > transcribernumthread
환경 변수: MM_CALLS_TRANSCRIBER_NUM_THREADS

Note

실시간 자막 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

true: 통화의 실시간 자막을 활성화합니다.
false: (기본값) 실시간 자막 기능이 비활성화됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablelivecaptions
환경 변수: MM_CALLS_ENABLE_LIVE_CAPTIONS

Note

실시간 자막: 모델 크기#

사용 가능 플랜: Enterprise, Enterprise Advanced

기본값은 Tiny입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsmodelsize
환경 변수: MM_CALLS_LIVE_CAPTIONS_MODEL_SIZE

Note

실시간 자막: 통화당 사용할 전사기 수#

사용 가능 플랜: Enterprise, Enterprise Advanced

기본값은 1입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumtranscribers
환경 변수: MM_CALLS_LIVE_CAPTIONS_NUM_TRANSCRIBERS

Note

실시간 자막: 전사기당 스레드 수#

사용 가능 플랜: Enterprise, Enterprise Advanced

실시간 자막 전사기당 스레드 수입니다. LiveCaptionsNumTranscribers * LiveCaptionsNumThreadsPerTranscriber의 곱은 [1, numCPUs] 범위 안에 있어야 합니다.

기본값은 2입니다. 필수 값입니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionsnumthreadspertranscriber
환경 변수: MM_CALLS_LIVE_CAPTIONS_NUM_THREADS_PER_TRANSCRIBER

Note

실시간 자막 언어#

사용 가능 플랜: Enterprise, Enterprise Advanced

실시간 자막 전사기에 전달되는 언어입니다. 'en'과 같은 2글자 ISO 639 Set 1 언어 코드여야 합니다.

비워 두면 기본값인 'en'(영어)으로 설정됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > livecaptionslanguage
환경 변수: MM_CALLS_LIVE_CAPTIONS_LANGUAGE

Note

이 설정은 자체 호스팅 배포에만 적용됩니다.

IPv6 활성화 (실험적)#

true: RTC 서비스가 듀얼 스택 모드로 작동하여 IPv4 후보에 더해 IPv6 연결을 수신 대기하고 IPv6 후보를 생성합니다.
false: (기본값) RTC 서비스가 IPv4 연결만 수신 대기합니다.

이 설정을 변경하면 적용을 위해 플러그인을 다시 시작해야 합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableipv6
환경 변수: MM_CALLS_ENABLE_IPV6

Note

통화 벨소리 활성화#

true: 벨소리 기능이 활성화됩니다. 다이렉트 메시지 및 그룹 메시지 참가자는 통화가 시작되면 데스크톱 앱 알림과 벨소리 알림을 받습니다.
false: (기본값) 벨소리 기능이 비활성화됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableringing
환경 변수: MM_CALLS_ENABLE_RINGING

Note

Mattermost 통화에서 통화 벨소리를 활성화하는 기능은 베타 단계에 있습니다.

AV1 활성화 (실험적)#

true: 화면 공유 트랙을 인코딩하는 데 AV1 코덱을 사용할 수 있습니다. AV1 인코딩을 지원하는 클라이언트에서는 화면 공유 품질이 개선될 수 있습니다.
false: (기본값) 화면 공유 트랙에 AV1 코덱이 비활성화됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enableAV1
환경 변수: MM_CALLS_ENABLE_AV1

Note

이 실험적 구성 설정과 화면 공유에 시뮬캐스트 활성화 실험적 구성 설정을 동시에 활성화하지 마세요.

다이렉트 메시지에서 화상 통화 활성화 (실험적)#

true: 다이렉트 메시지(DM) 채널에서 실험적 화상 통화를 활성화합니다.
false: (기본값) 화상 통화가 비활성화됩니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enablevideo
환경 변수: MM_CALLS_ENABLE_VIDEO

Note

다이렉트 메시지에서 화상 통화를 활성화하는 기능은 현재 실험적 단계에 있습니다.

Note

DC 신호 활성화 (실험적)#

true: 클라이언트가 미디어 트랙(예: 음성, 화면)의 신호 전달에 WebRTC 데이터 채널을 사용합니다. 특히 네트워크 연결 상태가 좋지 않을 때 더 효율적이고 경합 상태(race condition)가 덜 발생하는 처리 방식이 될 수 있습니다.
false: (기본값) 클라이언트가 미디어 트랙의 신호 전달에 WebSocket을 사용합니다.

시스템 구성 경로: Plugins > Calls
config.json 설정: PluginSettings > Plugins > com.mattermost.calls > enabledcsignaling
환경 변수: MM_CALLS_ENABLE_DC_SIGNALING

Note

전용 WebRTC 서비스를 통해 통화를 호스팅할 때 이 기능이 작동하려면 RTCD 서비스 v0.18.0 이상이 필요합니다.
이 실험적 구성 설정은 WebRTC 기반 통화 설정의 일부를 시스템이 처리하는 방식을 결정하므로 활성화할 때 주의하세요. 이 구성 설정을 활성화하면 특정 상황에서 통화 설정이 조금 더 빨라지거나 더 안정적으로 이루어질 수 있습니다.

AI 에이전트#

Note

Mattermost Agents는 이전에 Mattermost Copilot으로 알려져 있었습니다.

System Console에서 Plugins > Agents로 이동하여 다음 Mattermost Agents 구성 설정에 접근하세요.

플러그인 활성화#

true: Mattermost 워크스페이스에서 Agents 플러그인을 활성화합니다.
false: (기본값) Agents 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > Agents
config.json 설정: 해당 없음
환경 변수: 해당 없음

표시 이름#

시스템의 다른 봇과 구별하기 위해 Mattermost에서 사용하는 봇의 표시 이름입니다.

문자열 입력입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

에이전트 사용자명#

채널에서 봇을 @멘션하는 데 사용할 수 있는 봇의 사용자명입니다.

문자열 입력입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

에이전트 아바타#

Mattermost에서 에이전트의 아바타로 사용할 이미지를 업로드합니다.

이미지 업로드 인터페이스입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

서비스#

AI 지원에 사용할 LLM 서비스 제공업체를 선택합니다.

사용 가능한 옵션: OpenAI, OpenAI Compatible, Azure, Anthropic, Ask Sage.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: 해당 없음
환경 변수: 해당 없음

사용자 이름#

Ask Sage LLM 서비스에 인증할 때 사용하는 사용자 이름입니다.

문자열 입력이 필요합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

비밀번호#

Ask Sage LLM 서비스에 인증할 때 사용하는 비밀번호입니다.

문자열 입력이 필요합니다. 이 값은 저장될 때 암호화됩니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

API URL#

Mattermost가 LLM의 API와 통신할 때 사용하는 엔드포인트입니다. OpenAI Compatible 및 Azure LLM 서비스에 필요합니다.

문자열 입력(URL 형식)입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

API 키#

LLM의 API에 대한 요청을 인증할 때 사용하는 키입니다. OpenAI, OpenAI Compatible, Anthropic LLM 서비스에 필요합니다.

문자열 입력입니다. 이 값은 저장될 때 암호화됩니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

조직 ID#

해당하는 경우 요청이 올바른 조직으로 청구되고 처리되도록 합니다. OpenAI, OpenAI Compatible, Azure LLM 서비스에서 지원됩니다.

문자열 입력입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

사용자 ID 전송#

true: 분석, 개인화, 감사 목적으로 LLM에 보내는 API 요청에 고유 사용자 식별자를 포함합니다.
false: (기본값) 사용자 식별자를 포함하지 않습니다.

이 설정을 활성화하기 전에 LLM 데이터 개인정보 보호 정책을 검토하세요.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

기본 모델#

다른 모델을 명시적으로 선택하지 않은 경우 쿼리를 처리하는 데 사용할 특정 LLM입니다. 모든 LLM 서비스에서 지원됩니다.

문자열 입력(모델 이름)입니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

입력 토큰 제한#

선택한 LLM이 단일 프롬프트 또는 요청에서 처리할 수 있는 최대 토큰 수(단어, 문장 부호, 특수 문자를 포함한 텍스트 조각)입니다.

숫자 값입니다. 처리할 수 있는 사용자 쿼리의 크기에 직접 영향을 줍니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

출력 토큰 제한#

LLM이 쿼리에 대한 응답에서 생성할 수 있는 최대 토큰 수(단어, 문장 부호, 특수 문자를 포함한 텍스트 조각)입니다.

숫자 값입니다. Anthropic LLM 서비스에서는 0보다 커야 합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

스트리밍 타임아웃#

숫자 값(초 단위)입니다. LLM이 설정된 타임아웃보다 오래 걸리면 연결이 종료됩니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

스트리밍은 LLM이 응답을 생성하면서 점진적으로 표시할 수 있게 하여 사용자에게 더 부드럽고 상호작용적인 경험을 제공합니다.

사용자 지정 지침#

텍스트 입력입니다. 모델이 모든 상호작용에서 암묵적으로 따르는 지침으로, 일관성과 적응성을 제공합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

비전 활성화#

true: LLM이 이미지 관련 입력 또는 출력을 포함하는 응답을 처리하고 생성할 수 있도록 합니다. OpenAI, OpenAI Compatible, Azure, Anthropic LLM 서비스에서 지원됩니다.
false: (기본값) 비전 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

도구 활성화#

true: LLM이 추가 도구 또는 플러그인을 활용하여 기능을 확장할 수 있도록 합니다. OpenAI, OpenAI Compatible, Azure, Anthropic LLM 서비스에서 지원됩니다.
false: (기본값) 도구 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

Note

채널 접근#

사용 가능한 옵션: 모든 채널 허용, 선택한 채널 허용, 선택한 채널 차단, 모든 채널 차단.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

사용자 접근#

사용 가능한 옵션: 모든 사용자 허용, 선택한 사용자 허용, 선택한 사용자 차단.

시스템 구성 경로: Plugins > Agents > Add an AI Bot
config.json 설정: N/A
환경 변수: N/A

기본 에이전트#

여러 에이전트가 구성된 경우 AI 기능에 사용할 기본 봇을 선택합니다. 정의된 에이전트를 기준으로 합니다.

시스템 구성 경로: Plugins > Agents > AI Functions
config.json 설정: N/A
환경 변수: N/A

허용된 업스트림 호스트 이름#

도구를 사용할 때 LLM이 접속할 수 있도록 허용된 호스트 이름의 쉼표로 구분된 목록입니다. *.mydomain.com과 같은 와일드카드를 지원합니다.

예: JIRA 도구 사용을 허용하려면 mattermost.atlassian.net을 입력합니다.

시스템 구성 경로: Plugins > Agents > AI Functions
config.json 설정: N/A
환경 변수: N/A

LLM 추적 활성화#

true: LLM 요청 추적을 활성화하고 전체 대화 데이터를 로그로 출력합니다. 모든 LLM 서비스에서 지원됩니다.
false: (기본값) LLM 요청 추적을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Debug
config.json 설정: N/A
환경 변수: N/A

Note

이 설정은 디버깅 목적으로만 사용하세요. 활성화하면 민감한 대화 데이터가 로그에 기록될 수 있습니다.

임베딩 검색 활성화#

사용 가능 플랜: Enterprise, Enterprise Advanced

복합: pgvector와 OpenAI 호환 엔드포인트를 사용하여 Mattermost 콘텐츠 전반에 대한 시맨틱 검색을 위한 실험적 임베딩 검색 기능을 활성화합니다.
비활성화: (기본값) 임베딩 검색 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

Note

임베딩 제공업체 유형#

시맨틱 검색을 위한 임베딩을 생성할 제공업체를 선택합니다. 사용 가능한 옵션: OpenAI, OpenAI Compatible.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

API 키#

임베딩 제공업체의 API에 대한 요청을 인증할 때 사용하는 API 키입니다. OpenAI Compatible 임베딩 제공업체에 필요합니다.

문자열 입력입니다. 이 값은 저장될 때 암호화됩니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

모델#

콘텐츠의 벡터 표현을 생성하는 데 사용할 특정 임베딩 모델입니다. 선택한 임베딩 제공업체와 호환되어야 합니다.

문자열 입력(모델 이름)입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

API URL#

OpenAI-compatible 임베딩 API의 엔드포인트 URL입니다.

필수 문자열 입력(URL 형식)입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

차원 수#

숫자 입력입니다. 모델에 따라 일반적인 값은 768, 1024 또는 1536입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

청킹 전략#

임베딩 생성을 위해 콘텐츠를 더 작은 청크로 나누는 방법입니다. 사용 가능한 옵션: 문장, 단락, 고정 크기.

콘텐츠 유형과 검색 요구 사항에 따라 선택하세요.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

청크 크기#

각 콘텐츠 청크의 최대 크기(문자 수)입니다. 권장 범위는 512-1024자입니다. 최적 값은 청킹 전략에 따라 달라집니다.

숫자 입력입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

청크 중첩#

맥락의 연속성을 높이기 위해 연속된 청크가 공유하는 토큰 수입니다. 고정 크기 청킹의 권장 범위는 20-50자입니다.

숫자 입력입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

최소 청크 크기 비율#

숫자 입력(소수 비율)입니다.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

모든 게시물 재색인#

재색인 과정에서 색인 진행 상황을 모니터링하세요.

시스템 구성 경로: Plugins > Agents > Embedding Search
config.json 설정: N/A
환경 변수: N/A

GitLab#

GitLab을 Mattermost에 연결 제품 문서에서 자세한 내용을 확인하세요.

GitHub#

GitHub를 Mattermost에 연결 제품 문서에서 자세한 내용을 확인하세요.

Jira#

사용 가능한 Mattermost 구성 옵션은 Jira를 Mattermost에 연결 제품 문서를 참조하세요.

법적 보존#

사용 가능 플랜: Enterprise, Enterprise Advanced

자세한 내용은 법적 보존 제품 문서를 참조하세요.

Microsoft Calendar Integration#

사용 가능한 Mattermost 구성 옵션은 Microsoft Calendar Integration을 Mattermost에 연결 제품 문서를 참조하세요.

Microsoft Teams Meetings#

사용 가능한 Mattermost 구성 옵션은 Microsoft Teams Meetings를 Mattermost에 연결 제품 문서를 참조하세요.

MS Teams#

Tip

System Console에서 Plugins > MS Teams로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

모든 Mattermost 팀에 대해 Mattermost for Microsoft Teams 플러그인을 활성화합니다.

true: Mattermost 워크스페이스에서 MS Teams 플러그인을 활성화합니다.
false: (기본값) MS Teams 플러그인을 비활성화합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

Note

활성화된 팀 구성 옵션을 사용하여 Microsoft Teams 채팅과 다이렉트 메시지 및 그룹 메시지를 동기화할 Mattermost 팀을 지정하세요.

테넌트 ID#

Azure 포털에서 확인한 Microsoft Teams 테넌트 ID를 지정합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

클라이언트 ID#

Azure 포털에 등록한 OAuth 앱의 Microsoft Teams 클라이언트 ID를 지정합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

클라이언트 시크릿#

Azure 포털에 등록한 OAuth 앱의 클라이언트 시크릿을 지정합니다.

영숫자 값입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

저장 데이터 암호화 키#

새 암호화 시크릿을 다시 생성합니다. 이 암호화 시크릿은 OAuth 토큰을 암호화하고 복호화하는 데 사용됩니다.

영숫자 값입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

Note

재생성을 선택하여 새 키를 생성하세요.

웹훅 시크릿#

Microsoft Teams가 Mattermost로 메시지를 보낼 때 사용할 웹훅 시크릿을 생성합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

Note

재생성을 선택하여 새 키를 생성하세요.

평가용 API 요금 모델 사용#

테스트 목적으로만 활성화하세요. 실제 환경에서 충분한 수의 메시지 알림을 지원하려면 요금 모델이 필요합니다.

true: 평가용 API 요금 모델을 활성화합니다.
false: (기본값) 평가용 API 요금 모델을 비활성화합니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

알림 동기화#

Microsoft Teams에서 채팅 또는 그룹 채팅을 수신하면 Mattermost에서 연결된 사용자에게 알립니다.

true: (기본값) 이 기능을 활성화한 연결된 모든 사용자에 대해 채팅 메시지 알림을 동기화합니다.
false: 알림을 동기화하지 않습니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

한 번에 전체 다운로드를 지원할 첨부 파일의 최대 크기#

숫자 값입니다. 기본값은 20 MiB입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

파일 스트리밍 버퍼 크기#

Microsoft Teams에서 Mattermost로 첨부 파일을 스트리밍할 때 사용하는 버퍼 크기를 메비바이트(MiB) 단위로 지정합니다.

숫자 값입니다. 기본값은 20 MiB입니다.

시스템 구성 경로: Plugins > MS Teams
config.json 설정: N/A
환경 변수: N/A

성능 메트릭#

사용 가능 플랜: Entry, Enterprise, Enterprise Advanced(Professional 제외)

사용 가능한 Mattermost 구성 옵션은 성능 메트릭 모니터링 제품 문서를 참조하세요.

협업 플레이북#

Mattermost의 협업 플레이북을 사용하면 Mattermost 플랫폼과 통합된 반복 가능한 팀 기반 프로세스에 구조, 모니터링, 자동화를 제공할 수 있습니다.

System Console에서 Plugins > Collaborative playbooks로 이동하여 다음 구성 설정에 접근하세요.

플러그인 활성화#

true: (기본값) Mattermost 워크스페이스에서 협업 플레이북을 활성화합니다.
false: Mattermost 워크스페이스에서 협업 플레이북을 비활성화합니다.

시스템 구성 경로: Plugins > Collaborative playbooks
config.json 설정:
환경 변수:

활성화된 팀#

모든 Mattermost 팀 또는 선택한 팀에 대해서만 협업 플레이북을 활성화합니다.

시스템 구성 경로: Plugins > Collaborative playbooks
config.json 설정:
환경 변수:

실험적 기능 활성화#

true: Mattermost 워크스페이스에서 실험적 플레이북 기능을 활성화합니다.
false: Mattermost 워크스페이스에서 실험적 플레이북 기능을 비활성화합니다.

시스템 구성 경로: Plugins > Collaborative playbooks
config.json 설정:
환경 변수:

Zoom#

사용 가능한 Mattermost 구성 옵션은 Zoom을 Mattermost에 연결 제품 문서를 참조하세요.

config.json 전용 설정#

다음 셀프 호스팅 배포 설정은 config.json 파일에서만 구성할 수 있으며 System Console에서는 사용할 수 없습니다.

서명 공개 키 파일#

이 설정은 System Console에서 사용할 수 없으며 config.json에서만 설정할 수 있습니다.

서버에 내장된 Mattermost 플러그인 서명 키 외에도, 여기에 지정한 각 공개 키는 플러그인 서명을 검증하는 데 신뢰됩니다.

Important

사용자 지정 플러그인을 번들로 포함할 때는 다음을 수행하세요.

플러그인 파일과 해당 .sig 서명 파일을 모두 prepackaged_plugins 디렉터리에 넣습니다.
서명을 검증하려면 이 구성 설정을 사용하여 사용자 지정 공개 키를 추가합니다.

이 기능의 config.json 설정은 "SignaturePublicKeyFiles": {}이며, 서명 파일의 상대 경로 또는 절대 경로로 구성된 문자열 배열을 입력합니다.

Chimera OAuth 프록시 URL#

이 설정은 System Console에서 사용할 수 없으며 config.json에서만 설정할 수 있습니다.

Mattermost 플러그인이 미리 생성된 OAuth 애플리케이션에 연결할 때 사용하는 Chimera URL을 지정합니다.

이 기능의 config.json 설정은 "ChimeraOAuthProxyUrl": {}이며, 문자열을 입력합니다.