Tự Xây Trợ Lý AI Riêng Với Claude Agent SDK

Claude Code chạy tốt trong terminal, nhưng có việc mình cần chạy tự động lúc 6 giờ sáng mà không ngồi mở app: kiểm tra đơn hàng mới, tóm tắt rồi gửi báo cáo. Đó là lúc Claude Agent SDK vào việc: dựng một agent chạy độc lập, không cần người ngồi gõ lệnh.

Khác gì so với dùng Claude Code trực tiếp

Claude Code là công cụ tương tác, cần người mở lên và ra lệnh. Agent SDK là thư viện lập trình để nhúng vòng lặp agent (suy nghĩ, gọi tool, quan sát kết quả, lặp lại) vào chính ứng dụng hoặc script của bạn, chạy nền không cần giao diện chat.

📌 Chưa chắc nên chọn gì? Đọc trước Học AI: Dùng Claude, ChatGPT, Gemini Đúng Việc — hướng dẫn tổng hợp của Kudomax về học ai.

Các bước dựng một agent tối giản

• 1. Cài SDK vào dự án Python hoặc TypeScript, tuỳ ngôn ngữ đang dùng.
• 2. Định nghĩa tool: mỗi tool là một hàm cụ thể agent được phép gọi, ví dụ đọc file, gọi API nội bộ, hay ghi vào database. Càng mô tả rõ tool làm gì, agent càng gọi đúng lúc.
• 3. Viết prompt hệ thống mô tả vai trò và giới hạn của agent: việc nào được làm, việc nào phải dừng lại hỏi người dùng.
• 4. Chạy vòng lặp và log lại từng bước agent thực hiện trong lúc test, để biết agent đang nghĩ gì trước khi tin tưởng để nó chạy không giám sát.
• 5. Triển khai thành dịch vụ: chạy như một cron job, một worker nền, hoặc một endpoint API tuỳ nhu cầu, sau khi đã test đủ kỹ với dữ liệu thật.

Giới hạn quyền là bước không được bỏ qua

Một agent chạy tự động không có người giám sát trực tiếp mỗi lệnh, nên phải giới hạn rõ tool nào được gọi và dữ liệu nào được ghi. Đừng cấp quyền ghi vào database sản xuất cho một agent còn đang thử nghiệm. Luôn chạy trên môi trường test trước, theo dõi log vài ngày rồi mới đưa vào sản xuất.

Nếu agent cần thao tác trực tiếp trên máy tính thay vì chỉ gọi API, xem thêm Computer Use: để Claude tự thao tác trên máy tính để hiểu thêm giới hạn và rủi ro riêng của hướng đó.