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

Objectstructuur van Model Specs

Overzicht

Het modelSpecs object helpt je bij het bieden van een eenvoudigere UI-ervaring voor AI-modellen binnen je applicatie.

Er zijn 3 hoofdvelden onder modelSpecs:

  • enforce (optioneel; standaard: false)
  • prioritize (optioneel; standaard: true)
  • list (vereist)
  • addedEndpoints (optioneel)

Opmerkingen:

  • Als enforce is ingesteld op true, kunnen Model Specs potentieel conflicteren met andere interface-instellingen zoals modelSelect, presets en parameters.
  • De list array bevat gedetailleerde configuraties voor elk model, inclusief presets die specifiek gedrag, uiterlijk en mogelijkheden bepalen.
  • Als interface velden niet zijn opgegeven in de configuratie, zal het hebben van een lijst met Model Specs de volgende interface-elementen uitschakelen:
    • modelSelect
    • parameters
    • presets
  • Als je deze interface-elementen samen met Model Specs wilt inschakelen, kun je ze op true zetten in het interface object.

Beheer van door gebruikers verstrekte API-sleutels met Model Specs

Wanneer Model Specs modelSelect uitschakelen, wordt de vervolgkeuzelijst voor endpoints — en het tandwielpictogram dat het dialoogvenster Set API Key opent — verborgen. Gebruikers kunnen nog steeds sleutels instellen of roteren voor elk endpoint dat is geconfigureerd met apiKey: "user_provided" via Settings → Data controls → API keys.

Die lijst is beperkt tot de endpoints die een gebruiker daadwerkelijk kan bereiken: de endpoints waarnaar wordt verwezen door je Model Specs, plus alle addedEndpoints. Wanneer het agents endpoint bereikbaar is, bevat het ook de agent allowedProviders (of elke geconfigureerde provider wanneer allowedProviders niet is ingesteld).

Voorbeeld

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.

Top-level velden

enforce

KeyTypeDescriptionExample
enforceBooleanBepaalt of de Model Specs strikt voorrang moeten krijgen op andere configuratie-instellingen.Setting this to `true` can lead to conflicts with interface options if not managed carefully.

Standaard: false

Voorbeeld:

modelSpecs:
  enforce: true

prioritize

KeyTypeDescriptionExample
prioritizeBooleanGeeft aan of Model Specs voorrang moeten krijgen op de standaardconfiguratie wanneer beide van toepassing zijn.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.

Standaard: true

Voorbeeld:

modelSpecs:
  prioritize: false

addedEndpoints

KeyTypeDescriptionExample
addedEndpointsArray of StringsStaat toe dat specifieke endpoints (bijv. "openAI", "google") selecteerbaar zijn in de UI naast de gedefinieerde Model Specs.Requires `interface.modelSelect` to be `true`. If this field is used and `interface.modelSelect` is not explicitly set, `modelSelect` will default to `true`.

Standaard: [] (lege lijst)

Let op: Moet een van de volgende zijn:

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

Voorbeeld:

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

list

Vereist

KeyTypeDescriptionExample
listArray of ObjectsBevat een lijst met individuele Model Specs die verschillende configuraties en gedragingen specificeren.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 (List Item)

Binnen elke Model Spec, of elk list-item, kun je de volgende velden configureren:


name

KeyTypeDescriptionExample
nameStringUnieke identificatie voor het model.No default. Must be specified.

Beschrijving: Unieke identificatiecode voor het model.


label

KeyTypeDescriptionExample
labelStringEen gebruiksvriendelijke naam of label voor het model, getoond in de dropdown in de header.No default. Optional.

Beschrijving: Een gebruiksvriendelijke naam of label voor het model, getoond in de vervolgkeuzelijst in de koptekst.


default

KeyTypeDescriptionExample
defaultBooleanGeeft aan of deze Model Specs de standaardselectie zijn, die automatisch wordt geselecteerd bij elke nieuwe chat.

Beschrijving:
Geeft aan of deze Model Specs de standaardselectie is, die automatisch wordt geselecteerd bij elke nieuwe chat.


softDefault

KeyTypeDescriptionExample
softDefaultBooleanGeeft aan of deze Model Specs alleen moeten worden geselecteerd voor nieuwe gebruikers die nog geen model, Model Specs of agent hebben gekozen.

Beschrijving:

Specificeert een standaardinstelling voor de eerste keer opstarten zonder de latere selecties van een gebruiker te overschrijven. Gebruik softDefault wanneer je nieuwe gebruikers wilt begeleiden naar een samengestelde spec, terwijl de keuze van de gebruiker behouden blijft nadat ze een ander model, spec of agent hebben gekozen.

Het bekijken van een oudere conversatie die een soft-default spec gebruikte, stelt die spec niet opnieuw in als de standaard van de gebruiker nadat deze een andere selectie heeft gemaakt.

Voorbeeld:

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

iconURL

KeyTypeDescriptionExample
iconURLStringURL of een vooraf gedefinieerde endpoint-naam voor het icoon van het model in de selector, header en conversation branding.No default. Optional.

Beschrijving:
URL of een vooraf gedefinieerde endpoint-naam voor het icoon van het model in de selector, header en conversatie-branding. Gebruik showIconInMenu en showIconInHeader om te bepalen waar het icoon wordt weergegeven.


description

KeyTypeDescriptionExample
descriptionStringEen korte beschrijving van het model en het beoogde gebruik of de rol ervan, weergegeven in de modelkiezer en optioneel op de landingspagina van de chat.No default. Optional.

Description: Een korte beschrijving van het model en het beoogde gebruik of de rol ervan, weergegeven in de modelkiezer. Als showOnLanding op true staat, wordt dezelfde beschrijving ook getoond op de chat-landingspagina onder het spec-label.

Platte tekstbeschrijvingen worden weergegeven als tekst. Beschrijvingen die beginnen met < worden weergegeven via de config HTML-sanitizer, wat veilige inline markup en media zoals kleine iconen toestaat.


conversation_starters

KeyTypeDescriptionExample
conversation_startersArray of StringsVoorgestelde startprompts die als klikbare kaarten op de chat-landingspagina worden getoond wanneer deze Model Specs zijn geselecteerd.No default. Optional.

Beschrijving: Conversation starters bieden gebruikers samengestelde eerste prompts voor een Model Specs. Ze worden getoond op de lege chat-landingspagina voor de geselecteerde spec en zijn bijzonder nuttig met showOnLanding branding. Door op een starter te klikken, wordt deze ingediend als het eerste bericht van een nieuw gesprek.

  • Er worden maximaal 4 starters weergegeven, in overeenstemming met de limiet voor de agent/assistent.
  • Als de preset van de spec verwijst naar een agent of assistant die zijn eigen gespreksstarters definieert, dan krijgen deze voorrang.

Voorbeeld:

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
showOnLandingBooleanToont het label en de beschrijving van deze Model Specs op de chat-startpagina in plaats van de standaard begroeting.showOnLanding: true

Standaard: false

Gebruik dit wanneer een samengestelde Model Specs het eerste lege chat-scherm moet branden. Bestaande Model Specs blijven ongewijzigd, tenzij showOnLanding is ingesteld op true.

Voorbeeld:

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
groupStringOptionele groepsnaam voor het organiseren van Model Specs in de UI-selector. Bepaalt waar de spec in de menuhiërarchie verschijnt.No default. Optional.
groupIconStringOptioneel icoon voor aangepaste groepen. Kan een URL of een ingebouwde endpoint key zijn (bijv. "openAI", "groq"). Alleen de eerste spec met een groupIcon in elke groep wordt gebruikt.No default. Optional.

Beschrijving: Optionele groepsnaam voor het organiseren van Model Specs in de UI-selector. Het group veld biedt flexibele controle over hoe Model Specs worden georganiseerd:

  • Als group overeenkomt met een endpoint-naam (bijv. "openAI", "groq"): De Model Specs verschijnt genest onder dat endpoint in het selectiemenu
  • Als group een aangepaste naam is (komt niet overeen met een endpoint): Maakt een afzonderlijke inklapbare sectie met die naam aan. Je kunt optioneel groupIcon gebruiken om een aangepast icoon voor deze sectie in te stellen (URL of ingebouwde sleutel zoals "openAI").
  • Als group wordt weggelaten: De Model Specs verschijnt als een zelfstandig item op het hoogste niveau

Deze functie is bijzonder nuttig wanneer je beschrijvingen aan modellen wilt toevoegen zonder de organisatorische structuur van het keuzemenu te verliezen.


hideBadgeRow

KeyTypeDescriptionExample
hideBadgeRowBooleanVerbergt de rij met tool-badges voor deze Model Specs in de chat-composer.hideBadgeRow: true

Standaard: false

Gebruik dit wanneer een samengestelde Model Specs geen rij met tool-/mogelijkheden-badges onder de composer mag tonen.

Voorbeeld:

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

Voorbeeld:

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
showIconInMenuBooleanBepaalt of het icoon van het model in het vervolgkeuzemenu in de koptekst verschijnt.

Beschrijving:
Bepaalt of het icoon van het model in het vervolgkeuzemenu in de koptekst verschijnt. Standaard ingesteld op true.


showIconInHeader

KeyTypeDescriptionExample
showIconInHeaderBooleanBepaalt of het icoon van het model wordt weergegeven in de dropdown-knop in de header, links van de naam.

Beschrijving:
Bepaalt of het icoon van het model wordt weergegeven in de vervolgkeuzeknop in de koptekst, links van de naam. Standaard ingesteld op true.


authType

KeyTypeDescriptionExample
authTypeStringAuthenticatietype vereist voor de Model Specs.Optional. Possible values: "override_auth", "user_provided", "system_defined"

Beschrijving:
Authenticatietype vereist voor de Model Specs. Bepaalt of authenticatie wordt overschreven, verstrekt door de gebruiker of gedefinieerd door het systeem.


webSearch

KeyTypeDescriptionExample
webSearchBooleanSchakelt de zoekfunctie op het web in voor deze Model Specs.When true, the model can perform web searches.

Beschrijving:
Schakelt de mogelijkheid tot webzoeken in voor deze Model Specs. Wanneer ingesteld op true, kan het model webzoekopdrachten uitvoeren om actuele informatie op te halen.

Voorbeeld:

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

fileSearch

KeyTypeDescriptionExample
fileSearchBooleanSchakelt de bestandszoekfunctie in voor deze Model Specs.When true, the model can search through uploaded files.

Beschrijving:
Schakelt de mogelijkheid voor bestandszoekopdrachten in voor deze Model Specs. Wanneer ingesteld op true, kan het model geüploade bestanden doorzoeken en ernaar verwijzen.

Voorbeeld:

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

executeCode

KeyTypeDescriptionExample
executeCodeBooleanSchakelt de code-uitvoeringsmogelijkheid in voor deze Model Specs.When true, the model can execute code.

Beschrijving:
Schakelt de mogelijkheid tot code-uitvoering in voor deze Model Specs. Wanneer ingesteld op true, kan het model code uitvoeren in een geïsoleerde omgeving (sandbox).

Voorbeeld:

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

mcpServers

KeyTypeDescriptionExample
mcpServersArray of StringsLijst met MCP-servernamen die voor deze Model Specs moeten worden ingeschakeld.Each string should match a configured MCP server name.

Beschrijving:
Lijst met namen van Model Context Protocol (MCP) servers die voor deze Model Specs moeten worden ingeschakeld. MCP-servers breiden de mogelijkheden van het model uit met aangepaste tools en resources.

Voorbeeld:

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 StringsBeheert Skills voor deze Model Specs. Gebruik true voor de actieve toegankelijke catalogus van de gebruiker, false om Skills uit te schakelen, of een array van Skill-namen als een strikte allowlist.skills: ["brand-guidelines", "code-review"]

Beschrijving:

Beheert Skills voor deze Model Specs wanneer de Skills-functionaliteit van het Agents endpoint beschikbaar is.

  • true: schakelt de actieve toegankelijke Skill-catalogus van de gebruiker in.
  • false: schakelt Skills uit voor deze spec.
  • Array van Skill-namen: beperkt de catalogus, handmatige aanroepen en 'always-apply'-resolutie tot de genoemde Skills.

Voorbeeld:

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

subagents

KeyTypeDescriptionExample
subagents.enabledBooleanSchakelt de Subagents-functionaliteit in voor kortstondige agents die zijn gemaakt op basis van deze Model Specs.enabled: true
subagents.allowSelfBooleanStelt de kortstondige agent in staat om een geïsoleerde kopie van zichzelf aan te maken voor gericht werk.allowSelf: true
subagents.agent_idsArray of StringsPrivé server-side allowlist van aanvullende agent-ID's die deze Model Specs mag aanmaken.agent_ids: []

Beschrijving:

Beheert Subagents voor kortstondige agents die zijn aangemaakt vanuit deze Model Specs. Gebruik dit wanneer je wilt dat een samengestelde Model Spec delegatiegedrag blootstelt zonder dat gebruikers een blijvende bovenliggende agent hoeven aan te maken of te selecteren.

  • enabled: voegt de subagent spawn tool toe voor deze Model Specs.
  • allowSelf: staat de kortstondige agent toe om een nieuwe, geïsoleerde kopie van zichzelf aan te maken.
  • agent_ids: staat specifieke persistente agents toe als aanvullende subagents. Deze lijst is beperkt door MAX_SUBAGENTS en blijft aan de serverzijde; de opstartconfiguratie die naar clients wordt verzonden, bevat alleen de publieke enabled en allowSelf vlaggen.

Wanneer Model Specs worden afgedwongen, zijn de subagents instellingen van de Model Spec leidend boven de waarden in de request payload.

Voorbeeld:

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

artifacts

KeyTypeDescriptionExample
artifactsString | BooleanSchakelt de Artifacts-functionaliteit in voor deze Model Specs en stelt optioneel de artifact-modus in.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.

Beschrijving:
Schakelt de Artifacts-functionaliteit in voor deze Model Specs, waardoor het model interactieve artifacts zoals React-componenten, HTML en Mermaid-diagrammen kan genereren en weergeven. Wanneer ingesteld op true, wordt de standaard artifact-modus gebruikt. Je kunt ook direct een modus-string opgeven.

Voorbeeld:

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

preset

KeyTypeDescriptionExample
presetObjectGedetailleerde preset-configuraties die het gedrag en de mogelijkheden van het model definiëren.See "Preset Object Structure" below.

Beschrijving:
Gedetailleerde preset-configuraties die het gedrag en de mogelijkheden van het model definiëren (zie Preset Object Structure hieronder).


Preset-velden

Het preset veld voor een modelSpecs.list item bestaat uit een uitgebreid configuratieontwerp voor AI-modellen binnen het systeem. Het is ontworpen om de operationele instellingen van AI-modellen te specificeren, waarbij hun gedrag, output en interacties met andere systeemcomponenten en endpoint worden afgestemd.

Systeemopties

endpoint

Vereist

Geaccepteerde waarden:

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

Let op: Als u een custom endpoint gebruikt, moet de endpoint waarde exact overeenkomen met de gedefinieerde custom endpoint name.

KeyTypeDescriptionExample
endpointEnum (EModelEndpoint) or String (nullable)Specificeert het endpoint waarmee het model communiceert om bewerkingen uit te voeren. Deze instelling bepaalt de externe of interne service waarmee het model een interface vormt.

Voorbeeld:

preset:
  endpoint: 'openAI'

modelLabel

KeyTypeDescriptionExample
modelLabelString (nullable)Het label dat wordt gebruikt om het model te identificeren in gebruikersinterfaces of logboeken. Het biedt een voor mensen leesbare naam voor het model, die wordt weergegeven in de UI en ook bekend wordt gemaakt aan de AI.None

Standaard: None

Voorbeeld:

preset:
  modelLabel: 'Customer Support Bot'

greeting

KeyTypeDescriptionExample
greetingStringEen vooraf gedefinieerd bericht dat zichtbaar is in de UI voordat een nieuwe chat wordt gestart. Dit is een goede manier om instructies aan de gebruiker te geven, of om de interface vriendelijker en toegankelijker te maken.

Standaard: None

Voorbeeld:

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)Een statische tekst die aan elke prompt wordt toegevoegd die naar het model wordt gestuurd, om een consistente context voor antwoorden in te stellen.When using "assistants" as the endpoint, this becomes the OpenAI field `additional_instructions`.

Standaard: None

Voorbeeld 1:

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

Voorbeeld 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
resendFilesBooleanGeeft aan of bestanden opnieuw moeten worden verzonden in scenario's waarin persistente sessies niet worden onderhouden.

Standaard: true

Voorbeeld:

preset:
  resendFiles: true

imageDetail

Geaccepteerde waarden:

  • laag
  • auto
  • hoog
KeyTypeDescriptionExample
imageDetailEnum (eImageDetailSchema)Specificeert het detailniveau dat vereist is voor beeldanalysetaken, van toepassing op modellen met visuele mogelijkheden (OpenAI spec).

Standaard: "auto"

Voorbeeld:

preset:
  imageDetail: 'high'

maxContextTokens

KeyTypeDescriptionExample
maxContextTokensNumberHet maximale aantal context-tokens dat aan het model moet worden verstrekt.Useful if you want to limit the maximum context for this preset.

Voorbeeld:

preset:
  maxContextTokens: 4096

Agent-opties

Let op: deze opties zijn alleen van toepassing bij gebruik van het agents endpoint.

Je dient alle modelopties uit te sluiten en te vertrouwen op de configuratie van de agent zoals gedefinieerd in de UI.

Agent-toegangsfiltering (v0.8.0+)

Sinds v0.8.0 gebruikt LibreChat een op ACL (Access Control List) gebaseerd rechtenbeheersysteem voor agents. Wanneer Model Specs zijn geconfigureerd om agents te gebruiken, worden alle agents waar de gebruiker geen toegang toe heeft automatisch uitgefilterd, zelfs als ze zijn geconfigureerd in de Model Spec. Dit zorgt ervoor dat gebruikers alleen de agents zien en kunnen gebruiken waarvoor ze de juiste rechten hebben.

Voor meer informatie over het ACL-permissiesysteem, zie de Agents-documentatie.


agent_id

KeyTypeDescriptionExample
agent_idStringIdentificatie van een assistant.

Voorbeeld:

preset:
  agent_id: 'agent_someUniqueId'

Assistent-opties

Let op: deze opties zijn alleen van toepassing bij gebruik van de assistants of azureAssistants endpoint.

Net als bij Agents, moet je alle modelopties uitsluiten en vertrouwen op de configuratie van de assistant.


assistant_id

KeyTypeDescriptionExample
assistant_idStringIdentificatie van een assistant.

Voorbeeld:

preset:
  assistant_id: 'asst_someUniqueId'

instructions

Let op: dit is anders dan promptPrefix, aangezien dit de bestaande assistent-instructies voor huidige runs overschrijft.

Gebruik dit alleen als je de kerninstructies van de assistent wilt overschrijven.

Gebruik promptPrefix voor additional_instructions.

Meer informatie:

KeyTypeDescriptionExample
instructionsStringOverschrijft de standaardinstructies van de assistant.

Voorbeeld:

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

append_current_datetime

Voegt de huidige datum en tijd toe aan additional_instructions voor elke run. Overschrijft promptPrefix niet, maar voegt er iets aan toe.

KeyTypeDescriptionExample
append_current_datetimeBooleanVoegt de huidige datum en tijd toe aan `additional_instructions` zoals gedefinieerd door `promptPrefix`

Voorbeeld:

preset:
  append_current_datetime: true

Modelopties

Let op: Elke parameter hieronder bevat een opmerking over welke endpoint deze ondersteunt. OpenAI / AzureOpenAI / Custom ondersteunen doorgaans temperature, presence_penalty, frequency_penalty, stop, top_p, max_tokens. Google / Anthropic ondersteunen doorgaans topP, topK, maxOutputTokens; Google ondersteunt ook url_context op ondersteunde Gemini-tekstmodellen. Anthropic / OpenRouter / Bedrock (Anthropic- en Nova-modellen) ondersteunen promptCache en promptCacheTtl. Bedrock ondersteunt region, maxTokens en enkele andere.

model

Ondersteund door: Alle endpoints (behalve agents)

KeyTypeDescriptionExample
modelString (nullable)De modelnaam die voor de preset moet worden gebruikt, overeenkomend met een geconfigureerd model onder het gekozen endpoint.None

Standaard: None

Voorbeeld:

preset:
  model: 'gpt-4-turbo'

temperature

Ondersteund door: openAI, azureOpenAI, google (als temperature), anthropic (als temperature), en custom (OpenAI-achtig)

KeyTypeDescriptionExample
temperatureNumberBepaalt hoe deterministisch of "creatief" de modelreacties zijn.

Voorbeeld:

preset:
  temperature: 0.7

presence_penalty

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)
Doorgaans niet gebruikt door Google/Anthropic/Bedrock

KeyTypeDescriptionExample
presence_penaltyNumberStraf voor repetitieve tokens, wat het verkennen van nieuwe onderwerpen aanmoedigt.

Voorbeeld:

preset:
  presence_penalty: 0.3

frequency_penalty

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)
Doorgaans niet gebruikt door Google/Anthropic/Bedrock

KeyTypeDescriptionExample
frequency_penaltyNumberStraf voor herhaalde tokens, wat redundantie in antwoorden vermindert.

Voorbeeld:

preset:
  frequency_penalty: 0.5

stop

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)
Doorgaans niet gebruikt door Google/Anthropic/Bedrock

KeyTypeDescriptionExample
stopArray of StringsStop-tokens voor het model, die het instrueren om zijn antwoord te beëindigen als ze worden aangetroffen.

Voorbeeld:

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

top_p

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)
Google/Anthropic gebruiken vaak topP (hoofdletter “P”) in plaats van top_p.

KeyTypeDescriptionExample
top_pNumberNucleus sampling-parameter (0-1), die de willekeurigheid van tokens beheert.

Voorbeeld:

preset:
  top_p: 0.9

topP

Ondersteund door: google & anthropic
(vergelijkbaar doel als top_p, maar anders benoemd in die API's)

KeyTypeDescriptionExample
topPNumberNucleus sampling-parameter voor Google/Anthropic-endpoints.

Voorbeeld:

preset:
  topP: 0.8

topK

Ondersteund door: google & anthropic
(k-sampling limiet op de distributie van het volgende token)

KeyTypeDescriptionExample
topKNumberBeperkt de selectie van het volgende token tot de top K tokens.

Voorbeeld:

preset:
  topK: 40

max_tokens

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)
Gebruik voor Google/Anthropic maxOutputTokens of maxTokens (afhankelijk van de endpoint).

KeyTypeDescriptionExample
max_tokensNumberHet maximale aantal tokens in de modelrespons.

Voorbeeld:

preset:
  max_tokens: 4096

maxOutputTokens

Ondersteund door: google, anthropic
Equivalent aan max_tokens voor deze providers.

KeyTypeDescriptionExample
maxOutputTokensNumberHet maximale aantal tokens in het antwoord (Google/Anthropic).

Voorbeeld:

preset:
  maxOutputTokens: 2048

promptCache

Ondersteund door: anthropic, OpenRouter custom endpoints, bedrock (Anthropic en Nova modellen) (Schakel provider prompt caching in/uit)

KeyTypeDescriptionExample
promptCacheBooleanSchakelt provider prompt caching in of uit.

Standaard: true

Voorbeeld:

preset:
  promptCache: true

Let op: Voor Bedrock endpoints is prompt caching automatisch ingeschakeld voor Claude en Nova modellen. Stel promptCache: false in om dit expliciet uit te schakelen.


promptCacheTtl

Ondersteund door: anthropic, OpenRouter custom endpoints, bedrock (Anthropic en Nova modellen) (Stelt de levensduur van de prompt-cache in wanneer prompt caching is ingeschakeld)

KeyTypeDescriptionExample
promptCacheTtlEnumStelt de levensduur van de prompt-cache in. Ondersteunde waarden zijn `5m` en `1h`.Provider or SDK default

Geaccepteerde waarden:

  • 5m
  • 1h

Voorbeeld:

preset:
  promptCache: true
  promptCacheTtl: '1h'

Let op: promptCacheTtl wordt genegeerd wanneer prompt caching is uitgeschakeld. Wanneer dit wordt weggelaten, gebruikt de provider-integratie de standaard levensduur voor prompt-cache.


reasoning_effort

Geaccepteerde waarden:

  • "" (lege string — niet ingesteld, gebruikt de API-standaard)
  • "none"
  • "minimal"
  • "low"
  • "medium"
  • "high"
  • "xhigh" (extra hoog)

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig), bedrock (ZAI, MoonshotAI-modellen)

KeyTypeDescriptionExample
reasoning_effortStringBeheert het niveau van de redeneerinspanning voor het model. Het verminderen van de redeneerinspanning kan leiden tot snellere reacties en minder gebruikte tokens voor het redeneren. De `xhigh` optie biedt maximale redeneercapaciteit voor complexe problemen. Voor Bedrock zijn de geaccepteerde waarden `low`, `medium`, `high`.

Standaard: "" (niet ingesteld)

Voorbeeld:

preset:
  reasoning_effort: 'low'

reasoning_summary

Geaccepteerde waarden:

  • "" (lege string — schakelt redeneersamenvattingen uit)
  • "auto"
  • "concise"
  • "detailed"

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)

KeyTypeDescriptionExample
reasoning_summaryStringStelt voorkeuren in voor de samenvatting van het redeneren voor het model.

Standaard: "" (uitgeschakeld)

Voorbeeld:

preset:
  reasoning_summary: 'detailed'

useResponsesApi

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)

KeyTypeDescriptionExample
useResponsesApiBooleanSchakelt de responses API voor het model in of uit.

Standaard: false

Voorbeeld:

preset:
  useResponsesApi: true

verbosity

Geaccepteerde waarden:

  • "" (lege string — niet ingesteld, gebruikt de API-standaard)
  • "low"
  • "medium"
  • "high"

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)

KeyTypeDescriptionExample
verbosityStringBeheert het breedsprakigheidsniveau van modelreacties.

Standaard: "" (niet ingesteld)

Voorbeeld:

preset:
  verbosity: 'low'

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig), google, anthropic

KeyTypeDescriptionExample
web_searchBooleanSchakelt de zoekfunctionaliteit op het web in of uit voor het model.

Standaard: false

Let op: Voor Google endpoints verschijnt deze parameter als Grounding with Google Search in het daadwerkelijke paneel, maar bestuurt deze web_search in de implementatie.

Voorbeeld:

preset:
  web_search: true

url_context

Ondersteund door: google op ondersteunde Gemini-tekstmodellen, inclusief Gemini 2.5+ en Gemini 3.x

KeyTypeDescriptionExample
url_contextBooleanSchakelt Google URL Context in zodat het model URL's in het gebruikersbericht kan lezen. YouTube-links worden waar mogelijk omgezet naar native video-begrip-inputs.

Standaard: false

Voorbeeld:

preset:
  url_context: true

disableStreaming

Ondersteund door: openAI, azureOpenAI, custom (OpenAI-achtig)

KeyTypeDescriptionExample
disableStreamingBooleanSchakelt streaming-antwoorden van het model uit.

Standaard: false

Voorbeeld:

preset:
  disableStreaming: true

thinkingBudget

Ondersteund door: google, anthropic, bedrock (Anthropic-modellen)

KeyTypeDescriptionExample
thinkingBudgetNumber or StringBepaalt het aantal thinking tokens dat het model kan gebruiken voor interne redenering. Grotere budgetten kunnen de kwaliteit van het antwoord bij complexe problemen verbeteren.

Standaard: "Auto (-1)" (Google), 2000 (Anthropic, Bedrock (Anthropic-modellen))

Voorbeeld:

preset:
  thinkingBudget: '2000'

thinkingLevel

Ondersteund door: google (Gemini 3+ modellen)

KeyTypeDescriptionExample
thinkingLevelStringBeheert het niveau van de denkinspanning voor Gemini 3+ modellen. Gemini 2.5 modellen gebruiken in plaats daarvan `thinkingBudget`.

Geaccepteerde waarden:

  • "" (niet ingesteld/auto)
  • "minimal"
  • "low"
  • "medium"
  • "high"

Standaard: "" (niet ingesteld — model beslist)

Voorbeeld:

preset:
  thinkingLevel: 'medium'

effort

Ondersteund door: anthropic, bedrock (Anthropic-modellen)

KeyTypeDescriptionExample
effortStringRegelt het inspanningsniveau van Adaptive Thinking voor ondersteunde Anthropic-modellen (bijv. Claude Opus 4.6+ en Claude Fable/Mythos-klasse modellen). Hogere inspanningsniveaus wijzen meer denktokens toe voor complexe problemen.

Opties: "" (niet ingesteld/auto), "low", "medium", "high", "xhigh", "max"

Standaard: "" (niet ingesteld — model beslist)

Voorbeeld:

preset:
  effort: 'high'

thinkingDisplay

Ondersteund door: anthropic, bedrock (Anthropic-modellen)

KeyTypeDescriptionExample
thinkingDisplayStringBepaalt of redeneerinhoud wordt geretourneerd in modelreacties. Claude Opus 4.7+ en Claude Fable/Mythos-klasse modellen laten denkprocessen standaard weg; met deze instelling kun je kiezen voor redeneersamenvattingen of deze expliciet onderdrukken.

Opties: "auto" (standaard), "summarized", "omitted"

  • "auto" — LibreChat beslist: kiest voor "summarized" voor modellen die standaard geen 'thinking' bevatten (Opus 4.7+ en Fable/Mythos-klasse), en laat het veld weg voor oudere modellen
  • "summarized" — vraag altijd om een post-hoc samenvatting van de redenering
  • "omitted" — onderdruk altijd de redeneerinhoud (iets lagere latentie)

Standaard: "auto"

Voorbeeld:

preset:
  thinkingDisplay: 'summarized'

thinking

Ondersteund door: google, anthropic, bedrock (Anthropic-modellen)

KeyTypeDescriptionExample
thinkingBooleanGeeft aan of het model tijd moet besteden aan nadenken voordat het een antwoord genereert.

Standaard: true

Voorbeeld:

preset:
  thinking: true

region

Ondersteund door: bedrock
(Wordt gebruikt om een AWS-regio op te geven voor Amazon Bedrock)

KeyTypeDescriptionExample
regionStringAWS-regio voor Amazon Bedrock-endpoints.

Voorbeeld:

preset:
  region: 'us-east-1'

maxTokens

Ondersteund door: bedrock
(Wordt gebruikt in plaats van max_tokens)

KeyTypeDescriptionExample
maxTokensNumberMaximaal aantal output-tokens voor Amazon Bedrock-endpoints.

Voorbeeld:

preset:
  maxTokens: 1024

Hoe is deze gids?