Gọi công cụ: mô hình đề xuất, ứng dụng quyết định
Kiểm tra hành động do mô hình yêu cầu và trả về kết quả hữu ích.

Lời gọi công cụ là một đề xuất
Mô hình có thể đề xuất hàm và tham số, nhưng ứng dụng quyết định điều gì được thực thi. Đừng dùng mô hình thay cho hệ thống phân quyền. Tra cứu đơn hàng và hoàn tiền có mức rủi ro khác nhau và không nên được tin cậy như nhau.
Bắt đầu bằng một hàm nhỏ
Đặt tên rõ ràng, mô tả mục đích và cấu trúc tham số. Tìm kiếm chỉ đọc là ví dụ đầu tiên phù hợp. Kiểm tra mô hình và endpoint có hỗ trợ gọi công cụ không vì định dạng thông điệp có thể khác nhau. Không đưa thông tin bí mật vào prompt.
Một công cụ nên làm một việc rõ ràng như đọc trạng thái đơn hàng, thay vì vừa đọc vừa sửa và gửi thông báo. Mô tả kiểu, ý nghĩa và trường bắt buộc. Máy chủ vẫn phải kiểm tra giá trị thiếu hoặc sai, kể cả trường tùy chọn. Các mô hình xử lý định nghĩa công cụ khác nhau, nên hãy thử bằng mô hình dự định triển khai.
Mô hình đề xuất công cụ, còn ứng dụng kiểm tra quyền trước khi thực thi.Xác thực trước khi hành động
Phân tích và kiểm tra từng tham số ở máy chủ, sau đó xác minh quyền của người dùng với tài nguyên được yêu cầu. Đặt giới hạn, thời gian chờ và yêu cầu xác nhận với hành động nhạy cảm. Kết quả công cụ cũng là dữ liệu không đáng tin: chỉ dẫn trên trang tìm được không được ghi đè quy tắc ứng dụng.
ID đơn hàng do mô hình đề xuất không chứng minh người dùng được xem đơn đó. Máy chủ phải kiểm tra danh tính, chủ sở hữu tài nguyên và quy tắc nghiệp vụ; lời gọi công cụ không được vượt qua hệ thống quyền hiện có. Với xóa, thanh toán, gửi tin hay tác động khác, hãy trình bày hành động cụ thể và lấy xác nhận phù hợp trước khi thực thi có thể kiểm tra.
Trang web, tệp, kết quả tìm kiếm và phản hồi bên thứ ba có thể chứa chỉ dẫn không liên quan hoặc độc hại. Phân biệt dữ liệu với mệnh lệnh; nội dung bên ngoài không được thay đổi quy tắc phân quyền hay yêu cầu tiết lộ bí mật. Chỉ trả thông tin cần thiết cho mô hình, rút gọn hoặc ẩn dữ liệu khi phù hợp. Mã ứng dụng quyết định hành động cuối.
Trả kết quả và giữ dấu vết
Gửi kết quả ngắn gọn theo định dạng của endpoint, rồi để mô hình tiếp tục nếu giao thức hỗ trợ. Ghi tên công cụ, kết quả và mã yêu cầu nhưng không ghi thông tin xác thực hay dữ liệu cá nhân không cần thiết. Kiểm thử tham số sai, dịch vụ lỗi và lời gọi lặp.
Một tác vụ có thể cần nhiều lời gọi nhưng không được chạy vô hạn. Đặt thời gian chờ, số lần gọi và hạn chót tổng thể. Khi dịch vụ không khả dụng, trả kết quả thất bại rõ ràng để mô hình hoặc giao diện chọn bước tiếp. Không giả lỗi thành thành công hoặc lặp hành động tốn phí, có tác động mà người dùng không biết.
Thử tham số thiếu hoặc sai, tài nguyên không có quyền, công cụ quá thời gian và lời gọi trùng. Thêm kết quả chứa chỉ dẫn độc hại và xác nhận quyền không bị thay đổi. Ghi tên công cụ, kết quả và mã yêu cầu mà không ghi khóa đầy đủ hay dữ liệu cá nhân không cần thiết. Mô hình không được bỏ qua bước xác nhận hành động nhạy cảm.
Coi đề xuất của mô hình là dữ liệu đầu vào không đáng tin cậy
Tên công cụ và tham số từ mô hình chỉ là đề xuất, không phải quyền thực thi. Kiểm tra trường bắt buộc, kiểu, độ dài, giá trị cho phép và quyền truy cập của người dùng. Không ghép trực tiếp đầu ra mô hình vào SQL, lệnh hệ thống hoặc URL tùy ý.
Giữ mỗi công cụ có phạm vi rõ ràng và thực thi kiểm tra quyền ở máy chủ. Nội dung từ trang web hoặc tài liệu bên ngoài cũng là dữ liệu không đáng tin cậy; chỉ trả về thông tin cần cho tác vụ.
Thiết kế cho lỗi và bước xác nhận của con người
Dự kiến các trường hợp quá thời gian, không có kết quả, bị từ chối quyền hoặc dịch vụ không khả dụng. Thông báo lỗi trung thực, giới hạn số lần thử lại và bảo vệ các thao tác có tác dụng phụ khỏi việc thực thi trùng.
Với hành động quan trọng, hiển thị chính xác thao tác cần xác nhận và kiểm tra quyền trên máy chủ. Mô hình nói rằng đã được phép không thay thế sự đồng ý thực tế. Chỉ ghi mã yêu cầu, công cụ, loại kết quả và thời gian khi phù hợp.
Bắt đầu với một công cụ chỉ đọc
Với trợ lý tra cứu đơn hàng, trước tiên xác định người đang đăng nhập. Máy chủ kiểm tra đơn thuộc người đó trước khi trả về trạng thái cần thiết. Nếu không có quyền hoặc không tìm thấy đơn, trợ lý không nên tự đoán.
Thử đơn hợp lệ, đơn của người khác, mã sai hoặc thiếu và lỗi quá thời gian. Trước khi thêm công cụ ghi dữ liệu, hãy thử hủy xác nhận, nhấn hai lần và trạng thái kết quả chưa rõ.
Thử tra cứu chỉ đọc trước
Với công cụ tra trạng thái đơn theo ID, chỉ nhận trường cần thiết, kiểm tra quyền xem đơn ở máy chủ và trả trạng thái ngắn thay vì toàn bộ hồ sơ. Sau đó thử trường hợp thiếu ID và đơn của người khác. Nếu sau này thêm chức năng hủy đơn, hãy yêu cầu xác nhận phù hợp trước hành động riêng đó.
Trước hành động quan trọng, cho người dùng thấy đối tượng, thao tác và ảnh hưởng có thể xảy ra. Sau đó máy chủ kiểm tra lại quyền và trạng thái hiện tại. Xác nhận chỉ áp dụng cho hành động cụ thể; câu trả lời trước đó của mô hình không phải quyền thực thi. Hãy báo đúng kết quả thành công hoặc thất bại.