Một cổng, nhiều giao thức: thực sự hỗ trợ những gì?
Kiểm tra khả năng tương thích giữa mô hình và API trước khi tham số quan trọng bị thay đổi.

Bắt đầu từ công việc cần làm
Hai API đều nhận hội thoại nhưng có thể hoạt động khác nhau. Ứng dụng của bạn chỉ cần văn bản hay còn cần hình ảnh, đầu ra có cấu trúc hoặc gọi công cụ? Hãy chọn mô hình và endpoint cùng ghi rõ những khả năng đó. Tương thích định dạng không có nghĩa là mọi trường đều được hỗ trợ.
Tên endpoint giống nhau thường chỉ cho biết một phần cấu trúc gần nhau, không đảm bảo mọi mô hình hiểu mọi tham số. Giới hạn đầu ra, định dạng có cấu trúc, ảnh đầu vào và định nghĩa công cụ có thể khác. Nhà cung cấp, cổng và thư viện khách đều có thể kiểm tra hoặc chuyển đổi dữ liệu. Hãy thử riêng việc gọi được và khả năng sản phẩm thực sự cần.
Lập một bảng tương thích nhỏ
Với mỗi cặp mô hình và endpoint, ghi lại loại đầu vào, streaming, công cụ, định dạng đầu ra và các giới hạn. Thử từng khả năng quan trọng bằng một yêu cầu tối thiểu. Một câu trả lời văn bản thành công chưa chứng minh rằng hình ảnh hoặc công cụ cũng hoạt động.
Một yêu cầu văn bản thành công không chứng minh cùng mô hình hỗ trợ streaming, gọi công cụ và ảnh. Kiểm tra dấu kết thúc, tên công cụ, cấu trúc tham số, cách gửi ảnh và lỗi khi không hỗ trợ. Đừng coi trường của một nhà cung cấp là chuẩn chung; hãy xem tài liệu hiện tại của đúng mô hình và endpoint.
Lưu một bộ nhỏ gồm văn bản thông thường, tham số biên, luồng bị ngắt, công cụ và đầu vào đa phương thức cần thiết. Chạy lại sau khi đổi mô hình, thư viện hoặc cổng và so sánh cấu trúc phản hồi, không chỉ mã trạng thái. Loại khóa và dữ liệu khách hàng; ghi phạm vi ảnh hưởng và cách quay lại trước khi đưa vào production.
Một ghi chú hữu ích gồm phiên bản mô hình, endpoint, loại đầu vào, kết quả mong đợi, kết quả thực tế và ngày thử. Một nhãn “tương thích” không đủ: cùng một cặp có thể nhận văn bản nhưng từ chối một kiểu ảnh. Giữ trường chưa thử ở trạng thái chưa biết cho đến khi kiểm tra.
Bộ chuyển đổi kết nối hai giao thức nhưng có thể không chuyển được mọi tính năng.Kiểm tra cả yêu cầu lẫn phản hồi
Lưu ví dụ đã loại bỏ dữ liệu nhạy cảm trong bộ kiểm thử. Xem trường tùy chọn bị từ chối, bỏ qua hay chuyển đổi và phản hồi có đủ thông tin ứng dụng cần không. Không đưa khóa thật, prompt riêng tư hay dữ liệu khách hàng vào kiểm thử công khai. Kiểm tra lại khi đổi mô hình hoặc nhà cung cấp.
Với mỗi tham số quan trọng, ghi rõ nó được nhận và có hiệu lực, bị từ chối, bị bỏ qua hay bị chuyển đổi khác nghĩa. Kiểm tra yêu cầu và phản hồi, kể cả sự khác nhau giữa trường vắng mặt và giá trị 0 hoặc false. Mã thành công không chứng minh tham số đã có tác dụng. Dùng đầu vào làm lộ sự khác biệt và lưu kết quả đã ẩn dữ liệu nhạy cảm.
Quyết định trước khi thiếu tính năng
Tắt điều khiển không được mô hình hỗ trợ, hoặc chọn mô hình hay endpoint khác nếu tính năng là bắt buộc. Hiển thị lỗi dễ hiểu thay vì âm thầm bỏ chỉ dẫn. Giữ liên kết tài liệu và kết quả kiểm thử bên cạnh bảng tương thích để dễ bảo trì.
Trường chưa thử nên được đánh dấu chưa biết, không phải được hỗ trợ. Ghi ngày thử, ID mô hình, endpoint, kết quả và giới hạn. Nếu không thể chuyển đổi một khả năng, có thể tắt tùy chọn, giải thích hoặc đề xuất mô hình khác. Khi sự khác biệt làm đổi ý nghĩa yêu cầu, lỗi rõ ràng tốt hơn việc âm thầm bỏ chỉ dẫn.
Kiểm tra ý nghĩa thực sự của từng trường
Tương thích không chỉ là đổi tên trường. Một API có thể biểu diễn nội dung bằng chuỗi, API khác dùng các khối văn bản và hình ảnh. Hướng dẫn hệ thống, định nghĩa công cụ và lý do kết thúc cũng có thể khác nhau; yêu cầu được chấp nhận chưa chắc giữ nguyên ý nghĩa cần thiết.
Hãy kiểm tra riêng trường vắng mặt, giá trị rỗng và giá trị 0 hoặc false được gửi rõ ràng. Nếu không thể chuyển đổi một khả năng, hãy thông báo hoặc đưa ra phương án đã kiểm chứng thay vì âm thầm bỏ qua chỉ dẫn.
Kiểm tra riêng tính năng phát trực tuyến và gọi công cụ
Với luồng phản hồi, hãy kiểm tra ranh giới sự kiện, các phần nội dung, tín hiệu kết thúc và lỗi. Một lệnh gọi công cụ có thể đến từng phần; cần ghép và xác thực tham số trước khi thực thi.
Đề xuất của mô hình không thay thế quyền của người dùng. Máy chủ phải kiểm tra quyền, xử lý lỗi công cụ và trả kết quả theo đúng giao thức. Với đầu ra có cấu trúc, cũng cần xử lý trường hợp kết quả không đúng lược đồ.
Cập nhật hồ sơ tương thích
Lưu hồ sơ cho từng tổ hợp gồm mô hình, phiên bản, giao diện, đầu vào, luồng, công cụ, định dạng, ngày và kết quả. Phân biệt đã đạt, thất bại và chưa kiểm tra; không đưa khóa thật vào dữ liệu thử.
Với trợ lý theo dõi đơn hàng, thử tham số đúng hoặc thiếu, từ chối quyền và quá thời gian. Sau khi đổi mô hình hay cấu hình, chạy lại các tình huống đó và chuẩn bị phương án dự phòng đã được kiểm tra.
Một ví dụ cụ thể
Giả sử trợ lý hỗ trợ cần trả lời bằng văn bản và tra cứu khách hàng. Đưa cùng một câu hỏi cho từng mô hình, rồi thử một lần tra cứu hợp lệ và một tham số sai. Ghi lại mô hình có yêu cầu công cụ không, máy chủ có từ chối dữ liệu sai không và câu trả lời cuối có dùng kết quả không. Nếu thêm ảnh đầu vào, hãy kiểm tra riêng khả năng đó.