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
enforceis ingesteld op true, kunnen Model Specs potentieel conflicteren met andere interface-instellingen zoalsmodelSelect,presetsenparameters. - De
listarray 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:
modelSelectparameterspresets
- Als je deze interface-elementen samen met Model Specs wilt inschakelen, kun je ze op
truezetten in hetinterfaceobject.
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
| Key | Type | Description | Example |
|---|---|---|---|
| enforce | Boolean | Bepaalt 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: trueprioritize
| Key | Type | Description | Example |
|---|---|---|---|
| prioritize | Boolean | Geeft 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: falseaddedEndpoints
| Key | Type | Description | Example |
|---|---|---|---|
| addedEndpoints | Array of Strings | Staat 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
- googlelist
Vereist
| Key | Type | Description | Example |
|---|---|---|---|
| list | Array of Objects | Bevat 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
| Key | Type | Description | Example |
|---|---|---|---|
| name | String | Unieke identificatie voor het model. | No default. Must be specified. |
Beschrijving: Unieke identificatiecode voor het model.
label
| Key | Type | Description | Example |
|---|---|---|---|
| label | String | Een 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
| Key | Type | Description | Example |
|---|---|---|---|
| default | Boolean | Geeft 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
| Key | Type | Description | Example |
|---|---|---|---|
| softDefault | Boolean | Geeft 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
| Key | Type | Description | Example |
|---|---|---|---|
| iconURL | String | URL 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
| Key | Type | Description | Example |
|---|---|---|---|
| description | String | Een 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
| Key | Type | Description | Example |
|---|---|---|---|
| conversation_starters | Array of Strings | Voorgestelde 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
| Key | Type | Description | Example |
|---|---|---|---|
| showOnLanding | Boolean | Toont 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
| Key | Type | Description | Example |
|---|---|---|---|
| group | String | Optionele groepsnaam voor het organiseren van Model Specs in de UI-selector. Bepaalt waar de spec in de menuhiërarchie verschijnt. | No default. Optional. |
| groupIcon | String | Optioneel 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
groupovereenkomt met een endpoint-naam (bijv."openAI","groq"): De Model Specs verschijnt genest onder dat endpoint in het selectiemenu - Als
groupeen aangepaste naam is (komt niet overeen met een endpoint): Maakt een afzonderlijke inklapbare sectie met die naam aan. Je kunt optioneelgroupIcongebruiken om een aangepast icoon voor deze sectie in te stellen (URL of ingebouwde sleutel zoals"openAI"). - Als
groupwordt 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
| Key | Type | Description | Example |
|---|---|---|---|
| hideBadgeRow | Boolean | Verbergt 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
| Key | Type | Description | Example |
|---|---|---|---|
| showIconInMenu | Boolean | Bepaalt 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
| Key | Type | Description | Example |
|---|---|---|---|
| showIconInHeader | Boolean | Bepaalt 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
| Key | Type | Description | Example |
|---|---|---|---|
| authType | String | Authenticatietype 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
| Key | Type | Description | Example |
|---|---|---|---|
| webSearch | Boolean | Schakelt 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
| Key | Type | Description | Example |
|---|---|---|---|
| fileSearch | Boolean | Schakelt 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
| Key | Type | Description | Example |
|---|---|---|---|
| executeCode | Boolean | Schakelt 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
| Key | Type | Description | Example |
|---|---|---|---|
| mcpServers | Array of Strings | Lijst 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
| Key | Type | Description | Example |
|---|---|---|---|
| skills | Boolean or Array of Strings | Beheert 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
| Key | Type | Description | Example |
|---|---|---|---|
| subagents.enabled | Boolean | Schakelt de Subagents-functionaliteit in voor kortstondige agents die zijn gemaakt op basis van deze Model Specs. | enabled: true |
| subagents.allowSelf | Boolean | Stelt de kortstondige agent in staat om een geïsoleerde kopie van zichzelf aan te maken voor gericht werk. | allowSelf: true |
| subagents.agent_ids | Array of Strings | Privé 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 doorMAX_SUBAGENTSen blijft aan de serverzijde; de opstartconfiguratie die naar clients wordt verzonden, bevat alleen de publiekeenabledenallowSelfvlaggen.
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
| Key | Type | Description | Example |
|---|---|---|---|
| artifacts | String | Boolean | Schakelt 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
| Key | Type | Description | Example |
|---|---|---|---|
| preset | Object | Gedetailleerde 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:
openAIazureOpenAIgoogleanthropicassistantsazureAssistantsbedrockagents
Let op: Als u een custom endpoint gebruikt, moet de endpoint waarde exact overeenkomen met de gedefinieerde custom endpoint name.
| Key | Type | Description | Example |
|---|---|---|---|
| endpoint | Enum (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
| Key | Type | Description | Example |
|---|---|---|---|
| modelLabel | String (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
| Key | Type | Description | Example |
|---|---|---|---|
| greeting | String | Een 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
| Key | Type | Description | Example |
|---|---|---|---|
| promptPrefix | String (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
| Key | Type | Description | Example |
|---|---|---|---|
| resendFiles | Boolean | Geeft aan of bestanden opnieuw moeten worden verzonden in scenario's waarin persistente sessies niet worden onderhouden. |
Standaard: true
Voorbeeld:
preset:
resendFiles: trueimageDetail
Geaccepteerde waarden:
- laag
- auto
- hoog
| Key | Type | Description | Example |
|---|---|---|---|
| imageDetail | Enum (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
| Key | Type | Description | Example |
|---|---|---|---|
| maxContextTokens | Number | Het 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: 4096Agent-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
| Key | Type | Description | Example |
|---|---|---|---|
| agent_id | String | Identificatie 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
| Key | Type | Description | Example |
|---|---|---|---|
| assistant_id | String | Identificatie 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:
- https://platform.openai.com/docs/api-reference/models#runs-createrun-instructions
- https://platform.openai.com/docs/api-reference/runs/createRun#runs-createrun-additional_instructions
| Key | Type | Description | Example |
|---|---|---|---|
| instructions | String | Overschrijft 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.
| Key | Type | Description | Example |
|---|---|---|---|
| append_current_datetime | Boolean | Voegt de huidige datum en tijd toe aan `additional_instructions` zoals gedefinieerd door `promptPrefix` |
Voorbeeld:
preset:
append_current_datetime: trueModelopties
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 doorgaanstopP,topK,maxOutputTokens; Google ondersteunt ookurl_contextop ondersteunde Gemini-tekstmodellen. Anthropic / OpenRouter / Bedrock (Anthropic- en Nova-modellen) ondersteunenpromptCacheenpromptCacheTtl. Bedrock ondersteuntregion,maxTokensen enkele andere.
model
Ondersteund door: Alle endpoints (behalve
agents)
| Key | Type | Description | Example |
|---|---|---|---|
| model | String (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,temperature),anthropic(alstemperature), en custom (OpenAI-achtig)
| Key | Type | Description | Example |
|---|---|---|---|
| temperature | Number | Bepaalt hoe deterministisch of "creatief" de modelreacties zijn. |
Voorbeeld:
preset:
temperature: 0.7presence_penalty
Ondersteund door:
openAI,azureOpenAI, custom (OpenAI-achtig)
Doorgaans niet gebruikt door Google/Anthropic/Bedrock
| Key | Type | Description | Example |
|---|---|---|---|
| presence_penalty | Number | Straf voor repetitieve tokens, wat het verkennen van nieuwe onderwerpen aanmoedigt. |
Voorbeeld:
preset:
presence_penalty: 0.3frequency_penalty
Ondersteund door:
openAI,azureOpenAI, custom (OpenAI-achtig)
Doorgaans niet gebruikt door Google/Anthropic/Bedrock
| Key | Type | Description | Example |
|---|---|---|---|
| frequency_penalty | Number | Straf voor herhaalde tokens, wat redundantie in antwoorden vermindert. |
Voorbeeld:
preset:
frequency_penalty: 0.5stop
Ondersteund door:
openAI,azureOpenAI, custom (OpenAI-achtig)
Doorgaans niet gebruikt door Google/Anthropic/Bedrock
| Key | Type | Description | Example |
|---|---|---|---|
| stop | Array of Strings | Stop-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 vaaktopP(hoofdletter “P”) in plaats vantop_p.
| Key | Type | Description | Example |
|---|---|---|---|
| top_p | Number | Nucleus sampling-parameter (0-1), die de willekeurigheid van tokens beheert. |
Voorbeeld:
preset:
top_p: 0.9topP
Ondersteund door:
anthropic
(vergelijkbaar doel alstop_p, maar anders benoemd in die API's)
| Key | Type | Description | Example |
|---|---|---|---|
| topP | Number | Nucleus sampling-parameter voor Google/Anthropic-endpoints. |
Voorbeeld:
preset:
topP: 0.8topK
Ondersteund door:
anthropic
(k-sampling limiet op de distributie van het volgende token)
| Key | Type | Description | Example |
|---|---|---|---|
| topK | Number | Beperkt de selectie van het volgende token tot de top K tokens. |
Voorbeeld:
preset:
topK: 40max_tokens
Ondersteund door:
openAI,azureOpenAI, custom (OpenAI-achtig)
Gebruik voor Google/AnthropicmaxOutputTokensofmaxTokens(afhankelijk van de endpoint).
| Key | Type | Description | Example |
|---|---|---|---|
| max_tokens | Number | Het maximale aantal tokens in de modelrespons. |
Voorbeeld:
preset:
max_tokens: 4096maxOutputTokens
Ondersteund door:
anthropic
Equivalent aanmax_tokensvoor deze providers.
| Key | Type | Description | Example |
|---|---|---|---|
| maxOutputTokens | Number | Het maximale aantal tokens in het antwoord (Google/Anthropic). |
Voorbeeld:
preset:
maxOutputTokens: 2048promptCache
Ondersteund door:
anthropic, OpenRouter custom endpoints,bedrock(Anthropic en Nova modellen) (Schakel provider prompt caching in/uit)
| Key | Type | Description | Example |
|---|---|---|---|
| promptCache | Boolean | Schakelt provider prompt caching in of uit. |
Standaard: true
Voorbeeld:
preset:
promptCache: trueLet 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)
| Key | Type | Description | Example |
|---|---|---|---|
| promptCacheTtl | Enum | Stelt de levensduur van de prompt-cache in. Ondersteunde waarden zijn `5m` en `1h`. | Provider or SDK default |
Geaccepteerde waarden:
5m1h
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)
| Key | Type | Description | Example |
|---|---|---|---|
| reasoning_effort | String | Beheert 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)
| Key | Type | Description | Example |
|---|---|---|---|
| reasoning_summary | String | Stelt 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)
| Key | Type | Description | Example |
|---|---|---|---|
| useResponsesApi | Boolean | Schakelt de responses API voor het model in of uit. |
Standaard: false
Voorbeeld:
preset:
useResponsesApi: trueverbosity
Geaccepteerde waarden:
""(lege string — niet ingesteld, gebruikt de API-standaard)"low""medium""high"
Ondersteund door:
openAI,azureOpenAI, custom (OpenAI-achtig)
| Key | Type | Description | Example |
|---|---|---|---|
| verbosity | String | Beheert het breedsprakigheidsniveau van modelreacties. |
Standaard: "" (niet ingesteld)
Voorbeeld:
preset:
verbosity: 'low'web_search
Ondersteund door:
openAI,azureOpenAI, custom (OpenAI-achtig),anthropic
| Key | Type | Description | Example |
|---|---|---|---|
| web_search | Boolean | Schakelt 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: trueurl_context
Ondersteund door:
| Key | Type | Description | Example |
|---|---|---|---|
| url_context | Boolean | Schakelt 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: truedisableStreaming
Ondersteund door:
openAI,azureOpenAI, custom (OpenAI-achtig)
| Key | Type | Description | Example |
|---|---|---|---|
| disableStreaming | Boolean | Schakelt streaming-antwoorden van het model uit. |
Standaard: false
Voorbeeld:
preset:
disableStreaming: truethinkingBudget
Ondersteund door:
anthropic,bedrock(Anthropic-modellen)
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingBudget | Number or String | Bepaalt 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:
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingLevel | String | Beheert 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)
| Key | Type | Description | Example |
|---|---|---|---|
| effort | String | Regelt 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)
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingDisplay | String | Bepaalt 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:
anthropic,bedrock(Anthropic-modellen)
| Key | Type | Description | Example |
|---|---|---|---|
| thinking | Boolean | Geeft aan of het model tijd moet besteden aan nadenken voordat het een antwoord genereert. |
Standaard: true
Voorbeeld:
preset:
thinking: trueregion
Ondersteund door:
bedrock
(Wordt gebruikt om een AWS-regio op te geven voor Amazon Bedrock)
| Key | Type | Description | Example |
|---|---|---|---|
| region | String | AWS-regio voor Amazon Bedrock-endpoints. |
Voorbeeld:
preset:
region: 'us-east-1'maxTokens
Ondersteund door:
bedrock
(Wordt gebruikt in plaats vanmax_tokens)
| Key | Type | Description | Example |
|---|---|---|---|
| maxTokens | Number | Maximaal aantal output-tokens voor Amazon Bedrock-endpoints. |
Voorbeeld:
preset:
maxTokens: 1024Hoe is deze gids?