PricingLoginStart free
MCP Academy · 강의

호스트에 완료 요청하기

클라이언트를 호출하여 LLM 프롬프트를 실행합니다.

레슨 2/413개 단계

호스트에 완료 요청하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

요청 방식

생성을 요청하려면 서버가 프로토콜을 통해 클라이언트에 sampling/createMessage 요청을 보냅니다.

{ "method": "sampling/createMessage" }

컨텍스트를 통해 클라이언트에 접근하기

도구 내부에서는 Context 객체를 얻습니다. 이 객체의 세션은 샘플링을 실행할 수 있는 클라이언트로 연결되는 통로입니다.

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

create_message 호출하기

Python SDK는 ctx.session.create_message를 제공합니다. 이를 기다린 다음 메시지를 전달하면 모델의 응답을 돌려받습니다.

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

SamplingMessage 만들기

보내는 각 발화는 사용자와 같은 역할 및 실제 텍스트를 담은 콘텐츠 블록을 포함하는 SamplingMessage입니다.

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

TextContent로 텍스트 감싸기

일반 텍스트는 유형을 text로 설정한 TextContent 안에 넣습니다. 이 유형이 지정된 래퍼를 통해 MCP가 메시지 본문을 전달합니다.

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

항상 max_tokens 설정하기

max_tokens로 모델에 상한을 지정하세요. 생성되는 응답의 길이를 제한하고 비용을 예측 가능하게 합니다.

max_tokens=200

결과 읽기

응답의 content는 유형이 지정된 블록입니다. 유형을 확인하고 텍스트라면 result.content.text에서 답변을 읽으세요.

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

실행된 모델 확인하기

결과에는 클라이언트가 선택한 모델도 보고되므로, 어떤 모델이 출력을 생성했는지 정확히 기록할 수 있습니다.

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

왜 멈췄는지 알기

stopReason 필드는 생성이 끝난 이유를 알려 줍니다. 예를 들어 endTurn이거나 최대 토큰 한도에 도달한 경우입니다.

result.stopReason  # "endTurn"

간단히 살펴보는 전체 도구

샘플링 도구는 메시지를 만들고, 기다린 후 create_message를 호출한 다음 텍스트를 반환합니다. 몇 줄이면 충분합니다.

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

거부될 수도 있습니다

사용자가 요청을 거부할 수 있다는 점을 기억하세요. 거부를 모든 실패와 마찬가지로 처리하고 적절하게 대응해야 합니다.

빠른 확인

도구에서 호출할 때 알아야 할 한 가지 세부 사항입니다.

인터랙티브 레슨에서 답해보세요

복습

sampling/createMessage를 ctx.session을 통해 보내고, 프롬프트를 SamplingMessage와 TextContent로 감싼 다음 max_tokens를 설정하고 result.content.text를 읽으세요. 💬

무료로 시작

AI 튜터와 함께 Python을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
30
레슨
120
무료로 학습 시작전체 코스 보기

자주 묻는 질문

“호스트에 완료 요청하기” 강의는 무료인가요?

네 — “호스트에 완료 요청하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“호스트에 완료 요청하기”에서 뭘 배우나요?

클라이언트를 호출하여 LLM 프롬프트를 실행합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

MCP Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“호스트에 완료 요청하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 샘플링으로 할 수 있는 일
  2. 호스트에 완료 요청하기
  3. 메시지와 기본 설정 구성하기
  4. 사람이 참여하는 승인
← MCP Academy(으)로 돌아가기