Yapılandırma Yapısı

Not: Zorunlu olarak belirtilmeyen alanlar isteğe bağlıdır.

version

• gerekli

cache

skillSync

bkz: Skill Sync Nesne Yapısı

messageFilter

bkz: Mesaj Filtresi Nesne Yapısı

fileStrategy

• Seçenekler: "local" | "firebase" | "s3" | "azure_blob" | "cloudfront"

• Notlar:
  • "cloudfront", dosyaları S3'te depolar ve kararlı medya dağıtımı, imzalı çerezler ve imzalı indirmeler için CloudFront URL'leri döndürür.
  • "firebase", dosyaları Firebase Storage ve Firebase Hosting uç noktaları (edge locations) üzerinden sunar.
  • S3, dosyaları süresi dolan önceden imzalanmış URL'ler (geçici imzalı belirteçler) aracılığıyla sunar. Süre dolduğunda, bu URL'ye başvuran herhangi bir görsel veya avatar arayüzde bozuk görünecektir. Bu durum, S3'ü görsel varlıklar için birincil strateji olarak uygunsuz kılar. Ayrıntılar için ilgili tartışmaya göz atın.
  • Görseller ve avatarlar için en iyi performans adına "cloudfront" veya "firebase" kullanın ya da avatar ve image öğelerini CDN destekli bir stratejiye yönlendirmek için fileStrategies yapılandırmasını yapın.
  • Kurulum ayrıntıları için lütfen File Storage & CDN documentation bölümüne bakın.

fileStrategies

Farklı dosya türleri için dosya depolama stratejileri üzerinde ayrıntılı kontrol sağlar.

• Kullanılabilir Stratejiler: "local" | "firebase" | "s3" | "azure_blob" | "cloudfront"

Alt anahtarlar:

• Notlar:
  • Bu ayar, tekil fileStrategy seçeneğine göre önceliklidir
  • Belirli bir dosya türü yapılandırılmamışsa, sistem default değerine, ardından fileStrategy değerine ve son olarak "local" değerine geri döner.
  • Görsellerin ve avatarların kullanıcı arayüzünde düzgün bir şekilde oluşturulabilmesi için kalıcı ve kararlı URL'lere ihtiyaçları vardır. S3 önceden imzalanmış (presigned) URL'lerin süresi dolar (AWS sınırı: IAM kullanıcıları için 7 gün, STS/rol tabanlı kimlik bilgileri için saatler), bu da model seçicide ve sohbet arayüzünde bozuk görsellere neden olur. Tam bağlam için ilgili tartışmaya bakın. Bunu önlemek için avatar ve image için "cloudfront" veya "firebase" kullanın.
  • S3 ve Azure Blob Storage, kısa ömürlü önceden imzalanmış indirme URL'lerinin uygun olduğu document depolama için oldukça uygundur.
  • Her bir depolama sağlayıcısının kurulum detayları için lütfen File Storage & CDN documentation bölümüne bakın.

Örnekler:

# Use a single strategy for all file types
fileStrategies:
  default: 's3'

# Route images and avatars to CDN, keep documents in object storage
fileStrategies:
  avatar: 'cloudfront' # CDN delivery for avatars
  image: 'cloudfront' # CDN delivery for generated/uploaded images
  document: 's3' # Object storage for documents

# Only configure specific types, others use default
fileStrategies:
  default: 'local'
  avatar: 'firebase' # Only avatars use Firebase CDN, everything else is local

cloudfront

Anahtar:

Alt anahtarlar:

bkz: CloudFront Nesne Yapısı ve S3 ile CloudFront

filteredTools

• Notlar:
  • includedTools ve filteredTools öğelerinin her ikisi de belirtilmişse, yalnızca includedTools tanınacaktır.
  • Hem gptPlugins hem de assistants endpoint'lerini etkiler
  • Filtrelemek istediğiniz araçların isimlerini api/app/clients/tools/manifest.json dosyasında bulabilirsiniz.
    • pluginKey değerini kullanın
  • Ayrıca, api/app/clients/tools/.well-known dizini altında listelenenler de dahildir.
    • name_for_model değerini kullanın

includedTools

• Notlar:
  • includedTools ve filteredTools öğelerinin her ikisi de belirtilmişse, yalnızca includedTools tanınacaktır.
  • Hem gptPlugins hem de assistants endpoint'lerini etkiler
  • Filtrelemek istediğiniz araçların isimlerini api/app/clients/tools/manifest.json dosyasında bulabilirsiniz.
    • pluginKey değerini kullanın
  • Ayrıca, api/app/clients/tools/.well-known dizini altında listelenenler de dahildir.
    • name_for_model değerini kullanın

secureImageLinks

imageOutputType

• Not: Büyük/küçük harfe duyarlıdır. Google endpoint yalnızca "jpeg" ve "png" çıktı türlerini destekler.
• Seçenekler: "png" | "webp" | "jpeg"

ocr

Anahtar:

Alt anahtarlar:

bkz: OCR Yapılandırma Nesnesi Yapısı

webSearch

Anahtar:

Alt anahtarlar:

bkz: Web Search Object Structure

fileConfig

Anahtar:

Alt anahtarlar:

clientImageResize

Anahtar:

Alt anahtarlar:

Açıklama:

clientImageResize yapılandırması, yükleme öncesinde istemci tarafında otomatik görüntü yeniden boyutlandırmayı etkinleştirir. Bu özellik şunlara yardımcı olur:

• Sunucu sınırlarını aşan büyük görsel dosyaları nedeniyle oluşan yükleme hatalarını önleyin
• Bant genişliği kullanımını azaltmak için görüntüleri iletimden önce sıkıştırın
• Yükleme performansını daha küçük dosya boyutlarıyla iyileştirin
• Dosya boyutunu optimize ederken görüntü kalitesini koruyun

Etkinleştirildiğinde, belirtilen maxWidth veya maxHeight boyutlarını aşan görseller, sunucuya yüklenmeden önce istemci tarafında otomatik olarak yeniden boyutlandırılır. Yeniden boyutlandırma işlemi, görselin belirtilen sınırlar içinde kalmasını sağlarken orijinal en-boy oranını korur.

Örnek:

fileConfig:
  clientImageResize:
    enabled: true
    maxWidth: 1920
    maxHeight: 1080
    quality: 0.8
    compressFormat: 'jpeg'

Notlar:

• Yalnızca resim dosyaları (JPEG, PNG, WebP vb.) için geçerlidir
• Görüntüler belirtilen boyutları aştığında yeniden boyutlandırma otomatik olarak gerçekleşir
• Yeniden boyutlandırma sırasında orijinal en-boy oranı korunur
• Bu özellik, desteklenen tüm görsel yükleme endpoint'leri ile çalışır
• Kalite ayarı yalnızca JPEG ve WebP formatları için geçerlidir
• Kaliteyi çok düşük (< 0.5) ayarlamak, gözle görülür görüntü bozulmasına neden olabilir

bkz: Dosya Yapılandırma Nesne Yapısı

rateLimits

Anahtar:

Alt anahtarlar:

fileUploads Alt Anahtarları:

conversationsImport Alt Anahtarları:

tts Alt anahtarları:

stt Alt Anahtarları:

• Örnek:

rateLimits:
  fileUploads:
    ipMax: 100
    ipWindowInMinutes: 60
    userMax: 50
    userWindowInMinutes: 60
  conversationsImport:
    ipMax: 100
    ipWindowInMinutes: 60
    userMax: 50
    userWindowInMinutes: 60
  stt:
    ipMax: 100
    ipWindowInMinutes: 1
    userMax: 50
    userWindowInMinutes: 1
  tts:
    ipMax: 100
    ipWindowInMinutes: 1
    userMax: 50
    userWindowInMinutes: 1

registration

Anahtar:

Alt anahtarlar:

ayrıca bakınız:

• socialLogins,
• alloweddomains,
• Kayıt Nesnesi Yapısı

memory

Anahtar:

Alt anahtarlar:

bkz: Bellek Nesnesi Yapısı

summarization

Anahtar:

Alt anahtarlar:

bkz: Özetleme Nesne Yapısı

actions

Anahtar:

Alt anahtarlar:

ayrıca bakınız:

• allowedDomains,
• allowedAddresses,
• Actions Nesne Yapısı

interface

Anahtar:

Alt anahtarlar:

bkz: Arayüz Nesne Yapısı

modelSpecs

Anahtar:

Alt anahtarlar:

bkz: Model Specs Nesne Yapısı

endpoints

Anahtar:

Alt anahtarlar:

Not: Endpoint'ler, streamRate, headers, titleModel, titleMethod, titlePrompt, titlePromptTemplate, titleEndpoint ve maxToolResultChars gibi Shared Endpoint Settings desteğine sahiptir. Bunlar, her endpoint için ayrı ayrı veya all anahtarı kullanılarak global olarak yapılandırılabilir. headers, endpoint seviyesindeki değerlerle birleştirilir ve anahtar çakışmalarında endpoint seviyesindeki değerler önceliklidir. all anahtarı baseURL kabul etmez.

Note: endpoints.allowedAddresses applies to user-provided baseURL values (when an admin configures a custom endpoint with apiKey: 'user_provided' and baseURL: 'user_provided'). Each user-supplied baseURL is validated against the SSRF block at request time; entries listed here are exempted. See mcpSettings.allowedAddresses for the field semantics — same rules apply (private IP space only, port required, no URLs/paths/CIDR/bare hosts/public IP literals).

mcpSettings

Anahtar:

Alt anahtarlar:

• Notlar:
  • Bu, MCP sunucuları aracılığıyla dahili adreslerin kötüye kullanımına/yanlış kullanımına karşı koruma sağlayan bir güvenlik özelliğidir
  • Varsayılan olarak LibreChat, MCP sunucularının dahili, yerel veya özel ağ adreslerine bağlanmasını kısıtlar.
  • Yerel IP adreslerini veya alan adlarını kullanan MCP sunucuları, ya katı allowedDomains beyaz listesine eklenebilir (bu durumda yalnızca bu küme erişilebilir olur) ya da herkese açık hedeflerin erişilebilir kalmasını sağlamak için allowedAddresses aracılığıyla tam host:port hizmetleri olarak muaf tutulabilir.
  • Tüm yaml yapılandırma değişikliklerinde olduğu gibi, değişikliklerin geçerli olması için LibreChat'in yeniden başlatılması gerekir.
  • Etki alanlarını, joker karakterli alt etki alanlarını (*.example.com), Docker etki alanlarını ve IP adreslerini destekler

Örnek:

mcpSettings:
  # Strict whitelist mode:
  # allowedDomains:
  #   - "example.com"           # Specific domain
  #   - "*.example.com"         # All subdomains
  #   - "http://mcp-server:3000" # Internal service, explicitly whitelisted

  # Default SSRF mode with private service exemptions:
  allowedAddresses:
    - 'host.docker.internal:8080' # Permit one private host on one port
    - '10.0.0.5:8000' # Permit one private IP on one port

bkz: MCP Settings Object Structure

mcpServers

Anahtar:

Alt anahtarlar:

• Notlar:
  • Başlatma işlemi uygulama açılışında gerçekleşir ve değişikliklerin etkili olması için uygulamanın yeniden başlatılması gerekir.
  • <serverName>, her bir MCP sunucusu yapılandırması için benzersiz bir tanımlayıcıdır.
  • Her bir MCP sunucusu, dört bağlantı türünden biri kullanılarak yapılandırılabilir:
    • stdio
    • websocket
    • sse
    • streamable-http
  • type alanı, MCP sunucusuna olan bağlantı türünü belirtir.
  • type belirtilmezse, url veya command öğesinin varlığına ve biçimine göre varsayılan olarak atanır:
    • url belirtilmişse ve http veya https ile başlıyorsa, type varsayılan olarak sse olur.
    • url belirtilmişse ve ws veya wss ile başlıyorsa, type varsayılan olarak websocket olur.
    • command belirtilmişse, type varsayılan olarak stdio değerini alır.
  • Ek yapılandırma seçenekleri şunları içerir:
    • timeout: MCP sunucusu istekleri için milisaniye cinsinden zaman aşımı. Araç istekleri için yanıtın ne kadar bekleneceğini belirler.
    • initTimeout: MCP sunucusu başlatma işlemi için milisaniye cinsinden zaman aşımı süresi. Sunucunun başlatılması için ne kadar bekleneceğini belirler.
    • serverInstructions: Sunucu talimatlarının aracı bağlamına dahil edilip edilmeyeceğini kontrol eder. true (sunucu tarafından sağlananları kullan), false (devre dışı) veya özel bir metin (sunucu tarafından sağlananları geçersiz kılar) olabilir.
    • customUserVars: (İsteğe bağlı) Bireysel kullanıcıların bir MCP sunucusu için ayarlayabileceği özel değişkenleri (örneğin, API anahtarları, URL'ler) tanımlar. Arayüz aracılığıyla sağlanan bu kullanıcı bazlı değerler, daha sonra sunucunun headers veya env yapılandırmalarında {{VARIABLE_NAME}} sözdizimi kullanılarak referans gösterilebilir. Bu, MCP araçları için kullanıcı bazlı kimlik doğrulamaya veya özelleştirmeye olanak tanır.
  • bkz: MCP Servers Object Structure

Örnek:

mcpServers:
  everything:
    # type: sse # type can optionally be omitted
    url: http://localhost:3001/sse
    timeout: 30000
    initTimeout: 10000
    serverInstructions: true # Use server-provided instructions
  puppeteer:
    type: stdio
    command: npx
    args:
      - -y
      - '@modelcontextprotocol/server-puppeteer'
    timeout: 30000
    initTimeout: 10000
    serverInstructions: 'Do not access any local files or local/internal IP addresses'
  filesystem:
    # type: stdio
    command: npx
    args:
      - -y
      - '@modelcontextprotocol/server-filesystem'
      - /home/user/LibreChat/
    iconPath: /home/user/LibreChat/client/public/assets/logo.svg
  mcp-obsidian:
    command: npx
    args:
      - -y
      - 'mcp-obsidian'
      - /path/to/obsidian/vault
  streamable-http-example:
    type: streamable-http
    url: https://example.com/mcp
    headers:
      Authorization: 'Bearer ${API_TOKEN}'
    timeout: 30000
  per-user-crendentials-example:
    type: sse
    url: 'https//some.mcp/sse'
    headers:
      X-Custom-Auth-Token: '{{USER_API_KEY}}' # Placeholder for the user-provided API key, defined in `customUserVars` below.
    customUserVars:
      USER_API_KEY:
        title: 'Service API Key'
        description: "Your personal API key for this service. You can get it <a href='https://example.com/api-keys' target='_blank'>here</a>."
    serverInstructions: true

bkz: MCP Servers Object Structure

speech

Anahtar:

Alt anahtarlar:

bkz: Speech Object Structure

turnstile

Anahtar:

Alt anahtarlar:

bkz: Turnstile Nesne Yapısı

transactions

Anahtar:

Alt anahtarlar:

bkz: Transactions Object Structure

Ek bağlantılar

• Özetleme Nesne Yapısı
• AWS Bedrock Nesne Yapısı
• Özel Endpoint Nesne Yapısı
• Azure OpenAI Endpoint Nesne Yapısı
• Assistants Endpoint Nesne Yapısı
• Ajanlar
• OCR Yapılandırma Nesnesi Yapısı
• Konuşma Nesnesi Yapısı
• Turnstile Nesne Yapısı
• İşlemler Nesne Yapısı
• Bakiye Nesne Yapısı
• Web Arama Nesne Yapısı
• Bellek Nesnesi Yapısı