Parameter Kueri

LibreChat dapat mengonfigurasi percakapan obrolan secara langsung dari URL. Tambahkan parameter kueri ke jalur obrolan untuk memilih endpoint dan model, mengisi input sebelumnya, atau menimpa pengaturan percakapan sebelum obrolan dimuat.

Jalur Obrolan

Parameter kueri harus mengikuti jalur chat yang valid:

• Percakapan baru: /c/new?
• Percakapan yang ada: /c/[conversation-id]? (di mana conversation-id adalah percakapan yang sudah ada)

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

Penggunaan Dasar

Parameter endpoint dan model mencakup sebagian besar kasus. Atur keduanya untuk hasil yang dapat diprediksi:

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

Pemilihan endpoint

Gunakan endpoint secara mandiri untuk beralih antar endpoint tanpa menyebutkan nama model:

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

Ketika hanya endpoint yang diatur, LibreChat akan kembali ke model terakhir yang dipilih untuk endpoint tersebut (dari localStorage). Jika tidak ada pilihan sebelumnya, LibreChat akan menggunakan model pertama dalam daftar endpoint tersebut.

Nilai endpoint harus salah satu dari:

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

Untuk custom endpoint, gunakan nama yang telah dikonfigurasi sebagai nilainya (tidak peka huruf besar/kecil):

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

Pemilihan model

Gunakan model secara mandiri untuk beralih model dalam endpoint saat ini:

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

Ketika hanya model yang diatur, LibreChat menerapkannya hanya jika model tersebut ada di endpoint saat ini. Endpoint saat ini adalah endpoint default atau yang terakhir dipilih.

Prompt

Parameter prompt akan mengisi input obrolan sebelumnya:

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

q adalah singkatan yang dapat dipertukarkan untuk prompt:

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

Gabungkan dengan parameter lainnya:

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

Pengiriman otomatis

Tambahkan submit=true untuk mengirim prompt secara otomatis, tanpa konfirmasi manual:

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

Ini berguna untuk alur kerja otomatis (Raycast, Alfred, Automator) dan integrasi eksternal. Kombinasikan dengan parameter lainnya untuk peluncuran yang sepenuhnya menggunakan skrip:

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

Pengodean URL

Karakter khusus dalam nilai kueri harus di-URL-encode. Substitusi umum:

Sebagai contoh:

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

encodeURIComponent() bawaan JavaScript menangani pengodean untuk Anda:

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

Jalankan ini di konsol browser Anda (Ctrl+Shift+I) untuk melihat URL yang telah dienkode.

Spesifikasi, Agen, dan Asisten

Model specs

Pilih model spec berdasarkan nama:

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

Ini memuat setiap pengaturan yang didefinisikan oleh spec. Parameter model lainnya di dalam URL akan diabaikan ketika spec ada.

Agen

Muat agen berdasarkan ID tanpa memberi nama endpoint:

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

Ini mengatur endpoint ke agents secara otomatis.

Assistants

Muat asisten berdasarkan ID dengan cara yang sama:

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

Ini mengatur endpoint ke assistants secara otomatis.

Parameter yang Didukung

Pengaturan LibreChat

Parameter model

Parameter model yang didukung bervariasi tergantung pada endpoint. Nilai harus valid sesuai dengan API penyedia.

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

Untuk endpoint Google, atur url_context=true agar model teks Gemini yang didukung dapat membaca URL yang disertakan dalam pesan pengguna. URL YouTube ditangani dengan pemahaman video bawaan saat URL Context diaktifkan.

Anthropic, Bedrock (model Anthropic), endpoint kustom OpenRouter:

Atur promptCache ke true atau false untuk mengaktifkan atau menonaktifkan prompt caching. Atur promptCacheTtl ke 5m atau 1h untuk memilih masa berlaku cache saat prompt caching diaktifkan:

promptCache
promptCacheTtl=1h

Lihat dokumentasi prompt caching Anthropic dan dokumentasi prompt caching Bedrock untuk detailnya.

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

Sebagian besar parameter ini digunakan bersama dengan Model Spec Preset Fields; silakan merujuk ke sana untuk referensi lengkapnya.

Contoh

Beberapa parameter dalam satu URL:

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

Memuat Model Specs dengan prompt:

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

Saat menggunakan spec, parameter model lainnya akan diabaikan demi konfigurasi yang ada pada spec tersebut.

Validasi

Semua parameter divalidasi terhadap skema LibreChat sebelum diterapkan. Parameter dan nilai yang tidak valid akan diabaikan; pengaturan yang valid akan diterapkan pada percakapan.

Praktik Terbaik

1. Tetapkan endpoint dan model kapan pun memungkinkan.
2. Pastikan endpoint mendukung setiap parameter yang Anda berikan.
3. Jaga nilai agar tetap dalam batas penyedia.
4. Uji kombinasi parameter sebelum membagikan URL.

Parameter kueri memudahkan untuk berbagi konfigurasi percakapan tertentu, menandai pengaturan obrolan yang berbeda, dan mengotomatiskan permulaan obrolan dari alat eksternal.