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]?(buradaconversation-idmevcut 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-miniTemel 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-miniEndpoint 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=googleYalnı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-onlineModel 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-4oYalnı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 computingq, prompt için kullanılan birbirinin yerine geçebilen bir kısaltmadır:
https://your-domain.com/c/new?q=Explain quantum computingBunu diğer parametrelerle birleştirin:
https://your-domain.com/c/new?endpoint=anthropic&model=claude-3-5-sonnet-20241022&prompt=Explain quantum computingOtomatik 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=trueBu, 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=trueURL Kodlama
Sorgu değerlerindeki özel karakterler URL-encoded olmalıdır. Yaygın değişimler:
| Karakter | Kodlanmış |
|---|---|
: | %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-gpt4Bu, 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-idBu, 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-idBu, endpoint değerini otomatik olarak assistants olarak ayarlar.
Desteklenen Parametreler
LibreChat ayarları
| Parametre | Açıklama |
|---|---|
maxContextTokens | Sistem tarafından tanımlanan bağlam penceresini geçersiz kılar. |
resendFiles | Sonraki mesajlarda dosya yeniden gönderimini kontrol eder. |
promptPrefix | Özel talimatları / sistem mesajını ayarlar. |
imageDetail | Gö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). |
spec | Tam 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. |
fileTokenLimit | Maliyeti 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, disableStreamingGoogle, Anthropic:
topP, topK, maxOutputTokens, thinking, thinkingBudget, thinkingLevel, web_search, url_contextGoogle 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=1hAyrı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=mediumAssistants / 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=trueBu 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 markBir 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
- Mümkün olan her durumda hem
endpointhem demodeldeğerlerini ayarlayın. - Endpoint'in ilettiğiniz her parametreyi desteklediğini doğrulayın.
- Değerleri sağlayıcının sınırları içinde tutun.
- 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?
Geçici Sohbet
Geçici sohbetler, gizli ve odaklanmış bir deneyim için seçilen konuşmaları sohbet geçmişinizin, arama sonuçlarınızın ve yer işaretlerinizin dışında tutar.
Sohbetleri İçe Aktar
Sohbet İçe Aktarma özelliği, kullanıcıların diğer yapay zeka sohbet uygulamalarından dışa aktarılan sohbetleri içe aktarmasına olanak tanır. Şu anda ChatGPT, Claude ve ChatbotUI v1 üzerinden sohbet içe aktarmayı destekliyoruz.