Function Calling trong LLM: Bí quyết validate JSON Schema với Zod không bao giờ bị lỗi parse

import { z } from 'zod';
import { zodToJsonSchema } from 'zod-to-json-schema';
import OpenAI from 'openai';

// 1. Định nghĩa Schema chặt chẽ bằng Zod
const UserProfileExtractSchema = z.object({
  fullName: z.string().describe('Họ và tên ứng viên'),
  yearsOfExperience: z.number().int().nonnegative().describe('Số năm kinh nghiệm làm việc'),
  skills: z.array(z.string()).min(1).describe('Danh sách các kỹ năng kỹ thuật chính'),
  seniorityLevel: z.enum(['Junior', 'Middle', 'Senior', 'Lead']),
  salaryExpectationVND: z.number().optional().describe('Mức lương mong muốn tính theo VND')
});

type UserProfile = z.infer<typeof UserProfileExtractSchema>;

// 2. Sử dụng OpenAI Structured Outputs (json_schema)
const openai = new OpenAI();
const completion = await openai.chat.completions.create({
  model: 'gpt-4o-2024-08-06',
  messages: [
    { role: 'system', content: 'Bạn là trợ lý trích xuất hồ sơ ứng viên IT chính xác.' },
    { role: 'user', content: 'Hồ sơ: Nguyễn Văn A, 5 năm kinh nghiệm Node.js, React, mong muốn mức lương 40 triệu.' }
  ],
  response_format: {
    type: 'json_schema',
    json_schema: {
      name: 'candidate_profile',
      strict: true, // Ép buộc tuân thủ 100% schema!
      schema: zodToJsonSchema(UserProfileExtractSchema)
    }
  }
});

const result = UserProfileExtractSchema.parse(JSON.parse(completion.choices[0].message.content!));
console.log('Parsed successfully:', result.fullName, result.seniorityLevel);