Struktur des Model Specs Objekts
Übersicht
Das modelSpecs Objekt hilft Ihnen dabei, eine einfachere Benutzeroberfläche für KI-Modelle innerhalb Ihrer Anwendung bereitzustellen.
Es gibt 3 Hauptfelder unter modelSpecs:
enforce(optional; Standard: false)prioritize(optional; Standardwert: true)list(erforderlich)addedEndpoints(optional)
Hinweise:
- Wenn
enforceauf true gesetzt ist, können Model Specs potenziell mit anderen Schnittstelleneinstellungen wiemodelSelect,presetsundparametersin Konflikt geraten. - Das
list-Array enthält detaillierte Konfigurationen für jedes Modell, einschließlich Voreinstellungen, die spezifische Verhaltensweisen, Erscheinungsbilder und Fähigkeiten festlegen. - Wenn interface Felder in der Konfiguration nicht angegeben sind, führt das Vorhandensein einer Liste von Model Specs zur Deaktivierung der folgenden Interface-Elemente:
modelSelectparameterspresets
- Wenn Sie diese Schnittstellenelemente zusammen mit Model Specs aktivieren möchten, können Sie diese im
interface-Objekt auftruesetzen.
Verwaltung von benutzerdefinierten API-Schlüsseln mit Model Specs
Wenn Model Specs modelSelect deaktivieren, wird das Endpoints-Dropdown-Menü – sowie das Zahnrad-Symbol, das den Set API Key-Dialog öffnet – ausgeblendet. Benutzer können weiterhin Schlüssel für jeden Endpoint, der mit apiKey: "user_provided" konfiguriert ist, unter Settings → Data controls → API keys festlegen oder rotieren.
Diese Liste ist auf die endpoints beschränkt, die ein Benutzer tatsächlich erreichen kann: die endpoints, auf die in Ihren Model Specs verwiesen wird, sowie alle addedEndpoints. Wenn der agents endpoint erreichbar ist, enthält sie auch die agent allowedProviders (oder jeden konfigurierten Provider, wenn allowedProviders nicht festgelegt ist).
Beispiel
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 Felder
enforce
| Key | Type | Description | Example |
|---|---|---|---|
| enforce | Boolean | Bestimmt, ob die Model Specs andere Konfigurationseinstellungen strikt überschreiben sollen. | Setting this to `true` can lead to conflicts with interface options if not managed carefully. |
Standard: false
Beispiel:
modelSpecs:
enforce: trueprioritize
| Key | Type | Description | Example |
|---|---|---|---|
| prioritize | Boolean | Legt fest, ob Model Specs Vorrang vor der Standardkonfiguration haben sollen, wenn beide anwendbar sind. | 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. |
Standard: true
Beispiel:
modelSpecs:
prioritize: falseaddedEndpoints
| Key | Type | Description | Example |
|---|---|---|---|
| addedEndpoints | Array of Strings | Ermöglicht es, bestimmte endpoints (z. B. "openAI", "google") neben den definierten Model Specs in der Benutzeroberfläche auswählbar zu machen. | Requires `interface.modelSelect` to be `true`. If this field is used and `interface.modelSelect` is not explicitly set, `modelSelect` will default to `true`. |
Standard: [] (leere Liste)
Hinweis: Muss einer der folgenden Werte sein:
openAI, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock, agents
Beispiel:
modelSpecs:
# ... other modelSpecs fields
addedEndpoints:
- openAI
- googlelist
Erforderlich
| Key | Type | Description | Example |
|---|---|---|---|
| list | Array of Objects | Enthält eine Liste individueller Model Specs, die verschiedene Konfigurationen und Verhaltensweisen detailliert beschreiben. | 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 (Listenelement)
Innerhalb jedes Model Spec oder jedes list-Elements können Sie die folgenden Felder konfigurieren:
name
| Key | Type | Description | Example |
|---|---|---|---|
| name | String | Eindeutiger Bezeichner für das Modell. | No default. Must be specified. |
Beschreibung: Eindeutiger Bezeichner für das Modell.
label
| Key | Type | Description | Example |
|---|---|---|---|
| label | String | Ein benutzerfreundlicher Name oder eine Bezeichnung für das Modell, die im Dropdown-Menü der Kopfzeile angezeigt wird. | No default. Optional. |
Beschreibung: Ein benutzerfreundlicher Name oder eine Bezeichnung für das Modell, die im Dropdown-Menü der Kopfzeile angezeigt wird.
default
| Key | Type | Description | Example |
|---|---|---|---|
| default | Boolean | Legt fest, ob diese Model Specs die Standardauswahl sind, die bei jedem neuen Chat automatisch ausgewählt wird. |
Beschreibung:
Legt fest, ob diese Model Specs die Standardauswahl sind, die bei jedem neuen Chat automatisch ausgewählt wird.
softDefault
| Key | Type | Description | Example |
|---|---|---|---|
| softDefault | Boolean | Gibt an, ob dieses Model Spec nur für Erstbenutzer ausgewählt werden soll, die noch kein Modell, kein Model Spec oder keinen Agenten ausgewählt haben. |
Beschreibung:
Legt einen Standardwert für den ersten Start fest, ohne spätere Benutzerauswahlen zu überschreiben. Verwenden Sie softDefault, wenn Sie neue Benutzer zu einer kuratierten Spec führen möchten, während die Wahlfreiheit des Benutzers gewahrt bleibt, nachdem er ein anderes Modell, eine andere Spec oder einen anderen Agenten ausgewählt hat.
Das Anzeigen einer älteren Konversation, die eine Soft-Default-Spec verwendet hat, aktiviert diese Spec nicht erneut als Standard für den Benutzer, nachdem dieser eine andere Auswahl getroffen hat.
Beispiel:
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 oder ein vordefinierter endpoint Name für das Modellsymbol in der Auswahl, im Header und im Konversations-Branding. | No default. Optional. |
Beschreibung:
URL oder ein vordefinierter endpoint-Name für das Symbol des Modells im Auswahlmenü, im Header und im Branding der Konversation. Verwenden Sie showIconInMenu und showIconInHeader, um zu steuern, wo das Symbol angezeigt wird.
description
| Key | Type | Description | Example |
|---|---|---|---|
| description | String | Eine kurze Beschreibung des Modells und seines beabsichtigten Verwendungszwecks oder seiner Rolle, die in der Modellauswahl und optional auf der Chat-Startseite angezeigt wird. | No default. Optional. |
Beschreibung:
Eine kurze Beschreibung des Modells und seines beabsichtigten Verwendungszwecks oder seiner Rolle, die in der Modellauswahl angezeigt wird. Wenn showOnLanding auf true gesetzt ist, wird dieselbe Beschreibung auch auf der Chat-Startseite unter dem Spec-Label angezeigt.
Beschreibungen im Klartext werden als Text gerendert. Beschreibungen, die mit < beginnen, werden durch den Konfigurations-HTML-Sanitizer gerendert, was sicheres Inline-Markup und Medien wie kleine Symbole ermöglicht.
conversation_starters
| Key | Type | Description | Example |
|---|---|---|---|
| conversation_starters | Array of Strings | Vorgeschlagene Starter-Prompts, die als anklickbare Karten auf der Chat-Startseite angezeigt werden, wenn diese Model Specs ausgewählt sind. | No default. Optional. |
Beschreibung:
Conversation starters bieten Benutzern kuratierte erste Prompts für ein Model Spec. Sie werden auf der leeren Chat-Startseite für das ausgewählte Spec angezeigt und sind besonders nützlich mit dem showOnLanding-Branding. Ein Klick auf einen Starter sendet diesen als erste Nachricht einer neuen Konversation ab.
- Es werden maximal 4 Starter angezeigt, was dem Limit für Agenten/Assistenten entspricht.
- Wenn das Preset der Spezifikation auf einen Agenten oder Assistenten verweist, der seine eigenen Konversationsstarter definiert, haben diese Vorrang.
Beispiel:
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 | Zeigt das Label und die Beschreibung dieser Model Specs auf der Chat-Startseite anstelle der Standardbegrüßung an. | showOnLanding: true |
Standard: false
Verwenden Sie dies, wenn eine kuratierte Model Specs den ersten leeren Chat-Bildschirm branden soll. Bestehende Model Specs bleiben unverändert, es sei denn, showOnLanding ist auf true gesetzt.
Beispiel:
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 | Optionale Gruppenbezeichnung zur Organisation von Model Specs in der UI-Auswahl. Steuert, wo die Spec in der Menühierarchie erscheint. | No default. Optional. |
| groupIcon | String | Optionales Icon für benutzerdefinierte Gruppen. Kann eine URL oder ein integrierter endpoint-Schlüssel sein (z. B. "openAI", "groq"). Nur die erste Spec mit einem groupIcon in jeder Gruppe wird verwendet. | No default. Optional. |
Beschreibung:
Optionaler Gruppenname zur Organisation von Model Specs im UI-Auswahlmenü. Das Feld group bietet flexible Kontrolle darüber, wie Model Specs organisiert werden:
- Wenn
groupmit einem endpoint-Namen übereinstimmt (z. B."openAI","groq"): Das Model Spec erscheint im Auswahlmenü unter diesem endpoint verschachtelt. - Wenn
groupein benutzerdefinierter Name ist (der mit keinem endpoint übereinstimmt): Erstellt einen separaten, einklappbaren Abschnitt mit diesem Namen. Sie können optionalgroupIconverwenden, um ein benutzerdefiniertes Symbol für diesen Abschnitt festzulegen (URL oder integrierter Schlüssel wie"openAI"). - Falls
groupweggelassen wird: Das Model Spec erscheint als eigenständiges Element auf der obersten Ebene
Diese Funktion ist besonders nützlich, wenn Sie Modellen Beschreibungen hinzufügen möchten, ohne die Organisationsstruktur des Auswahlmenüs zu verlieren.
hideBadgeRow
| Key | Type | Description | Example |
|---|---|---|---|
| hideBadgeRow | Boolean | Blendet die Tool-Badge-Zeile für diese Model Specs im Chat-Composer aus. | hideBadgeRow: true |
Standard: false
Verwenden Sie dies, wenn eine kuratierte Model Specs nicht die Reihe der Tool-/Fähigkeits-Badges unterhalb des Composers anzeigen soll.
Beispiel:
modelSpecs:
list:
- name: 'general-assistant'
label: 'General Assistant'
hideBadgeRow: true
preset:
endpoint: 'openAI'
model: 'gpt-4o-mini'Beispiel:
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 | Steuert, ob das Symbol des Modells im Dropdown-Menü der Kopfzeile angezeigt wird. |
Beschreibung:
Steuert, ob das Symbol des Modells im Dropdown-Menü der Kopfzeile angezeigt wird. Standardmäßig auf true gesetzt.
showIconInHeader
| Key | Type | Description | Example |
|---|---|---|---|
| showIconInHeader | Boolean | Steuert, ob das Symbol des Modells in der Header-Dropdown-Schaltfläche links neben seinem Namen angezeigt wird. |
Beschreibung:
Steuert, ob das Symbol des Modells in der Header-Dropdown-Schaltfläche links neben seinem Namen angezeigt wird. Standardmäßig auf true gesetzt.
authType
| Key | Type | Description | Example |
|---|---|---|---|
| authType | String | Für die Model Specs erforderlicher Authentifizierungstyp. | Optional. Possible values: "override_auth", "user_provided", "system_defined" |
Beschreibung:
Authentifizierungstyp, der für die Model Specs erforderlich ist. Bestimmt, ob die Authentifizierung überschrieben, vom Benutzer bereitgestellt oder vom System definiert wird.
webSearch
| Key | Type | Description | Example |
|---|---|---|---|
| webSearch | Boolean | Aktiviert die Websuchfunktion für diese Model Specs. | When true, the model can perform web searches. |
Beschreibung:
Aktiviert die Websuchfunktion für diese Model Specs. Wenn dies auf true gesetzt ist, kann das Modell Websuchen durchführen, um aktuelle Informationen abzurufen.
Beispiel:
modelSpecs:
list:
- name: 'research-assistant'
label: 'Research Assistant'
webSearch: true
preset:
endpoint: 'openAI'
model: 'gpt-4o'fileSearch
| Key | Type | Description | Example |
|---|---|---|---|
| fileSearch | Boolean | Aktiviert die Dateisuchfunktion für diese Model Specs. | When true, the model can search through uploaded files. |
Beschreibung:
Aktiviert die Dateisuchfunktion für diese Model Specs. Wenn auf true gesetzt, kann das Modell hochgeladene Dateien durchsuchen und darauf verweisen.
Beispiel:
modelSpecs:
list:
- name: 'document-analyst'
label: 'Document Analyst'
fileSearch: true
preset:
endpoint: 'openAI'
model: 'gpt-4o'executeCode
| Key | Type | Description | Example |
|---|---|---|---|
| executeCode | Boolean | Aktiviert die Codeausführungsfunktion für diese Model Specs. | When true, the model can execute code. |
Beschreibung:
Aktiviert die Codeausführungsfunktion für diese Model Specs. Wenn dies auf true gesetzt ist, kann das Modell Code in einer isolierten Umgebung (Sandbox) ausführen.
Beispiel:
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 | Liste der für diese Model Specs zu aktivierenden Model Context Protocol (MCP) Servernamen. | Each string should match a configured MCP server name. |
Beschreibung:
Liste der Namen von Model Context Protocol (MCP) Servern, die für diese Model Specs aktiviert werden sollen. MCP-Server erweitern die Fähigkeiten des Modells um benutzerdefinierte Tools und Ressourcen.
Beispiel:
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 | Steuert Skills für diese Model Specs. Verwenden Sie true für den aktiven, zugänglichen Katalog des Benutzers, false, um Skills zu deaktivieren, oder ein Array von Skill-Namen als strikte Positivliste. | skills: ["brand-guidelines", "code-review"] |
Beschreibung:
Steuert Skills für diese Model Specs, wenn die Skills-Funktion des Agents endpoint verfügbar ist.
true: aktiviert den aktiven zugänglichen Skill-Katalog des Benutzers.false: deaktiviert Skills für diese Spec.- Array der Skill-Namen: schränkt den Katalog, den manuellen Aufruf und die „always-apply“-Auflösung auf die benannten Skills ein.
Beispiel:
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 | Aktiviert die Subagents-Funktion für ephemere Agents, die aus dieser Model Specs erstellt wurden. | enabled: true |
| subagents.allowSelf | Boolean | Ermöglicht es dem ephemeren Agenten, eine isolierte Kopie seiner selbst für fokussierte Arbeit zu erstellen. | allowSelf: true |
| subagents.agent_ids | Array of Strings | Private serverseitige Positivliste zusätzlicher Agenten-IDs, die diese Model Specs erzeugen dürfen. | agent_ids: [] |
Beschreibung:
Steuert Subagents für ephemere Agents, die aus dieser Model Spec erstellt wurden. Verwenden Sie dies, wenn eine kuratierte Model Spec das Delegationsverhalten bereitstellen soll, ohne dass Benutzer einen persistenten übergeordneten Agenten erstellen oder auswählen müssen.
enabled: fügt das Subagent-Spawn-Tool für diese Model Specs hinzu.allowSelf: erlaubt es dem ephemeren Agenten, eine neue, isolierte Kopie seiner selbst zu erstellen.agent_ids: ermöglicht spezifische persistente Agents als zusätzliche Subagents. Diese Liste ist durchMAX_SUBAGENTSbegrenzt und bleibt serverseitig; die beim Start an Clients gesendete Konfiguration enthält nur die öffentlichenenabled- undallowSelf-Flags.
Wenn Model Specs erzwungen werden, haben die subagents-Einstellungen der Model Specs Vorrang vor den Werten der Request-Payload.
Beispiel:
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 | Aktiviert die Artifacts-Funktion für diese Model Specs und legt optional den Artifact-Modus fest. | 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. |
Beschreibung:
Aktiviert die Artifacts-Funktion für diese Model Specs, wodurch das Modell interaktive Artefakte wie React-Komponenten, HTML und Mermaid-Diagramme generieren und anzeigen kann. Wenn der Wert auf true gesetzt ist, wird der Standard-Artefaktmodus verwendet. Sie können auch direkt einen Modus-String angeben.
Beispiel:
modelSpecs:
list:
- name: 'artifact-assistant'
label: 'Artifact Assistant'
artifacts: true
preset:
endpoint: 'openAI'
model: 'gpt-4o'preset
| Key | Type | Description | Example |
|---|---|---|---|
| preset | Object | Detaillierte Preset-Konfigurationen, die das Verhalten und die Fähigkeiten des Modells definieren. | See "Preset Object Structure" below. |
Beschreibung:
Detaillierte Preset-Konfigurationen, die das Verhalten und die Fähigkeiten des Modells definieren (siehe Preset-Objektstruktur unten).
Preset-Felder
Das preset-Feld für ein modelSpecs.list-Element besteht aus einem umfassenden Konfigurationsentwurf für KI-Modelle innerhalb des Systems. Es wurde entwickelt, um die Betriebseinstellungen von KI-Modellen festzulegen und deren Verhalten, Ausgaben sowie Interaktionen mit anderen Systemkomponenten und endpoint-Instanzen anzupassen.
Systemoptionen
endpoint
Erforderlich
Akzeptierte Werte:
openAIazureOpenAIgoogleanthropicassistantsazureAssistantsbedrockagents
Hinweis: Wenn Sie einen benutzerdefinierten endpoint verwenden, muss der endpoint-Wert exakt mit dem definierten Namen des benutzerdefinierten endpoints übereinstimmen.
| Key | Type | Description | Example |
|---|---|---|---|
| endpoint | Enum (EModelEndpoint) or String (nullable) | Gibt den endpoint an, mit dem das Modell zur Ausführung von Vorgängen kommuniziert. Diese Einstellung bestimmt den externen oder internen Dienst, mit dem das Modell interagiert. |
Beispiel:
preset:
endpoint: 'openAI'modelLabel
| Key | Type | Description | Example |
|---|---|---|---|
| modelLabel | String (nullable) | Das Label, das zur Identifizierung des Modells in Benutzeroberflächen oder Protokollen verwendet wird. Es bietet einen für Menschen lesbaren Namen für das Modell, der in der UI angezeigt und auch der KI bekannt gemacht wird. | None |
Standard: None
Beispiel:
preset:
modelLabel: 'Customer Support Bot'greeting
| Key | Type | Description | Example |
|---|---|---|---|
| greeting | String | Eine vordefinierte Nachricht, die in der Benutzeroberfläche sichtbar ist, bevor ein neuer Chat gestartet wird. Dies ist eine gute Möglichkeit, dem Benutzer Anweisungen zu geben oder die Benutzeroberfläche freundlicher und zugänglicher zu gestalten. |
Standard: None
Beispiel:
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) | Ein statischer Text, der jedem an das Modell gesendeten Prompt vorangestellt wird und einen konsistenten Kontext für Antworten festlegt. | When using "assistants" as the endpoint, this becomes the OpenAI field `additional_instructions`. |
Standard: None
Beispiel 1:
preset:
promptPrefix: 'As a financial advisor, ...'Beispiel 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 | Gibt an, ob Dateien in Szenarien erneut gesendet werden sollen, in denen keine persistenten Sitzungen aufrechterhalten werden. |
Standard: true
Beispiel:
preset:
resendFiles: trueimageDetail
Akzeptierte Werte:
- niedrig
- auto
- hoch
| Key | Type | Description | Example |
|---|---|---|---|
| imageDetail | Enum (eImageDetailSchema) | Legt den erforderlichen Detailgrad bei Bildanalyseaufgaben fest, anwendbar auf Modelle mit Vision-Funktionen (OpenAI-Spezifikation). |
Standard: "auto"
Beispiel:
preset:
imageDetail: 'high'maxContextTokens
| Key | Type | Description | Example |
|---|---|---|---|
| maxContextTokens | Number | Die maximale Anzahl an Kontext-Tokens, die dem Modell bereitgestellt werden. | Useful if you want to limit the maximum context for this preset. |
Beispiel:
preset:
maxContextTokens: 4096Agent-Optionen
Beachten Sie, dass diese Optionen nur bei Verwendung des agents endpoint gelten.
Sie sollten alle Modelloptionen ausschließen und sich auf die Konfiguration des Agenten verlassen, wie sie in der Benutzeroberfläche definiert ist.
Agent-Zugriffsfilterung (v0.8.0+)
Seit v0.8.0 verwendet LibreChat ein ACL-basiertes (Access Control List) Berechtigungssystem für Agents. Wenn Model Specs so konfiguriert sind, dass sie Agents verwenden, werden alle Agents, auf die der Benutzer keinen Zugriff hat, automatisch herausgefiltert, selbst wenn sie in der Model Spec konfiguriert sind. Dies stellt sicher, dass Benutzer nur die Agents sehen und verwenden können, für die sie die entsprechenden Berechtigungen haben.
Weitere Informationen zum ACL-Berechtigungssystem finden Sie in der Agents-Dokumentation.
agent_id
| Key | Type | Description | Example |
|---|---|---|---|
| agent_id | String | Identifizierung eines Assistenten. |
Beispiel:
preset:
agent_id: 'agent_someUniqueId'Assistant-Optionen
Beachte, dass diese Optionen nur bei Verwendung des assistants oder azureAssistants endpoint anwendbar sind.
Ähnlich wie bei Agents sollten Sie alle Modelloptionen ausschließen und sich auf die Konfiguration des Assistenten verlassen.
assistant_id
| Key | Type | Description | Example |
|---|---|---|---|
| assistant_id | String | Identifizierung eines Assistenten. |
Beispiel:
preset:
assistant_id: 'asst_someUniqueId'instructions
Hinweis: Dies unterscheidet sich von promptPrefix, da dies die bestehenden Anweisungen des Assistenten für aktuelle Durchläufe überschreibt.
Verwenden Sie dies nur, wenn Sie die Kernanweisungen des Assistenten überschreiben möchten.
Verwenden Sie promptPrefix für additional_instructions.
Weitere Informationen:
- 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 | Überschreibt die Standardanweisungen des Assistenten. |
Beispiel:
preset:
instructions: 'Please handle customer queries regarding order status.'append_current_datetime
Fügt das aktuelle Datum und die Uhrzeit zu additional_instructions für jeden Durchlauf hinzu. Überschreibt promptPrefix nicht, sondern ergänzt es.
| Key | Type | Description | Example |
|---|---|---|---|
| append_current_datetime | Boolean | Fügt das aktuelle Datum und die Uhrzeit zu `additional_instructions` hinzu, wie durch `promptPrefix` definiert |
Beispiel:
preset:
append_current_datetime: trueModelloptionen
Hinweis: Jeder der unten aufgeführten Parameter enthält einen Hinweis darauf, welche Endpoints ihn unterstützen.
OpenAI / AzureOpenAI / Custom unterstützen in der Regeltemperature,presence_penalty,frequency_penalty,stop,top_p,max_tokens.
Google / Anthropic unterstützen in der RegeltopP,topK,maxOutputTokens; Google unterstützt zudemurl_contextbei unterstützten Gemini-Textmodellen. Anthropic / OpenRouter / Bedrock (Anthropic- und Nova-Modelle) unterstützenpromptCacheundpromptCacheTtl. Bedrock unterstütztregion,maxTokensund einige weitere.
model
Unterstützt von: Allen endpoints (außer
agents)
| Key | Type | Description | Example |
|---|---|---|---|
| model | String (nullable) | Der für das Preset zu verwendende Modellname, passend zu einem konfigurierten Modell unter dem gewählten endpoint. | None |
Standard: None
Beispiel:
preset:
model: 'gpt-4-turbo'temperature
Unterstützt von:
openAI,azureOpenAI,temperature),anthropic(alstemperature) und benutzerdefiniert (OpenAI-ähnlich)
| Key | Type | Description | Example |
|---|---|---|---|
| temperature | Number | Steuert, wie deterministisch oder „kreativ“ die Antworten des Modells sind. |
Beispiel:
preset:
temperature: 0.7presence_penalty
Unterstützt von:
openAI,azureOpenAI, custom (OpenAI-ähnlich)
Wird normalerweise nicht von Google/Anthropic/Bedrock verwendet
| Key | Type | Description | Example |
|---|---|---|---|
| presence_penalty | Number | Strafe für wiederholte Tokens, um die Erkundung neuer Themen zu fördern. |
Beispiel:
preset:
presence_penalty: 0.3frequency_penalty
Unterstützt von:
openAI,azureOpenAI, custom (OpenAI-ähnlich)
Wird normalerweise nicht von Google/Anthropic/Bedrock verwendet
| Key | Type | Description | Example |
|---|---|---|---|
| frequency_penalty | Number | Strafe für wiederholte Tokens, um Redundanz in Antworten zu reduzieren. |
Beispiel:
preset:
frequency_penalty: 0.5stop
Unterstützt von:
openAI,azureOpenAI, custom (OpenAI-ähnlich)
Wird normalerweise nicht von Google/Anthropic/Bedrock verwendet
| Key | Type | Description | Example |
|---|---|---|---|
| stop | Array of Strings | Stopp-Tokens für das Modell, die es anweisen, seine Antwort zu beenden, falls sie gefunden werden. |
Beispiel:
preset:
stop:
- 'END'
- 'STOP'top_p
Unterstützt durch:
openAI,azureOpenAI, custom (OpenAI-ähnlich)
Google/Anthropic verwenden ofttopP(großes „P“) anstelle vontop_p.
| Key | Type | Description | Example |
|---|---|---|---|
| top_p | Number | Nucleus-Sampling-Parameter (0-1), der die Zufälligkeit von Tokens steuert. |
Beispiel:
preset:
top_p: 0.9topP
Unterstützt von:
anthropic
(ähnlicher Zweck wietop_p, aber in diesen APIs anders benannt)
| Key | Type | Description | Example |
|---|---|---|---|
| topP | Number | Nucleus-Sampling-Parameter für Google/Anthropic-endpoint. |
Beispiel:
preset:
topP: 0.8topK
Unterstützt durch:
anthropic
(k-Sampling-Limit für die Verteilung des nächsten Tokens)
| Key | Type | Description | Example |
|---|---|---|---|
| topK | Number | Begrenzt die Auswahl des nächsten Tokens auf die Top-K-Tokens. |
Beispiel:
preset:
topK: 40max_tokens
Unterstützt von:
openAI,azureOpenAI, custom (OpenAI-ähnlich)
Verwenden Sie für Google/AnthropicmaxOutputTokensodermaxTokens(abhängig vom endpoint).
| Key | Type | Description | Example |
|---|---|---|---|
| max_tokens | Number | Die maximale Anzahl an Tokens in der Modellantwort. |
Beispiel:
preset:
max_tokens: 4096maxOutputTokens
Unterstützt von:
anthropic
Entsprichtmax_tokensfür diese Anbieter.
| Key | Type | Description | Example |
|---|---|---|---|
| maxOutputTokens | Number | Die maximale Anzahl an Tokens in der Antwort (Google/Anthropic). |
Beispiel:
preset:
maxOutputTokens: 2048promptCache
Unterstützt durch:
anthropic, OpenRouter benutzerdefinierte endpoints,bedrock(Anthropic und Nova Modelle) (Provider-Prompt-Caching umschalten)
| Key | Type | Description | Example |
|---|---|---|---|
| promptCache | Boolean | Aktiviert oder deaktiviert das Prompt-Caching des Anbieters. |
Standard: true
Beispiel:
preset:
promptCache: trueHinweis: Für Bedrock-endpoints ist das Prompt-Caching für Claude- und Nova-Modelle automatisch aktiviert. Setzen Sie promptCache: false, um es explizit zu deaktivieren.
promptCacheTtl
Unterstützt durch:
anthropic, OpenRouter-benutzerdefinierte Endpunkte,bedrock(Anthropic- und Nova-Modelle) (Legt die Lebensdauer des Prompt-Caches fest, wenn Prompt-Caching aktiviert ist)
| Key | Type | Description | Example |
|---|---|---|---|
| promptCacheTtl | Enum | Legt die Lebensdauer des Prompt-Caches fest. Unterstützte Werte sind `5m` und `1h`. | Provider or SDK default |
Akzeptierte Werte:
5m1h
Beispiel:
preset:
promptCache: true
promptCacheTtl: '1h'Hinweis: promptCacheTtl wird ignoriert, wenn das Prompt-Caching deaktiviert ist. Wenn dieser Wert weggelassen wird, verwendet die Provider-Integration ihre standardmäßige Prompt-Cache-Lebensdauer.
reasoning_effort
Akzeptierte Werte:
""(leerer String — nicht gesetzt, verwendet den API-Standard)"none""minimal""low""medium""high""xhigh"(extra hoch)
Unterstützt durch:
openAI,azureOpenAI, custom (OpenAI-ähnlich),bedrock(ZAI, MoonshotAI-Modelle)
| Key | Type | Description | Example |
|---|---|---|---|
| reasoning_effort | String | Steuert den Grad des Reasoning-Aufwands für das Modell. Eine Verringerung des Reasoning-Aufwands kann zu schnelleren Antworten und einem geringeren Token-Verbrauch beim Reasoning führen. Die Option `xhigh` bietet maximale Reasoning-Fähigkeiten für komplexe Probleme. Für Bedrock sind die akzeptierten Werte `low`, `medium`, `high`. |
Standard: "" (nicht festgelegt)
Beispiel:
preset:
reasoning_effort: 'low'reasoning_summary
Akzeptierte Werte:
""(leerer String — deaktiviert Zusammenfassungen des Denkprozesses)"auto""concise""detailed"
Unterstützt durch:
openAI,azureOpenAI, benutzerdefiniert (OpenAI-ähnlich)
| Key | Type | Description | Example |
|---|---|---|---|
| reasoning_summary | String | Legt die Einstellungen für die Zusammenfassung der Überlegungen des Modells fest. |
Standard: "" (deaktiviert)
Beispiel:
preset:
reasoning_summary: 'detailed'useResponsesApi
Unterstützt durch:
openAI,azureOpenAI, benutzerdefiniert (OpenAI-ähnlich)
| Key | Type | Description | Example |
|---|---|---|---|
| useResponsesApi | Boolean | Aktiviert oder deaktiviert die Responses-API für das Modell. |
Standard: false
Beispiel:
preset:
useResponsesApi: trueverbosity
Akzeptierte Werte:
""(leerer String — nicht gesetzt, verwendet den API-Standard)"low""medium""high"
Unterstützt durch:
openAI,azureOpenAI, benutzerdefiniert (OpenAI-ähnlich)
| Key | Type | Description | Example |
|---|---|---|---|
| verbosity | String | Steuert die Ausführlichkeit der Modellantworten. |
Standard: "" (nicht festgelegt)
Beispiel:
preset:
verbosity: 'low'web_search
Unterstützt durch:
openAI,azureOpenAI, custom (OpenAI-like),anthropic
| Key | Type | Description | Example |
|---|---|---|---|
| web_search | Boolean | Aktiviert oder deaktiviert die Websuchfunktion für das Modell. |
Standard: false
Hinweis: Für Google-endpoints erscheint dieser Parameter im eigentlichen Panel als Grounding with Google Search, steuert jedoch web_search in der Implementierung.
Beispiel:
preset:
web_search: trueurl_context
Unterstützt durch:
| Key | Type | Description | Example |
|---|---|---|---|
| url_context | Boolean | Aktiviert den Google URL-Kontext, damit das Modell URLs lesen kann, die in der Benutzernachricht enthalten sind. YouTube-Links werden nach Möglichkeit in native Video-Verständnis-Inputs konvertiert. |
Standard: false
Beispiel:
preset:
url_context: truedisableStreaming
Unterstützt durch:
openAI,azureOpenAI, benutzerdefiniert (OpenAI-ähnlich)
| Key | Type | Description | Example |
|---|---|---|---|
| disableStreaming | Boolean | Deaktiviert das Streaming von Antworten des Modells. |
Standard: false
Beispiel:
preset:
disableStreaming: truethinkingBudget
Unterstützt von:
anthropic,bedrock(Anthropic-Modelle)
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingBudget | Number or String | Steuert die Anzahl der Thinking-Tokens, die das Modell für interne Überlegungen verwenden kann. Größere Budgets können die Antwortqualität bei komplexen Problemen verbessern. |
Standard: "Auto (-1)" (Google), 2000 (Anthropic, Bedrock (Anthropic-Modelle))
Beispiel:
preset:
thinkingBudget: '2000'thinkingLevel
Unterstützt von:
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingLevel | String | Steuert den Grad des Denkaufwands für Gemini 3+ Modelle. Gemini 2.5 Modelle verwenden stattdessen `thinkingBudget`. |
Akzeptierte Werte:
""(nicht festgelegt/auto)"minimal""low""medium""high"
Standard: "" (nicht festgelegt — das Modell entscheidet)
Beispiel:
preset:
thinkingLevel: 'medium'effort
Unterstützt von:
anthropic,bedrock(Anthropic-Modelle)
| Key | Type | Description | Example |
|---|---|---|---|
| effort | String | Steuert die Adaptive Thinking-Aufwandsebene für unterstützte Anthropic-Modelle (z. B. Claude Opus 4.6+ und Modelle der Claude Fable/Mythos-Klasse). Höhere Aufwandsebenen weisen mehr Thinking-Token für komplexe Probleme zu. |
Optionen: "" (nicht gesetzt/auto), "low", "medium", "high", "xhigh", "max"
Standard: "" (nicht festgelegt — das Modell entscheidet)
Beispiel:
preset:
effort: 'high'thinkingDisplay
Unterstützt von:
anthropic,bedrock(Anthropic-Modelle)
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingDisplay | String | Steuert, ob Reasoning-Inhalte in Modellantworten zurückgegeben werden. Claude Opus 4.7+ und Modelle der Claude Fable/Mythos-Klasse lassen Thinking-Inhalte standardmäßig weg; diese Einstellung ermöglicht es Ihnen, Reasoning-Zusammenfassungen zu aktivieren oder diese explizit zu unterdrücken. |
Optionen: "auto" (Standard), "summarized", "omitted"
"auto"— LibreChat entscheidet: wählt"summarized"für Modelle, die standardmäßig kein Thinking verwenden (Opus 4.7+ und Fable/Mythos-Klasse), und lässt das Feld für ältere Modelle weg"summarized"— fordert immer eine nachträgliche Zusammenfassung der Überlegungen an"omitted"— unterdrückt immer den Reasoning-Inhalt (etwas geringere Latenz)
Standard: "auto"
Beispiel:
preset:
thinkingDisplay: 'summarized'thinking
Unterstützt von:
anthropic,bedrock(Anthropic-Modelle)
| Key | Type | Description | Example |
|---|---|---|---|
| thinking | Boolean | Gibt an, ob das Modell Zeit zum Nachdenken aufwenden soll, bevor es eine Antwort generiert. |
Standard: true
Beispiel:
preset:
thinking: trueregion
Unterstützt von:
bedrock
(Wird verwendet, um eine AWS-Region für Amazon Bedrock anzugeben)
| Key | Type | Description | Example |
|---|---|---|---|
| region | String | AWS-Region für Amazon Bedrock-endpoints. |
Beispiel:
preset:
region: 'us-east-1'maxTokens
Unterstützt von:
bedrock
(Wird anstelle vonmax_tokensverwendet)
| Key | Type | Description | Example |
|---|---|---|---|
| maxTokens | Number | Maximale Ausgabe-Token für Amazon Bedrock-endpoints. |
Beispiel:
preset:
maxTokens: 1024Wie finden Sie diese Anleitung?