텍스트만이 아닌 메시지 반환하기
프롬프트 출력을 구조화된 채팅 메시지 형태로 구성합니다.
텍스트만이 아닌 메시지 반환하기은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
단일 문자열을 넘어서
프롬프트는 한 줄을 반환하는 것 이상을 할 수 있습니다. 더 풍부한 여러 차례 대화의 시작점이 되도록 메시지 목록을 반환할 수 있습니다. 🗂️
메시지에는 역할이 있습니다
각 메시지에는 일반적으로 사용자 또는 어시스턴트에 해당하는 역할이 있습니다. 역할을 지정하면 사용자가 입력하기도 전에 짧은 대화를 구성할 수 있습니다.
메시지 도우미
SDK는 UserMessage와 AssistantMessage 도우미를 제공하므로 원시 구조를 직접 작성하지 않고도 대화 차례를 구성할 수 있습니다.
from mcp.server.fastmcp.prompts import base
@mcp.prompt()
def ask() -> list[base.Message]:
return [base.UserMessage("Help me debug.")]목록 반환하기
여러 대화 차례를 보내려면 이러한 메시지 객체의 목록을 반환하세요. 호스트는 이를 순서대로 재생하여 대화의 시작으로 사용합니다.
return [
base.UserMessage("Explain this error."),
base.AssistantMessage("Sure, paste it in.")
]단일 문자열도 여전히 작동합니다
일반 문자열을 반환하는 것은 간단한 표현일 뿐입니다. SDK가 이를 사용자 메시지 하나로 감쌉니다. 목록을 사용하면 설정을 더 세밀하게 제어할 수 있습니다.
어시스턴트 구성하기
AssistantMessage를 사용하면 모델의 페르소나를 미리 설정하거나 규칙을 상기시킬 수 있어, 대화가 처음부터 올바른 방향으로 진행됩니다.
컨텍스트 설정하기
시작 메시지를 사용하여 코딩 표준이나 역할처럼 모델이 작업 내내 기억해야 할 컨텍스트를 미리 제공하세요.
인수 섞어 넣기
목록의 어떤 메시지에든 인수를 넣을 수 있습니다. 사용자의 입력은 단순한 한 줄이 아니라 구조화된 대화로 전달됩니다.
@mcp.prompt()
def debug(error: str) -> list[base.Message]:
return [base.UserMessage(f"Fix this error:\n{error}")]순서가 중요합니다
목록의 순서가 대화 차례의 순서가 됩니다. 컨텍스트나 시스템 스타일의 메모를 먼저 제시한 다음 사용자의 요청을 배치하면 모델이 자연스럽게 읽을 수 있습니다.
메시지를 사용하는 이유
구조화된 메시지는 텍스트 덩어리 하나보다 더 나은 시작점을 제공합니다. 특히 실제 요청 전에 설정이 필요한 작업에서 유용합니다.
간결하게 유지하기
잘 배치된 대화 몇 차례가 많고 복잡한 대화보다 낫습니다. 추가되는 메시지마다 토큰이 사용되므로 결과를 실제로 개선하는 내용만 포함하세요.
빠른 확인
더 풍부한 반환 타입을 확실히 알아보겠습니다.
복습: 메시지 출력
잘하셨습니다! 프롬프트는 UserMessage와 AssistantMessage로 만든 역할 태그가 포함된 메시지 목록을 반환하여 더 풍부한 시작 대화를 구성할 수 있습니다. ✅
AI 튜터와 함께 Python을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 30
- 레슨
- 120
자주 묻는 질문
“텍스트만이 아닌 메시지 반환하기” 강의는 무료인가요?
네 — “텍스트만이 아닌 메시지 반환하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“텍스트만이 아닌 메시지 반환하기”에서 뭘 배우나요?
프롬프트 출력을 구조화된 채팅 메시지 형태로 구성합니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
MCP Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“텍스트만이 아닌 메시지 반환하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 첫 프롬프트 등록하기
- 프롬프트에 인수 추가하기
- 텍스트만이 아닌 메시지 반환하기
- 코드 검토 프롬프트 템플릿