Model Specs Nesne Yapısı
Genel Bakış
modelSpecs nesnesi, uygulamanızdaki yapay zeka modelleri için daha basit bir kullanıcı arayüzü deneyimi sunmanıza yardımcı olur.
modelSpecs altında 3 ana alan bulunmaktadır:
enforce(isteğe bağlı; varsayılan: false)prioritize(isteğe bağlı; varsayılan: true)list(gerekli)addedEndpoints(isteğe bağlı)
Notlar:
enforcedeğeri true olarak ayarlanırsa, Model Specs ayarları potansiyel olarakmodelSelect,presetsveparametersgibi diğer arayüz ayarlarıyla çakışabilir.listdizisi, belirli davranışları, görünümleri ve yetenekleri belirleyen ön ayarlar da dahil olmak üzere her model için ayrıntılı yapılandırmalar içerir.- Eğer interface alanları yapılandırmada belirtilmemişse, bir Model Specs listesine sahip olmak aşağıdaki arayüz öğelerini devre dışı bırakacaktır:
modelSelectparameterspresets
- Model specs ile birlikte bu arayüz öğelerini etkinleştirmek isterseniz, bunları
interfacenesnesi içindetrueolarak ayarlayabilirsiniz.
Model Specs ile kullanıcı tarafından sağlanan API anahtarlarını yönetme
Model Specs modelSelect özelliğini devre dışı bıraktığında, uç nokta açılır menüsü ve API Anahtarını Ayarla iletişim kutusunu açan dişli simgesi gizlenir. Kullanıcılar, apiKey: "user_provided" ile yapılandırılmış herhangi bir uç nokta için anahtarları Ayarlar → Veri kontrolleri → API anahtarları bölümünden ayarlamaya veya değiştirmeye devam edebilirler.
Bu liste, bir kullanıcının gerçekten erişebildiği endpoint'ler ile sınırlandırılmıştır: model specs tarafından referans verilen endpoint'ler ve addedEndpoints ile eklenenler. agents endpoint'ine erişilebildiğinde, bu liste aynı zamanda agent allowedProviders değerlerini de içerir (veya allowedProviders ayarlanmadığında yapılandırılmış tüm sağlayıcıları içerir).
Örnek
modelSpecs:
enforce: true
prioritize: true
list:
- name: 'meeting-notes-gpt4'
label: 'Meeting Notes Assistant (GPT4)'
softDefault: true
description: 'Generate meeting notes by simply pasting in the transcript from a Teams recording.'
iconURL: 'https://example.com/icon.png'
showOnLanding: true
conversation_starters:
- 'Summarize this meeting transcript'
- 'Extract action items and owners'
hideBadgeRow: true
skills:
- 'brand-guidelines'
- 'meeting-notes'
subagents:
enabled: true
allowSelf: true
agent_ids: []
preset:
endpoint: 'azureOpenAI'
model: 'gpt-4-turbo-1106-preview'
maxContextTokens: 128000 # Maximum context tokens
max_tokens: 4096 # Maximum output tokens
temperature: 0.2
modelLabel: 'Meeting Summarizer'
greeting: |
This assistant creates meeting notes based on transcripts of Teams recordings.
To start, simply paste the transcript into the chat box.
promptPrefix: |
Based on the transcript, create coherent meeting minutes for a business meeting. Include the following sections:
- Date and Attendees
- Agenda
- Minutes
- Action Items
Focus on what items were discussed and/or resolved. List any open action items.
The format should be a bulleted list of high level topics in chronological order, and then one or more concise sentences explaining the details.
Each high level topic should have at least two sub topics listed, but add as many as necessary to support the high level topic.
- Do not start items with the same opening words.
Take a deep breath and be sure to think step by step.Üst Düzey Alanlar
enforce
| Key | Type | Description | Example |
|---|---|---|---|
| enforce | Boolean | Model spesifikasyonlarının diğer yapılandırma ayarlarını kesin olarak geçersiz kılıp kılmayacağını belirler. | Setting this to `true` can lead to conflicts with interface options if not managed carefully. |
Varsayılan: false
Örnek:
modelSpecs:
enforce: trueprioritize
| Key | Type | Description | Example |
|---|---|---|---|
| prioritize | Boolean | Her ikisi de geçerli olduğunda, Model Specs öğesinin varsayılan yapılandırmaya göre öncelikli olup olmayacağını belirtir. | When set to `true`, it ensures that a modelSpec is always selected in the UI. Doing this may prevent users from selecting different endpoints for the selected spec. |
Varsayılan: true
Örnek:
modelSpecs:
prioritize: falseaddedEndpoints
| Key | Type | Description | Example |
|---|---|---|---|
| addedEndpoints | Array of Strings | Belirli endpoint'lerin (örneğin "openAI", "google") kullanıcı arayüzünde tanımlı Model Specs ile birlikte seçilebilir olmasını sağlar. | Requires `interface.modelSelect` to be `true`. If this field is used and `interface.modelSelect` is not explicitly set, `modelSelect` will default to `true`. |
Varsayılan: [] (boş liste)
Not: Aşağıdakilerden biri olmalıdır:
openAI, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock, agents
Örnek:
modelSpecs:
# ... other modelSpecs fields
addedEndpoints:
- openAI
- googlelist
Gerekli
| Key | Type | Description | Example |
|---|---|---|---|
| list | Array of Objects | Çeşitli yapılandırmaları ve davranışları detaylandıran bireysel Model Specs listesini içerir. | Each object in the list details the configuration for a specific model, including its behaviors, appearance, and capabilities related to the application's functionality. |
Model Spec (Liste Öğesi)
Her bir Model Spec veya her bir list öğesi içinde, aşağıdaki alanları yapılandırabilirsiniz:
name
| Key | Type | Description | Example |
|---|---|---|---|
| name | String | Model için benzersiz tanımlayıcı. | No default. Must be specified. |
Açıklama: Model için benzersiz tanımlayıcı.
label
| Key | Type | Description | Example |
|---|---|---|---|
| label | String | Model için başlık açılır menüsünde gösterilen kullanıcı dostu bir ad veya etiket. | No default. Optional. |
Açıklama: Model için kullanıcı dostu bir isim veya etiket; başlık açılır menüsünde gösterilir.
default
| Key | Type | Description | Example |
|---|---|---|---|
| default | Boolean | Bu model spec'in varsayılan seçim olup olmadığını ve her yeni sohbette otomatik olarak seçilip seçilmeyeceğini belirtir. |
Açıklama:
Bu Model Specs öğesinin varsayılan seçim olup olmadığını ve her yeni sohbette otomatik olarak seçilip seçilmeyeceğini belirtir.
softDefault
| Key | Type | Description | Example |
|---|---|---|---|
| softDefault | Boolean | Bu model spec'in yalnızca henüz bir model, model spec veya ajan seçmemiş olan ilk kez gelen kullanıcılar için seçilip seçilmeyeceğini belirtir. |
Açıklama:
Kullanıcının daha sonraki seçimlerini geçersiz kılmadan ilk çalıştırma için bir varsayılan değer belirler. Kullanıcı başka bir model, spec veya ajan seçtikten sonra kendi tercihini korurken, yeni kullanıcıları özel olarak seçilmiş bir spec'e yönlendirmek istediğinizde softDefault kullanın.
Soft-default bir spec kullanan eski bir konuşmayı görüntülemek, kullanıcı başka bir seçim yaptıktan sonra o spec'i kullanıcının varsayılanı olarak yeniden etkinleştirmez.
Örnek:
modelSpecs:
list:
- name: 'general-assistant'
label: 'General Assistant'
softDefault: true
preset:
endpoint: 'openAI'
model: 'gpt-4o-mini'iconURL
| Key | Type | Description | Example |
|---|---|---|---|
| iconURL | String | Seçicide, başlıkta ve sohbet markalamasında modelin simgesi için URL veya önceden tanımlanmış bir endpoint adı. | No default. Optional. |
Açıklama:
Modelin seçicide, başlıkta ve konuşma markalamasında görünecek simgesi için URL veya önceden tanımlanmış bir endpoint adı. Simgenin nerede görüneceğini kontrol etmek için showIconInMenu ve showIconInHeader kullanın.
description
| Key | Type | Description | Example |
|---|---|---|---|
| description | String | Model seçicide ve isteğe bağlı olarak sohbet başlangıç sayfasında gösterilen, modelin ve amaçlanan kullanımının veya rolünün kısa bir açıklaması. | No default. Optional. |
Açıklama:
Modelin ve amaçlanan kullanımının veya rolünün kısa bir açıklaması; model seçicide gösterilir. Eğer showOnLanding değeri true ise, aynı açıklama sohbet giriş sayfasında da spec etiketinin altında gösterilir.
Düz metin açıklamaları metin olarak oluşturulur. < ile başlayan açıklamalar, güvenli satır içi işaretlemeye ve küçük simgeler gibi medyalara izin veren yapılandırma HTML temizleyicisi aracılığıyla oluşturulur.
conversation_starters
| Key | Type | Description | Example |
|---|---|---|---|
| conversation_starters | Array of Strings | Bu Model Specs seçildiğinde sohbet giriş ekranında tıklanabilir kartlar olarak gösterilen önerilen başlangıç istemleri. | No default. Optional. |
Açıklama:
Sohbet başlatıcılar, kullanıcılara bir Model Specs için özel olarak hazırlanmış ilk istemleri sunar. Seçilen spec için boş sohbet açılış sayfasında gösterilirler ve özellikle showOnLanding markalaması ile birlikte kullanıldıklarında oldukça faydalıdırlar. Bir başlatıcıya tıklandığında, bu ifade yeni bir sohbetin ilk mesajı olarak gönderilir.
- Ajan/asistan sınırıyla eşleşecek şekilde en fazla 4 başlangıç öğesi görüntülenir.
- Eğer spesifikasyonun ön ayarı, kendi konuşma başlatıcılarını tanımlayan bir ajana veya asistana işaret ediyorsa, bunlar önceliklidir.
Örnek:
modelSpecs:
list:
- name: 'meeting-notes'
label: 'Meeting Notes'
showOnLanding: true
conversation_starters:
- 'Summarize this meeting transcript'
- 'Create action items with owners and due dates'
preset:
endpoint: 'agents'
model: 'gpt-4o'showOnLanding
| Key | Type | Description | Example |
|---|---|---|---|
| showOnLanding | Boolean | Bu Model Specs etiketini ve açıklamasını, varsayılan karşılama mesajı yerine sohbet giriş ekranında gösterir. | showOnLanding: true |
Varsayılan: false
Bunu, seçilmiş bir Model Specs boş sohbet ekranını markalaması gerektiğinde kullanın. showOnLanding değeri true olarak ayarlanmadığı sürece mevcut Model Specs değişmeden kalır.
Örnek:
modelSpecs:
list:
- name: 'branded-assistant'
label: 'Acme Research'
description: '<span><img src="/assets/acme.svg" alt="Acme" /> Research with approved sources</span>'
showOnLanding: true
iconURL: '/assets/acme.svg'
preset:
endpoint: 'openAI'
model: 'gpt-4o'group
| Key | Type | Description | Example |
|---|---|---|---|
| group | String | UI seçicisindeki Model Specs öğelerini düzenlemek için isteğe bağlı grup adı. Spesifikasyonun menü hiyerarşisinde nerede görüneceğini kontrol eder. | No default. Optional. |
| groupIcon | String | Özel gruplar için isteğe bağlı simge. Bir URL veya yerleşik bir endpoint anahtarı (örneğin, "openAI", "groq") olabilir. Her grupta yalnızca groupIcon içeren ilk spec kullanılır. | No default. Optional. |
Açıklama:
UI seçicisinde Model Specs'i düzenlemek için isteğe bağlı grup adı. group alanı, Model Specs'in nasıl düzenleneceği üzerinde esnek bir kontrol sağlar:
- Eğer
groupbir endpoint adıyla eşleşiyorsa (örneğin,"openAI","groq"): Model spec, seçici menüsünde ilgili endpoint'in altında iç içe geçmiş şekilde görünür. - Eğer
groupözel bir isimse (herhangi bir endpoint ile eşleşmiyorsa): Bu isimle ayrı, daraltılabilir bir bölüm oluşturur. Bu bölüm için özel bir simge ayarlamak isterseniz isteğe bağlı olarakgroupIconkullanabilirsiniz (URL veya"openAI"gibi yerleşik bir anahtar). groupbelirtilmediyse: Model spec, en üst seviyede bağımsız bir öğe olarak görünür
Bu özellik, seçici menüsünün organizasyonel yapısını kaybetmeden modellere açıklamalar eklemek istediğinizde özellikle kullanışlıdır.
hideBadgeRow
| Key | Type | Description | Example |
|---|---|---|---|
| hideBadgeRow | Boolean | Sohbet oluşturucudaki bu Model Specs için araç rozeti satırını gizler. | hideBadgeRow: true |
Varsayılan: false
Küratörlü bir Model Specs öğesinin, besteleyicinin (composer) altındaki araç/yetenek rozetleri satırını göstermemesi gerektiğinde bunu kullanın.
Örnek:
modelSpecs:
list:
- name: 'general-assistant'
label: 'General Assistant'
hideBadgeRow: true
preset:
endpoint: 'openAI'
model: 'gpt-4o-mini'Örnek:
modelSpecs:
list:
# Example 1: Nested under an endpoint
# When group matches an endpoint name, the spec appears under that endpoint
- name: 'gpt-4o-optimized'
label: 'GPT-4 Optimized'
description: 'Most capable GPT-4 model with multimodal support'
group: 'openAI' # Appears nested under the OpenAI endpoint
preset:
endpoint: 'openAI'
model: 'gpt-4o'
# Example 2: Custom group section with icon
# When group is a custom name, it creates a separate collapsible section
- name: 'coding-assistant'
label: 'Coding Assistant'
description: 'Specialized for coding tasks'
group: 'My Assistants'
groupIcon: 'https://example.com/icons/assistants.png' # Custom icon for the group
preset:
endpoint: 'openAI'
model: 'gpt-4o'
# Multiple specs with the same group name are grouped together
- name: 'writing-assistant'
label: 'Writing Assistant'
description: 'Specialized for creative writing'
group: 'My Assistants' # Grouped with coding-assistant, uses its icon
preset:
endpoint: 'anthropic'
model: 'claude-sonnet-4'
# Example 3: Custom group using built-in icon
- name: 'fast-model'
label: 'Fast Model'
group: 'Fast Models'
groupIcon: 'groq' # Uses built-in Groq icon
preset:
endpoint: 'groq'
model: 'llama3-8b-8192'
# Example 4: Standalone (no group)
# When group is omitted, the spec appears at the top level
- name: 'general-assistant'
label: 'General Assistant'
description: 'General purpose assistant'
# No group field - appears as standalone item at top level
preset:
endpoint: 'openAI'
model: 'gpt-4o-mini'showIconInMenu
| Key | Type | Description | Example |
|---|---|---|---|
| showIconInMenu | Boolean | Modelin simgesinin başlık açılır menüsünde görünüp görünmeyeceğini kontrol eder. |
Açıklama:
Modelin simgesinin başlık açılır menüsünde görünüp görünmeyeceğini kontrol eder. Varsayılan değer true şeklindedir.
showIconInHeader
| Key | Type | Description | Example |
|---|---|---|---|
| showIconInHeader | Boolean | Modelin simgesinin, adının solunda yer alan başlık açılır menü düğmesinde görünüp görünmeyeceğini kontrol eder. |
Açıklama:
Modelin simgesinin, başlık açılır menü düğmesinde, adının solunda görünüp görünmeyeceğini kontrol eder. Varsayılan değer true şeklindedir.
authType
| Key | Type | Description | Example |
|---|---|---|---|
| authType | String | Model spec için gerekli kimlik doğrulama türü. | Optional. Possible values: "override_auth", "user_provided", "system_defined" |
Açıklama:
Model spec için gerekli kimlik doğrulama türü. Kimlik doğrulamanın geçersiz kılınıp kılınmayacağını, kullanıcı tarafından mı sağlanacağını yoksa sistem tarafından mı tanımlanacağını belirler.
webSearch
| Key | Type | Description | Example |
|---|---|---|---|
| webSearch | Boolean | Bu Model Specs için web arama özelliğini etkinleştirir. | When true, the model can perform web searches. |
Açıklama:
Bu Model Specs için web arama özelliğini etkinleştirir. true olarak ayarlandığında, model güncel bilgileri almak için web araması gerçekleştirebilir.
Örnek:
modelSpecs:
list:
- name: 'research-assistant'
label: 'Research Assistant'
webSearch: true
preset:
endpoint: 'openAI'
model: 'gpt-4o'fileSearch
| Key | Type | Description | Example |
|---|---|---|---|
| fileSearch | Boolean | Bu Model Specs için dosya arama özelliğini etkinleştirir. | When true, the model can search through uploaded files. |
Açıklama:
Bu Model Specs için dosya arama özelliğini etkinleştirir. true olarak ayarlandığında, model yüklenen dosyalar içinde arama yapabilir ve bu dosyalara referans verebilir.
Örnek:
modelSpecs:
list:
- name: 'document-analyst'
label: 'Document Analyst'
fileSearch: true
preset:
endpoint: 'openAI'
model: 'gpt-4o'executeCode
| Key | Type | Description | Example |
|---|---|---|---|
| executeCode | Boolean | Bu Model Specs için kod yürütme özelliğini etkinleştirir. | When true, the model can execute code. |
Açıklama:
Bu Model Specs için kod yürütme özelliğini etkinleştirir. true olarak ayarlandığında, model korumalı bir ortamda kod yürütebilir.
Örnek:
modelSpecs:
list:
- name: 'code-assistant'
label: 'Code Assistant'
executeCode: true
preset:
endpoint: 'openAI'
model: 'gpt-4o'mcpServers
| Key | Type | Description | Example |
|---|---|---|---|
| mcpServers | Array of Strings | Bu Model Specs için etkinleştirilecek Model Context Protocol (MCP) sunucu adlarının listesi. | Each string should match a configured MCP server name. |
Açıklama:
Bu Model Specs için etkinleştirilecek Model Context Protocol (MCP) sunucu adlarının listesi. MCP sunucuları, özel araçlar ve kaynaklarla modelin yeteneklerini genişletir.
Örnek:
modelSpecs:
list:
- name: 'enhanced-assistant'
label: 'Enhanced Assistant'
mcpServers:
- 'filesystem'
- 'sequential-thinking'
- 'fetch'
preset:
endpoint: 'openAI'
model: 'gpt-4o'skills
| Key | Type | Description | Example |
|---|---|---|---|
| skills | Boolean or Array of Strings | Bu Model Specs için Yetenekleri (Skills) kontrol eder. Kullanıcının aktif erişilebilir kataloğu için true, Yetenekleri zorunlu olarak kapatmak için false veya katı bir izin listesi olarak Yetenek adlarından oluşan bir dizi kullanın. | skills: ["brand-guidelines", "code-review"] |
Açıklama:
Agents endpoint Skills özelliği mevcut olduğunda bu Model Specs için Skills'i kontrol eder.
true: kullanıcının aktif erişilebilir Beceri kataloğunu etkinleştirir.false: bu Model Specs için Skills özelliğini devre dışı bırakır.- Beceri adlarından oluşan dizi: belirtilen Beceriler için kataloğu daraltır, manuel çağırmayı sağlar ve her zaman uygulama çözümlemesi yapar.
Örnek:
modelSpecs:
list:
- name: 'brand-assistant'
label: 'Brand Assistant'
skills:
- 'brand-guidelines'
- 'approved-claims'
preset:
endpoint: 'agents'
model: 'gpt-4o'subagents
| Key | Type | Description | Example |
|---|---|---|---|
| subagents.enabled | Boolean | Bu Model Specs'ten oluşturulan geçici aracılar için Subagents özelliğini etkinleştirir. | enabled: true |
| subagents.allowSelf | Boolean | Geçici ajanın, odaklanmış çalışma için kendisinin yalıtılmış bir kopyasını oluşturmasına olanak tanır. | allowSelf: true |
| subagents.agent_ids | Array of Strings | Bu model spesifikasyonunun oluşturabileceği ek agent ID'lerinin özel sunucu tarafı izin listesi. | agent_ids: [] |
Açıklama:
Bu model spec'ten oluşturulan geçici (ephemeral) aracılar için Subagents'ı kontrol eder. Bunu, kullanıcıların kalıcı bir üst aracı oluşturmasını veya seçmesini gerektirmeden, küratörlü bir model spec'in delegasyon davranışını sergilemesini istediğinizde kullanın.
enabled: bu Model Specs için alt aracı (subagent) oluşturma aracını ekler.allowSelf: geçici ajanın kendisinin yalıtılmış yeni bir kopyasını oluşturmasına izin verir.agent_ids: ek alt temsilciler olarak belirli kalıcı temsilcilere izin verir. Bu listeMAX_SUBAGENTSile sınırlandırılmıştır ve sunucu tarafında kalır; istemcilere gönderilen başlangıç yapılandırması yalnızca herkese açıkenabledveallowSelfbayraklarını içerir.
Model Specs zorunlu kılındığında, model spec'in subagents ayarları, istek yükü (payload) değerlerine göre yetkili kılınır.
Örnek:
modelSpecs:
list:
- name: 'research-assistant'
label: 'Research Assistant'
subagents:
enabled: true
allowSelf: true
agent_ids: []
preset:
endpoint: 'agents'
model: 'gpt-4o'artifacts
| Key | Type | Description | Example |
|---|---|---|---|
| artifacts | String | Boolean | Bu Model Specs için Artifacts özelliğini etkinleştirir ve isteğe bağlı olarak artifact modunu ayarlar. | Set to `true` to enable with the default mode, `false` or omit to disable, or a specific mode string (e.g., `"default"`) to enable with that mode. |
Açıklama:
Bu Model Specs için Artifacts özelliğini etkinleştirir; bu sayede modelin React bileşenleri, HTML ve Mermaid diyagramları gibi etkileşimli artifact'ler oluşturmasına ve görüntülemesine olanak tanır. true olarak ayarlandığında, varsayılan artifact modu kullanılır. Ayrıca doğrudan bir mod dizgisi de belirtebilirsiniz.
Örnek:
modelSpecs:
list:
- name: 'artifact-assistant'
label: 'Artifact Assistant'
artifacts: true
preset:
endpoint: 'openAI'
model: 'gpt-4o'preset
| Key | Type | Description | Example |
|---|---|---|---|
| preset | Object | Modelin davranışını ve yeteneklerini tanımlayan ayrıntılı ön ayar yapılandırmaları. | See "Preset Object Structure" below. |
Açıklama:
Modelin davranışını ve yeteneklerini tanımlayan ayrıntılı ön ayar yapılandırmaları (aşağıdaki Preset Object Structure bölümüne bakın).
Ön Ayar Alanları
modelSpecs.list öğesi için preset alanı, sistem içindeki AI modellerine yönelik kapsamlı bir yapılandırma planından oluşur. Bu alan, AI modellerinin operasyonel ayarlarını belirlemek, davranışlarını, çıktılarını ve diğer sistem bileşenleri ve endpoint'ler ile olan etkileşimlerini özelleştirmek için tasarlanmıştır.
Sistem Seçenekleri
endpoint
Gerekli
Kabul Edilen Değerler:
openAIazureOpenAIgoogleanthropicassistantsazureAssistantsbedrockagents
Not: Özel bir endpoint kullanıyorsanız, endpoint değeri tanımlanan özel endpoint adı ile tam olarak eşleşmelidir.
| Key | Type | Description | Example |
|---|---|---|---|
| endpoint | Enum (EModelEndpoint) or String (nullable) | Modelin işlemleri gerçekleştirmek için iletişim kurduğu endpoint'i belirtir. Bu ayar, modelin arayüz oluşturduğu harici veya dahili hizmeti belirler. |
Örnek:
preset:
endpoint: 'openAI'modelLabel
| Key | Type | Description | Example |
|---|---|---|---|
| modelLabel | String (nullable) | Kullanıcı arayüzlerinde veya günlüklerde modeli tanımlamak için kullanılan etiket. Arayüzde görüntülenen ve ayrıca yapay zekaya tanıtılan, model için insan tarafından okunabilir bir ad sağlar. | None |
Varsayılan: None
Örnek:
preset:
modelLabel: 'Customer Support Bot'greeting
| Key | Type | Description | Example |
|---|---|---|---|
| greeting | String | Yeni bir sohbet başlatılmadan önce arayüzde görünen önceden tanımlanmış bir mesaj. Bu, kullanıcıya talimatlar vermek veya arayüzü daha samimi ve erişilebilir kılmak için iyi bir yoldur. |
Varsayılan: None
Örnek:
preset:
greeting: 'This assistant creates meeting notes based on transcripts of Teams recordings. To start, simply paste the transcript into the chat box.'promptPrefix
| Key | Type | Description | Example |
|---|---|---|---|
| promptPrefix | String (nullable) | Modele gönderilen her istemin başına eklenen ve yanıtlar için tutarlı bir bağlam oluşturan statik bir metin. | When using "assistants" as the endpoint, this becomes the OpenAI field `additional_instructions`. |
Varsayılan: None
Örnek 1:
preset:
promptPrefix: 'As a financial advisor, ...'Örnek 2:
preset:
promptPrefix: |
Based on the transcript, create coherent meeting minutes for a business meeting. Include the following sections:
- Date and Attendees
- Agenda
- Minutes
- Action Items
Focus on what items were discussed and/or resolved. List any open action items.
The format should be a bulleted list of high level topics in chronological order, and then one or more concise sentences explaining the details.
Each high level topic should have at least two sub topics listed, but add as many as necessary to support the high level topic.
- Do not start items with the same opening words.
Take a deep breath and be sure to think step by step.resendFiles
| Key | Type | Description | Example |
|---|---|---|---|
| resendFiles | Boolean | Kalıcı oturumların sürdürülmediği senaryolarda dosyaların yeniden gönderilip gönderilmeyeceğini belirtir. |
Varsayılan: true
Örnek:
preset:
resendFiles: trueimageDetail
Kabul Edilen Değerler:
- düşük
- otomatik
- yüksek
| Key | Type | Description | Example |
|---|---|---|---|
| imageDetail | Enum (eImageDetailSchema) | Görüntü analizi görevlerinde gereken ayrıntı düzeyini belirtir, görsel yeteneklere sahip modeller için geçerlidir (OpenAI spesifikasyonu). |
Varsayılan: "auto"
Örnek:
preset:
imageDetail: 'high'maxContextTokens
| Key | Type | Description | Example |
|---|---|---|---|
| maxContextTokens | Number | Modele sağlanacak maksimum bağlam belirteci (context token) sayısı. | Useful if you want to limit the maximum context for this preset. |
Örnek:
preset:
maxContextTokens: 4096Ajan Seçenekleri
Bu seçeneklerin yalnızca agents endpoint kullanıldığında geçerli olduğunu unutmayın.
Herhangi bir model seçeneğini hariç tutmalı ve arayüzde tanımlandığı şekliyle temsilcinin (agent) yapılandırmasına başvurmalısınız.
Ajan Erişim Filtreleme (v0.8.0+)
v0.8.0 itibarıyla LibreChat, ajanlar için ACL (Erişim Denetim Listesi) tabanlı bir izin sistemi kullanmaktadır. Model Specs ajanları kullanacak şekilde yapılandırıldığında, kullanıcının erişim izni olmayan tüm ajanlar, model spec içinde yapılandırılmış olsalar dahi otomatik olarak filtrelenir. Bu, kullanıcıların yalnızca uygun izinlere sahip oldukları ajanları görmelerini ve kullanabilmelerini sağlar.
ACL izin sistemi hakkında daha fazla bilgi için Agents belgelerine bakın.
agent_id
| Key | Type | Description | Example |
|---|---|---|---|
| agent_id | String | Bir asistanın tanımlanması. |
Örnek:
preset:
agent_id: 'agent_someUniqueId'Asistan Seçenekleri
Bu seçeneklerin yalnızca assistants veya azureAssistants endpoint'i kullanılırken geçerli olduğunu unutmayın.
Agents kısmına benzer şekilde, herhangi bir model seçeneğini hariç tutmalı ve asistanın yapılandırmasına güvenmelisiniz.
assistant_id
| Key | Type | Description | Example |
|---|---|---|---|
| assistant_id | String | Bir asistanın tanımlanması. |
Örnek:
preset:
assistant_id: 'asst_someUniqueId'instructions
Not: bu, mevcut çalıştırmalar için mevcut asistan talimatlarını geçersiz kıldığından promptPrefix öğesinden farklıdır.
Bunu yalnızca asistanın temel talimatlarını geçersiz kılmak istiyorsanız kullanın.
additional_instructions için promptPrefix kullanın.
Daha fazla bilgi:
- 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 | Asistanın varsayılan talimatlarını geçersiz kılar. |
Örnek:
preset:
instructions: 'Please handle customer queries regarding order status.'append_current_datetime
Her çalıştırma için additional_instructions kısmına güncel tarih ve saati ekler. promptPrefix değerinin üzerine yazmaz, ona ekleme yapar.
| Key | Type | Description | Example |
|---|---|---|---|
| append_current_datetime | Boolean | `promptPrefix` tarafından tanımlandığı şekilde `additional_instructions` kısmına güncel tarih ve saati ekler |
Örnek:
preset:
append_current_datetime: trueModel Seçenekleri
Not: Aşağıdaki her parametre, hangi endpoint'lerin bunu desteklediğine dair bir not içerir.
OpenAI / AzureOpenAI / Custom genellikletemperature,presence_penalty,frequency_penalty,stop,top_p,max_tokensparametrelerini destekler.
Google / Anthropic genellikletopP,topK,maxOutputTokensparametrelerini destekler; Google ayrıca desteklenen Gemini metin modellerindeurl_contextözelliğini de destekler. Anthropic / OpenRouter / Bedrock (Anthropic ve Nova modelleri)promptCachevepromptCacheTtlparametrelerini destekler. Bedrockregion,maxTokensve diğer birkaç parametreyi destekler.
model
Destekleyenler: Tüm endpoint'ler (
agentshariç)
| Key | Type | Description | Example |
|---|---|---|---|
| model | String (nullable) | Ön ayar için kullanılacak model adı; seçilen endpoint altında yapılandırılmış bir modelle eşleşmelidir. | None |
Varsayılan: None
Örnek:
preset:
model: 'gpt-4-turbo'temperature
Destekleyenler:
openAI,azureOpenAI,temperatureolarak),anthropic(temperatureolarak) ve özel (OpenAI benzeri)
| Key | Type | Description | Example |
|---|---|---|---|
| temperature | Number | Model yanıtlarının ne kadar belirleyici veya “yaratıcı” olacağını kontrol eder. |
Örnek:
preset:
temperature: 0.7presence_penalty
Destekleyenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
Genellikle Google/Anthropic/Bedrock tarafından kullanılmaz
| Key | Type | Description | Example |
|---|---|---|---|
| presence_penalty | Number | Tekrarlayan belirteçler için ceza, yeni konuların keşfedilmesini teşvik eder. |
Örnek:
preset:
presence_penalty: 0.3frequency_penalty
Destekleyenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
Genellikle Google/Anthropic/Bedrock tarafından kullanılmaz
| Key | Type | Description | Example |
|---|---|---|---|
| frequency_penalty | Number | Tekrarlanan belirteçler için ceza, yanıtlardaki fazlalığı azaltır. |
Örnek:
preset:
frequency_penalty: 0.5stop
Destekleyenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
Genellikle Google/Anthropic/Bedrock tarafından kullanılmaz
| Key | Type | Description | Example |
|---|---|---|---|
| stop | Array of Strings | Model için durdurma belirteçleri; karşılaşıldığında yanıtı sonlandırması talimatını verir. |
Örnek:
preset:
stop:
- 'END'
- 'STOP'top_p
Desteklenenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
Google/Anthropic genellikletop_pyerinetopP(büyük “P” ile) kullanır.
| Key | Type | Description | Example |
|---|---|---|---|
| top_p | Number | Nucleus örnekleme parametresi (0-1), token rastgeleliğini kontrol eder. |
Örnek:
preset:
top_p: 0.9topP
Destekleyenler:
anthropic
(top_pile benzer bir amaca sahiptir, ancak bu API'lerde farklı şekilde adlandırılmıştır)
| Key | Type | Description | Example |
|---|---|---|---|
| topP | Number | Google/Anthropic endpoint'leri için Nucleus sampling parametresi. |
Örnek:
preset:
topP: 0.8topK
Destekleyenler:
anthropic
(bir sonraki token dağılımı üzerinde k-sampling sınırı)
| Key | Type | Description | Example |
|---|---|---|---|
| topK | Number | Bir sonraki token seçimini en üstteki K token ile sınırlar. |
Örnek:
preset:
topK: 40max_tokens
Destekleyenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
Google/Anthropic için (endpoint'e bağlı olarak)maxOutputTokensveyamaxTokenskullanın.
| Key | Type | Description | Example |
|---|---|---|---|
| max_tokens | Number | Model yanıtındaki maksimum token sayısı. |
Örnek:
preset:
max_tokens: 4096maxOutputTokens
Destekleyenler:
anthropic
Bu sağlayıcılar içinmax_tokensile eşdeğerdir.
| Key | Type | Description | Example |
|---|---|---|---|
| maxOutputTokens | Number | Yanıt içindeki maksimum token sayısı (Google/Anthropic). |
Örnek:
preset:
maxOutputTokens: 2048promptCache
Destekleyenler:
anthropic, OpenRouter özel endpoint'leri,bedrock(Anthropic ve Nova modelleri) (Sağlayıcı istem önbelleğe almayı aç/kapat)
| Key | Type | Description | Example |
|---|---|---|---|
| promptCache | Boolean | Sağlayıcı istem önbelleğe almayı etkinleştirir veya devre dışı bırakır. |
Varsayılan: true
Örnek:
preset:
promptCache: trueNot: Bedrock endpoint'leri için, Claude ve Nova modellerinde prompt caching otomatik olarak etkindir. Bunu açıkça devre dışı bırakmak için promptCache: false ayarını yapın.
promptCacheTtl
Destekleyenler:
anthropic, OpenRouter özel endpoint'leri,bedrock(Anthropic ve Nova modelleri) (İstem önbelleğe alma etkinleştirildiğinde istem önbelleği ömrünü ayarlar)
| Key | Type | Description | Example |
|---|---|---|---|
| promptCacheTtl | Enum | Prompt-cache ömrünü ayarlar. Desteklenen değerler `5m` ve `1h` şeklindedir. | Provider or SDK default |
Kabul Edilen Değerler:
5m1h
Örnek:
preset:
promptCache: true
promptCacheTtl: '1h'Not: promptCacheTtl, prompt önbelleğe alma devre dışı bırakıldığında yoksayılır. Belirtilmediğinde, sağlayıcı entegrasyonu kendi varsayılan prompt-cache ömrünü kullanır.
reasoning_effort
Kabul Edilen Değerler:
""(boş dizge — ayarlanmamış, API varsayılanını kullanır)"none""minimal""low""medium""high""xhigh"(ekstra yüksek)
Desteklenenler:
openAI,azureOpenAI, özel (OpenAI benzeri),bedrock(ZAI, MoonshotAI modelleri)
| Key | Type | Description | Example |
|---|---|---|---|
| reasoning_effort | String | Model için muhakeme çabası seviyesini kontrol eder. Muhakeme çabasını azaltmak, daha hızlı yanıtlar ve muhakeme için daha az token kullanımı sağlayabilir. `xhigh` seçeneği, karmaşık problemler için maksimum muhakeme yeteneği sunar. Bedrock için kabul edilen değerler `low`, `medium`, `high` şeklindedir. |
Varsayılan: "" (ayarlanmamış)
Örnek:
preset:
reasoning_effort: 'low'reasoning_summary
Kabul Edilen Değerler:
""(boş dizge — düşünme özetlerini devre dışı bırakır)"auto""concise""detailed"
Desteklenenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
| Key | Type | Description | Example |
|---|---|---|---|
| reasoning_summary | String | Model için düşünme özeti tercihlerini ayarlar. |
Varsayılan: "" (devre dışı)
Örnek:
preset:
reasoning_summary: 'detailed'useResponsesApi
Desteklenenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
| Key | Type | Description | Example |
|---|---|---|---|
| useResponsesApi | Boolean | Model için yanıtlar API'sini etkinleştirir veya devre dışı bırakır. |
Varsayılan: false
Örnek:
preset:
useResponsesApi: trueverbosity
Kabul Edilen Değerler:
""(boş dizge — ayarlanmamış, API varsayılanını kullanır)"low""medium""high"
Desteklenenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
| Key | Type | Description | Example |
|---|---|---|---|
| verbosity | String | Model yanıtlarının ayrıntı düzeyini kontrol eder. |
Varsayılan: "" (ayarlanmamış)
Örnek:
preset:
verbosity: 'low'web_search
Desteklenenler:
openAI,azureOpenAI, özel (OpenAI benzeri),anthropic
| Key | Type | Description | Example |
|---|---|---|---|
| web_search | Boolean | Model için web arama işlevini etkinleştirir veya devre dışı bırakır. |
Varsayılan: false
Not: Google endpoint'leri için bu parametre, gerçek panelde Grounding with Google Search olarak görünür ancak uygulamada web_search değerini kontrol eder.
Örnek:
preset:
web_search: trueurl_context
Destekleyenler: Gemini 2.5+ ve Gemini 3.x dahil olmak üzere desteklenen Gemini metin modellerinde
| Key | Type | Description | Example |
|---|---|---|---|
| url_context | Boolean | Modelin kullanıcı mesajında yer alan URL'leri okuyabilmesi için Google URL Context'i etkinleştirir. YouTube bağlantıları, mümkün olduğunda yerel video anlama girdilerine dönüştürülür. |
Varsayılan: false
Örnek:
preset:
url_context: truedisableStreaming
Desteklenenler:
openAI,azureOpenAI, özel (OpenAI benzeri)
| Key | Type | Description | Example |
|---|---|---|---|
| disableStreaming | Boolean | Modelden gelen yanıtların akışını devre dışı bırakır. |
Varsayılan: false
Örnek:
preset:
disableStreaming: truethinkingBudget
Destekleyenler:
anthropic,bedrock(Anthropic modelleri)
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingBudget | Number or String | Modelin içsel muhakeme için kullanabileceği düşünme belirteci (thinking token) sayısını kontrol eder. Daha büyük bütçeler, karmaşık problemler için yanıt kalitesini artırabilir. |
Varsayılan: "Auto (-1)" (Google), 2000 (Anthropic, Bedrock (Anthropic modelleri))
Örnek:
preset:
thinkingBudget: '2000'thinkingLevel
Destekleyen:
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingLevel | String | Gemini 3+ modelleri için düşünme çabası seviyesini kontrol eder. Gemini 2.5 modelleri bunun yerine `thinkingBudget` kullanır. |
Kabul Edilen Değerler:
""(ayarlanmamış/otomatik)"minimal""low""medium""high"
Varsayılan: "" (ayarlanmamış — model karar verir)
Örnek:
preset:
thinkingLevel: 'medium'effort
Destekleyenler:
anthropic,bedrock(Anthropic modelleri)
| Key | Type | Description | Example |
|---|---|---|---|
| effort | String | Desteklenen Anthropic modelleri (örneğin, Claude Opus 4.6+ ve Claude Fable/Mythos sınıfı modeller) için Adaptive Thinking çaba düzeyini kontrol eder. Daha yüksek çaba düzeyleri, karmaşık problemler için daha fazla düşünme token'ı ayırır. |
Seçenekler: "" (ayarlanmamış/otomatik), "low", "medium", "high", "xhigh", "max"
Varsayılan: "" (ayarlanmamış — model karar verir)
Örnek:
preset:
effort: 'high'thinkingDisplay
Destekleyenler:
anthropic,bedrock(Anthropic modelleri)
| Key | Type | Description | Example |
|---|---|---|---|
| thinkingDisplay | String | Model yanıtlarında düşünme içeriğinin döndürülüp döndürülmeyeceğini kontrol eder. Claude Opus 4.7+ ve Claude Fable/Mythos sınıfı modeller varsayılan olarak düşünme içeriğini çıkarır; bu ayar, düşünme özetlerini dahil etmenize veya bunları açıkça devre dışı bırakmanıza olanak tanır. |
Seçenekler: "auto" (varsayılan), "summarized", "omitted"
"auto"— LibreChat karar verir: varsayılan olarak düşünme sürecini atlayan modeller için (Opus 4.7+ ve Fable/Mythos sınıfı)"summarized"seçeneğini etkinleştirir, daha eski modeller için ise alanı boş bırakır"summarized"— her zaman muhakemenin post-hoc bir özetini talep eder"omitted"— her zaman düşünme içeriğini bastırır (biraz daha düşük gecikme süresi)
Varsayılan: "auto"
Örnek:
preset:
thinkingDisplay: 'summarized'thinking
Destekleyenler:
anthropic,bedrock(Anthropic modelleri)
| Key | Type | Description | Example |
|---|---|---|---|
| thinking | Boolean | Modelin yanıt oluşturmadan önce düşünmeye zaman ayırıp ayırmayacağını belirtir. |
Varsayılan: true
Örnek:
preset:
thinking: trueregion
Destekleyen:
bedrock
(Amazon Bedrock için bir AWS bölgesi belirtmek amacıyla kullanılır)
| Key | Type | Description | Example |
|---|---|---|---|
| region | String | Amazon Bedrock endpoint'leri için AWS bölgesi. |
Örnek:
preset:
region: 'us-east-1'maxTokens
Destekleyen:
bedrock
(max_tokensyerine kullanılır)
| Key | Type | Description | Example |
|---|---|---|---|
| maxTokens | Number | Amazon Bedrock endpoint'leri için maksimum çıktı token sayısı. |
Örnek:
preset:
maxTokens: 1024Bu rehber nasıl?