Arayüz Nesne Yapısı

Genel Bakış

interface nesnesi, menüler, paneller ve bağlantılar gibi bileşenlerin görünürlük ve davranış ayarları da dahil olmak üzere uygulama içindeki çeşitli kullanıcı arayüzü öğelerinin özelleştirilmesine olanak tanır. Bu bölüm, interface nesne yapısının ayrıntılı bir dökümünü sağlar.

Bunlar interface altındaki alanlardır:

• 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

Notlar:

• interface yapılandırmaları uygulama genelinde uygulanır.
• Çoğu ayar için varsayılan değerler sağlanmıştır ancak bunlar belirli gereksinimlere veya koşullara göre geçersiz kılınabilir.
• Uygulamadaki koşullu mantık, Model Specs gibi diğer yapılandırmalara dayalı olarak bu ayarları daha da değiştirebilir.

Örnek

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

İzin yönetimi için kullanımdan kaldırılmıştır. use, create, share ve public alt anahtarları, başlangıçta rol izinlerini oluşturur. Rol/grup/kullanıcı bazında MCP sunucusu izinlerini yönetmek için Admin Panel kullanılması tercih edilir. placeholder ve trustCheckbox alt anahtarları bundan etkilenmez.

Anahtar:

Alt anahtarlar:

trustCheckbox Alt anahtarları:

Örnek:

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

Anahtar:

Alt anahtarlar:

termsOfService

Anahtar:

Alt anahtarlar:

modelSelect

Anahtar:

Varsayılan: true

Notlar:

• modelSpecs.addedEndpoints kullanılıyorsa bunun true olarak ayarlanması gerekir.
• Eğer modelSpecs.addedEndpoints kullanılıyor ve interface.modelSelect açıkça ayarlanmamışsa, varsayılan olarak true değerini alır.

Örnek:

interface:
  modelSelect: true

parameters

Anahtar:

Varsayılan: true

Örnek:

interface:
  parameters: false

contextUsage

Anahtar:

Varsayılan: true

Örnek:

interface:
  contextUsage: true

contextCost

Anahtar:

Varsayılan: false

Notlar:

• Görünür maliyet değerlerini tercih etmek için contextCost: true ayarını yapın. Maliyet değerleri gizli kalırken token kullanımı contextUsage aracılığıyla görünür kalabilir.
• currency, yalnızca maliyet gösterimi etkinleştirildiğinde görüntülenen maliyetleri etkiler.

Örnek:

interface:
  contextCost: true

currency

Anahtar:

Alt anahtarlar:

Örnek:

interface:
  currency:
    code: EUR
    rate: 0.92

presets

Anahtar:

Varsayılan: true

Örnek:

interface:
  presets: true

prompts

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için PROMPTS rol izinlerini tohumlar. Rol/grup/kullanıcı bazında istem izinlerini yönetmek için Admin Panel kullanılması tercih edilir.

Anahtar:

Varsayılan: true

Önemli: Boolean ve Object Yapılandırması

• Boolean (prompts: true): Yalnızca use iznini günceller. Mevcut create, share ve public izin değerleri veritabanından korunur. Bunu, yönetici paneli aracılığıyla yapılandırılan diğer ayarları etkilemeden basit bir özellik açma/kapama anahtarı olarak kullanın.

• Nesne: Yalnızca açıkça belirtilen alt izinleri günceller. Yapılandırmada yer almayan tüm izinler veritabanından olduğu gibi korunur.

Nesne yapısını kullanırken:

Alt anahtarlar:

Örnek (boolean - basit özellik açma/kapama):

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

Örnek (nesne - ayrıntılı kontrol):

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

Örnek (nesne - tam kontrol):

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

bookmarks

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta BOOKMARKS rol iznini yalnızca varsayılan USER rolü için ekler. Admin Panel kullanılması tercih edilir.

Anahtar:

Varsayılan: true

Örnek:

interface:
  bookmarks: true

memories

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta MEMORIES rol izinlerini yalnızca varsayılan USER rolü için oluşturur. Admin Panel kullanılması tercih edilir. Bu anahtarın, memory davranış yapılandırmasından ayrı olduğunu unutmayın.

Anahtar:

Varsayılan: true

Not: Bu, memories özelliğinin arayüz görünürlüğünü kontrol eder. Ayrıntılı bellek davranışı yapılandırması (token sınırları, kişiselleştirme, aracı ayarları) için Memory Configuration bölümüne bakın.

Örnek:

interface:
  memories: true

multiConvo

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için MULTI_CONVO rol iznini oluşturur. Bunun yerine Admin Panel kullanılması tercih edilir.

Anahtar:

Varsayılan: true

Örnek:

interface:
  multiConvo: true

agents

Agents hakkında daha fazla bilgi

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta AGENTS rolü izinlerini yalnızca varsayılan USER rolü için oluşturur. Rol/grup/kullanıcı bazında temsilci izinlerini yönetmek için Admin Panel kullanılması tercih edilir.

Anahtar:

Varsayılan: true

Önemli: Boolean ve Object Yapılandırması

• Boolean (agents: true): Yalnızca use iznini günceller. Mevcut create, share ve public izin değerleri veritabanından korunur. Bunu, yönetici paneli aracılığıyla yapılandırılan diğer ayarları etkilemeden basit bir özellik açma/kapama anahtarı olarak kullanın.

• Nesne: Yalnızca açıkça belirtilen alt izinleri günceller. Yapılandırmada yer almayan tüm izinler veritabanından olduğu gibi korunur.

Nesne yapısını kullanırken:

Alt anahtarlar:

Örnek (boolean - basit özellik açma/kapama):

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

Örnek (nesne - ayrıntılı kontrol):

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

Örnek (nesne - tam kontrol):

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

remoteAgents

Harici uygulamaların API anahtarları aracılığıyla LibreChat ajanlarıyla programatik olarak etkileşime girmesine olanak tanıyan Agents API'ye (OpenAI uyumlu ve Open Responses API uç noktaları) erişimi kontrol eder.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta REMOTE_AGENTS rol izinlerini yalnızca varsayılan USER rolü için oluşturur. Admin Panel kullanılması tercih edilir.

Anahtar:

Alt anahtarlar:

Varsayılan: Tüm alanlar varsayılan olarak false (devre dışı) değerindedir.

Örnek:

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

Not: Yönetici kullanıcılar, bu yapılandırmadan bağımsız olarak varsayılan şekilde tüm uzak aracı (remote agent) izinlerine sahiptir.

skills

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta SKILLS rol izinlerini yalnızca varsayılan USER rolü için oluşturur. Rol/grup/kullanıcı bazında Skills izinlerini yönetmek için Admin Panel kullanılması tercih edilir. defaultActiveOnShare bir izin biti değildir ve bir YAML davranış ayarı olarak kalmaya devam eder.

Anahtar:

Varsayılan: use ve create için true, share, public ve defaultActiveOnShare için false.

Alt anahtarlar:

Örnek:

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

Skills davranışı ve çağırma modları için Skills bölümüne bakın.

sharedLinks

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için SHARED_LINKS rol izinlerini oluşturur. Paylaşılan bağlantı izinlerini rol/grup/kullanıcı bazında yönetmek için Admin Panel kullanılması tercih edilmelidir.

Anahtar:

Varsayılan: create: true, share: true, public: true

Önemli: Boolean ve Object Yapılandırması

• Boolean (sharedLinks: true): Varsayılan USER rolü için tüm SHARED_LINKS izinlerini etkinleştirir.
• Boolean (sharedLinks: false): Varsayılan USER rolü için tüm SHARED_LINKS izinlerini devre dışı bırakır.
• Nesne: Yalnızca açıkça belirtilen alt izinleri günceller. Yapılandırmada yer almayan tüm izinler veritabanından olduğu gibi korunur.

Alt anahtarlar:

Örnek:

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

Kullanıcıya yönelik paylaşılan bağlantı davranışı için bkz. Paylaşılabilir Bağlantılar.

temporaryChat

Geçici sohbet özelliğinin kullanıcılar için kullanılabilir olup olmadığını kontrol eder. Geçici sohbetler konuşma geçmişine kaydedilmez ve yapılandırılabilir bir saklama süresinden sonra otomatik olarak silinir.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için TEMPORARY_CHAT rol iznini oluşturur. Admin Panel kullanılması tercih edilir. Aşağıdaki temporaryChatRetention bir izin değildir ve saklama süresini yapılandırmak için önerilen yöntem olmaya devam etmektedir.

Anahtar:

Varsayılan: true

Not: Geçici sohbetler için saklama süresi temporaryChatRetention kullanılarak yapılandırılabilir.

Örnek:

interface:
  temporaryChat: true

temporaryChatRetention

temporaryChatRetention yapılandırması, geçici sohbetlerin otomatik olarak silinmeden önce ne kadar süreyle tutulacağını özelleştirmenize olanak tanır.

Anahtar:

Doğrulama Kuralları:

• Minimum: 1 saat (anında silinmeyi önler)
• Maksimum: 8760 saat (maksimum 1 yıl saklama süresi)
• Varsayılan: 720 saat (30 gün)

Yapılandırma Yöntemleri:

1. LibreChat.yaml (önerilen): interface.temporaryChatRetention: 168
2. Environment Variable (kullanımdan kaldırıldı): TEMP_CHAT_RETENTION_HOURS=168

Not: TEMP_CHAT_RETENTION_HOURS ortam değişkeni kullanımdan kaldırılmıştır. Lütfen bunun yerine librechat.yaml içindeki interface.temporaryChatRetention yapılandırma seçeneğini kullanın. Yapılandırma dosyası değeri, ortam değişkenine göre önceliklidir.

Örnek:

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

Yaygın Saklama Süreleri:

• 1 saat: temporaryChatRetention: 1 (minimum saklama süresi)
• 24 saat: temporaryChatRetention: 24 (1 gün)
• 168 saat: temporaryChatRetention: 168 (1 hafta)
• 720 saat: temporaryChatRetention: 720 (30 gün - varsayılan)
• 8760 saat: temporaryChatRetention: 8760 (1 yıl - maksimum)

retentionMode

Hangi verilerin saklama sürelerine tabi olacağını kontrol eder.

Anahtar:

Varsayılan: temporary

Örnek:

interface:
  temporaryChatRetention: 168
  retentionMode: 'all'

retainAgentFiles

Kalıcı aracı kaynak dosyalarının tüm veri saklama politikalarından muaf tutulup tutulmayacağını kontrol eder.

Anahtar:

Varsayılan: false

Notlar:

• Bu ayar, yalnızca retentionMode değeri "all" olarak ayarlandığında davranışı değiştirir.
• Ajanların, konuşmalar, mesajlar ve ajan dışı dosyalar için saklama süreleri belirlenmiş olsa bile kalıcı kaynak dosyalarını korumaları gerektiğinde bunu true olarak ayarlayın.

Örnek:

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

autoSubmitFromUrl

/c/new adresindeki URL sorgu parametreleri aracılığıyla sağlanan bir istemin modele otomatik olarak gönderilip gönderilmeyeceğini kontrol eder.

Kimliği doğrulanmış bir kullanıcı tarafından /c/new?prompt=…&submit=true açıldığında, LibreChat normalde oluşturucuyu URL ile sağlanan istemle önceden doldurur ve hemen gönderir. Bu, özel olarak oluşturulmuş derin bağlantılar ve paylaşılan sohbet URL'leri için bir kolaylık özelliğidir.

Kullanıcıların harici kaynaklardan hazırlanmış bağlantılar alabileceği ve bellek veya araç etkinleştirilmiş modellerin, bir istem enjeksiyonu yükünün modele ulaşması durumunda hassas bağlamı sızdırabileceği dağıtımlar için operatörler otomatik gönderimi devre dışı bırakabilir. Bayrak false olarak ayarlandığında, istem yine de oluşturucuda önceden doldurulur ancak kullanıcının Gönder düğmesine açıkça basması gerekir.

Anahtar:

Varsayılan: true (açıkça devre dışı bırakılmadığı sürece mevcut davranış korunur).

Notlar:

• Bu ayar, URL tabanlı Model Specs seçimi veya diğer URL tabanlı ayarları etkilemez; yalnızca otomatik gönderim adımını etkiler.
• Sorgu parametresi, istem kaynağı olarak hem prompt hem de q değerlerini kabul eder; prompt önceliğe sahiptir. submit=true tetikleyicidir.
• Hassas bellek veya araç verilerini işleyen, tek tıkla istem enjeksiyonu vektörünün açık kullanıcı onayı gerektirmesi gereken LibreChat örnekleri için önerilir.

Örnek:

interface:
  autoSubmitFromUrl: false

customWelcome

Anahtar:

Varsayılan: Yok (belirtilmemişse, varsayılan bir karşılama mesajı kullanılır)

Örnek:

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

Not: Kişiselleştirilmiş bir karşılama deneyimi için kullanıcının adını dinamik olarak eklemek üzere customWelcome mesajı içinde {{user.name}} kullanabilirsiniz.

runCode

Markdown Kod Blokları için "Kodu Çalıştır" düğmesini etkinleştirir/devre dışı bırakır. LibreChat Code Interpreter API hakkında daha fazla bilgi

Not: Bu ayar, Agents Code Interpreter Capability özelliğini devre dışı bırakmaz. Agents özelliğini devre dışı bırakmak için bunun yerine Agents Endpoint configuration bölümüne bakın.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için RUN_CODE rol iznini ekler (seed). Bunun yerine Admin Panel kullanılması tercih edilir.

Anahtar:

Varsayılan: true

Örnek:

interface:
  runCode: true

webSearch

Sohbet arayüzündeki web araması düğmesini etkinleştirir/devre dışı bırakır. Web Arama Yapılandırması hakkında daha fazla bilgi için.

Not: Bu ayar, Agents Web Search Capability özelliğini devre dışı bırakmaz. Agents özelliğini devre dışı bırakmak için bunun yerine Agents Endpoint configuration bölümüne bakın.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için WEB_SEARCH rol iznini oluşturur. Admin Panel kullanılması tercih edilir.

Anahtar:

Varsayılan: true

Örnek:

interface:
  webSearch: true

fileSearch

Sohbet arayüzündeki dosya arama (araç aracılığıyla RAG API kullanımı için) düğmesini etkinleştirir/devre dışı bırakır

Not: Bu ayar, Agents File Search Capability özelliğini devre dışı bırakmaz. Agents özelliğini devre dışı bırakmak için bunun yerine Agents Endpoint configuration bölümüne bakın.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için FILE_SEARCH rol iznini oluşturur. Admin Panel kullanılması tercih edilir.

Anahtar:

Varsayılan: true

Örnek:

interface:
  fileSearch: true

fileCitations

Dosya alıntıları işlevselliğinin genel kullanılabilirliğini kontrol eder. Devre dışı bırakıldığında, tüm kullanıcılar için FILE_CITATIONS iznini etkili bir şekilde kaldırır ve bireysel kullanıcı izinlerine bakılmaksızın dosya araması kullanılırken herhangi bir dosya alıntısının görüntülenmesini engeller.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta FILE_CITATIONS rol iznini tohumlar/küresel olarak kısıtlar. Alıntı izinlerini rol/grup/kullanıcı bazında yönetmek için Admin Panel tercih edilmelidir.

Not:

• Bu ayar, sistem genelindeki FILE_CITATIONS izni için küresel bir açma/kapama düğmesi görevi görür.
• false olarak ayarlandığında, roller aracılığıyla izin verilmiş olsa bile hiçbir kullanıcı dosya alıntılarını göremez.
• Dosya alıntıları, fileSearch özelliğinin etkinleştirilmesini gerektirir.
• Dosya arama özelliğine sahip ajanları kullanırken, alıntı davranışı (miktar ve kalite) Agents endpoint configuration aracılığıyla yapılandırılabilir.

Anahtar:

Varsayılan: true

Örnek:

interface:
  fileCitations: true

defaultPinnedTools

Henüz sabitlenmiş araç durumlarını özelleştirmemiş kullanıcılar için başlangıçtaki istem çubuğu sabitlenmiş araçlarını belirler. Bir kullanıcı bir aracı sabitlediğinde veya sabitlemeyi kaldırdığında, LibreChat kullanıcının bu tercihini korur.

Anahtar:

Desteklenen değerler:

• Yerleşik araç anahtarları: artifacts, execute_code, web_search, file_search, skills
• mcp ile MCP sunucuları açılır menüsünü sabitleyin
• O sunucuyu sabitlenmiş olarak eklemek için belirli bir MCP sunucu adı

Örnek:

interface:
  defaultPinnedTools:
    - artifacts
    - execute_code
    - mcp

peoplePicker

Kişi seçici arayüzünde hangi temel türlerin (kullanıcılar, gruplar, roller) seçim için kullanılabilir olduğunu kontrol eder; genellikle temsilciler paylaşılırken veya erişim kontrolleri yönetilirken kullanılır.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta yalnızca varsayılan USER rolü için PEOPLE_PICKER rol izinlerini oluşturur. Bunun yerine Admin Panel kullanılması tercih edilir.

Anahtar:

Alt anahtarlar:

Varsayılan:

peoplePicker:
  users: true
  groups: true
  roles: true

Örnek:

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

marketplace

Agent Marketplace erişimini etkinleştirir/devre dışı bırakır.

İzin yönetimi için kullanımdan kaldırılmıştır. Başlangıçta MARKETPLACE rol iznini yalnızca varsayılan USER rolü için ekler. Admin Panel kullanılması tercih edilir.

Anahtar:

Alt anahtarlar:

Varsayılan:

marketplace:
  use: false

Örnek:

interface:
  marketplace:
    use: true # Enable marketplace access