Bỏ qua đến nội dung chính

Prompts in the client

📖 Nội dung bài học

Gia đình phông chữ

Tóm tắt

Prompts trong MCP định nghĩa một tập hợp các tin nhắn người dùng và trợ lý mà client có thể dùng. Các prompt này nên có chất lượng cao, được kiểm thử kỹ và liên quan đến mục đích chung của server MCP.

Triển khai list_prompts

Bước đầu tiên là triển khai phương thức list_prompts trong client MCP của bạn. Phương thức này lấy tất cả các prompt có sẵn từ server:

async def list_prompts(self) -> list[types.Prompt]:
    result = await self.session().list_prompts()
    return result.prompts

Việc triển khai đơn giản này gọi phương thức list_prompts của session và trả về mảng prompts từ kết quả.

Lấy các Prompt riêng lẻ

Phương thức get_prompt lấy một prompt cụ thể với các đối số được nội suy vào nó. Khi bạn yêu cầu một prompt, bạn cung cấp các đối số được truyền cho hàm prompt dưới dạng keyword arguments:

async def get_prompt(self, prompt_name, args: dict[str, str]):
    result = await self.session().get_prompt(prompt_name, args)
    return result.messages

Phương thức trả về các tin nhắn từ kết quả, tạo thành một cuộc trò chuyện có thể được đưa trực tiếp vào Claude.

Cách hoạt động của đối số Prompt

Khi bạn định nghĩa một hàm prompt ở phía server, nó có thể chấp nhận các tham số. Ví dụ, một prompt định dạng tài liệu có thể mong đợi một tham số doc_id:

def format_document(doc_id: str):
    # The doc_id gets interpolated into the prompt

Khi client gọi get_prompt, từ điển đối số phải chứa các key được mong đợi. Server MCP sẽ truyền chúng dưới dạng keyword arguments cho hàm prompt, cho phép chèn nội dung động vào template prompt.

Kiểm thử Prompts trong CLI

Sau khi triển khai, bạn có thể kiểm thử prompts thông qua command-line interface. Khi bạn gõ một dấu gạch chéo, các prompts khả dụng sẽ xuất hiện dưới dạng các lệnh. Việc chọn một prompt có thể nhắc bạn chọn từ các tùy chọn có sẵn (như ID tài liệu), và sau đó prompt hoàn chỉnh được gửi đến Claude.

Quy trình làm việc trông như sau:

  1. Người dùng chọn một prompt (ví dụ: "format")
  2. Hệ thống nhắc các đối số bắt buộc (ví dụ: tài liệu nào để định dạng)
  3. Prompt được gửi đến Claude với các giá trị nội suy
  4. Claude sau đó có thể dùng tools để lấy thêm dữ liệu và hoàn thành tác vụ

Các phương pháp hay nhất về Prompt

Khi tạo prompts cho server MCP của bạn:

  • Làm cho chúng liên quan đến mục đích của server bạn
  • Kiểm thử chúng kỹ lưỡng trước khi triển khai
  • Dùng các hướng dẫn rõ ràng, cụ thể
  • Thiết kế chúng để hoạt động tốt với các tools có sẵn của bạn
  • Xem xét những đối số mà người dùng sẽ cần cung cấp

Prompts là cầu nối giữa chức năng được định nghĩa trước và nhu cầu động của người dùng, cung cấp cho Claude những điểm khởi đầu có cấu trúc cho các tác vụ phức tạp trong khi vẫn duy trì tính linh hoạt thông qua tham số hóa.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?