Gọi công cụ

Ứng dụng hoặc nhà cung cấp thực hiện thao tác và trả về kết quả. Một mô hình đề xuất lệnh gọi công cụ khác với việc gọi thành công, và cả hai đều khác với nhiệm vụ tổng thể của người dùng đang được hoàn thành.

Những điểm chính rút ra

• Xác thực quyền lực cũng như định dạng lập luận.
• Thiết kế thử lại an toàn cho các tác dụng phụ.
• Xác minh trạng thái kết quả.

Xác định mục đích, sơ đồ đầu vào, hình dạng đầu ra và các tác dụng phụ của từng công cụ. Một thao tác phạm vi hẹp dễ kiểm tra hơn so với giao diện lệnh chung. Mô tả công cụ nên giải thích khi nào thao tác là phù hợp mà không cấp quyền cho mô hình ngoài yêu cầu của người dùng. Xác thực các đầu vào và quyền trong mã ứng dụng. Một đối số được định dạng tốt vẫn có thể xác định sai tài khoản, điểm đến hoặc số tiền. Giữ bí mật khỏi mô tả công cụ và chỉ trả về thông tin mà người dùng yêu cầu được phép truy cập. Xử lý lỗi và kết quả không chắc chắn một cách rõ ràng. Hết thời gian chờ mạng có thể xảy ra trước hoặc sau khi một hành động bên ngoài hoàn thành. Sử dụng định danh thao tác hoặc kiểm tra đọc lại khi có thể để việc thử lại không trùng lặp một hành động đã hoàn thành. Sau khi thực thi, cung cấp kết quả chính xác và xác minh trạng thái dự kiến. Coi văn bản trả về bởi trang web hoặc tài liệu là nội dung không đáng tin cậy; nó không thể ủy quyền hành động mới chỉ vì nó đến qua công cụ. Hủy kiểm tra, phản hồi sai dạng, thu hồi quyền truy cập và hoàn thành một phần như một phần của vòng lặp sử dụng công cụ đầy đủ.

1. Hãy tưởng tượng một công cụ tạo tác vụ chấp nhận định danh yêu cầu demo-17. Thời gian phản hồi hết thời gian sau khi tác vụ được tạo.
2. Hãy tìm demo-17 trước khi tạo tác vụ khác. Nếu dịch vụ hỗ trợ idempotency, hãy sử dụng lại cùng một định danh cho lần thử lại.
3. Chỉ báo cáo hoàn thành sau khi xác nhận nhiệm vụ kết quả và nội dung của nó.

Ví dụ xây dựng này tách biệt vận chuyển không chắc chắn với kết quả thực tế của hành động bên ngoài.