Kết nối AI Agent với Google Sheets thường bắt đầu từ một bảng đội marketing đã dùng lâu: mỗi người thêm một cột, trạng thái viết theo nhiều cách, ngày tháng có chỗ là ngày thật có chỗ là chữ. Bộ kết nối có thể đọc được bảng, nhưng AI vẫn hiểu sai khách nào cần theo dõi hoặc ngân sách nào chưa được xác nhận.
Trước khi chọn công cụ nối, anh chị cần thống nhất một hàng đại diện cho điều gì, ID nào nhận diện bản ghi và từng cột có nghĩa ra sao. Bài này hướng dẫn chuẩn hóa đầu vào, kèm mẫu lead giả định và cách kiểm dữ liệu trả về. Nội dung không phải hướng dẫn cấp quyền cho một tài khoản cụ thể hoặc kết quả thử nghiệm connector.
Khi nào Google Sheets đủ dùng làm nguồn cho AI?
Sheets có thể là điểm bắt đầu khi phạm vi công việc rõ, dữ liệu có người quản lý và thao tác cần làm chưa đòi hỏi nhiều quan hệ phức tạp. Chẳng hạn, đội muốn AI đọc danh sách lead đã được rà soát để gợi ý các trường hợp còn thiếu thông tin, rồi người phụ trách kiểm lại trước khi liên hệ.
Điều kiện quan trọng là đội biết bảng này có quyền quyết định thông tin nào. Nếu trạng thái khách đã chốt nằm ở CRM, một bản xuất sang Sheets từ tuần trước không nên trở thành nguồn để AI khẳng định khách vẫn đang chờ tư vấn. Có thể đối chiếu cách chọn nguồn dữ liệu cho trợ lý AI để xác định nguồn chính, phạm vi sử dụng và thời điểm cập nhật.
Nên xem lại lựa chọn khi nhiều người và nhiều hệ thống cùng ghi, cần giới hạn truy cập chi tiết, phải giữ lịch sử thay đổi nghiệp vụ hoặc cần kiểm soát chặt các thao tác liên quan nhau. Không có một số lượng hàng chung để kết luận “dưới mức này Sheets luôn đủ”. Tính phù hợp còn phụ thuộc cách truy vấn, tần suất cập nhật, quyền truy cập và hậu quả khi dữ liệu sai.
Với bảng vừa đọc vừa ghi, nên tách giai đoạn thử đọc khỏi giai đoạn cho phép sửa. Trước hết chứng minh rằng dữ liệu đi qua connector vẫn giữ đúng ID, kiểu và ý nghĩa. Sau đó mới xác định cột nào được cập nhật, ai duyệt và làm thế nào để tránh ghi vào dữ liệu đã thay đổi.
Thiết kế một hàng, một ID và một nghĩa cho từng cột
Trong ví dụ của bài, một hàng đại diện cho một lead. Nếu cần ghi nhiều lần liên hệ với cùng lead, nên có bảng hoạt động riêng, mỗi hoạt động mang ID riêng và liên kết về lead. Trộn lead với từng cuộc gọi trong cùng một bảng dễ khiến AI đếm một người thành nhiều lead.
Vùng dùng cho máy đọc nên có một hàng tên cột duy nhất, không gộp ô, không chen tiêu đề nhóm hoặc dòng tổng vào giữa bản ghi. Có thể giữ trang trình bày đẹp cho người xem, nhưng cần phân biệt nó với vùng dữ liệu nguồn. Không dùng màu nền làm dấu hiệu duy nhất cho trạng thái; ý nghĩa cần nằm trong giá trị cột.
Bảng dưới là một hợp đồng dữ liệu đề xuất gồm mười cột. Tên trường, vai trò và quy tắc là ví dụ thiết kế, không phải mẫu bắt buộc của Google hay chính sách nội bộ VIN.
| Cột | Kiểu và quy tắc | Vai trò chịu trách nhiệm |
|---|---|---|
| lead_id | Chuỗi duy nhất, không rỗng; giữ nguyên khi sắp xếp hoặc chuyển hàng. Ví dụ LD001. | Người quản lý dữ liệu cấp ID; người nhập không tự tái sử dụng. |
| received_at | Thời điểm tiếp nhận; mẫu dùng chuỗi ISO 8601 có múi giờ, như 2026-11-03T09:00:00+07:00. | Đầu mối tiếp nhận xác nhận thời điểm; tích hợp kiểm cách biểu diễn. |
| source | Chuỗi thuộc danh mục nguồn đã thống nhất, ví dụ WEB hoặc EVENT. | Marketing quản lý danh mục và nghĩa từng nguồn. |
| stage | Một giá trị trong NEW, REVIEW, CONTACTED; không ghép nhiều trạng thái vào một ô. | Sales xác nhận định nghĩa và điều kiện chuyển trạng thái. |
| owner_id | Mã vai trò hoặc người được giao, ví dụ S01; phải tra được trong danh mục chủ sở hữu. | Quản lý Sales chịu trách nhiệm việc phân công. |
| budget_vnd và budget_state | Số tiền nguyên không âm hoặc giá trị thiếu; KNOWN đi cùng số, UNKNOWN đi cùng ô chưa có số. Số 0 chỉ dùng khi đã xác nhận bằng 0. | Người tư vấn xác nhận căn cứ; Marketing không tự suy ngân sách. |
| needs_followup | Boolean TRUE/FALSE theo quy tắc đã chốt; không lẫn “có”, “yes”, dấu tích và chữ tự do. | Sales định nghĩa việc cần theo dõi; tích hợp kiểm kiểu trả về. |
| updated_at và schema_version | Thời điểm cập nhật bản ghi và phiên bản cấu trúc, ví dụ v1. Không coi đây là thời điểm connector vừa đọc. | Người phụ trách dữ liệu và tích hợp phối hợp quản lý. |
ID phải gắn với đối tượng, không gắn với vị trí hàng. Khi bảng được sắp xếp, hàng 12 có thể chuyển sang khách khác. Nếu tích hợp nhớ “sửa hàng 12” từ lần đọc trước, nó có thể ghi sai người. Trước khi sửa, cần tìm lại đúng ID và kiểm dữ liệu chưa thay đổi theo cơ chế đã thiết kế; đây không phải bảo đảm giao dịch an toàn chỉ nhờ có cột ID.

Các mã có số 0 đầu, mã đơn, số điện thoại thường cần được giữ dưới dạng văn bản nếu mục đích là nhận diện, không phải tính toán. Đổi định dạng sau khi dữ liệu đã mất số 0 không tự khôi phục thông tin gốc; cần đối chiếu nguồn thay vì để AI đoán lại.
Kiểm kiểu dữ liệu thực tế, không chỉ nhìn cách ô hiển thị
Một ô hiển thị “5.000.000 đ” có thể chứa số được định dạng tiền tệ hoặc một chuỗi gõ tay. Một ô trông như ngày có thể chứa giá trị ngày giờ hoặc văn bản. Hai trường hợp nhìn giống nhau nhưng cần xử lý khác khi đọc qua bộ kết nối.
Chốt cách đọc số, ngày và công thức
Google Sheets API phân biệt các chế độ trả giá trị: FORMATTED_VALUE trả giá trị đã tính và định dạng theo bảng; UNFORMATTED_VALUE trả giá trị đã tính chưa định dạng; FORMULA trả công thức. Ngày giờ cũng có thể được biểu diễn bằng số nội bộ. Vì vậy phải kiểm cấu hình đọc và mẫu phản hồi thật của connector.
Với mẫu trong bài, trường thời điểm được quy ước là chuỗi ISO 8601 kèm +07:00. Đây là lựa chọn cho mẫu trao đổi, không có nghĩa mọi ô ngày trong Google Sheets phải lưu như vậy. Nếu đội dùng ô ngày gốc, người tích hợp cần chuyển theo quy tắc ngày giờ của hệ thống, không coi một số nhận được là số tiền hoặc mã khách.
Tránh tự đổi “03/04/26” khi chưa biết người nhập muốn ngày 3 tháng 4 hay ngày 4 tháng 3. Đưa dòng này vào danh sách cần xác minh. Khi chuyển đổi số tiền từ chuỗi, chỉ áp dụng dấu phân cách và đơn vị sau khi đã xác nhận quy ước nguồn; không xóa mọi ký tự rồi mặc định kết quả đúng.
Với công thức, cần biết AI cần kết quả đã tính hay công thức để giải thích. Lỗi công thức phải được báo là lỗi dữ liệu, không biến thành 0. Nếu giá trị phụ thuộc một nguồn ngoài, cũng cần kiểm thời điểm và trạng thái cập nhật trước khi dùng nó để ra quyết định.
Ô trống cần có ý nghĩa rõ
Ô ngân sách trống có thể nghĩa là chưa hỏi, khách chưa trả lời hoặc dữ liệu chưa đồng bộ. Không nên dùng một ô trống để đại diện cho mọi tình huống. Trong mẫu này, budget_state cho biết KNOWN hay UNKNOWN; budget_vnd trống cùng UNKNOWN được hiểu là chưa có số để tính.
Tài liệu ValueRange cũng nêu đầu ra có thể bỏ các hàng và cột trống ở cuối. Người tích hợp cần đối chiếu phạm vi và ánh xạ cột, thay vì cho rằng mọi mảng trả về luôn đủ số phần tử. Hàng thiếu trường cần được xử lý theo hợp đồng, không tự dịch các giá trị sang cột khác.

Đối với cột trạng thái, nguồn và chủ sở hữu, nên dùng danh mục rõ. Dropdown và data validation của Google Sheets cho phép chọn giá trị từ danh sách và cấu hình xử lý đầu vào không hợp lệ. Cần phân biệt chế độ từ chối với chế độ chỉ cảnh báo. Ngoài kiểm ở giao diện, vẫn kiểm dữ liệu tại đầu vào của tích hợp, kể cả các đường ghi khác.
Mẫu sáu hàng: giữ nguyên dữ liệu gốc và tách dòng cần xác minh
Giả sử đội nhận sáu dòng dưới đây. Tất cả mã, số tiền và tình huống đều được tự tạo để hướng dẫn; không có dữ liệu khách hàng thật. Cách xử lý được đề xuất cho hợp đồng mười cột ở trên, chưa phải kết quả chạy một agent hoặc connector.
| Dòng nguồn | Điểm cần kiểm | Kết quả đề xuất |
|---|---|---|
| r1 — LD001 | Ngân sách ghi “5.000.000 đ”; người phụ trách đã xác nhận đơn vị VND và quy ước dấu chấm. | Đưa vào vùng chuẩn: budget_vnd = 5000000, budget_state = KNOWN. |
| r2 — LD002 | Cùng ID với r3 nhưng stage = NEW, chưa có bằng chứng bản nào là đúng. | Giữ lại để xác minh cùng r3; không chọn dòng đầu hoặc cuối một cách tự động. |
| r3 — LD002 | Cùng ID với r2 nhưng stage = CONTACTED. | Giữ lại để xác minh; bảo toàn cả hai dòng nguồn và lý do xung đột. |
| r4 — LD003 | Ngày tiếp nhận “03/04/26”, chưa xác nhận cách ghi ngày/tháng. | Chờ xác minh thời điểm; không đoán theo ngôn ngữ hội thoại. |
| r5 — LD004 | Chưa biết ngân sách; các trường bắt buộc khác đã rõ. | Cho vào vùng chuẩn với budget_state = UNKNOWN, budget_vnd để trống; khi xuất JSON dùng null theo quy ước mẫu. |
| r6 — LD005 | Người phụ trách đã xác nhận ngân sách hiện tại bằng 0. | Cho vào vùng chuẩn với budget_vnd = 0, budget_state = KNOWN. Không đổi thành thiếu dữ liệu. |
Theo cách phân loại này, có ba dòng đủ điều kiện vào vùng chuẩn và ba dòng nguồn cần xác minh. Hai dòng LD002 cùng bị giữ lại vì ID xung đột chưa được giải quyết. Đây là số dòng trong ví dụ, không phải tỷ lệ chất lượng dữ liệu của doanh nghiệp.
Với ba lead đã chấp nhận, chỉ hai lead có ngân sách được biết. Tổng phần ngân sách đã biết là 5.000.000 VND; một lead còn UNKNOWN. Khi trả lời, AI cần nêu cả phạm vi và phần thiếu, thay vì gọi đó là “tổng ngân sách của toàn bộ lead”. Cũng không đưa ba dòng đang chờ xác minh vào phép tính như thể dữ liệu đã hợp lệ.
Nên tách vùng dữ liệu gốc, vùng đã chuẩn hóa và danh sách lỗi. Mỗi dòng đã xử lý cần truy được về dòng nguồn hoặc mã nhập liệu để người phụ trách xem lý do chuyển đổi. Vùng lỗi cần có nguyên nhân, người nhận và kết quả xác minh; không chỉ là nơi đẩy dữ liệu khó đọc rồi bỏ quên.
Nếu người dùng đổi tên cột hoặc thêm một ý nghĩa mới, cập nhật từ điển dữ liệu và phiên bản cấu trúc. Một trường “ngày” chuyển từ ngày tiếp nhận sang ngày hẹn là thay đổi nghiệp vụ, dù tên cột vẫn giữ nguyên. Tích hợp cần phát hiện lệch cấu trúc và dừng phần xử lý liên quan khi chưa có ánh xạ được duyệt.
Chốt quyền đọc, quyền sửa và kiểm đầu ra của connector
Trước khi nối dữ liệu thật, xác nhận tài khoản thực hiện kết nối được phép truy cập file nào và với mục đích gì. Thử đọc chỉ nên dùng quyền phù hợp với việc đọc. Nếu cần ghi, phải chỉ rõ các cột được sửa, điều kiện duyệt và nơi giữ kết quả đối chiếu; không mặc định AI được sửa mọi ô mà tài khoản nhìn thấy.
Không dùng việc ẩn tab hoặc bảo vệ vùng làm bằng chứng dữ liệu đã được giữ kín. Google lưu ý bảo vệ sheet/range không phải biện pháp bảo mật; người có quyền vẫn có những khả năng sao chép dữ liệu. Cần quản lý quyền chia sẻ thực tế và chỉ đưa dữ liệu cần thiết vào phạm vi sử dụng.
Phạm vi “chỉ đọc tab LEADS” trong cấu hình connector cũng cần được phân biệt với quyền mà tài khoản kết nối có trên file. Người phụ trách phải kiểm cả hai, không coi một lời hướng dẫn trong prompt là rào cản truy cập. Các nội dung trong ô ghi chú là dữ liệu, không được dùng để thay đổi quy tắc cấp quyền hoặc ra lệnh cho agent gửi dữ liệu đi nơi khác.
Danh sách nghiệm thu đề xuất trước khi dùng dữ liệu thật:
- Đọc đúng file, tab và vùng; xác nhận cấu trúc cột, không chỉ thấy kết nối báo thành công.
- Đổi thứ tự hàng trong bản thử, kiểm ID vẫn gắn đúng dữ liệu; không để thao tác phụ thuộc số hàng cũ.
- Đưa ID thiếu hoặc trùng vào mẫu, kiểm hệ thống giữ lại để xác minh thay vì âm thầm gộp.
- Đọc số tiền, ô ngày, công thức, lỗi công thức và ô trống; ghi lại giá trị thực tế connector trả về.
- Kiểm UNKNOWN khác số 0, chuỗi mã khác số để tính và boolean khác chữ tự do.
- Đổi tên cột hoặc phiên bản cấu trúc, kiểm luồng phát hiện thay đổi trước khi xử lý tiếp.
- Kiểm tài khoản chỉ được dùng phạm vi đã cấp; không dựa vào tab ẩn hay prompt để giới hạn quyền.
- Nếu mở quyền ghi, thử dữ liệu đã bị người khác sửa giữa lúc đọc và ghi; kiểm cách phát hiện, xử lý xung đột và đối chiếu kết quả.
Đây là các ca cần chạy trên cấu hình cụ thể, chưa được thực thi trong bài. Khi có ghi dữ liệu, áp dụng nguyên tắc xác minh bản ghi trước khi AI báo thành công. Nếu Sheets là một lớp trung gian trước CRM, cần thêm quy tắc nguồn chính và quyền cập nhật CRM để tránh hai hệ thống cùng quyết định một trạng thái.
Câu hỏi thường gặp khi dùng Google Sheets cho AI Agent
Có cần dùng tên cột tiếng Anh không?
Không bắt buộc. Điều quan trọng là tên cột ổn định, không trùng và có định nghĩa rõ. Có thể dùng tên kỹ thuật để ánh xạ và nhãn tiếng Việt để người nhập dễ hiểu. Khi đổi tên, cập nhật cấu hình và kiểm lại đầu ra thay vì giả định connector sẽ tự nhận đúng.
AI có tự làm sạch hết dữ liệu được không?
AI có thể gợi ý nhóm lỗi hoặc cách chuyển đổi, nhưng dữ liệu thiếu căn cứ cần người có trách nhiệm xác minh. Ngày mơ hồ, ID xung đột và ngân sách chưa biết không nên được “làm sạch” bằng suy đoán. Giữ nguyên bản gốc và ghi rõ phần nào được sửa theo quy tắc nào.
Chỉ thêm cột ID là đủ để ghi dữ liệu an toàn?
Chưa đủ. ID giúp tìm đúng đối tượng, còn quyền ghi, dữ liệu thay đổi giữa hai lần thao tác, ghi trùng và kết quả chưa rõ vẫn cần cơ chế riêng. Trước khi cho agent sửa, phải biết nó phát hiện xung đột thế nào và ai xử lý khi không thể xác minh.
Bảng có thể thay CRM khi đã nối AI không?
Cần đánh giá theo nhu cầu quản lý lead, lịch sử hoạt động, phân quyền, quan hệ dữ liệu và trách nhiệm vận hành. Việc nối AI không tự bổ sung mọi chức năng của CRM. Có thể dùng Sheets cho một phạm vi giới hạn rồi chuyển sang hệ thống phù hợp hơn khi yêu cầu tăng lên.
