MCP là gì
Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép trợ lý AI sử dụng các dịch vụ bên ngoài theo một cách thống nhất. Một dịch vụ công bố danh sách công cụ. Mỗi công cụ có tên, mô tả, dữ liệu đầu vào và định dạng kết quả trả về. Trợ lý đọc danh sách, chọn một công cụ khi cuộc hội thoại cần đến, và nhận lại câu trả lời có cấu trúc.
Hình vẽ cho thấy hình dạng của máy chủ MCP.
- Trợ lý đọc danh sách công cụ và chọn một công cụ khi cuộc hội thoại cần đến.
- Công cụ chỉ đọc: năng lực sản xuất, thiết kế, báo cáo kiểm tra, báo giá, đơn hàng và tin nhắn.
- Công cụ ghi: tải lên, báo giá và tin nhắn.
- Công cụ dẫn đến đơn hàng chỉ có thể chuẩn bị một đơn hàng. Việc phê duyệt được thực hiện trên trang web.
- Trang web trả lời theo định dạng có cấu trúc, với số liệu chính xác.
Kết quả rất đơn giản. Thay vì trợ lý phải đoán cách trang web hoạt động, trang web cho trợ lý biết chính xác những gì có thể làm. Sau đó, trợ lý có thể thực hiện các việc như "kiểm tra file bo mạch này" hoặc "cho xem giá" theo cách chính xác và có thể lặp lại.
Vì sao nhà máy cung cấp công cụ thay vì biểu mẫu web
Biểu mẫu web được thiết kế cho mắt người. Trợ lý sử dụng biểu mẫu web phải xem ảnh chụp màn hình hoặc trích xuất nội dung trang, và cách này không còn hoạt động khi trang thay đổi.
Danh sách công cụ được thiết kế cho phần mềm. Danh sách cho biết mỗi bước cần gì và kết quả trả về là gì. Đối với đơn hàng bo mạch, điều này quan trọng vì các bước đều chính xác: tải file lên, đọc báo cáo kiểm tra, thay đổi tùy chọn, đọc giá, xác nhận. Mỗi bước có số liệu phải chính xác, ví dụ kích thước lỗ tính bằng micromet hoặc giá tính bằng một loại tiền tệ. Câu trả lời có cấu trúc giữ cho các số liệu đó chính xác.
Công cụ cũng giúp việc đảm bảo an toàn dễ dàng hơn. Một công cụ có thể nêu rõ rằng công cụ đó sử dụng tiền, và trợ lý có thể được xây dựng để hỏi ý kiến trước khi sử dụng công cụ như vậy. Biểu mẫu web không đưa ra tín hiệu như vậy.
Những gì hiện có
Máy chủ MCP. Địa chỉ của máy chủ là https://uliketechnology.com/api/mcp. Khi chưa đăng nhập, trợ lý có thể đọc những gì nhà máy có thể sản xuất, mở phiên khách, gửi bo mạch đến kiểm tra file và nhận giá, trong hạn mức hằng ngày. Để trợ lý làm việc với tài khoản, cần kết nối https://uliketechnology.com/api/mcp/account: địa chỉ này yêu cầu trợ lý đăng nhập với tư cách là Quý khách. Sau đó, trợ lý cũng có thể đọc đơn hàng, chuẩn bị đơn hàng để chờ phê duyệt, và đọc và viết tin nhắn với nhà máy.
Hai cách kết nối. Trợ lý đăng nhập với tư cách là Quý khách: trợ lý mở một trang của trang web này trong trình duyệt, trang hiển thị tên, địa chỉ và những gì trợ lý yêu cầu làm, và chưa cho phép nội dung nào cho đến khi nhấn Cho phép. Hoặc khóa API được tạo trong tài khoản, chọn những gì khóa được phép làm, và đưa khóa cho chương trình riêng. Cả hai đều hành động với tư cách là Quý khách, trong phạm vi quyền đã chọn, và quyền truy cập có thể được chấm dứt bất cứ lúc nào. Dành cho nhà phát triển và trợ lý có các địa chỉ và các bước.
REST API. Đây là cùng một dịch vụ không có MCP: tải lên, kiểm tra file, báo giá và đơn hàng. Hướng dẫn nhanh API cho thấy các lệnh gọi.
Mô hình an toàn
Mô hình dựa trên bốn quy tắc.
- Trợ lý luôn làm việc cho một người đã đăng nhập. Trợ lý không có tài khoản riêng. Đăng nhập được thực hiện bằng tài khoản cá nhân, và quyền cho phép trợ lý hành động thay mặt được cấp với các quyền được nêu tên. Quyền có thể được thu hồi.
- Trợ lý có thể chuẩn bị đơn hàng. Trợ lý không thể đặt đơn hàng, và không thể thanh toán. Khi trợ lý đã đăng nhập thay mặt yêu cầu đặt đơn hàng, câu trả lời là "cần phê duyệt" và một liên kết đến trang web. Chưa đặt đơn hàng nào. Quý khách mở liên kết, đăng nhập, xem đơn hàng và tổng chính xác, rồi phê duyệt hoặc từ chối. Liên kết chỉ hoạt động một lần, gắn với tài khoản, hết hạn sau 24 giờ, và ngừng hoạt động nếu báo giá hoặc tổng thay đổi. Thanh toán bằng chuyển khoản ngân hàng, do Quý khách tự thực hiện.
- Kỹ sư xác nhận mọi đơn hàng. Bất kể ai đặt đơn hàng, kỹ sư đều kiểm tra file và đơn hàng trước khi sản xuất bắt đầu.
- Mỗi công cụ đều nêu rõ loại của công cụ. Công cụ được đánh dấu là chỉ đọc, là công cụ ghi một bản ghi, hoặc là công cụ thực hiện cam kết. Hai công cụ thực hiện cam kết, đặt và hủy đơn hàng, dùng một khóa khiến lệnh gọi lặp lại chỉ xảy ra một lần.
- Người dùng đăng nhập bằng tài khoản cá nhân và cho phép trợ lý hành động thay mặt.
- Trợ lý chuẩn bị đơn hàng. Trợ lý không thể đặt đơn hàng hoặc thanh toán.
- Trang web hiển thị đơn hàng và tổng chính xác sau một liên kết.
- Kỹ sư xác nhận mọi đơn hàng trước khi sản xuất.
- Đường màu hổ phách là liên kết phê duyệt. Trợ lý chuyển liên kết cho Quý khách, và liên kết chỉ hoạt động cho Quý khách, khi đã đăng nhập.
Cố ý không có công cụ nào thanh toán, thêm hoặc thay đổi địa chỉ, hoặc tạo khóa API. Các việc đó chỉ được thực hiện trong trình duyệt, nơi Quý khách đang làm việc.
Khóa API hoạt động theo cùng một cách. Khóa là chương trình riêng hành động với tư cách là Quý khách, và đơn hàng do khóa gửi được chuẩn bị, chưa được đặt: câu trả lời là liên kết phê duyệt, và đơn hàng được đặt sau khi Quý khách phê duyệt trên trang web.
Văn bản từ file cũng được coi là dữ liệu. Tên file, văn bản bên trong file thiết kế và mô tả BOM được trả về trong các trường có độ dài giới hạn, không bao giờ dưới dạng chỉ thị. Mô tả của mỗi công cụ nêu tên các trường mang văn bản như vậy và yêu cầu trợ lý không làm theo bất kỳ nội dung nào viết trong đó. Văn bản trong file không thể thay đổi những gì trợ lý được phép làm.
Các công cụ
Dưới đây là các công cụ máy chủ cung cấp. Trợ lý chỉ thấy các công cụ được phép dùng: khi chưa đăng nhập là năm nhóm đầu tiên, và sau khi tài khoản được kết nối là các công cụ thuộc phạm vi quyền đã cấp.
| Nhóm | Công cụ |
|---|---|
| Đọc những gì nhà máy có thể sản xuất | get_capabilities |
| Làm việc không cần tài khoản | start_guest_session |
| Tải lên và đọc bo mạch | create_upload_session, complete_upload, list_designs, get_design, set_layer_mapping |
| Kiểm tra | validate_design, get_validation_report |
| Báo giá | preview_quote, create_pcb_quote, list_quotes, get_quote, update_quote_options |
| Địa chỉ | list_addresses |
| Đơn hàng | place_order, list_orders, get_order, cancel_order, answer_engineering_query |
| Tin nhắn với nhà máy | list_threads, get_thread, create_thread, post_thread_message, mark_thread_read, close_thread |
place_order trả về liên kết phê duyệt được mô tả ở trên. cancel_order chỉ hoạt động trước khi đơn hàng được chuyển sang sản xuất. Câu hỏi mà nhà máy đánh dấu là riêng tư không thể được trả lời qua trợ lý: công cụ từ chối và yêu cầu trợ lý hiển thị câu hỏi cho Quý khách.
Máy chủ cũng mang hướng dẫn thiết kế cho trợ lý dưới dạng tài nguyên, ulike://guide/pcb-design, và một prompt, check-and-quote-a-board, hướng dẫn trợ lý qua các bước tải lên, kiểm tra và báo giá.
Đơn hàng qua trợ lý diễn ra như thế nào
Giả sử có yêu cầu trợ lý đặt hai mươi bo mạch. Trợ lý đọc năng lực sản xuất, gửi file zip đến địa chỉ tải lên, đọc báo cáo kiểm tra và cho biết đã tìm thấy gì. Trợ lý tạo báo giá và hiển thị giá. Khi giá cần kỹ sư, báo giá có thể được đặt sau khi kỹ sư xác nhận. Sau đó, trợ lý chuẩn bị đơn hàng và đưa ra một liên kết. Quý khách mở liên kết, đăng nhập, kiểm tra tổng và địa chỉ, rồi phê duyệt. Trang đơn hàng hiển thị thông tin ngân hàng và mã tham chiếu cho chuyển khoản. Kỹ sư xác nhận đơn hàng, và sản xuất bắt đầu khi thanh toán đã đến.
Trợ lý không bao giờ giữ thông tin thanh toán. Trợ lý đã đăng nhập thay mặt Quý khách không bao giờ có thể đặt đơn hàng mà không có phê duyệt của Quý khách. Nếu câu trả lời có vẻ không đúng, điều đó được nhìn thấy trên trang phê duyệt trước khi bất kỳ đơn hàng nào được đặt.
Những gì MCP không thay đổi
MCP là một cách để tiếp cận cùng một dịch vụ. MCP không bổ sung quyền mới nào. Trợ lý sử dụng máy chủ MCP gặp cùng kiểm tra file, cùng giới hạn, cùng giá và cùng kiểm tra của kỹ sư như người sử dụng trang web. Các quyền cấp cho trợ lý không bao giờ rộng hơn quyền của chính Quý khách. Một công cụ chỉ có thể làm những gì quyền của công cụ cho phép, và quyền có thể được gỡ bỏ bất kỳ lúc nào.
Những việc có thể làm ngay bây giờ
Cần thêm địa chỉ của máy chủ MCP vào trợ lý hỗ trợ MCP, hoặc tạo khóa API cho chương trình riêng. Dành cho nhà phát triển và trợ lý cho thấy cả hai cách. Khi làm việc với trợ lý, hãy cung cấp Hướng dẫn thiết kế PCB cho trợ lý AI của nhà máy cho trợ lý. Để biết cách làm việc với trợ lý nói chung, hãy đọc Đặt hàng bo mạch với trợ lý AI.