인터페이스 객체 구조

개요

interface 객체를 사용하면 메뉴, 패널, 링크와 같은 구성 요소의 가시성 및 동작 설정을 포함하여 애플리케이션 내 다양한 사용자 인터페이스 요소를 사용자 지정할 수 있습니다. 이 섹션에서는 interface 객체 구조에 대한 자세한 분석을 제공합니다.

다음은 interface 아래의 필드들입니다:

• mcpServers
• privacyPolicy
• termsOfService
• modelSelect
• parameters
• contextUsage
• contextCost
• currency
• presets
• prompts
• bookmarks
• memories
• multiConvo
• agents
• remoteAgents
• skills
• sharedLinks
• temporaryChat
• temporaryChatRetention
• retentionMode
• retainAgentFiles
• autoSubmitFromUrl
• customWelcome
• runCode
• webSearch
• fileSearch
• fileCitations
• defaultPinnedTools
• peoplePicker
• marketplace

참고:

• interface 구성은 애플리케이션 내에서 전역적으로 적용됩니다.
• 대부분의 설정에는 기본값이 제공되지만, 특정 요구 사항이나 조건에 따라 재정의할 수 있습니다.
• 애플리케이션의 조건부 로직은 Model Specs와 같은 다른 구성에 따라 이러한 설정을 추가로 수정할 수 있습니다.

예시

interface:
  mcpServers:
    placeholder: 'MCP Servers'
    use: true
    create: true
    share: false
    public: false
    configureObo: false
    trustCheckbox:
      label: 'I trust this server'
      subLabel: 'Only enable servers you trust'
  privacyPolicy:
    externalUrl: 'https://example.com/privacy'
    openNewTab: true
  termsOfService:
    externalUrl: 'https://example.com/terms'
    openNewTab: true
    modalAcceptance: true
    modalTitle: 'Terms of Service'
    modalContent: |
      # Terms of Service
      ## Introduction
      Welcome to LibreChat!
  modelSelect: false
  parameters: true
  contextUsage: true
  contextCost: true
  currency:
    code: EUR
    rate: 0.92
  presets: false
  prompts:
    use: true
    create: true
    share: true
    public: false
  bookmarks: true
  multiConvo: true
  agents:
    use: true
    create: true
    share: true
    public: false
  skills:
    use: true
    create: true
    share: false
    public: false
    defaultActiveOnShare: false
  sharedLinks:
    create: true
    share: true
    public: false
    snapshotFiles: true
  customWelcome: 'Hey {{user.name}}! Welcome to LibreChat'
  runCode: true
  webSearch: true
  fileSearch: true
  fileCitations: true
  defaultPinnedTools:
    - artifacts
    - execute_code
    - mcp

mcpServers

권한 관리 기능에서 더 이상 사용되지 않습니다(Deprecated). use, create, share, 및 public 하위 키는 시작 시 역할 권한을 시드(seed)하는 데 사용됩니다. 역할/그룹/사용자별 MCP 서버 권한을 관리하려면 Admin Panel을 사용하는 것을 권장합니다. placeholder 및 trustCheckbox 하위 키는 영향을 받지 않습니다.

키:

하위 키:

trustCheckbox 하위 키:

예시:

interface:
  mcpServers:
    placeholder: 'Select MCP Server'
    use: true
    create: true
    share: false
    configureObo: false
    trustCheckbox:
      label:
        en: 'I trust this server'
        es: 'Confío en este servidor'
      subLabel:
        en: 'Only enable servers you trust'
        es: 'Solo habilite servidores en los que confíe'

privacyPolicy

키:

하위 키:

termsOfService

키:

하위 키:

modelSelect

키:

기본값: true

참고:

• modelSpecs.addedEndpoints를 사용하는 경우 이 값은 true여야 합니다.
• modelSpecs.addedEndpoints가 사용되고 interface.modelSelect가 명시적으로 설정되지 않은 경우, 기본값은 true입니다.

예시:

interface:
  modelSelect: true

parameters

키:

기본값: true

예시:

interface:
  parameters: false

contextUsage

키:

기본값: true

예시:

interface:
  contextUsage: true

contextCost

키:

기본값: false

참고:

• contextCost: true를 설정하여 표시되는 비용 값을 선택하십시오. contextUsage를 통해 토큰 사용량은 계속 표시되도록 하면서 비용 값은 숨길 수 있습니다.
• currency는 비용 표시가 활성화된 경우 표시되는 비용에만 영향을 미칩니다.

예시:

interface:
  contextCost: true

currency

키:

하위 키:

예시:

interface:
  currency:
    code: EUR
    rate: 0.92

presets

키:

기본값: true

예시:

interface:
  presets: true

prompts

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 PROMPTS 역할 권한을 시드(seed)합니다. 역할/그룹/사용자별 프롬프트 권한 관리는 Admin Panel을 사용하는 것을 권장합니다.

키:

기본값: true

중요: 불리언(Boolean) vs 객체(Object) 구성

• Boolean (prompts: true): use 권한만 업데이트합니다. 기존의 create, share, public 권한 값은 데이터베이스에서 그대로 유지됩니다. 관리자 패널을 통해 구성된 다른 설정에 영향을 주지 않고 간단한 기능 토글로 사용하세요.

• Object: 명시적으로 지정된 하위 권한만 업데이트합니다. 구성에 포함되지 않은 권한은 데이터베이스에 있는 기존 설정이 유지됩니다.

객체 구조를 사용할 때:

하위 키:

예시 (boolean - 간단한 기능 토글):

interface:
  prompts: true # Only updates USE; create/share/public remain unchanged

예시 (객체 - 세밀한 제어):

interface:
  prompts:
    use: true
    create: false # Disable creation while allowing use
    # share and public not specified - preserves existing values

예시 (객체 - 전체 제어):

interface:
  prompts:
    use: true
    create: true
    share: true
    public: false

bookmarks

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 BOOKMARKS 역할 권한을 시드(seed)합니다. 관리자 패널을 사용하는 것을 권장합니다.

키:

기본값: true

예시:

interface:
  bookmarks: true

memories

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 MEMORIES 역할 권한을 시드(seed)합니다. 관리자 패널 사용을 권장합니다. 이 토글은 memory 동작 구성과는 별개라는 점을 유의하세요.

키:

기본값: true

참고: 이 설정은 메모리 기능의 UI 표시 여부를 제어합니다. 메모리 동작에 대한 상세 구성(토큰 제한, 개인화, 에이전트 설정)은 Memory Configuration을 참조하세요.

예시:

interface:
  memories: true

multiConvo

권한 관리 기능에서 더 이상 사용되지 않습니다(Deprecated). 시작 시 기본 USER 역할에 대해서만 MULTI_CONVO 역할 권한을 시드(seed)합니다. 관리자 패널 사용을 권장합니다.

키:

기본값: true

예시:

interface:
  multiConvo: true

agents

Agents에 대한 추가 정보

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 AGENTS 역할 권한을 시드(seed)합니다. 역할/그룹/사용자별 에이전트 권한을 관리하려면 Admin Panel을 사용하는 것을 권장합니다.

키:

기본값: true

중요: 불리언(Boolean) vs 객체(Object) 구성

• Boolean (agents: true): use 권한만 업데이트합니다. 기존의 create, share, 및 public 권한 값은 데이터베이스에서 그대로 유지됩니다. 관리자 패널을 통해 구성된 다른 설정에 영향을 주지 않고 간단한 기능 토글로 사용하세요.

• Object: 명시적으로 지정된 하위 권한만 업데이트합니다. 구성에 포함되지 않은 권한은 데이터베이스에 있는 기존 설정이 유지됩니다.

객체 구조를 사용할 때:

하위 키:

예시 (boolean - 간단한 기능 토글):

interface:
  agents: true # Only updates USE; create/share/public remain unchanged

예시 (객체 - 세밀한 제어):

interface:
  agents:
    use: true
    create: false # Disable creation while allowing use
    # share and public not specified - preserves existing values

예시 (객체 - 전체 제어):

interface:
  agents:
    use: true
    create: true
    share: true
    public: false

remoteAgents

Agents API(OpenAI 호환 및 Open Responses API 엔드포인트)에 대한 액세스를 제어하며, 이를 통해 외부 애플리케이션이 API 키를 사용하여 프로그래밍 방식으로 LibreChat 에이전트와 상호 작용할 수 있습니다.

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 REMOTE_AGENTS 역할 권한을 시드(seed)합니다. 관리자 패널 사용을 권장합니다.

키:

하위 키:

기본값: 모든 필드는 기본적으로 false(비활성화)로 설정됩니다.

예시:

interface:
  remoteAgents:
    use: true
    create: true
    share: false
    public: false

참고: 관리자 사용자는 이 구성과 관계없이 기본적으로 모든 원격 에이전트 권한이 활성화되어 있습니다.

skills

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 SKILLS 역할 권한을 시드(seed)합니다. 역할/그룹/사용자별로 Skills 권한을 관리하려면 Admin Panel을 사용하는 것을 권장합니다. defaultActiveOnShare는 권한 비트가 아니며 YAML 동작 설정으로 유지됩니다.

키:

기본값: use 및 create의 경우 true, share, public, defaultActiveOnShare의 경우 false입니다.

하위 키:

예시:

interface:
  skills:
    use: true
    create: true
    share: false
    public: false
    defaultActiveOnShare: false

Skills 동작 및 호출 모드에 대한 자세한 내용은 Skills를 참조하세요.

sharedLinks

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 SHARED_LINKS 역할 권한을 시드(seed)합니다. 역할/그룹/사용자별 공유 링크 권한을 관리하려면 Admin Panel을 사용하는 것을 권장합니다.

키:

기본값: create: true, share: true, public: true

중요: 불리언(Boolean) vs 객체(Object) 구성

• Boolean (sharedLinks: true): 기본 USER 역할에 대한 모든 SHARED_LINKS 권한을 활성화합니다.
• Boolean (sharedLinks: false): 기본 USER 역할에 대한 모든 SHARED_LINKS 권한을 비활성화합니다.
• Object: 명시적으로 지정된 하위 권한만 업데이트합니다. 구성에 포함되지 않은 권한은 데이터베이스에 있는 기존 설정이 유지됩니다.

하위 키:

예시:

interface:
  sharedLinks:
    create: true
    share: true
    public: false
    snapshotFiles: true

사용자 대상 공유 링크 동작에 대해서는 Shareable Links를 참조하세요.

temporaryChat

사용자가 임시 채팅 기능을 사용할 수 있는지 여부를 제어합니다. 임시 채팅은 대화 기록에 저장되지 않으며, 구성 가능한 보존 기간이 지나면 자동으로 삭제됩니다.

권한 관리 기능에서 더 이상 사용되지 않습니다(Deprecated). 시작 시 기본 USER 역할에 대해서만 TEMPORARY_CHAT 역할 권한을 시드(seed)합니다. Admin Panel 사용을 권장합니다. 아래의 temporaryChatRetention은 권한이 아니며, 보존 기간을 설정하는 권장 방법으로 유지됩니다.

키:

기본값: true

참고: 임시 채팅의 보존 기간은 temporaryChatRetention을 사용하여 구성할 수 있습니다.

예시:

interface:
  temporaryChat: true

temporaryChatRetention

temporaryChatRetention 구성을 사용하면 임시 채팅이 자동으로 삭제되기 전까지 보관되는 기간을 사용자 지정할 수 있습니다.

키:

유효성 검사 규칙:

• 최소: 1시간 (즉시 삭제 방지)
• 최대: 8760시간 (최대 1년 보존)
• 기본값: 720시간 (30일)

구성 방법:

1. LibreChat.yaml (권장): interface.temporaryChatRetention: 168
2. 환경 변수 (사용 중단): TEMP_CHAT_RETENTION_HOURS=168

참고: 환경 변수 TEMP_CHAT_RETENTION_HOURS는 더 이상 사용되지 않습니다. 대신 librechat.yaml의 interface.temporaryChatRetention 설정 옵션을 사용하십시오. 설정 파일의 값이 환경 변수보다 우선합니다.

예시:

interface:
  temporaryChatRetention: 168 # Retain temporary chats for 7 days
  retentionMode: 'temporary'

일반적인 보존 기간:

• 1시간: temporaryChatRetention: 1 (최소 보존 기간)
• 24시간: temporaryChatRetention: 24 (1일)
• 168시간: temporaryChatRetention: 168 (1주)
• 720시간: temporaryChatRetention: 720 (30일 - 기본값)
• 8760시간: temporaryChatRetention: 8760 (1년 - 최대)

retentionMode

어떤 데이터에 보존 기한을 적용할지 제어합니다.

키:

기본값: temporary

예시:

interface:
  temporaryChatRetention: 168
  retentionMode: 'all'

retainAgentFiles

영구 에이전트 리소스 파일이 모든 데이터 보존 정책에서 제외되는지 여부를 제어합니다.

키:

기본값: false

참고:

• 이 설정은 retentionMode가 "all"로 설정된 경우에만 동작을 변경합니다.
• 대화, 메시지 및 에이전트가 아닌 파일에 보존 기한이 적용되는 경우에도 에이전트가 영구 리소스 파일을 유지해야 할 때 이 값을 true로 설정하세요.

예시:

interface:
  temporaryChatRetention: 168
  retentionMode: 'all'
  retainAgentFiles: true

autoSubmitFromUrl

/c/new의 URL 쿼리 매개변수를 통해 제공된 프롬프트가 모델에 자동으로 제출될지 여부를 제어합니다.

인증된 사용자가 /c/new?prompt=…&submit=true를 열면, LibreChat은 일반적으로 URL로 제공된 프롬프트로 입력창을 미리 채우고 즉시 제출합니다. 이는 생성된 딥링크 및 공유 채팅 URL을 위한 편의 기능입니다.

외부 소스로부터 조작된 링크를 받을 수 있는 배포 환경의 경우, 프롬프트 인젝션 페이로드가 모델에 도달하면 메모리나 도구가 활성화된 모델이 민감한 컨텍스트를 유출할 위험이 있습니다. 이러한 환경에서는 운영자가 자동 제출(auto-submission) 기능을 비활성화할 수 있습니다. 이 플래그를 false로 설정하면 프롬프트가 입력창에 미리 채워지기는 하지만, 사용자가 직접 Send 버튼을 눌러야만 전송됩니다.

키:

기본값: true (명시적으로 비활성화하지 않는 한 기존 동작이 유지됩니다).

참고:

• 이 설정은 URL 기반 Model Specs 선택이나 기타 URL 기반 설정에는 영향을 미치지 않으며, 자동 제출 단계에만 영향을 줍니다.
• 쿼리 매개변수는 프롬프트 소스로 prompt와 q를 모두 허용하며, prompt가 우선순위를 갖습니다. submit=true가 트리거 역할을 합니다.
• 민감한 메모리나 도구 데이터를 처리하는 인스턴스에 권장됩니다. 이러한 환경에서는 클릭 한 번으로 실행되는 프롬프트 인젝션 벡터가 명시적인 사용자 확인을 요구하도록 설정해야 합니다.

예시:

interface:
  autoSubmitFromUrl: false

customWelcome

키:

기본값: 없음 (지정하지 않을 경우, 기본 인사말이 사용됩니다)

예시:

interface:
  customWelcome: 'Hey {{user.name}}! Welcome to LibreChat'

참고: customWelcome 메시지 내에서 {{user.name}}을 사용하여 사용자 이름을 동적으로 삽입함으로써 개인화된 환영 인사를 제공할 수 있습니다.

runCode

Markdown 코드 블록에 대한 "코드 실행(Run Code)" 버튼을 활성화/비활성화합니다. LibreChat Code Interpreter API에 대한 자세한 정보는 여기를 참조하세요.

참고: 이 설정은 Agents Code Interpreter Capability를 비활성화하지 않습니다. Agents 기능을 비활성화하려면 대신 Agents Endpoint configuration을 참조하세요.

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 RUN_CODE 역할 권한을 시드(seed)합니다. Admin Panel 사용을 권장합니다.

키:

기본값: true

예시:

interface:
  runCode: true

webSearch

채팅 인터페이스에서 웹 검색 버튼을 활성화/비활성화합니다. 자세한 내용은 웹 검색 구성을 참조하세요.

참고: 이 설정은 Agents Web Search Capability를 비활성화하지 않습니다. Agents 기능을 비활성화하려면 대신 Agents Endpoint configuration을 참조하세요.

권한 관리 기능에서 더 이상 사용되지 않습니다(Deprecated). 시작 시 기본 USER 역할에 대해서만 WEB_SEARCH 역할 권한을 시드(seed)합니다. Admin Panel 사용을 권장합니다.

키:

기본값: true

예시:

interface:
  webSearch: true

fileSearch

채팅 인터페이스에서 파일 검색(도구를 통한 RAG API 사용용) 버튼을 활성화/비활성화합니다.

참고: 이 설정은 Agents File Search Capability를 비활성화하지 않습니다. Agents 기능을 비활성화하려면 대신 Agents Endpoint configuration을 참조하세요.

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 FILE_SEARCH 역할 권한을 시드(seed)합니다. 관리자 패널 사용을 권장합니다.

키:

기본값: true

예시:

interface:
  fileSearch: true

fileCitations

파일 인용 기능의 전역 가용성을 제어합니다. 비활성화하면 모든 사용자에 대한 FILE_CITATIONS 권한이 사실상 제거되어, 개별 사용자 권한과 관계없이 파일 검색 사용 시 파일 인용이 표시되지 않도록 합니다.

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 FILE_CITATIONS 역할 권한을 시드(seed)하거나 전역적으로 게이트합니다. 역할/그룹/사용자별로 인용 권한을 관리하려면 Admin Panel을 사용하는 것을 권장합니다.

참고:

• 이 설정은 시스템 전체의 FILE_CITATIONS 권한에 대한 전역 토글 역할을 합니다.
• false로 설정하면, 역할(roles)을 통해 권한이 부여된 경우라도 모든 사용자가 파일 인용(file citations)을 볼 수 없습니다.
• 파일 인용(file citations)을 사용하려면 fileSearch 기능을 활성화해야 합니다.
• 파일 검색 기능이 있는 에이전트를 사용할 때, 인용 동작(수량 및 품질)은 Agents endpoint configuration을 통해 구성할 수 있습니다.

키:

기본값: true

예시:

interface:
  fileCitations: true

defaultPinnedTools

사용자가 고정된 도구 상태를 사용자 지정하지 않은 경우, 초기 프롬프트 바에 고정된 도구를 시드(seed)합니다. 사용자가 도구를 고정하거나 고정 해제하면 LibreChat은 해당 사용자의 선택을 유지합니다.

키:

지원되는 값:

• 내장 도구 키: artifacts, execute_code, web_search, file_search, skills
• mcp를 사용하여 MCP 서버 드롭다운을 고정합니다
• 해당 서버를 고정된 서버로 시드(seed)하기 위한 특정 MCP 서버 이름

예시:

interface:
  defaultPinnedTools:
    - artifacts
    - execute_code
    - mcp

peoplePicker

사람 선택기 인터페이스에서 선택할 수 있는 주체 유형(사용자, 그룹, 역할)을 제어하며, 일반적으로 에이전트를 공유하거나 액세스 제어를 관리할 때 사용됩니다.

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 PEOPLE_PICKER 역할 권한을 시드(seed)합니다. 관리자 패널 사용을 권장합니다.

키:

하위 키:

기본값:

peoplePicker:
  users: true
  groups: true
  roles: true

예시:

interface:
  peoplePicker:
    users: true
    groups: true
    roles: false # Disable role selection in people picker

marketplace

Agent Marketplace에 대한 액세스를 활성화/비활성화합니다.

권한 관리 기능에서 더 이상 사용되지 않습니다. 시작 시 기본 USER 역할에 대해서만 MARKETPLACE 역할 권한을 시드(seed)합니다. 관리자 패널 사용을 권장합니다.

키:

하위 키:

기본값:

marketplace:
  use: false

예시:

interface:
  marketplace:
    use: true # Enable marketplace access