MCP Academy · Ders

Yalnızca Metin Değil, Mesajlar Döndürme

İstem çıktısını yapılandırılmış sohbet mesajları olarak biçimlendirin.

3. ders / 413 adım

Yalnızca Metin Değil, Mesajlar Döndürme, CoddyKit'te ücretsiz bir MCP Academy dersidir. Bu, 4 dersinin 3. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, MCP Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. MCP Academy kursu toplamda 4 dersten oluşur.

Tek Bir Dizenin Ötesinde

Bir istem, tek bir satır döndürmekten fazlasını yapabilir. Daha zengin, çok turlu bir başlangıç oluşturmak için bir mesaj listesi döndürebilir. 🗂️

Mesajların Rolleri Vardır

Her mesaj bir role taşır; bu rol genellikle kullanıcı veya asistan olur. Roller, kullanıcı daha yazmaya başlamadan önce kısa bir karşılıklı konuşma hazırlamanızı sağlar.

Mesaj Yardımcıları

SDK, ham yapıyı elle yazmadan sohbet turları oluşturabilmeniz için UserMessage ve AssistantMessage yardımcılarını sağlar.

from mcp.server.fastmcp.prompts import base

@mcp.prompt()
def ask() -> list[base.Message]:
    return [base.UserMessage("Help me debug.")]

Bir Liste Döndürün

Birkaç tur göndermek için bu mesaj nesnelerinden oluşan bir liste döndürün. Ana uygulama, konuşmanın başlangıcı olarak bunları sırayla yeniden oynatır.

return [
    base.UserMessage("Explain this error."),
    base.AssistantMessage("Sure, paste it in.")
]

Tek Bir Dize Hâlâ Çalışır

Düz bir dize döndürmek yalnızca kısa bir gösterimdir: SDK bunu tek bir kullanıcı mesajı olarak sarar. Listeler, kurulum üzerinde daha hassas denetim sağlar.

Asistanı Hazırlayın

Bir AssistantMessage, modelin kişiliğini önceden belirleyebilir veya ona kuralları hatırlatabilir; böylece konuşma daha baştan doğru yönde ilerler.

Bağlamı Ayarlayın

Modelin görev boyunca aklında tutması gereken kodlama standartları veya bir rol gibi bağlamları başlangıç mesajlarıyla yerleştirin.

Bağımsız Değişkenleri Ekleyin

Bağımsız değişkenleri listedeki herhangi bir mesaja ekleyebilirsiniz. Kullanıcı girdileri yalnızca tek bir satıra değil, yapılandırılmış bir konuşmaya aktarılır.

@mcp.prompt()
def debug(error: str) -> list[base.Message]:
    return [base.UserMessage(f"Fix this error:\n{error}")]

Sıra Önemlidir

Listenin sırası, tur sırasıdır. Önce bağlamı veya sistem tarzı bir notu, ardından kullanıcının isteğini verin; böylece model bunları doğal biçimde okur.

Mesajlar Neden Kullanılır

Yapılandırılmış mesajlar, özellikle gerçek isteğe geçmeden önce hazırlık gerektiren görevlerde, tek parça metinden daha iyi bir başlangıç oluşturur.

Sade Tutun

İyi yerleştirilmiş birkaç tur, çok sayıdaki turdan daha etkilidir. Her ek mesaj belirteç tüketir; bu nedenle yalnızca sonucu gerçekten iyileştirenleri ekleyin.

Hızlı Kontrol

Daha zengin dönüş türünü netleştirelim.

İnteraktif derste cevapla

Özet: Mesaj Çıktısı

Çok iyi! İstemler, daha zengin bir başlangıç oluşturmak için UserMessage ve AssistantMessage kullanılarak hazırlanan, rolleri etiketlenmiş bir mesaj listesi döndürebilir. ✅

Başlamak ücretsiz

Yapay zeka eğitmeniyle Python öğren — ücretsiz

Tarayıcında gerçek kod yaz ve çalıştır, 7/24 yapay zeka eğitmeninden anında yardım al; web'de ya da uygulamada kaldığın yerden devam et.

Kurslar: 30
Dersler: 120

Ücretsiz öğrenmeye başla Tüm kursu görüntüle

Sıkça Sorulan Sorular

“Yalnızca Metin Değil, Mesajlar Döndürme” dersi ücretsiz mi?

Evet — “Yalnızca Metin Değil, Mesajlar Döndürme” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve MCP Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. MCP Academy kursu toplamda 4 dersten oluşur.

“Yalnızca Metin Değil, Mesajlar Döndürme” dersinde ne öğreneceğim?

İstem çıktısını yapılandırılmış sohbet mesajları olarak biçimlendirin. MCP Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

MCP Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te MCP Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 3. dersidir.

“Yalnızca Metin Değil, Mesajlar Döndürme” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu MCP Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her MCP Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← MCP Academy Sayfasına Dön