---
title: "Chat template (sohbet şablonu) nedir? Mesajlar token'a"
description: "Sohbet şablonu, rol ve içerik mesajlarından oluşan listeyi sohbet modelinin eğitildiği token dizisine çevirir. Şablonlar nasıl çalışır, yanlışı neden zarar verir?"
url: https://broadrouter.com/tr/glossary/chat-template/
lang: tr
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/glossary/chat-template/) (güncelleme: 2026-11-15).

# Sohbet şablonu (chat template)

Güncellendi 2026-11-15

Sohbet şablonu (chat template), genellikle Jinja ile yazılan ve modelin tokenizer'ıyla birlikte gelen, rollere sahip sohbet mesajlarından oluşan bir listeyi modelin beklediği tek token dizisine, özel kontrol token'larıyla birlikte dönüştüren biçimlendirme kuralıdır. Yanlış şablon, modelin cevaplarını ciddi biçimde bozabilir.

Diğer adları: sohbet şablonu, chat şablonu, Jinja sohbet şablonu, chat\_template, Jinja chat template, tokenizer chat template

Bir sohbet modeli hiçbir zaman bir mesaj listesi görmez. Uzun tek bir token dizisi görür. O dizinin neye benzeyeceğine sohbet şablonu karar verir.

## Nasıl çalışır

Hugging Face rehberi temel noktayı söyler: tüm nedensel dil modelleri “continue a sequence of tokens” (çeviri: bir token dizisini sürdürür) ve verdiğiniz rol ve içerik sözlükleri “get converted to a token sequence, often with control tokens” (çeviri: çoğu zaman kontrol token’larıyla birlikte bir token dizisine dönüştürülür). Farklı modeller, “even if they were fine-tuned from the same base model” (çeviri: aynı temel modelden ince ayarlanmış olsalar bile) farklı biçimler kullanır.

Rehberde aynı kısa sohbet iki şablonla şöyle oluşturulur:

```text
Mistral-7B-Instruct:
<s>[INST] Hello, how are you? [/INST]I'm doing great. How can I help you today?</s>

Zephyr-7B:
<|user|>
Hello, how are you?</s>
<|assistant|>
I'm doing great. How can I help you today?</s>
```

Transformers’ta bir sohbeti `tokenizer.apply_chat_template(messages, add_generation_prompt=True)` ile oluşturursunuz. `add_generation_prompt` bayrağı bir asistan turunu açan token’ları ekler; rehber, bunlar olmadan modelin yanıt vermek yerine kullanıcının mesajını sürdürebileceği konusunda uyarır.

Şablonlar model özelliklerini de taşıyabilir. Google’ın Gemma 4 kartı, düşünme modunun sistem isteminin başına bir `<|think|>` token’ı konarak açıldığını ve “many libraries like Transformers and llama.cpp handle the complexities of the chat template for you.” (çeviri: Transformers ve llama.cpp gibi birçok kütüphane sohbet şablonunun karmaşıklığını sizin yerinize halleder.) olduğunu söyler.

## Neden önemli

-   **Kalite.** Rehber, “with the wrong control tokens, these models would have drastically worse performance.” (çeviri: yanlış kontrol token’larıyla bu modellerin performansı büyük ölçüde kötüleşir.) der.
-   **Kendi sunucunuzda barındırma.** Sunum motorları sohbet isteklerini kabul etmek için bir şablona ihtiyaç duyar. vLLM belgeleri, şablon olmadan “all chat requests will error” (çeviri: tüm sohbet istekleri hata verir) der ve şablonu sağlamak için `--chat-template` kabul eder. Bkz. [vLLM](https://broadrouter.com/tr/glossary/vllm/).
-   **Token sayıları.** Kontrol token’ları girdi [token’ı](https://broadrouter.com/tr/glossary/token/) olarak sayılır. [Göndermeden önce token sayma](https://broadrouter.com/tr/blog/count-tokens-before-sending/) yazımız yerel sayılarla faturalanan sayıların neden farklı olduğunu anlatır.
-   **Çift özel token’lar.** Rehber, şablonlamadan sonra `<bos>` veya `<eos>` eklemenin “is often incorrect or duplicated, hurting model performance” (çeviri: çoğu zaman yanlış veya tekrarlı olduğu ve model performansına zarar verdiği) konusunda uyarır.
-   **[Sistem istemi](https://broadrouter.com/tr/glossary/system-prompt/) de bunun parçasıdır.** Sistem mesajının nereye yerleşeceğine ve modelin bir sistem rolü olup olmadığına şablon karar verir.

## BroadNet Inference’ta

BroadNet’in API’si [OpenAI uyumlu](https://broadrouter.com/tr/glossary/openai-compatible-api/) bir chat completions uç noktasıdır; yani `messages` gönderirsiniz ve şablonu BroadNet uygular; ham şablon metni göndermezsiniz. BroadNet, [Gemma 4 VL 26B](https://broadrouter.com/tr/models/gemma-4-vl-26b/) modelini konuşma odaklı iş akışı için ayarlanmış bir şablon olan “BroadNet conversational chat template” (çeviri: BroadNet konuşma sohbet şablonu) ile sunduğunu bildirir. BroadNet’in Gemma’sını yerelde çalıştırılan aynı ağırlıklarla karşılaştırırsanız cevaplar farklı olabilir; bu yüzden kendi istemlerinizle test edin. BroadNet diğer modellerinin şablon ayrıntılarını yayımlamaz. [GPU filosu ve sunum yazısı](https://broadrouter.com/tr/blog/broadnet-gpu-fleet-and-serving/) diğer Gemma sunum tercihlerini listeler.

## Sık sorulan sorular

### Bir API'yi çağırırken sohbet şablonu uygulamam gerekir mi?

Hayır. Bir chat completions API'sinde mesaj listesini gönderirsiniz ve şablonu sağlayıcı kendi tarafında uygular. Şablonlarla yalnızca bir modeli yerelde çalıştırırken veya ham bir metin tamamlama uç noktasını çağırırken kendiniz uğraşırsınız.

### Token sayılarım neden sağlayıcınınkinden farklı?

Şablon her mesajın etrafına kontrol token'ları ekler. Yalnızca mesaj metninizi saymak bunları atlar; bu yüzden faturalanan istem genellikle biraz daha büyüktür.

### add\_generation\_prompt ne işe yarar?

Bir asistan turunu başlatan token'ları ekler; böylece model mesajınızı sürdürmek yerine yanıt verir. Hugging Face belgeleri bunu ChatML tarzı şablonlarda sondaki <|im\_start|>assistant olarak gösterir.

## Ayrıca bakın

-   [Tokenizer](https://broadrouter.com/tr/glossary/tokenizer/) (terim)
-   [Sistem istemi (system prompt)](https://broadrouter.com/tr/glossary/system-prompt/) (terim)
-   [Token](https://broadrouter.com/tr/glossary/token/) (terim)
-   [vLLM](https://broadrouter.com/tr/glossary/vllm/) (terim)
-   [OpenAI uyumlu API](https://broadrouter.com/tr/glossary/openai-compatible-api/) (terim)
-   [GGUF](https://broadrouter.com/tr/glossary/gguf/) (terim)
-   [LLM isteği göndermeden önce token sayısı nasıl hesaplanır?](https://broadrouter.com/tr/blog/count-tokens-before-sending/) (yazı)
-   [BroadNet'in GPU donanımı ve sunum yaklaşımı, BroadNet'in anlatımıyla](https://broadrouter.com/tr/blog/broadnet-gpu-fleet-and-serving/) (yazı)

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-glossary-chat-template&utm_content=page-cta) ·

**Kaynaklar**

-   [Hugging Face Transformers belgeleri, sohbet şablonları (kontrol tarihi 2026-11-15)](https://huggingface.co/docs/transformers/en/chat_templating)
-   [vLLM belgeleri, çevrim içi sunum: sohbet şablonu (kontrol tarihi 2026-11-15)](https://docs.vllm.ai/en/latest/serving/online_serving/)
-   [Google, Gemma 4 26B A4B talimatla ayarlanmış model kartı (kontrol tarihi 2026-11-15)](https://huggingface.co/google/gemma-4-26B-A4B-it)
-   [BroadNet, Gemma 4 VL 26B model sayfası: sunum yapılandırması (kontrol tarihi 2026-11-15) (İngilizce)](https://www.broadnet.ai/inference/models/gemma-4-vl-26b)
