Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

Model Specs Nesne Yapısı

Genel Bakış

modelSpecs nesnesi, uygulamanızdaki yapay zeka modelleri için daha basit bir kullanıcı arayüzü deneyimi sunmanıza yardımcı olur.

modelSpecs altında 3 ana alan bulunmaktadır:

  • enforce (isteğe bağlı; varsayılan: false)
  • prioritize (isteğe bağlı; varsayılan: true)
  • list (gerekli)
  • addedEndpoints (isteğe bağlı)

Notlar:

  • enforce değeri true olarak ayarlanırsa, Model Specs ayarları potansiyel olarak modelSelect, presets ve parameters gibi diğer arayüz ayarlarıyla çakışabilir.
  • list dizisi, belirli davranışları, görünümleri ve yetenekleri belirleyen ön ayarlar da dahil olmak üzere her model için ayrıntılı yapılandırmalar içerir.
  • Eğer interface alanları yapılandırmada belirtilmemişse, bir Model Specs listesine sahip olmak aşağıdaki arayüz öğelerini devre dışı bırakacaktır:
    • modelSelect
    • parameters
    • presets
  • Model specs ile birlikte bu arayüz öğelerini etkinleştirmek isterseniz, bunları interface nesnesi içinde true olarak ayarlayabilirsiniz.

Model Specs ile kullanıcı tarafından sağlanan API anahtarlarını yönetme

Model Specs modelSelect özelliğini devre dışı bıraktığında, uç nokta açılır menüsü ve API Anahtarını Ayarla iletişim kutusunu açan dişli simgesi gizlenir. Kullanıcılar, apiKey: "user_provided" ile yapılandırılmış herhangi bir uç nokta için anahtarları Ayarlar → Veri kontrolleri → API anahtarları bölümünden ayarlamaya veya değiştirmeye devam edebilirler.

Bu liste, bir kullanıcının gerçekten erişebildiği endpoint'ler ile sınırlandırılmıştır: model specs tarafından referans verilen endpoint'ler ve addedEndpoints ile eklenenler. agents endpoint'ine erişilebildiğinde, bu liste aynı zamanda agent allowedProviders değerlerini de içerir (veya allowedProviders ayarlanmadığında yapılandırılmış tüm sağlayıcıları içerir).

Örnek

modelSpecs:
  enforce: true
  prioritize: true
  list:
    - name: 'meeting-notes-gpt4'
      label: 'Meeting Notes Assistant (GPT4)'
      softDefault: true
      description: 'Generate meeting notes by simply pasting in the transcript from a Teams recording.'
      iconURL: 'https://example.com/icon.png'
      showOnLanding: true
      conversation_starters:
        - 'Summarize this meeting transcript'
        - 'Extract action items and owners'
      hideBadgeRow: true
      skills:
        - 'brand-guidelines'
        - 'meeting-notes'
      subagents:
        enabled: true
        allowSelf: true
        agent_ids: []
      preset:
        endpoint: 'azureOpenAI'
        model: 'gpt-4-turbo-1106-preview'
        maxContextTokens: 128000 # Maximum context tokens
        max_tokens: 4096 # Maximum output tokens
        temperature: 0.2
        modelLabel: 'Meeting Summarizer'
        greeting: |
          This assistant creates meeting notes based on transcripts of Teams recordings.
          To start, simply paste the transcript into the chat box.
        promptPrefix: |
          Based on the transcript, create coherent meeting minutes for a business meeting. Include the following sections:
          - Date and Attendees
          - Agenda
          - Minutes
          - Action Items

          Focus on what items were discussed and/or resolved. List any open action items.
          The format should be a bulleted list of high level topics in chronological order, and then one or more concise sentences explaining the details.
          Each high level topic should have at least two sub topics listed, but add as many as necessary to support the high level topic. 

          - Do not start items with the same opening words.

          Take a deep breath and be sure to think step by step.

Üst Düzey Alanlar

enforce

KeyTypeDescriptionExample
enforceBooleanModel spesifikasyonlarının diğer yapılandırma ayarlarını kesin olarak geçersiz kılıp kılmayacağını belirler.Setting this to `true` can lead to conflicts with interface options if not managed carefully.

Varsayılan: false

Örnek:

modelSpecs:
  enforce: true

prioritize

KeyTypeDescriptionExample
prioritizeBooleanHer ikisi de geçerli olduğunda, Model Specs öğesinin varsayılan yapılandırmaya göre öncelikli olup olmayacağını belirtir.When set to `true`, it ensures that a modelSpec is always selected in the UI. Doing this may prevent users from selecting different endpoints for the selected spec.

Varsayılan: true

Örnek:

modelSpecs:
  prioritize: false

addedEndpoints

KeyTypeDescriptionExample
addedEndpointsArray of StringsBelirli endpoint'lerin (örneğin "openAI", "google") kullanıcı arayüzünde tanımlı Model Specs ile birlikte seçilebilir olmasını sağlar.Requires `interface.modelSelect` to be `true`. If this field is used and `interface.modelSelect` is not explicitly set, `modelSelect` will default to `true`.

Varsayılan: [] (boş liste)

Not: Aşağıdakilerden biri olmalıdır:

  • openAI, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock, agents

Örnek:

modelSpecs:
  # ... other modelSpecs fields
  addedEndpoints:
    - openAI
    - google

list

Gerekli

KeyTypeDescriptionExample
listArray of ObjectsÇeşitli yapılandırmaları ve davranışları detaylandıran bireysel Model Specs listesini içerir.Each object in the list details the configuration for a specific model, including its behaviors, appearance, and capabilities related to the application's functionality.

Model Spec (Liste Öğesi)

Her bir Model Spec veya her bir list öğesi içinde, aşağıdaki alanları yapılandırabilirsiniz:


name

KeyTypeDescriptionExample
nameStringModel için benzersiz tanımlayıcı.No default. Must be specified.

Açıklama: Model için benzersiz tanımlayıcı.


label

KeyTypeDescriptionExample
labelStringModel için başlık açılır menüsünde gösterilen kullanıcı dostu bir ad veya etiket.No default. Optional.

Açıklama: Model için kullanıcı dostu bir isim veya etiket; başlık açılır menüsünde gösterilir.


default

KeyTypeDescriptionExample
defaultBooleanBu model spec'in varsayılan seçim olup olmadığını ve her yeni sohbette otomatik olarak seçilip seçilmeyeceğini belirtir.

Açıklama:
Bu Model Specs öğesinin varsayılan seçim olup olmadığını ve her yeni sohbette otomatik olarak seçilip seçilmeyeceğini belirtir.


softDefault

KeyTypeDescriptionExample
softDefaultBooleanBu model spec'in yalnızca henüz bir model, model spec veya ajan seçmemiş olan ilk kez gelen kullanıcılar için seçilip seçilmeyeceğini belirtir.

Açıklama:

Kullanıcının daha sonraki seçimlerini geçersiz kılmadan ilk çalıştırma için bir varsayılan değer belirler. Kullanıcı başka bir model, spec veya ajan seçtikten sonra kendi tercihini korurken, yeni kullanıcıları özel olarak seçilmiş bir spec'e yönlendirmek istediğinizde softDefault kullanın.

Soft-default bir spec kullanan eski bir konuşmayı görüntülemek, kullanıcı başka bir seçim yaptıktan sonra o spec'i kullanıcının varsayılanı olarak yeniden etkinleştirmez.

Örnek:

modelSpecs:
  list:
    - name: 'general-assistant'
      label: 'General Assistant'
      softDefault: true
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o-mini'

iconURL

KeyTypeDescriptionExample
iconURLStringSeçicide, başlıkta ve sohbet markalamasında modelin simgesi için URL veya önceden tanımlanmış bir endpoint adı.No default. Optional.

Açıklama:
Modelin seçicide, başlıkta ve konuşma markalamasında görünecek simgesi için URL veya önceden tanımlanmış bir endpoint adı. Simgenin nerede görüneceğini kontrol etmek için showIconInMenu ve showIconInHeader kullanın.


description

KeyTypeDescriptionExample
descriptionStringModel seçicide ve isteğe bağlı olarak sohbet başlangıç sayfasında gösterilen, modelin ve amaçlanan kullanımının veya rolünün kısa bir açıklaması.No default. Optional.

Açıklama: Modelin ve amaçlanan kullanımının veya rolünün kısa bir açıklaması; model seçicide gösterilir. Eğer showOnLanding değeri true ise, aynı açıklama sohbet giriş sayfasında da spec etiketinin altında gösterilir.

Düz metin açıklamaları metin olarak oluşturulur. < ile başlayan açıklamalar, güvenli satır içi işaretlemeye ve küçük simgeler gibi medyalara izin veren yapılandırma HTML temizleyicisi aracılığıyla oluşturulur.


conversation_starters

KeyTypeDescriptionExample
conversation_startersArray of StringsBu Model Specs seçildiğinde sohbet giriş ekranında tıklanabilir kartlar olarak gösterilen önerilen başlangıç istemleri.No default. Optional.

Açıklama: Sohbet başlatıcılar, kullanıcılara bir Model Specs için özel olarak hazırlanmış ilk istemleri sunar. Seçilen spec için boş sohbet açılış sayfasında gösterilirler ve özellikle showOnLanding markalaması ile birlikte kullanıldıklarında oldukça faydalıdırlar. Bir başlatıcıya tıklandığında, bu ifade yeni bir sohbetin ilk mesajı olarak gönderilir.

  • Ajan/asistan sınırıyla eşleşecek şekilde en fazla 4 başlangıç öğesi görüntülenir.
  • Eğer spesifikasyonun ön ayarı, kendi konuşma başlatıcılarını tanımlayan bir ajana veya asistana işaret ediyorsa, bunlar önceliklidir.

Örnek:

modelSpecs:
  list:
    - name: 'meeting-notes'
      label: 'Meeting Notes'
      showOnLanding: true
      conversation_starters:
        - 'Summarize this meeting transcript'
        - 'Create action items with owners and due dates'
      preset:
        endpoint: 'agents'
        model: 'gpt-4o'

showOnLanding

KeyTypeDescriptionExample
showOnLandingBooleanBu Model Specs etiketini ve açıklamasını, varsayılan karşılama mesajı yerine sohbet giriş ekranında gösterir.showOnLanding: true

Varsayılan: false

Bunu, seçilmiş bir Model Specs boş sohbet ekranını markalaması gerektiğinde kullanın. showOnLanding değeri true olarak ayarlanmadığı sürece mevcut Model Specs değişmeden kalır.

Örnek:

modelSpecs:
  list:
    - name: 'branded-assistant'
      label: 'Acme Research'
      description: '<span><img src="/assets/acme.svg" alt="Acme" /> Research with approved sources</span>'
      showOnLanding: true
      iconURL: '/assets/acme.svg'
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

group

KeyTypeDescriptionExample
groupStringUI seçicisindeki Model Specs öğelerini düzenlemek için isteğe bağlı grup adı. Spesifikasyonun menü hiyerarşisinde nerede görüneceğini kontrol eder.No default. Optional.
groupIconStringÖzel gruplar için isteğe bağlı simge. Bir URL veya yerleşik bir endpoint anahtarı (örneğin, "openAI", "groq") olabilir. Her grupta yalnızca groupIcon içeren ilk spec kullanılır.No default. Optional.

Açıklama: UI seçicisinde Model Specs'i düzenlemek için isteğe bağlı grup adı. group alanı, Model Specs'in nasıl düzenleneceği üzerinde esnek bir kontrol sağlar:

  • Eğer group bir endpoint adıyla eşleşiyorsa (örneğin, "openAI", "groq"): Model spec, seçici menüsünde ilgili endpoint'in altında iç içe geçmiş şekilde görünür.
  • Eğer group özel bir isimse (herhangi bir endpoint ile eşleşmiyorsa): Bu isimle ayrı, daraltılabilir bir bölüm oluşturur. Bu bölüm için özel bir simge ayarlamak isterseniz isteğe bağlı olarak groupIcon kullanabilirsiniz (URL veya "openAI" gibi yerleşik bir anahtar).
  • group belirtilmediyse: Model spec, en üst seviyede bağımsız bir öğe olarak görünür

Bu özellik, seçici menüsünün organizasyonel yapısını kaybetmeden modellere açıklamalar eklemek istediğinizde özellikle kullanışlıdır.


hideBadgeRow

KeyTypeDescriptionExample
hideBadgeRowBooleanSohbet oluşturucudaki bu Model Specs için araç rozeti satırını gizler.hideBadgeRow: true

Varsayılan: false

Küratörlü bir Model Specs öğesinin, besteleyicinin (composer) altındaki araç/yetenek rozetleri satırını göstermemesi gerektiğinde bunu kullanın.

Örnek:

modelSpecs:
  list:
    - name: 'general-assistant'
      label: 'General Assistant'
      hideBadgeRow: true
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o-mini'

Örnek:

modelSpecs:
  list:
    # Example 1: Nested under an endpoint
    # When group matches an endpoint name, the spec appears under that endpoint
    - name: 'gpt-4o-optimized'
      label: 'GPT-4 Optimized'
      description: 'Most capable GPT-4 model with multimodal support'
      group: 'openAI' # Appears nested under the OpenAI endpoint
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

    # Example 2: Custom group section with icon
    # When group is a custom name, it creates a separate collapsible section
    - name: 'coding-assistant'
      label: 'Coding Assistant'
      description: 'Specialized for coding tasks'
      group: 'My Assistants'
      groupIcon: 'https://example.com/icons/assistants.png' # Custom icon for the group
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

    # Multiple specs with the same group name are grouped together
    - name: 'writing-assistant'
      label: 'Writing Assistant'
      description: 'Specialized for creative writing'
      group: 'My Assistants' # Grouped with coding-assistant, uses its icon
      preset:
        endpoint: 'anthropic'
        model: 'claude-sonnet-4'

    # Example 3: Custom group using built-in icon
    - name: 'fast-model'
      label: 'Fast Model'
      group: 'Fast Models'
      groupIcon: 'groq' # Uses built-in Groq icon
      preset:
        endpoint: 'groq'
        model: 'llama3-8b-8192'

    # Example 4: Standalone (no group)
    # When group is omitted, the spec appears at the top level
    - name: 'general-assistant'
      label: 'General Assistant'
      description: 'General purpose assistant'
      # No group field - appears as standalone item at top level
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o-mini'

showIconInMenu

KeyTypeDescriptionExample
showIconInMenuBooleanModelin simgesinin başlık açılır menüsünde görünüp görünmeyeceğini kontrol eder.

Açıklama:
Modelin simgesinin başlık açılır menüsünde görünüp görünmeyeceğini kontrol eder. Varsayılan değer true şeklindedir.


showIconInHeader

KeyTypeDescriptionExample
showIconInHeaderBooleanModelin simgesinin, adının solunda yer alan başlık açılır menü düğmesinde görünüp görünmeyeceğini kontrol eder.

Açıklama:
Modelin simgesinin, başlık açılır menü düğmesinde, adının solunda görünüp görünmeyeceğini kontrol eder. Varsayılan değer true şeklindedir.


authType

KeyTypeDescriptionExample
authTypeStringModel spec için gerekli kimlik doğrulama türü.Optional. Possible values: "override_auth", "user_provided", "system_defined"

Açıklama:
Model spec için gerekli kimlik doğrulama türü. Kimlik doğrulamanın geçersiz kılınıp kılınmayacağını, kullanıcı tarafından mı sağlanacağını yoksa sistem tarafından mı tanımlanacağını belirler.


webSearch

KeyTypeDescriptionExample
webSearchBooleanBu Model Specs için web arama özelliğini etkinleştirir.When true, the model can perform web searches.

Açıklama:
Bu Model Specs için web arama özelliğini etkinleştirir. true olarak ayarlandığında, model güncel bilgileri almak için web araması gerçekleştirebilir.

Örnek:

modelSpecs:
  list:
    - name: 'research-assistant'
      label: 'Research Assistant'
      webSearch: true
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

fileSearch

KeyTypeDescriptionExample
fileSearchBooleanBu Model Specs için dosya arama özelliğini etkinleştirir.When true, the model can search through uploaded files.

Açıklama:
Bu Model Specs için dosya arama özelliğini etkinleştirir. true olarak ayarlandığında, model yüklenen dosyalar içinde arama yapabilir ve bu dosyalara referans verebilir.

Örnek:

modelSpecs:
  list:
    - name: 'document-analyst'
      label: 'Document Analyst'
      fileSearch: true
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

executeCode

KeyTypeDescriptionExample
executeCodeBooleanBu Model Specs için kod yürütme özelliğini etkinleştirir.When true, the model can execute code.

Açıklama:
Bu Model Specs için kod yürütme özelliğini etkinleştirir. true olarak ayarlandığında, model korumalı bir ortamda kod yürütebilir.

Örnek:

modelSpecs:
  list:
    - name: 'code-assistant'
      label: 'Code Assistant'
      executeCode: true
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

mcpServers

KeyTypeDescriptionExample
mcpServersArray of StringsBu Model Specs için etkinleştirilecek Model Context Protocol (MCP) sunucu adlarının listesi.Each string should match a configured MCP server name.

Açıklama:
Bu Model Specs için etkinleştirilecek Model Context Protocol (MCP) sunucu adlarının listesi. MCP sunucuları, özel araçlar ve kaynaklarla modelin yeteneklerini genişletir.

Örnek:

modelSpecs:
  list:
    - name: 'enhanced-assistant'
      label: 'Enhanced Assistant'
      mcpServers:
        - 'filesystem'
        - 'sequential-thinking'
        - 'fetch'
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

skills

KeyTypeDescriptionExample
skillsBoolean or Array of StringsBu Model Specs için Yetenekleri (Skills) kontrol eder. Kullanıcının aktif erişilebilir kataloğu için true, Yetenekleri zorunlu olarak kapatmak için false veya katı bir izin listesi olarak Yetenek adlarından oluşan bir dizi kullanın.skills: ["brand-guidelines", "code-review"]

Açıklama:

Agents endpoint Skills özelliği mevcut olduğunda bu Model Specs için Skills'i kontrol eder.

  • true: kullanıcının aktif erişilebilir Beceri kataloğunu etkinleştirir.
  • false: bu Model Specs için Skills özelliğini devre dışı bırakır.
  • Beceri adlarından oluşan dizi: belirtilen Beceriler için kataloğu daraltır, manuel çağırmayı sağlar ve her zaman uygulama çözümlemesi yapar.

Örnek:

modelSpecs:
  list:
    - name: 'brand-assistant'
      label: 'Brand Assistant'
      skills:
        - 'brand-guidelines'
        - 'approved-claims'
      preset:
        endpoint: 'agents'
        model: 'gpt-4o'

subagents

KeyTypeDescriptionExample
subagents.enabledBooleanBu Model Specs'ten oluşturulan geçici aracılar için Subagents özelliğini etkinleştirir.enabled: true
subagents.allowSelfBooleanGeçici ajanın, odaklanmış çalışma için kendisinin yalıtılmış bir kopyasını oluşturmasına olanak tanır.allowSelf: true
subagents.agent_idsArray of StringsBu model spesifikasyonunun oluşturabileceği ek agent ID'lerinin özel sunucu tarafı izin listesi.agent_ids: []

Açıklama:

Bu model spec'ten oluşturulan geçici (ephemeral) aracılar için Subagents'ı kontrol eder. Bunu, kullanıcıların kalıcı bir üst aracı oluşturmasını veya seçmesini gerektirmeden, küratörlü bir model spec'in delegasyon davranışını sergilemesini istediğinizde kullanın.

  • enabled: bu Model Specs için alt aracı (subagent) oluşturma aracını ekler.
  • allowSelf: geçici ajanın kendisinin yalıtılmış yeni bir kopyasını oluşturmasına izin verir.
  • agent_ids: ek alt temsilciler olarak belirli kalıcı temsilcilere izin verir. Bu liste MAX_SUBAGENTS ile sınırlandırılmıştır ve sunucu tarafında kalır; istemcilere gönderilen başlangıç yapılandırması yalnızca herkese açık enabled ve allowSelf bayraklarını içerir.

Model Specs zorunlu kılındığında, model spec'in subagents ayarları, istek yükü (payload) değerlerine göre yetkili kılınır.

Örnek:

modelSpecs:
  list:
    - name: 'research-assistant'
      label: 'Research Assistant'
      subagents:
        enabled: true
        allowSelf: true
        agent_ids: []
      preset:
        endpoint: 'agents'
        model: 'gpt-4o'

artifacts

KeyTypeDescriptionExample
artifactsString | BooleanBu Model Specs için Artifacts özelliğini etkinleştirir ve isteğe bağlı olarak artifact modunu ayarlar.Set to `true` to enable with the default mode, `false` or omit to disable, or a specific mode string (e.g., `"default"`) to enable with that mode.

Açıklama:
Bu Model Specs için Artifacts özelliğini etkinleştirir; bu sayede modelin React bileşenleri, HTML ve Mermaid diyagramları gibi etkileşimli artifact'ler oluşturmasına ve görüntülemesine olanak tanır. true olarak ayarlandığında, varsayılan artifact modu kullanılır. Ayrıca doğrudan bir mod dizgisi de belirtebilirsiniz.

Örnek:

modelSpecs:
  list:
    - name: 'artifact-assistant'
      label: 'Artifact Assistant'
      artifacts: true
      preset:
        endpoint: 'openAI'
        model: 'gpt-4o'

preset

KeyTypeDescriptionExample
presetObjectModelin davranışını ve yeteneklerini tanımlayan ayrıntılı ön ayar yapılandırmaları.See "Preset Object Structure" below.

Açıklama:
Modelin davranışını ve yeteneklerini tanımlayan ayrıntılı ön ayar yapılandırmaları (aşağıdaki Preset Object Structure bölümüne bakın).


Ön Ayar Alanları

modelSpecs.list öğesi için preset alanı, sistem içindeki AI modellerine yönelik kapsamlı bir yapılandırma planından oluşur. Bu alan, AI modellerinin operasyonel ayarlarını belirlemek, davranışlarını, çıktılarını ve diğer sistem bileşenleri ve endpoint'ler ile olan etkileşimlerini özelleştirmek için tasarlanmıştır.

Sistem Seçenekleri

endpoint

Gerekli

Kabul Edilen Değerler:

  • openAI
  • azureOpenAI
  • google
  • anthropic
  • assistants
  • azureAssistants
  • bedrock
  • agents

Not: Özel bir endpoint kullanıyorsanız, endpoint değeri tanımlanan özel endpoint adı ile tam olarak eşleşmelidir.

KeyTypeDescriptionExample
endpointEnum (EModelEndpoint) or String (nullable)Modelin işlemleri gerçekleştirmek için iletişim kurduğu endpoint'i belirtir. Bu ayar, modelin arayüz oluşturduğu harici veya dahili hizmeti belirler.

Örnek:

preset:
  endpoint: 'openAI'

modelLabel

KeyTypeDescriptionExample
modelLabelString (nullable)Kullanıcı arayüzlerinde veya günlüklerde modeli tanımlamak için kullanılan etiket. Arayüzde görüntülenen ve ayrıca yapay zekaya tanıtılan, model için insan tarafından okunabilir bir ad sağlar.None

Varsayılan: None

Örnek:

preset:
  modelLabel: 'Customer Support Bot'

greeting

KeyTypeDescriptionExample
greetingStringYeni bir sohbet başlatılmadan önce arayüzde görünen önceden tanımlanmış bir mesaj. Bu, kullanıcıya talimatlar vermek veya arayüzü daha samimi ve erişilebilir kılmak için iyi bir yoldur.

Varsayılan: None

Örnek:

preset:
  greeting: 'This assistant creates meeting notes based on transcripts of Teams recordings. To start, simply paste the transcript into the chat box.'

promptPrefix

KeyTypeDescriptionExample
promptPrefixString (nullable)Modele gönderilen her istemin başına eklenen ve yanıtlar için tutarlı bir bağlam oluşturan statik bir metin.When using "assistants" as the endpoint, this becomes the OpenAI field `additional_instructions`.

Varsayılan: None

Örnek 1:

preset:
  promptPrefix: 'As a financial advisor, ...'

Örnek 2:

preset:
  promptPrefix: |
    Based on the transcript, create coherent meeting minutes for a business meeting. Include the following sections:
    - Date and Attendees
    - Agenda
    - Minutes
    - Action Items

    Focus on what items were discussed and/or resolved. List any open action items.
    The format should be a bulleted list of high level topics in chronological order, and then one or more concise sentences explaining the details.
    Each high level topic should have at least two sub topics listed, but add as many as necessary to support the high level topic. 

    - Do not start items with the same opening words.

    Take a deep breath and be sure to think step by step.

resendFiles

KeyTypeDescriptionExample
resendFilesBooleanKalıcı oturumların sürdürülmediği senaryolarda dosyaların yeniden gönderilip gönderilmeyeceğini belirtir.

Varsayılan: true

Örnek:

preset:
  resendFiles: true

imageDetail

Kabul Edilen Değerler:

  • düşük
  • otomatik
  • yüksek
KeyTypeDescriptionExample
imageDetailEnum (eImageDetailSchema)Görüntü analizi görevlerinde gereken ayrıntı düzeyini belirtir, görsel yeteneklere sahip modeller için geçerlidir (OpenAI spesifikasyonu).

Varsayılan: "auto"

Örnek:

preset:
  imageDetail: 'high'

maxContextTokens

KeyTypeDescriptionExample
maxContextTokensNumberModele sağlanacak maksimum bağlam belirteci (context token) sayısı.Useful if you want to limit the maximum context for this preset.

Örnek:

preset:
  maxContextTokens: 4096

Ajan Seçenekleri

Bu seçeneklerin yalnızca agents endpoint kullanıldığında geçerli olduğunu unutmayın.

Herhangi bir model seçeneğini hariç tutmalı ve arayüzde tanımlandığı şekliyle temsilcinin (agent) yapılandırmasına başvurmalısınız.

Ajan Erişim Filtreleme (v0.8.0+)

v0.8.0 itibarıyla LibreChat, ajanlar için ACL (Erişim Denetim Listesi) tabanlı bir izin sistemi kullanmaktadır. Model Specs ajanları kullanacak şekilde yapılandırıldığında, kullanıcının erişim izni olmayan tüm ajanlar, model spec içinde yapılandırılmış olsalar dahi otomatik olarak filtrelenir. Bu, kullanıcıların yalnızca uygun izinlere sahip oldukları ajanları görmelerini ve kullanabilmelerini sağlar.

ACL izin sistemi hakkında daha fazla bilgi için Agents belgelerine bakın.


agent_id

KeyTypeDescriptionExample
agent_idStringBir asistanın tanımlanması.

Örnek:

preset:
  agent_id: 'agent_someUniqueId'

Asistan Seçenekleri

Bu seçeneklerin yalnızca assistants veya azureAssistants endpoint'i kullanılırken geçerli olduğunu unutmayın.

Agents kısmına benzer şekilde, herhangi bir model seçeneğini hariç tutmalı ve asistanın yapılandırmasına güvenmelisiniz.


assistant_id

KeyTypeDescriptionExample
assistant_idStringBir asistanın tanımlanması.

Örnek:

preset:
  assistant_id: 'asst_someUniqueId'

instructions

Not: bu, mevcut çalıştırmalar için mevcut asistan talimatlarını geçersiz kıldığından promptPrefix öğesinden farklıdır.

Bunu yalnızca asistanın temel talimatlarını geçersiz kılmak istiyorsanız kullanın.

additional_instructions için promptPrefix kullanın.

Daha fazla bilgi:

KeyTypeDescriptionExample
instructionsStringAsistanın varsayılan talimatlarını geçersiz kılar.

Örnek:

preset:
  instructions: 'Please handle customer queries regarding order status.'

append_current_datetime

Her çalıştırma için additional_instructions kısmına güncel tarih ve saati ekler. promptPrefix değerinin üzerine yazmaz, ona ekleme yapar.

KeyTypeDescriptionExample
append_current_datetimeBoolean`promptPrefix` tarafından tanımlandığı şekilde `additional_instructions` kısmına güncel tarih ve saati ekler

Örnek:

preset:
  append_current_datetime: true

Model Seçenekleri

Not: Aşağıdaki her parametre, hangi endpoint'lerin bunu desteklediğine dair bir not içerir.
OpenAI / AzureOpenAI / Custom genellikle temperature, presence_penalty, frequency_penalty, stop, top_p, max_tokens parametrelerini destekler.
Google / Anthropic genellikle topP, topK, maxOutputTokens parametrelerini destekler; Google ayrıca desteklenen Gemini metin modellerinde url_context özelliğini de destekler. Anthropic / OpenRouter / Bedrock (Anthropic ve Nova modelleri) promptCache ve promptCacheTtl parametrelerini destekler. Bedrock region, maxTokens ve diğer birkaç parametreyi destekler.

model

Destekleyenler: Tüm endpoint'ler (agents hariç)

KeyTypeDescriptionExample
modelString (nullable)Ön ayar için kullanılacak model adı; seçilen endpoint altında yapılandırılmış bir modelle eşleşmelidir.None

Varsayılan: None

Örnek:

preset:
  model: 'gpt-4-turbo'

temperature

Destekleyenler: openAI, azureOpenAI, google (temperature olarak), anthropic (temperature olarak) ve özel (OpenAI benzeri)

KeyTypeDescriptionExample
temperatureNumberModel yanıtlarının ne kadar belirleyici veya “yaratıcı” olacağını kontrol eder.

Örnek:

preset:
  temperature: 0.7

presence_penalty

Destekleyenler: openAI, azureOpenAI, özel (OpenAI benzeri)
Genellikle Google/Anthropic/Bedrock tarafından kullanılmaz

KeyTypeDescriptionExample
presence_penaltyNumberTekrarlayan belirteçler için ceza, yeni konuların keşfedilmesini teşvik eder.

Örnek:

preset:
  presence_penalty: 0.3

frequency_penalty

Destekleyenler: openAI, azureOpenAI, özel (OpenAI benzeri)
Genellikle Google/Anthropic/Bedrock tarafından kullanılmaz

KeyTypeDescriptionExample
frequency_penaltyNumberTekrarlanan belirteçler için ceza, yanıtlardaki fazlalığı azaltır.

Örnek:

preset:
  frequency_penalty: 0.5

stop

Destekleyenler: openAI, azureOpenAI, özel (OpenAI benzeri)
Genellikle Google/Anthropic/Bedrock tarafından kullanılmaz

KeyTypeDescriptionExample
stopArray of StringsModel için durdurma belirteçleri; karşılaşıldığında yanıtı sonlandırması talimatını verir.

Örnek:

preset:
  stop:
    - 'END'
    - 'STOP'

top_p

Desteklenenler: openAI, azureOpenAI, özel (OpenAI benzeri)
Google/Anthropic genellikle top_p yerine topP (büyük “P” ile) kullanır.

KeyTypeDescriptionExample
top_pNumberNucleus örnekleme parametresi (0-1), token rastgeleliğini kontrol eder.

Örnek:

preset:
  top_p: 0.9

topP

Destekleyenler: google & anthropic
(top_p ile benzer bir amaca sahiptir, ancak bu API'lerde farklı şekilde adlandırılmıştır)

KeyTypeDescriptionExample
topPNumberGoogle/Anthropic endpoint'leri için Nucleus sampling parametresi.

Örnek:

preset:
  topP: 0.8

topK

Destekleyenler: google & anthropic
(bir sonraki token dağılımı üzerinde k-sampling sınırı)

KeyTypeDescriptionExample
topKNumberBir sonraki token seçimini en üstteki K token ile sınırlar.

Örnek:

preset:
  topK: 40

max_tokens

Destekleyenler: openAI, azureOpenAI, özel (OpenAI benzeri)
Google/Anthropic için (endpoint'e bağlı olarak) maxOutputTokens veya maxTokens kullanın.

KeyTypeDescriptionExample
max_tokensNumberModel yanıtındaki maksimum token sayısı.

Örnek:

preset:
  max_tokens: 4096

maxOutputTokens

Destekleyenler: google, anthropic
Bu sağlayıcılar için max_tokens ile eşdeğerdir.

KeyTypeDescriptionExample
maxOutputTokensNumberYanıt içindeki maksimum token sayısı (Google/Anthropic).

Örnek:

preset:
  maxOutputTokens: 2048

promptCache

Destekleyenler: anthropic, OpenRouter özel endpoint'leri, bedrock (Anthropic ve Nova modelleri) (Sağlayıcı istem önbelleğe almayı aç/kapat)

KeyTypeDescriptionExample
promptCacheBooleanSağlayıcı istem önbelleğe almayı etkinleştirir veya devre dışı bırakır.

Varsayılan: true

Örnek:

preset:
  promptCache: true

Not: Bedrock endpoint'leri için, Claude ve Nova modellerinde prompt caching otomatik olarak etkindir. Bunu açıkça devre dışı bırakmak için promptCache: false ayarını yapın.


promptCacheTtl

Destekleyenler: anthropic, OpenRouter özel endpoint'leri, bedrock (Anthropic ve Nova modelleri) (İstem önbelleğe alma etkinleştirildiğinde istem önbelleği ömrünü ayarlar)

KeyTypeDescriptionExample
promptCacheTtlEnumPrompt-cache ömrünü ayarlar. Desteklenen değerler `5m` ve `1h` şeklindedir.Provider or SDK default

Kabul Edilen Değerler:

  • 5m
  • 1h

Örnek:

preset:
  promptCache: true
  promptCacheTtl: '1h'

Not: promptCacheTtl, prompt önbelleğe alma devre dışı bırakıldığında yoksayılır. Belirtilmediğinde, sağlayıcı entegrasyonu kendi varsayılan prompt-cache ömrünü kullanır.


reasoning_effort

Kabul Edilen Değerler:

  • "" (boş dizge — ayarlanmamış, API varsayılanını kullanır)
  • "none"
  • "minimal"
  • "low"
  • "medium"
  • "high"
  • "xhigh" (ekstra yüksek)

Desteklenenler: openAI, azureOpenAI, özel (OpenAI benzeri), bedrock (ZAI, MoonshotAI modelleri)

KeyTypeDescriptionExample
reasoning_effortStringModel için muhakeme çabası seviyesini kontrol eder. Muhakeme çabasını azaltmak, daha hızlı yanıtlar ve muhakeme için daha az token kullanımı sağlayabilir. `xhigh` seçeneği, karmaşık problemler için maksimum muhakeme yeteneği sunar. Bedrock için kabul edilen değerler `low`, `medium`, `high` şeklindedir.

Varsayılan: "" (ayarlanmamış)

Örnek:

preset:
  reasoning_effort: 'low'

reasoning_summary

Kabul Edilen Değerler:

  • "" (boş dizge — düşünme özetlerini devre dışı bırakır)
  • "auto"
  • "concise"
  • "detailed"

Desteklenenler: openAI, azureOpenAI, özel (OpenAI benzeri)

KeyTypeDescriptionExample
reasoning_summaryStringModel için düşünme özeti tercihlerini ayarlar.

Varsayılan: "" (devre dışı)

Örnek:

preset:
  reasoning_summary: 'detailed'

useResponsesApi

Desteklenenler: openAI, azureOpenAI, özel (OpenAI benzeri)

KeyTypeDescriptionExample
useResponsesApiBooleanModel için yanıtlar API'sini etkinleştirir veya devre dışı bırakır.

Varsayılan: false

Örnek:

preset:
  useResponsesApi: true

verbosity

Kabul Edilen Değerler:

  • "" (boş dizge — ayarlanmamış, API varsayılanını kullanır)
  • "low"
  • "medium"
  • "high"

Desteklenenler: openAI, azureOpenAI, özel (OpenAI benzeri)

KeyTypeDescriptionExample
verbosityStringModel yanıtlarının ayrıntı düzeyini kontrol eder.

Varsayılan: "" (ayarlanmamış)

Örnek:

preset:
  verbosity: 'low'

Desteklenenler: openAI, azureOpenAI, özel (OpenAI benzeri), google, anthropic

KeyTypeDescriptionExample
web_searchBooleanModel için web arama işlevini etkinleştirir veya devre dışı bırakır.

Varsayılan: false

Not: Google endpoint'leri için bu parametre, gerçek panelde Grounding with Google Search olarak görünür ancak uygulamada web_search değerini kontrol eder.

Örnek:

preset:
  web_search: true

url_context

Destekleyenler: Gemini 2.5+ ve Gemini 3.x dahil olmak üzere desteklenen Gemini metin modellerinde google

KeyTypeDescriptionExample
url_contextBooleanModelin kullanıcı mesajında yer alan URL'leri okuyabilmesi için Google URL Context'i etkinleştirir. YouTube bağlantıları, mümkün olduğunda yerel video anlama girdilerine dönüştürülür.

Varsayılan: false

Örnek:

preset:
  url_context: true

disableStreaming

Desteklenenler: openAI, azureOpenAI, özel (OpenAI benzeri)

KeyTypeDescriptionExample
disableStreamingBooleanModelden gelen yanıtların akışını devre dışı bırakır.

Varsayılan: false

Örnek:

preset:
  disableStreaming: true

thinkingBudget

Destekleyenler: google, anthropic, bedrock (Anthropic modelleri)

KeyTypeDescriptionExample
thinkingBudgetNumber or StringModelin içsel muhakeme için kullanabileceği düşünme belirteci (thinking token) sayısını kontrol eder. Daha büyük bütçeler, karmaşık problemler için yanıt kalitesini artırabilir.

Varsayılan: "Auto (-1)" (Google), 2000 (Anthropic, Bedrock (Anthropic modelleri))

Örnek:

preset:
  thinkingBudget: '2000'

thinkingLevel

Destekleyen: google (Gemini 3+ modelleri)

KeyTypeDescriptionExample
thinkingLevelStringGemini 3+ modelleri için düşünme çabası seviyesini kontrol eder. Gemini 2.5 modelleri bunun yerine `thinkingBudget` kullanır.

Kabul Edilen Değerler:

  • "" (ayarlanmamış/otomatik)
  • "minimal"
  • "low"
  • "medium"
  • "high"

Varsayılan: "" (ayarlanmamış — model karar verir)

Örnek:

preset:
  thinkingLevel: 'medium'

effort

Destekleyenler: anthropic, bedrock (Anthropic modelleri)

KeyTypeDescriptionExample
effortStringDesteklenen Anthropic modelleri (örneğin, Claude Opus 4.6+ ve Claude Fable/Mythos sınıfı modeller) için Adaptive Thinking çaba düzeyini kontrol eder. Daha yüksek çaba düzeyleri, karmaşık problemler için daha fazla düşünme token'ı ayırır.

Seçenekler: "" (ayarlanmamış/otomatik), "low", "medium", "high", "xhigh", "max"

Varsayılan: "" (ayarlanmamış — model karar verir)

Örnek:

preset:
  effort: 'high'

thinkingDisplay

Destekleyenler: anthropic, bedrock (Anthropic modelleri)

KeyTypeDescriptionExample
thinkingDisplayStringModel yanıtlarında düşünme içeriğinin döndürülüp döndürülmeyeceğini kontrol eder. Claude Opus 4.7+ ve Claude Fable/Mythos sınıfı modeller varsayılan olarak düşünme içeriğini çıkarır; bu ayar, düşünme özetlerini dahil etmenize veya bunları açıkça devre dışı bırakmanıza olanak tanır.

Seçenekler: "auto" (varsayılan), "summarized", "omitted"

  • "auto" — LibreChat karar verir: varsayılan olarak düşünme sürecini atlayan modeller için (Opus 4.7+ ve Fable/Mythos sınıfı) "summarized" seçeneğini etkinleştirir, daha eski modeller için ise alanı boş bırakır
  • "summarized" — her zaman muhakemenin post-hoc bir özetini talep eder
  • "omitted" — her zaman düşünme içeriğini bastırır (biraz daha düşük gecikme süresi)

Varsayılan: "auto"

Örnek:

preset:
  thinkingDisplay: 'summarized'

thinking

Destekleyenler: google, anthropic, bedrock (Anthropic modelleri)

KeyTypeDescriptionExample
thinkingBooleanModelin yanıt oluşturmadan önce düşünmeye zaman ayırıp ayırmayacağını belirtir.

Varsayılan: true

Örnek:

preset:
  thinking: true

region

Destekleyen: bedrock
(Amazon Bedrock için bir AWS bölgesi belirtmek amacıyla kullanılır)

KeyTypeDescriptionExample
regionStringAmazon Bedrock endpoint'leri için AWS bölgesi.

Örnek:

preset:
  region: 'us-east-1'

maxTokens

Destekleyen: bedrock
(max_tokens yerine kullanılır)

KeyTypeDescriptionExample
maxTokensNumberAmazon Bedrock endpoint'leri için maksimum çıktı token sayısı.

Örnek:

preset:
  maxTokens: 1024

Bu rehber nasıl?