Tweet
Structured Output: Làm sao để Claude trả về dữ liệu đúng cấu trúc?
Claude có thể tạo ra nội dung rất linh hoạt bằng ngôn ngữ tự nhiên. Nhưng trong nhiều ứng dụng, chúng ta không chỉ cần một đoạn text.
Ứng dụng có thể cần Claude trả về dữ liệu theo một cấu trúc cụ thể để tiếp tục xử lý ở bước sau.
Ví dụ, thay vì:
Hệ thống có thể cần dữ liệu dạng:
Customer ID → Refund Amount → Recommendation
Đây là lúc Structured Output trở nên quan trọng.
Structured Output là gì?
Hiểu đơn giản, Structured Output giúp định nghĩa trước cấu trúc dữ liệu mà Claude cần trả về.
Trong tài liệu CCAR-F, nội dung này gắn với tool_use, JSON Schema và schema design.
Schema có thể xác định:
Nếu chỉ yêu cầu:
Nhưng nếu hệ thống yêu cầu: customer_id
status
confidence
thì việc xác định schema ngay từ đầu giúp output nhất quán hơn.
Đặc biệt với những workflow có nhiều bước, kết quả từ Claude ở bước trước có thể trở thành input cho bước tiếp theo. Khi đó, một output có cấu trúc rõ ràng sẽ giúp hệ thống xử lý dễ dàng hơn.
Required và Optional
Một điểm cần chú ý khi thiết kế schema là phân biệt required và optional fields.
Không phải thông tin nào cũng luôn tồn tại.
Ví dụ, một hệ thống có thể yêu cầu:
customer_id → bắt buộc
nhưng:
refund_reason → có thể không có
Nếu thiết kế schema không phù hợp, Agent có thể gặp vấn đề khi dữ liệu thực tế không chứa đầy đủ thông tin.
Vì vậy, CCAR-F cũng đề cập đến việc sử dụng optional/nullable fields trong schema để hạn chế những trường hợp output không phù hợp hoặc dẫn đến việc Claude phải tự suy đoán dữ liệu. Structured Output trong workflow
Có thể hình dung:
User Request
↓
Claude
↓
Structured Output / Schema
↓
Validation
↓
Ứng dụng tiếp tục xử lý
Nếu output không đạt yêu cầu, workflow còn có thể sử dụng validation-retry loop để kiểm tra và thực hiện lại khi cần. Đây cũng là một nội dung nằm trong phần JSON Schema và validation của CCAR-F. Vì vậy, Structured Output không đơn giản là “bắt Claude trả về JSON”, mà là thiết kế một cấu trúc dữ liệu rõ ràng để Claude và ứng dụng có thể phối hợp với nhau ổn định hơn.
👉 VnPro hiện có khóa đào tạo và luyện thi chứng chỉ CCAR-F. Hãy liên hệ VnPro để được tư vấn và đăng ký khóa học nhé!!
Ứng dụng có thể cần Claude trả về dữ liệu theo một cấu trúc cụ thể để tiếp tục xử lý ở bước sau.
Ví dụ, thay vì:
“Khách hàng có khả năng được hoàn tiền. Số tiền đề xuất là 300 USD.”
Hệ thống có thể cần dữ liệu dạng:
Customer ID → Refund Amount → Recommendation
Đây là lúc Structured Output trở nên quan trọng.
Structured Output là gì?
Hiểu đơn giản, Structured Output giúp định nghĩa trước cấu trúc dữ liệu mà Claude cần trả về.
Trong tài liệu CCAR-F, nội dung này gắn với tool_use, JSON Schema và schema design.
Schema có thể xác định:
- Field nào bắt buộc
- Field nào là tùy chọn
- Kiểu dữ liệu của field
- Các giá trị được phép
- Những field có thể nhận giá trị null
Nếu chỉ yêu cầu:
“Hãy trả về thông tin khách hàng.”
Claude có thể tạo ra nhiều cách trình bày khác nhau.Nhưng nếu hệ thống yêu cầu: customer_id
status
confidence
thì việc xác định schema ngay từ đầu giúp output nhất quán hơn.
Đặc biệt với những workflow có nhiều bước, kết quả từ Claude ở bước trước có thể trở thành input cho bước tiếp theo. Khi đó, một output có cấu trúc rõ ràng sẽ giúp hệ thống xử lý dễ dàng hơn.
Required và Optional
Một điểm cần chú ý khi thiết kế schema là phân biệt required và optional fields.
Không phải thông tin nào cũng luôn tồn tại.
Ví dụ, một hệ thống có thể yêu cầu:
customer_id → bắt buộc
nhưng:
refund_reason → có thể không có
Nếu thiết kế schema không phù hợp, Agent có thể gặp vấn đề khi dữ liệu thực tế không chứa đầy đủ thông tin.
Vì vậy, CCAR-F cũng đề cập đến việc sử dụng optional/nullable fields trong schema để hạn chế những trường hợp output không phù hợp hoặc dẫn đến việc Claude phải tự suy đoán dữ liệu. Structured Output trong workflow
Có thể hình dung:
User Request
↓
Claude
↓
Structured Output / Schema
↓
Validation
↓
Ứng dụng tiếp tục xử lý
Nếu output không đạt yêu cầu, workflow còn có thể sử dụng validation-retry loop để kiểm tra và thực hiện lại khi cần. Đây cũng là một nội dung nằm trong phần JSON Schema và validation của CCAR-F. Vì vậy, Structured Output không đơn giản là “bắt Claude trả về JSON”, mà là thiết kế một cấu trúc dữ liệu rõ ràng để Claude và ứng dụng có thể phối hợp với nhau ổn định hơn.
👉 VnPro hiện có khóa đào tạo và luyện thi chứng chỉ CCAR-F. Hãy liên hệ VnPro để được tư vấn và đăng ký khóa học nhé!!