MCP Academy · Lekcja

Żądanie uzupełnienia od hosta

Wywołaj klienta, aby uruchomić prompt LLM.

Żądanie uzupełnienia od hosta to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej MCP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs MCP Academy zawiera 4 lekcji w sumie.

Części tej lekcji nie zostały jeszcze przetłumaczone i są wyświetlane po angielsku.

The Request Method

To ask for a generation, your server sends a sampling/createMessage request to the client over the protocol.

{ "method": "sampling/createMessage" }

Reach the Client via Context

Inside a tool you get a Context object. Its session is your line back to the client that can run sampling.

async def tool(topic: str, ctx: Context) -> str:
    ...

Call create_message

The Python SDK exposes ctx.session.create_message. Await it, pass your messages, and you get the model’s reply back.

result = await ctx.session.create_message(
    messages=[...],
    max_tokens=100,
)

Build a SamplingMessage

Each turn you send is a SamplingMessage with a role like user and a content block holding the actual text.

SamplingMessage(role="user",
    content=TextContent(type="text", text=prompt))

Wrap Text in TextContent

Plain text goes inside TextContent with type set to text. That typed wrapper is how MCP carries the message body.

TextContent(type="text", text="Summarize this report")

Always Set max_tokens

Give the model a ceiling with max_tokens. It caps how long the generated reply can be and keeps cost predictable.

max_tokens=200

Read the Result

The reply’s content is a typed block. Check its type, and if it is text, read result.content.text for the answer.

if result.content.type == "text":
    return result.content.text

Inspect Which Model Ran

The result also reports the model the client chose, so you can log exactly which model produced your output.

print(result.model)  # e.g. claude-3-sonnet-20240307

Know Why It Stopped

A stopReason field tells you why generation ended — like endTurn or hitting your max token limit.

result.stopReason  # "endTurn"

A Whole Tool, Briefly

So a sampling tool is: build a message, await create_message, then return the text — just a few lines.

r = await ctx.session.create_message(
    messages=[msg], max_tokens=100)
return r.content.text

It Can Be Rejected

Remember the request may be denied by the user. Treat a rejection like any failure and handle it gracefully.

Quick Check

One detail about making the call from your tool.

Recap

Send sampling/createMessage via ctx.session, wrap prompts in SamplingMessage and TextContent, set max_tokens, then read result.content.text. 💬

Często zadawane pytania

Czy lekcja „Żądanie uzupełnienia od hosta” jest bezpłatna?

Tak — pełny tekst „Żądanie uzupełnienia od hosta” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu MCP Academy, przejdź na CoddyKit PRO. Kurs MCP Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Żądanie uzupełnienia od hosta”?

Wywołaj klienta, aby uruchomić prompt LLM. Ćwiczysz MCP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć MCP Academy?

Nie wymagamy żadnego doświadczenia. MCP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Żądanie uzupełnienia od hosta”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji MCP Academy?

Tak. Każda lekcja MCP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do MCP Academy