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

Sorgu Parametreleri

LibreChat'te URL sorgu parametrelerini kullanarak sohbet konuşmalarını nasıl yapılandıracağınızı öğrenin. Modelleri, endpoint'leri ve konuşma ayarlarını dinamik olarak belirleyin.

LibreChat, bir sohbet konuşmasını doğrudan URL üzerinden yapılandırabilir. Sohbet yolu sonuna sorgu parametreleri ekleyerek endpoint ve modeli seçebilir, girişi önceden doldurabilir veya sohbet yüklenmeden önce konuşma ayarlarını geçersiz kılabilirsiniz.

Sohbet Yolları (Chat Paths)

Sorgu parametreleri geçerli bir sohbet yolunu izlemelidir:

  • Yeni sohbetler: /c/new?
  • Mevcut sohbetler: /c/[conversation-id]? (burada conversation-id mevcut bir sohbet kimliğidir)
https://your-domain.com/c/new?endpoint=ollama&model=llama3%3Alatest
https://your-domain.com/c/03debefd-6a50-438a-904d-1a806f82aad4?endpoint=openAI&model=o1-mini

Temel Kullanım

endpoint ve model parametreleri çoğu durumu kapsar. Öngörülebilir sonuçlar için her ikisini de ayarlayın:

https://your-domain.com/c/new?endpoint=azureOpenAI&model=o1-mini

Endpoint seçimi

Bir modeli adlandırmadan uç noktalar arasında geçiş yapmak için endpoint ifadesini tek başına kullanın:

https://your-domain.com/c/new?endpoint=google

Yalnızca endpoint ayarlandığında, LibreChat söz konusu endpoint için seçilen son modele ( localStorage üzerinden) geri döner. Daha önce yapılmış bir seçim yoksa, endpoint listesindeki ilk modeli kullanır.

endpoint değeri şunlardan biri olmalıdır:

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

Özel bir endpoint için, yapılandırılmış adını değer olarak kullanın (büyük/küçük harf duyarlı değildir):

# endpoint=perplexity for a custom endpoint named `Perplexity`
https://your-domain.com/c/new?endpoint=perplexity&model=llama-3.1-sonar-small-128k-online

Model seçimi

Mevcut endpoint içinde modeller arasında geçiş yapmak için tek başına model kullanın:

https://your-domain.com/c/new?model=gpt-4o

Yalnızca model ayarlandığında, LibreChat bunu yalnızca model mevcut endpoint içinde bulunuyorsa uygular. Mevcut endpoint, varsayılan endpoint veya en son seçilen endpoint'tir.

İstem

prompt parametresi, sohbet girişini önceden doldurur:

https://your-domain.com/c/new?prompt=Explain quantum computing

q, prompt için kullanılan birbirinin yerine geçebilen bir kısaltmadır:

https://your-domain.com/c/new?q=Explain quantum computing

Bunu diğer parametrelerle birleştirin:

https://your-domain.com/c/new?endpoint=anthropic&model=claude-3-5-sonnet-20241022&prompt=Explain quantum computing

Otomatik gönderim

İstemi manuel onay gerektirmeden otomatik olarak göndermek için submit=true ekleyin:

https://your-domain.com/c/new?prompt=Explain quantum computing&submit=true

Bu, otomatik iş akışları (Raycast, Alfred, Automator) ve harici entegrasyonlar için kullanışlıdır. Tamamen betikleştirilmiş bir başlatma için bunu diğer parametrelerle birleştirin:

https://your-domain.com/c/new?endpoint=openAI&model=gpt-4&prompt=Explain quantum computing&submit=true

URL Kodlama

Sorgu değerlerindeki özel karakterler URL-encoded olmalıdır. Yaygın değişimler:

KarakterKodlanmış
:%3A
/%2F
?%3F
#%23
&%26
=%3D
+%2B
Boşluk%20 (veya +)

Örneğin:

Original: `Write a function: def hello()`
Encoded: `/c/new?prompt=Write%20a%20function%3A%20def%20hello()`

JavaScript'in yerleşik encodeURIComponent() işlevi kodlamayı sizin yerinize halleder:

const prompt = "Write a function: def hello()";
const encodedPrompt = encodeURIComponent(prompt);
const url = `/c/new?prompt=${encodedPrompt}`;
console.log(url);

Kodlanmış URL'yi görmek için bunu tarayıcı konsolunuzda (Ctrl+Shift+I) çalıştırın.

Specs, Agents ve Assistants

Model Specs

İsme göre bir model spec seçin:

https://your-domain.com/c/new?spec=meeting-notes-gpt4

Bu, spec tarafından tanımlanan her ayarı yükler. spec mevcut olduğunda URL'deki diğer model parametreleri yok sayılır.

Ajanlar

Bir uç noktayı adlandırmadan kimliğe (ID) göre bir ajan yükleyin:

https://your-domain.com/c/new?agent_id=your-agent-id

Bu, endpoint değerini otomatik olarak agents olarak ayarlar.

Assistants

Aynı şekilde bir asistanı ID ile yükleyin:

https://your-domain.com/c/new?assistant_id=your-assistant-id

Bu, endpoint değerini otomatik olarak assistants olarak ayarlar.

Desteklenen Parametreler

LibreChat ayarları

ParametreAçıklama
maxContextTokensSistem tarafından tanımlanan bağlam penceresini geçersiz kılar.
resendFilesSonraki mesajlarda dosya yeniden gönderimini kontrol eder.
promptPrefixÖzel talimatları / sistem mesajını ayarlar.
imageDetailGörüntü kalitesi: low, auto veya high. Yalnızca OpenAI, OpenAI benzeri özel endpoint'ler ve Azure OpenAI için geçerlidir (varsayılan auto değeridir).
specTam adıyla bir model spec seçer. Ayarlandığında, diğer model parametreleri spec lehine göz ardı edilir. Eğer spec'ler enforce: true ile yapılandırılmışsa, URL sorgu parametrelerinin çalışması için bu parametre gerekli olabilir.
fileTokenLimitMaliyeti ve kaynak kullanımını kontrol etmek için dosya işleme için maksimum token sınırı. İstek değeri, YAML varsayılanını geçersiz kılar.

Model parametreleri

Desteklenen model parametreleri endpoint'e göre değişiklik gösterir. Değerler, sağlayıcının API'sine göre geçerli olmalıdır.

OpenAI, Custom, Azure OpenAI:

temperature, presence_penalty, frequency_penalty, stop, top_p, max_tokens,
reasoning_effort, reasoning_summary, verbosity, useResponsesApi, web_search, disableStreaming

Google, Anthropic:

topP, topK, maxOutputTokens, thinking, thinkingBudget, thinkingLevel, web_search, url_context

Google endpoint'leri için, desteklenen Gemini metin modellerinin kullanıcı mesajına dahil edilen URL'leri okumasını sağlamak üzere url_context=true ayarını yapın. URL Context etkinleştirildiğinde, YouTube URL'leri yerel video anlama özelliği ile işlenir.

Anthropic, Bedrock (Anthropic modelleri), OpenRouter özel endpoint'leri:

İstem önbelleğe almayı açıp kapatmak için promptCache değerini true veya false olarak ayarlayın. İstem önbelleğe alma etkinleştirildiğinde önbellek ömrünü seçmek için promptCacheTtl değerini 5m veya 1h olarak ayarlayın:

promptCache
promptCacheTtl=1h

Ayrıntılar için Anthropic prompt caching docs ve Bedrock prompt caching docs sayfalarına bakın.

Bedrock:

# Bedrock region
region=us-west-2
# Bedrock equivalent of `max_tokens`
maxTokens=200
# Bedrock reasoning effort (for supported models like ZAI, MoonshotAI)
reasoning_effort=medium

Assistants / Azure Assistants:

# Overrides existing assistant instructions for the current run
instructions=your+instructions
# Adds the current date and time to `additional_instructions` for each run
append_current_datetime=true

Bu parametrelerin çoğu Model Spec Preset Fields ile paylaşılmaktadır; tam referans için oraya bakabilirsiniz.

Örnekler

Tek bir URL içinde birden fazla parametre:

https://your-domain.com/c/new?endpoint=google&model=gemini-2.0-flash-exp&temperature=0.7&prompt=Oh hi mark

Bir istem ile Model Specs yükleme:

https://your-domain.com/c/new?spec=meeting-notes-gpt4&prompt=Here%20is%20the%20transcript...

spec kullanılırken, diğer model parametreleri, spec'in yapılandırması lehine göz ardı edilir.

Doğrulama

Tüm parametreler, uygulanmadan önce LibreChat şemasına göre doğrulanır. Geçersiz parametreler ve değerler göz ardı edilir; geçerli ayarlar ise konuşmaya uygulanır.

Sorgu parametrelerini dikkatli kullanın

  • Kötüye kullanım veya sağlayıcı limitlerinin aşılması API hatalarına yol açabilir.
  • Hatalı istek (bad request) hatası alırsanız, New Chat düğmesine tıklayarak konuşmayı sıfırlayın.
  • Seçili endpoint desteklemiyorsa bir parametrenin hiçbir etkisi olmaz.

En İyi Uygulamalar

  1. Mümkün olan her durumda hem endpoint hem de model değerlerini ayarlayın.
  2. Endpoint'in ilettiğiniz her parametreyi desteklediğini doğrulayın.
  3. Değerleri sağlayıcının sınırları içinde tutun.
  4. URL'leri paylaşmadan önce parametre kombinasyonlarını test edin.

Sorgu parametreleri; belirli konuşma yapılandırmalarını paylaşmayı, farklı sohbet kurulumlarını yer imlerine eklemeyi ve harici araçlardan sohbet başlatmayı otomatikleştirmeyi kolaylaştırır.

Bu rehber nasıl?