Định nghĩa prompt

Vai trò của prompt trong MCP

Prompt là các template chỉ dẫn có sẵn, đã được kiểm thử, mà MCP server cung cấp cho client. Thay vì để người dùng tự viết prompt, tác giả server có thể soạn sẵn những chỉ dẫn chuyên biệt, chất lượng cao, cho ra kết quả tốt và nhất quán hơn qua nhiều tình huống khác nhau.

Vì sao nên dùng prompt có sẵn

Người dùng hoàn toàn có thể tự yêu cầu trực tiếp (ví dụ: “Chuyển report.pdf sang markdown”), nhưng một prompt được soạn kỹ lưỡng thường cho kết quả tốt hơn. Tác giả server đã bỏ công sức test prompt đó với nhiều trường hợp biên và thực hành tốt nhất, để người dùng hưởng lợi mà không cần tự mình trở thành chuyên gia viết prompt.

Ví dụ thực tế: lệnh format

Bài học minh hoạ bằng một tính năng định dạng tài liệu, chuyển nội dung sang markdown. Người dùng gõ /format doc_id, hệ thống áp dụng một prompt có sẵn để đọc và định dạng lại tài liệu với heading, danh sách, và cấu trúc phù hợp.

Một MCP client kết nối tới nhiều MCP server, mỗi server phơi bày Tools, Resources, và Prompts.

Định nghĩa prompt

Prompt dùng decorator @mcp.prompt(), tương tự tool và resource. Hàm trả về một danh sách các object base.Message gửi cho Claude.

@mcp.prompt(
    name="format",
    description="Rewrites the contents of the document in Markdown format."
)
def format_document(
    doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
    prompt = f"""
Your goal is to reformat a document to be written with markdown syntax.

The id of the document you need to reformat is:
<document_id>
{doc_id}
</document_id>

Add in headers, bullet points, tables, etc as necessary. Feel free to add in structure.
Use the 'edit_document' tool to edit the document. After the document has been reformatted...
"""

    return [
        base.UserMessage(prompt)
    ]

So sánh: prompt ngắn gọn người dùng có thể tự viết, so với prompt dài và đã được kiểm thử kỹ mà một MCP server có thể cung cấp thay thế.

Test và lợi ích

Dùng MCP Inspector để xác minh các biến được nội suy (interpolate) vào template ra sao trước khi triển khai.

MCP Inspector với prompt format được chọn, hiển thị tham số doc_id và message đã nội suy.

Lợi ích chính:

• Nhất quán qua mỗi lần dùng.
• Mã hoá sẵn kiến thức chuyên môn.
• Tái sử dụng được trên nhiều ứng dụng client.
• Bảo trì tập trung một chỗ.

Nguồn

Dịch từ bài giảng “Defining prompts”, khóa Introduction to Model Context Protocol trên Claude Academy.