Model Specs オブジェクト構造

概要

modelSpecs オブジェクトは、アプリケーション内のAIモデルに対して、よりシンプルなUI体験を提供するのに役立ちます。

modelSpecs の下には3つの主要なフィールドがあります：

enforce (任意; デフォルト: false)
prioritize (任意; デフォルト: true)
list (必須)
addedEndpoints (オプション)

注記:

enforce が true に設定されている場合、Model Specs は modelSelect、presets、parameters といった他のインターフェース設定と競合する可能性があります。
list 配列には、各モデルの詳細な設定が含まれており、特定の動作、外観、および機能を規定するプリセットが含まれています。
interface フィールドが設定で指定されていない場合、Model Specs のリストが存在すると、以下のインターフェース要素が無効になります：
- modelSelect
- parameters
- presets
Model Specs と併せてこれらのインターフェース要素を有効にしたい場合は、interface オブジェクト内でそれらを true に設定できます。

Model Specsを使用したユーザー提供のAPIキーの管理

Model Specs で modelSelect を無効にすると、エンドポイントのドロップダウンと、Set API Key ダイアログを開くための歯車アイコンが非表示になります。ユーザーは、apiKey: "user_provided" で設定された任意のエンドポイントに対して、Settings → Data controls → API keys から引き続きキーの設定や更新を行うことができます。

そのリストは、ユーザーが実際にアクセス可能なendpointに限定されます。具体的には、Model Specsで参照されているendpointと、addedEndpointsで追加されたendpointです。agents endpointにアクセス可能な場合、そこにはエージェントのallowedProvidersも含まれます（allowedProvidersが設定されていない場合は、設定済みのすべてのプロバイダーが含まれます）。

例

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.

トップレベルフィールド

enforce

Key	Type	Description	Example
enforce	Boolean	Model Specsが他の設定を厳密に上書きするかどうかを決定します。	Setting this to `true` can lead to conflicts with interface options if not managed carefully.

デフォルト: false

例:

modelSpecs:
  enforce: true

prioritize

Key	Type	Description	Example
prioritize	Boolean	両方が適用可能な場合に、デフォルト設定よりもModel Specsを優先するかどうかを指定します。	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.

デフォルト: true

例:

modelSpecs:
  prioritize: false

addedEndpoints

Key	Type	Description	Example
addedEndpoints	Array of Strings	定義されたModel Specsと並んで、特定のendpoint（例: "openAI", "google"）をUI上で選択可能にします。	Requires `interface.modelSelect` to be `true`. If this field is used and `interface.modelSelect` is not explicitly set, `modelSelect` will default to `true`.

デフォルト: [] (空のリスト)

注: 以下の中のいずれかである必要があります:

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

例:

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

list

必須

Key	Type	Description	Example
list	Array of Objects	さまざまな構成や動作を詳述した個別のModel Specsのリストが含まれています。	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 (リスト項目)

各 Model Spec、または各 list アイテム内で、以下のフィールドを設定できます：

name

Key	Type	Description	Example
name	String	モデルの一意の識別子。	No default. Must be specified.

説明: モデルの一意の識別子。

label

Key	Type	Description	Example
label	String	ヘッダーのドロップダウンに表示される、モデルのユーザーフレンドリーな名前またはラベル。	No default. Optional.

説明: ヘッダーのドロップダウンに表示される、モデルのユーザーフレンドリーな名前またはラベル。

default

Key	Type	Description	Example
default	Boolean	このModel Specsがデフォルトの選択であるかどうかを指定し、新規チャットごとに自動選択されるようにします。

説明:
この Model Specs がデフォルトの選択であるかどうかを指定します。新しいチャットごとに自動的に選択されるようになります。

softDefault

Key	Type	Description	Example
softDefault	Boolean	このModel Specsが、まだモデル、Model Specs、またはエージェントを選択していない初回ユーザーに対してのみ選択されるべきかどうかを指定します。

説明:

ユーザーのその後の選択を上書きすることなく、初回実行時のデフォルトを指定します。ユーザーが別のモデル、Spec、またはエージェントを選択した後にその選択を維持しつつ、新規ユーザーを推奨のSpecへ誘導したい場合は softDefault を使用してください。

ソフトデフォルトのModel Specsを使用した古い会話を表示しても、ユーザーが別の選択を行った後にそのスペックがユーザーのデフォルトとして再設定されることはありません。

例:

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、または定義済みのendpoint名。	No default. Optional.

説明:
モデルセレクター、ヘッダー、および会話のブランディングで使用されるアイコンのURL、または定義済みのendpoint名です。アイコンの表示場所を制御するには、showIconInMenu および showIconInHeader を使用してください。

description

Key	Type	Description	Example
description	String	モデルとその意図された用途や役割についての簡単な説明。モデルセレクターや、オプションでチャットのランディングページに表示されます。	No default. Optional.

Description: モデルとその意図された用途や役割についての簡単な説明で、モデルセレクターに表示されます。showOnLanding が true の場合、同じ説明がチャットランディングのスペックラベルの下にも表示されます。

プレーンテキストの説明はテキストとしてレンダリングされます。< で始まる説明は設定のHTMLサニタイザーを通じてレンダリングされるため、安全なインラインマークアップや小さなアイコンなどのメディアを使用できます。

conversation_starters

Key	Type	Description	Example
conversation_starters	Array of Strings	このModel Specsが選択された際に、チャットのランディングページでクリック可能なカードとして表示される推奨スタータープロンプト。	No default. Optional.

説明: Conversation starters（会話のきっかけ）は、Model Specsに対して厳選された最初のプロンプトをユーザーに提供します。これらは選択されたスペックの空のチャットランディングページに表示され、特に showOnLanding ブランディングと組み合わせると非常に有効です。スターターをクリックすると、それが新しい会話の最初のメッセージとして送信されます。

エージェント/アシスタントの制限に合わせて、最大4つのスターターが表示されます。
スペックのプリセットが独自の会話スターターを定義するエージェントやアシスタントを指している場合、そちらが優先されます。

例:

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	チャットのランディングページで、デフォルトの挨拶の代わりにこのModel Specsのラベルと説明を表示します。	showOnLanding: true

デフォルト: false

キュレーションされた Model Specs を最初の空のチャット画面に表示させたい場合に使用します。showOnLanding が true に設定されていない限り、既存の Model Specs は変更されません。

例:

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	UIセレクターでModel Specsを整理するためのオプションのグループ名です。メニュー階層内でスペックがどこに表示されるかを制御します。	No default. Optional.
groupIcon	String	カスタムグループ用のオプションアイコン。URLまたは組み込みのendpointキー（例: "openAI", "groq"）を指定できます。各グループ内でgroupIconが設定された最初のspecのみが使用されます。	No default. Optional.

説明: UIセレクターでModel Specsを整理するためのオプションのグループ名です。groupフィールドを使用すると、Model Specsの整理方法を柔軟に制御できます：

group が endpoint 名と一致する場合 (例: "openAI"、"groq")：Model Specs はセレクターメニュー内のその endpoint の下にネストされて表示されます。
group がカスタム名の場合 (どの endpoint にも一致しない場合): その名前で折りたたみ可能なセクションが個別に作成されます。オプションで groupIcon を使用して、このセクションにカスタムアイコン（URL または "openAI" のような組み込みキー）を設定できます。
group を省略した場合: モデルスペックはトップレベルの独立した項目として表示されます

この機能は、セレクターメニューの組織構造を維持したままモデルに説明を追加したい場合に特に便利です。

hideBadgeRow

Key	Type	Description	Example
hideBadgeRow	Boolean	チャットコンポーザー内のこのModel Specsにおけるツールバッジの行を非表示にします。	hideBadgeRow: true

デフォルト: false

キュレーションされた Model Specs で、コンポーザーの下にツール/機能バッジの行を表示させたくない場合に使用します。

例:

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

例:

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	ヘッダーのドロップダウンメニューにモデルのアイコンを表示するかどうかを制御します。

説明:
モデルのアイコンをヘッダーのドロップダウンメニューに表示するかどうかを制御します。デフォルトは true です。

showIconInHeader

Key	Type	Description	Example
showIconInHeader	Boolean	ヘッダーのドロップダウンボタン内、モデル名の左側にモデルのアイコンを表示するかどうかを制御します。

説明:
モデルのアイコンをヘッダーのドロップダウンボタン内、名前の左側に表示するかどうかを制御します。デフォルトは true です。

authType

Key	Type	Description	Example
authType	String	Model Specsに必要な認証タイプ。	Optional. Possible values: "override_auth", "user_provided", "system_defined"

説明:
Model Specs に必要な認証タイプ。認証が上書きされるか、ユーザーによって提供されるか、あるいはシステムによって定義されるかを決定します。

webSearch

Key	Type	Description	Example
webSearch	Boolean	このModel Specsでウェブ検索機能を有効にします。	When true, the model can perform web searches.

説明:
この Model Specs に対してウェブ検索機能を有効にします。true に設定すると、モデルはウェブ検索を実行して最新の情報を取得できるようになります。

例:

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

fileSearch

Key	Type	Description	Example
fileSearch	Boolean	このModel Specsでファイル検索機能を有効にします。	When true, the model can search through uploaded files.

説明:
この Model Specs のファイル検索機能を有効にします。true に設定すると、モデルはアップロードされたファイルを検索し、参照できるようになります。

例:

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

executeCode

Key	Type	Description	Example
executeCode	Boolean	この Model Specs でコード実行機能を有効にします。	When true, the model can execute code.

説明:
この Model Specs のコード実行機能を有効にします。true に設定すると、モデルはサンドボックス環境でコードを実行できるようになります。

例:

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	このModel Specsで有効にするModel Context Protocol (MCP) サーバー名のリスト。	Each string should match a configured MCP server name.

説明:
この Model Specs で有効にする Model Context Protocol (MCP) サーバー名のリストです。MCP サーバーは、カスタムツールやリソースを使用してモデルの機能を拡張します。

例:

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	このModel Specsのスキルを制御します。ユーザーがアクティブにアクセス可能なカタログを使用する場合はtrue、スキルを強制的にオフにする場合はfalse、または許可するスキル名の配列を厳密な許可リストとして指定します。	skills: ["brand-guidelines", "code-review"]

説明:

Agents endpointのSkills機能が利用可能な場合、このModel SpecsのSkillsを制御します。

true: ユーザーのアクティブでアクセス可能なスキルカタログを有効にします。
false: この Model Specs で Skills を無効にします。
Skill名の配列：カタログの絞り込み、手動呼び出し、および指定されたSkillへの常時適用解決を行います。

例:

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	このModel Specsから作成されたエフェメラルエージェントに対して、Subagents機能を有効にします。	enabled: true
subagents.allowSelf	Boolean	エフェメラルエージェントが、集中的な作業のために自身の分離されたコピーを生成できるようにします。	allowSelf: true
subagents.agent_ids	Array of Strings	このModel Specsが生成できる追加のAgent IDのプライベートなサーバーサイド許可リスト。	agent_ids: []

説明:

このモデルスペックから作成されるエフェメラルエージェントのサブエージェントを制御します。ユーザーが永続化された親エージェントを作成または選択することなく、キュレーションされたモデルスペックで委任動作を公開したい場合に使用します。

enabled: この Model Specs に対してサブエージェント生成ツールを追加します。
allowSelf: エフェメラルエージェントが、それ自身の新しい分離されたコピーを生成できるようにします。
agent_ids: 特定の永続化されたエージェントをサブエージェントとして追加することを許可します。このリストは MAX_SUBAGENTS によって上限が設定され、サーバー側に保持されます。クライアントに送信される起動設定には、公開されている enabled および allowSelf フラグのみが含まれます。

Model Specsが強制されている場合、Model Specsのsubagents設定がリクエストペイロードの値よりも優先されます。

例:

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	このModel SpecsでArtifacts機能を有効にし、オプションでアーティファクトモードを設定します。	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.

説明:
この Model Specs に対して Artifacts 機能を有効にし、モデルが React コンポーネント、HTML、Mermaid ダイアグラムなどのインタラクティブなアーティファクトを生成および表示できるようにします。true に設定すると、デフォルトのアーティファクトモードが使用されます。モード文字列を直接指定することも可能です。

例:

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

preset

Key	Type	Description	Example
preset	Object	モデルの動作と機能を定義する詳細なプリセット設定。	See "Preset Object Structure" below.

説明:
モデルの動作と機能を定義する詳細なプリセット設定（以下の「プリセットオブジェクト構造」を参照）。

Preset Fields

modelSpecs.list アイテムの preset フィールドは、システム内の AI モデルに対する包括的な構成設計図で構成されています。これは、AI モデルの動作設定を指定し、その挙動、出力、および他のシステムコンポーネントや endpoint との対話を調整するように設計されています。

System Options

endpoint

必須

許容値:

openAI
azureOpenAI
google
anthropic
assistants
azureAssistants
bedrock
agents

注意: カスタム endpoint を使用している場合、endpoint の値は定義されたカスタム endpoint 名と完全に一致している必要があります。

Key	Type	Description	Example
endpoint	Enum (EModelEndpoint) or String (nullable)	モデルが操作を実行するために通信するendpointを指定します。この設定は、モデルがインターフェースする外部または内部のサービスを決定します。

例:

preset:
  endpoint: 'openAI'

modelLabel

Key	Type	Description	Example
modelLabel	String (nullable)	ユーザーインターフェースやログでモデルを識別するために使用されるラベルです。UIに表示され、AIにも認識される、人間が読みやすいモデル名を提供します。	None

デフォルト: None

例:

preset:
  modelLabel: 'Customer Support Bot'

greeting

Key	Type	Description	Example
greeting	String	新しいチャットを開始する前にUIに表示される定義済みのメッセージです。ユーザーへの指示を提供したり、インターフェースをより親しみやすくアクセスしやすいものにするための優れた方法です。

デフォルト: None

例:

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)	モデルに送信されるすべてのプロンプトの先頭に付加される静的テキストであり、応答に対して一貫したコンテキストを設定します。	When using "assistants" as the endpoint, this becomes the OpenAI field `additional_instructions`.

デフォルト: None

例 1:

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

例 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	永続的なセッションが維持されないシナリオにおいて、ファイルを再送信すべきかどうかを示します。

デフォルト: true

例:

preset:
  resendFiles: true

imageDetail

許容値:

低
自動
高

Key	Type	Description	Example
imageDetail	Enum (eImageDetailSchema)	画像分析タスクで必要とされる詳細レベルを指定します。ビジョン機能を持つモデル（OpenAI spec）に適用されます。

デフォルト: "auto"

例:

preset:
  imageDetail: 'high'

maxContextTokens

Key	Type	Description	Example
maxContextTokens	Number	モデルに提供するコンテキストトークンの最大数。	Useful if you want to limit the maximum context for this preset.

例:

preset:
  maxContextTokens: 4096

エージェントオプション

これらのオプションは、agents endpointを使用している場合にのみ適用されることに注意してください。

モデルのオプションは除外し、UIで定義されたエージェントの設定に従うようにしてください。

エージェントアクセスフィルタリング (v0.8.0+)

v0.8.0以降、LibreChatはエージェントに対してACL（アクセス制御リスト）ベースの権限システムを使用しています。Model Specsがエージェントを使用するように設定されている場合、ユーザーがアクセス権を持たないエージェントは、Model Specs内で設定されていたとしても自動的に除外されます。これにより、ユーザーは適切な権限を持つエージェントのみを表示および使用できるようになります。

ACL権限システムの詳細については、Agentsのドキュメントを参照してください。

agent_id

Key	Type	Description	Example
agent_id	String	アシスタントの識別。

例:

preset:
  agent_id: 'agent_someUniqueId'

アシスタントオプション

これらのオプションは、assistants または azureAssistants endpoint を使用している場合にのみ適用されることに注意してください。

Agents と同様に、モデルオプションは除外し、アシスタントの設定に従うようにしてください。

assistant_id

Key	Type	Description	Example
assistant_id	String	アシスタントの識別。

例:

preset:
  assistant_id: 'asst_someUniqueId'

instructions

Note: これは promptPrefix とは異なり、現在の実行に対して既存のアシスタントの指示を上書きするものです。

アシスタントのコア指示を上書きしたい場合にのみ、これを使用してください。

additional_instructions には promptPrefix を使用してください。

詳細情報:

Key	Type	Description	Example
instructions	String	アシスタントのデフォルトの指示を上書きします。

例:

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

append_current_datetime

各実行の additional_instructions に現在の日時を追加します。promptPrefix を上書きするのではなく、それに追加する形で動作します。

Key	Type	Description	Example
append_current_datetime	Boolean	`promptPrefix` で定義された通り、現在の日時を `additional_instructions` に追加します

例:

preset:
  append_current_datetime: true

モデルオプション

注: 以下の各パラメータには、それをサポートする endpoint に関する注記が含まれています。
OpenAI / AzureOpenAI / Custom は通常、temperature、presence_penalty、frequency_penalty、stop、top_p、max_tokens をサポートしています。
Google / Anthropic は通常、topP、topK、maxOutputTokens をサポートしています。また、Google はサポートされている Gemini テキストモデルにおいて url_context もサポートしています。 Anthropic / OpenRouter / Bedrock (Anthropic および Nova モデル) は、promptCache および promptCacheTtl をサポートしています。 Bedrock は、region、maxTokens、およびその他いくつかのパラメータをサポートしています。

model

サポート対象: すべての endpoint ( agents を除く)

Key	Type	Description	Example
model	String (nullable)	プリセットに使用するモデル名。選択したendpointの下で設定されたモデルと一致させる必要があります。	None

デフォルト: None

例:

preset:
  model: 'gpt-4-turbo'

temperature

サポート対象: openAI、azureOpenAI、google（temperatureとして）、anthropic（temperatureとして）、およびカスタム（OpenAI互換）

Key	Type	Description	Example
temperature	Number	モデルの応答の決定論的または「創造的」な度合いを制御します。

例:

preset:
  temperature: 0.7

presence_penalty

サポート対象: openAI, azureOpenAI, custom (OpenAI-like)
通常、Google/Anthropic/Bedrockでは使用されません

Key	Type	Description	Example
presence_penalty	Number	反復トークンに対するペナルティ。新しいトピックの探索を促進します。

例:

preset:
  presence_penalty: 0.3

frequency_penalty

サポート対象: openAI, azureOpenAI, custom (OpenAI-like)
通常、Google/Anthropic/Bedrockでは使用されません

Key	Type	Description	Example
frequency_penalty	Number	繰り返しトークンに対するペナルティ。応答内の冗長性を低減します。

例:

preset:
  frequency_penalty: 0.5

stop

サポート対象: openAI, azureOpenAI, custom (OpenAI-like)
通常、Google/Anthropic/Bedrockでは使用されません

Key	Type	Description	Example
stop	Array of Strings	モデルのストップトークン。これに遭遇するとモデルに応答を終了するよう指示します。

例:

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

top_p

サポート対象: openAI、azureOpenAI、カスタム (OpenAI互換)
Google/Anthropic は、top_p ではなく topP (「P」が大文字) を使用することがよくあります。

Key	Type	Description	Example
top_p	Number	Nucleus samplingパラメータ (0-1)、トークンのランダム性を制御します。

例:

preset:
  top_p: 0.9

topP

サポート対象: google & anthropic
(top_p と同様の目的ですが、それらのAPIでは異なる名称が付けられています)

Key	Type	Description	Example
topP	Number	Google/Anthropic endpoint用のNucleus samplingパラメータ。

例:

preset:
  topP: 0.8

topK

サポート対象: google & anthropic
(次のトークン分布に対するk-サンプリング制限)

Key	Type	Description	Example
topK	Number	次のトークンの選択を上位K個のトークンに制限します。

例:

preset:
  topK: 40

max_tokens

サポート対象: openAI, azureOpenAI, カスタム (OpenAI互換)
Google/Anthropicの場合は、(endpointに応じて) maxOutputTokens または maxTokens を使用してください。

Key	Type	Description	Example
max_tokens	Number	モデルの応答における最大トークン数。

例:

preset:
  max_tokens: 4096

maxOutputTokens

サポート対象: google, anthropic
これらのプロバイダーにおける max_tokens と同等です。

Key	Type	Description	Example
maxOutputTokens	Number	レスポンスの最大トークン数 (Google/Anthropic)。

例:

preset:
  maxOutputTokens: 2048

promptCache

サポート対象: anthropic、OpenRouterカスタムエンドポイント、bedrock (AnthropicおよびNovaモデル) (プロバイダーのプロンプトキャッシングを切り替え)

Key	Type	Description	Example
promptCache	Boolean	プロバイダーのプロンプトキャッシングを有効または無効にします。

デフォルト: true

例:

preset:
  promptCache: true

注: Bedrock エンドポイントの場合、Claude および Nova モデルではプロンプトキャッシングが自動的に有効になります。明示的に無効にするには promptCache: false を設定してください。

promptCacheTtl

サポート対象: anthropic、OpenRouter カスタムエンドポイント、bedrock (Anthropic および Nova モデル) (プロンプトキャッシングが有効な場合のプロンプトキャッシュの有効期間を設定します)

Key	Type	Description	Example
promptCacheTtl	Enum	prompt-cacheの有効期間を設定します。サポートされている値は `5m` および `1h` です。	Provider or SDK default

許容値:

5m
1h

例:

preset:
  promptCache: true
  promptCacheTtl: '1h'

注: promptCacheTtl は、プロンプトキャッシュが無効な場合は無視されます。省略された場合、プロバイダー統合はデフォルトのプロンプトキャッシュ有効期間を使用します。

reasoning_effort

許容値:

"" (空文字列 — 未設定、APIのデフォルトを使用)
"none"
"minimal"
"low"
"medium"
"high"
"xhigh" (超高)

サポート対象: openAI, azureOpenAI, カスタム (OpenAI互換), bedrock (ZAI, MoonshotAIモデル)

Key	Type	Description	Example
reasoning_effort	String	モデルの推論努力レベルを制御します。推論努力を減らすことで、応答の高速化や推論に使用されるトークン数の削減が可能になります。`xhigh`オプションは、複雑な問題に対して最大限の推論能力を提供します。Bedrockの場合、指定可能な値は`low`、`medium`、`high`です。

デフォルト: "" (未設定)

例:

preset:
  reasoning_effort: 'low'

reasoning_summary

許容値:

"" (空文字列 — 推論の要約を無効にします)
"auto"
"concise"
"detailed"

サポート対象: openAI、azureOpenAI、カスタム (OpenAI互換)

Key	Type	Description	Example
reasoning_summary	String	モデルの推論サマリー設定を定義します。

デフォルト: "" (無効)

例:

preset:
  reasoning_summary: 'detailed'

useResponsesApi

サポート対象: openAI、azureOpenAI、カスタム (OpenAI互換)

Key	Type	Description	Example
useResponsesApi	Boolean	モデルのレスポンスAPIを有効または無効にします。

デフォルト: false

例:

preset:
  useResponsesApi: true

verbosity

許容値:

"" (空文字列 — 未設定、APIのデフォルトを使用)
"low"
"medium"
"high"

サポート対象: openAI、azureOpenAI、カスタム (OpenAI互換)

Key	Type	Description	Example
verbosity	String	モデルの応答の冗長性を制御します。

デフォルト: "" (未設定)

例:

preset:
  verbosity: 'low'

web_search

サポート対象: openAI, azureOpenAI, custom (OpenAI-like), google, anthropic

Key	Type	Description	Example
web_search	Boolean	モデルのウェブ検索機能を有効または無効にします。

デフォルト: false

注: Google endpointの場合、このパラメータは実際のパネル上では Grounding with Google Search と表示されますが、実装上は web_search を制御します。

例:

preset:
  web_search: true

url_context

サポート対象: Gemini 2.5+ および Gemini 3.x を含む、サポートされている Gemini テキストモデル上の google

Key	Type	Description	Example
url_context	Boolean	Google URL Contextを有効にすることで、モデルがユーザーメッセージに含まれるURLを読み取れるようになります。YouTubeリンクは、可能な場合にネイティブの動画理解入力に変換されます。

デフォルト: false

例:

preset:
  url_context: true

disableStreaming

サポート対象: openAI、azureOpenAI、カスタム (OpenAI互換)

Key	Type	Description	Example
disableStreaming	Boolean	モデルからのストリーミング応答を無効にします。

デフォルト: false

例:

preset:
  disableStreaming: true

thinkingBudget

サポート対象: google, anthropic, bedrock (Anthropicモデル)

Key	Type	Description	Example
thinkingBudget	Number or String	モデルが内部推論に使用できる思考トークンの数を制御します。予算を増やすことで、複雑な問題に対する回答の品質が向上する可能性があります。

デフォルト: "Auto (-1)" (Google), 2000 (Anthropic, Bedrock (Anthropic models))

例:

preset:
  thinkingBudget: '2000'

thinkingLevel

サポート対象: google (Gemini 3+ モデル)

Key	Type	Description	Example
thinkingLevel	String	Gemini 3以降のモデルの思考努力レベルを制御します。Gemini 2.5モデルでは代わりに `thinkingBudget` を使用します。

許容値:

"" (未設定/自動)
"minimal"
"low"
"medium"
"high"

デフォルト: "" (未設定 — モデルが決定)

例:

preset:
  thinkingLevel: 'medium'

effort

サポート対象: anthropic, bedrock (Anthropicモデル)

Key	Type	Description	Example
effort	String	サポートされているAnthropicモデル（例：Claude Opus 4.6以降およびClaude Fable/Mythosクラスのモデル）のAdaptive Thinkingの努力レベルを制御します。努力レベルを高くすると、複雑な問題に対してより多くの思考トークンが割り当てられます。

オプション: "" (未設定/自動), "low", "medium", "high", "xhigh", "max"

デフォルト: "" (未設定 — モデルが決定)

例:

preset:
  effort: 'high'

thinkingDisplay

サポート対象: anthropic, bedrock (Anthropicモデル)

Key	Type	Description	Example
thinkingDisplay	String	モデルの応答に推論コンテンツを含めるかどうかを制御します。Claude Opus 4.7以降およびClaude Fable/Mythosクラスのモデルはデフォルトで思考コンテンツを除外しますが、この設定により、推論の要約を有効にするか、明示的に抑制するかを選択できます。

オプション: "auto" (デフォルト), "summarized", "omitted"

"auto" — LibreChatが決定します：デフォルトで思考プロセスを省略するモデル（Opus 4.7以降およびFable/Mythosクラス）に対しては"summarized"を有効にし、古いモデルに対してはこのフィールドをオフにします。
"summarized" — 常に事後的な推論の要約を要求します
"omitted" — 推論コンテンツを常に抑制する（レイテンシがわずかに低下します）

デフォルト: "auto"

例:

preset:
  thinkingDisplay: 'summarized'

thinking

サポート対象: google, anthropic, bedrock (Anthropicモデル)

Key	Type	Description	Example
thinking	Boolean	モデルが応答を生成する前に思考に時間を費やすべきかどうかを示します。

デフォルト: true

例:

preset:
  thinking: true

region

サポート対象: bedrock
(Amazon BedrockのAWSリージョンを指定するために使用されます)

Key	Type	Description	Example
region	String	Amazon Bedrock エンドポイントの AWS リージョン。

例:

preset:
  region: 'us-east-1'

maxTokens

サポート対象: bedrock
(max_tokens の代わりに使用)

Key	Type	Description	Example
maxTokens	Number	Amazon Bedrock endpointの最大出力トークン数。

例:

preset:
  maxTokens: 1024

Model Specs オブジェクト構造

このページの内容