MCP Academy · Lektion

Nachrichten statt nur Text zurückgeben

Strukturieren Sie die Ausgabe eines Prompts als Chatnachrichten.

Lektion 3 von 413 Schritte

Nachrichten statt nur Text zurückgeben ist eine kostenlose MCP Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des MCP Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.

Beyond a Single String

Ein Prompt kann mehr als nur eine Zeile zurückgeben. Er kann eine Liste von Nachrichten zurückgeben, um einen reichhaltigeren, mehrstufigen Einstieg zu ermöglichen. 🗂️

Messages Have Roles

Jede Nachricht hat eine Rolle, in der Regel Nutzer oder Assistent. Mit Rollen können Sie einen kurzen Dialog einrichten, noch bevor der Nutzer überhaupt etwas eingibt.

The Message Helpers

Das SDK stellt Ihnen die Hilfsklassen UserMessage und AssistantMessage zur Verfügung, mit denen Sie Chat-Turns erstellen können, ohne die rohe Struktur manuell schreiben zu müssen.

from mcp.server.fastmcp.prompts import base

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

Return a List

Um mehrere Turns zu senden, geben Sie eine Liste dieser Nachrichtenobjekte zurück. Der Host spielt sie in der Reihenfolge als Beginn des Gesprächs ab.

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

A Single String Still Works

Die Rückgabe eines einfachen Strings ist nur eine Abkürzung: Das SDK verpackt ihn als eine einzelne Nutzer-Nachricht. Listen geben Ihnen eine genauere Kontrolle über das Setup.

Stage the Assistant

Eine AssistantMessage kann die Persona des Modells vorbereiten oder es an Regeln erinnern, damit das Gespräch direkt auf dem richtigen Weg beginnt.

Set Up Context

Verwenden Sie Eröffnungsnachrichten, um Kontext, wie Codierungsstandards oder eine Rolle, zu etablieren, den das Modell während der gesamten Aufgabe im Hinterkopf behalten soll.

Mix Arguments In

Du kannst weiterhin Argumente in jede Nachricht der Liste einfügen. Die Eingaben des Nutzers fließen in ein strukturiertes Gespräch ein, nicht nur in eine einzelne Zeile.

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

Order Matters

Die Listenreihenfolge ist die Zugreihenfolge. Beginnen Sie mit Kontext oder einem Hinweis im Systemstil, gefolgt von der Anfrage des Nutzers, damit das Modell sie auf natürliche Weise liest.

Why Use Messages

Strukturierte Nachrichten bilden einen besseren Ausgangspunkt als ein einziger Textblock, insbesondere bei Aufgaben, die vor der eigentlichen Anfrage noch Vorbereitung erfordern.

Keep It Lean

Ein paar gut platzierte Drehungen schlagen viele. Jede zusätzliche Nachricht kostet Tokens, also füge nur das hinzu, was das Ergebnis wirklich verbessert.

Quick Check

Legen wir den präziseren Rückgabedyp fest.

Recap: Message Output

Gut gemacht! Prompts können eine Liste von rollenbasierten Nachrichten zurückgeben, die mit UserMessage und AssistantMessage erstellt wurden, um einen reichhaltigeren Einstieg zu ermöglichen. ✅

Kostenlos starten

Lerne Python mit einem KI-Tutor — kostenlos

Schreibe und führe echten Code in deinem Browser aus, bekomme sofortige Hilfe von einem 24/7 KI-Tutor und setze dein Lernen im Web oder in der App fort.

Kurse
30
Lektionen
120

Häufig gestellte Fragen

Ist die Lektion „Nachrichten statt nur Text zurückgeben“ kostenlos?

Ja — der vollständige Text von „Nachrichten statt nur Text zurückgeben“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des MCP Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Nachrichten statt nur Text zurückgeben“?

Strukturieren Sie die Ausgabe eines Prompts als Chatnachrichten. Du übst MCP Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um MCP Academy zu starten?

Keine Vorkenntnisse erforderlich. MCP Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.

Wie lange dauert die Lektion „Nachrichten statt nur Text zurückgeben“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser MCP Academy-Lektion Code schreiben und ausführen?

Ja. Jede MCP Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Ihren ersten Prompt registrieren
  2. Argumente zu einem Prompt hinzufügen
  3. Nachrichten statt nur Text zurückgeben
  4. Eine Vorlage für einen Code-Review-Prompt
← Zurück zu MCP Academy