prompts.md•4.62 kB
# Chi Tiết Về Prompts - Templates Và Định Dạng Tin Nhắn
## Định Nghĩa Cốt Lõi
Prompts trong MCP là các templates hoặc định dạng tin nhắn được lưu trữ và sử dụng lại để tạo ra các tương tác có cấu trúc giữa AI và người dùng hoặc hệ thống. Prompts hoạt động theo nguyên tắc "template-oriented" - nghĩa là chúng định nghĩa cách thức và nội dung giao tiếp.
## Cách Triển Khai Với TypeScript SDK
Theo tài liệu chính thức từ ModelContextProtocol TypeScript SDK, prompts được triển khai qua phương thức `server.prompt()`:
```typescript
import { z } from "zod";
server.prompt(
"jiraIssueCreation",
{
summary: z.string().describe('Tóm tắt issue'),
projectContext: z.string().describe('Ngữ cảnh dự án')
},
({ summary, projectContext }) => ({
messages: [{
role: "user",
content: {
type: "text",
text: `Please create a well-structured Jira issue with the summary: ${summary}. Project context: ${projectContext}`
}
}]
})
);
```
## Use Cases Với Atlassian
Prompts giúp chuẩn hóa các tương tác phức tạp, ví dụ:
- Tạo issue với nội dung chi tiết
- Tóm tắt nội dung ticket hoặc trang Confluence
- Hướng dẫn AI cách đặt câu hỏi hoặc phản hồi
- Tạo các workflow agentic dựa trên kịch bản
## So Sánh Với Tools & Resources
| Khía Cạnh | Prompts | Tools | Resources |
|-----------|---------|-------|-----------|
| **Mô hình kiểm soát** | Template-oriented | Model-controlled | Application-controlled |
| **Hoạt động chính** | FORMAT/TEMPLATE | CREATE/UPDATE/DELETE | READ |
| **Tác dụng phụ** | Không | Có | Không |
| **Cần xác nhận người dùng** | Không | Thường cần | Thường không cần |
| **Tương tự REST** | N/A | POST/PUT/DELETE | GET |
| **Kiểu dữ liệu trả về** | `{ messages: [...] }` | `{ content: [...] }` | `{ contents: [...] }` |
| **Định nghĩa parameters** | Zod schema | Zod schema | ResourceTemplate |
## Ưu Điểm Của Prompts
1. **Tái Sử Dụng Cao**: Cho phép định nghĩa các mẫu câu hỏi/phản hồi chuẩn hóa
2. **Tăng Tính Nhất Quán**: Giúp AI trả lời theo phong cách và nội dung mong muốn
3. **Hỗ Trợ Workflow Phức Tạp**: Dễ dàng xây dựng các kịch bản tương tác agentic
4. **Dễ Dàng Cập Nhật**: Có thể version và thay đổi prompt mà không ảnh hưởng code logic
## Hạn Chế Của Prompts
1. **Không Thực Hiện Hành Động**: Chỉ định nghĩa nội dung, không tương tác trực tiếp với hệ thống như Tools
2. **Phụ Thuộc Vào AI**: Hiệu quả phụ thuộc vào khả năng hiểu và sử dụng prompt của mô hình
3. **Không Có Validation Mạnh Mẽ**: Không có schema validation như tools
## Best Practices Theo Tài Liệu Chính Thức
1. **Sử Dụng Zod Schema**: Để định nghĩa rõ ràng các tham số đầu vào
2. **Tạo Prompt Ngắn Gọn, Rõ Ràng**: Giúp AI hiểu và thực thi đúng
3. **Versioning Prompt**: Quản lý các phiên bản prompt để dễ dàng cập nhật
4. **Kết Hợp Với Tools và Resources**: Sử dụng prompt để điều phối việc gọi tools và truy vấn resources
## Ví Dụ Tương Tác Thực Tế
```
User: "Tôi muốn tạo một issue mới về lỗi đăng nhập"
AI: "Tôi sẽ chuẩn bị nội dung issue. Vui lòng cung cấp tóm tắt và mô tả chi tiết."
User: "Tóm tắt: Lỗi đăng nhập. Mô tả: Người dùng không thể đăng nhập bằng SSO."
AI: Sử dụng prompt để tạo nội dung:
"Please create a well-structured Jira issue with the summary: Lỗi đăng nhập. Project context: Authentication module."
Sau đó AI gọi tool `createIssue` với nội dung được tạo từ prompt.
```
## Mối Liên Hệ Giữa Ba Capabilities
Khi triển khai MCP Server cho Atlassian, ba capabilities này hoạt động cùng nhau trong một hệ sinh thái hoàn chỉnh:
- **Resources** cung cấp dữ liệu (như danh sách projects, chi tiết issue)
- **Tools** thực hiện hành động (như tạo issue, cập nhật trang)
- **Prompts** định hình cách AI hiểu và phản hồi
Prompts đóng vai trò là cầu nối giữa yêu cầu ngôn ngữ tự nhiên và các hành động cụ thể, giúp AI tương tác hiệu quả và có cấu trúc hơn với dữ liệu từ Resources và thực hiện hành động thông qua Tools.