Cách AI Agent kết nối API với phần mềm doanh nghiệp từng bước

API giống quầy giao dịch của phần mềm

Hãy hình dung phần mềm bán hàng của bạn như một ngân hàng. Nhân viên bên trong được vào kho, mở sổ sách, sửa số liệu. Người bên ngoài thì không. Họ chỉ được đứng ở quầy, điền đúng mẫu giấy tờ và nhận kết quả qua ô cửa.

API chính là quầy giao dịch đó.

Mỗi quầy chỉ nhận vài loại yêu cầu nhất định, như tra cứu đơn hàng hay tạo khách hàng mới. Mẫu điền thiếu sẽ bị trả lại, ai không có thẻ hợp lệ bị từ chối ngay từ cửa. Chính những quy định này giữ dữ liệu doanh nghiệp an toàn, kể cả khi người đứng trước quầy là một AI.

Khi AI Agent kết nối API, nó cũng chỉ làm được những gì quầy giao dịch cho phép, trong phạm vi quyền hạn doanh nghiệp cấp. Phần lớn CRM, phần mềm bán hàng, kế toán hay sàn thương mại điện tử hiện nay đều có sẵn API. Phần mềm cũ hoặc tự viết thì chưa chắc, trường hợp này được bàn ở phần sau.

AI Agent biết gọi API nào nhờ bản mô tả công cụ

Trước khi AI Agent bắt đầu làm việc, đội triển khai khai báo cho nó một danh sách công cụ. Mỗi công cụ tương ứng với 1 loại yêu cầu gửi qua API và đi kèm 3 thông tin: tên gọi, mô tả bằng lời khi nào nên dùng, và những dữ liệu bắt buộc phải có. Một công cụ tra cứu đơn hàng có thể được mô tả như sau:

• Tên: tra cứu đơn hàng

• Dùng khi: khách hỏi về tình trạng, thời gian giao hoặc nội dung đơn đã đặt

• Cần có: mã đơn hàng và số điện thoại đặt hàng

Khi khách nhắn tin, AI đọc câu hỏi, đối chiếu với các mô tả này rồi chọn công cụ phù hợp nhất. Cách làm không khác mấy so với một nhân viên mới được phát bảng hướng dẫn: gặp việc này thì mở phần mềm kia, điền đủ các ô sau.

Nghe đơn giản. Nhưng bản mô tả quyết định rất nhiều. Mô tả mơ hồ, hoặc 2 công cụ có phạm vi na ná nhau, AI rất dễ chọn nhầm. Trong thực tế, không ít lỗi bị đổ cho "AI chưa đủ thông minh" hóa ra bắt nguồn từ bản mô tả viết vội. Giai đoạn đầu chỉ nên khai báo 3 đến 5 công cụ thật rõ ràng.

Các hạng mục kỹ thuật cần khảo sát trước, như cách xác thực hay giới hạn số lượt gọi, đã có trong bài tích hợp AI Agent với CRM, ERP và API. Ở đây, ta xem điều gì diễn ra bên trong mỗi lần AI Agent kết nối API.

Theo chân 1 yêu cầu tra cứu đơn hàng từ đầu đến cuối

21 giờ tối, một khách nhắn vào fanpage: "Đơn hôm thứ 2 của mình sao chưa thấy giao?"

1. AI nhận ra đây là câu hỏi về tình trạng giao hàng và chọn công cụ tra cứu đơn hàng.

2. Khách chưa đưa mã đơn, nên AI hỏi lại mã đơn hoặc số điện thoại đã dùng khi đặt. AI không đoán. Bước hỏi lại này đồng thời là bước xác minh, giúp tránh trường hợp lộ thông tin đơn của người khác.

3. Có đủ dữ liệu, AI Agent kết nối API của phần mềm bán hàng và gửi đi mã đơn 1024 cùng số điện thoại khách vừa cung cấp. Thời gian chờ thường chỉ tính bằng giây.

4. Phần mềm trả về dữ liệu thô dưới dạng các trường thông tin: trạng thái "đang vận chuyển", ngày dự kiến giao 3/10, ghi chú "giao lần 1 không liên lạc được người nhận".

5. AI chuyển dữ liệu đó thành lời: "Đơn 1024 của anh đang được vận chuyển. Hôm qua bên giao hàng đã đến nhưng chưa liên lạc được với anh, dự kiến giao lại vào ngày 3/10. Anh có muốn để lại khung giờ nhận hàng thuận tiện không?"

Nhìn lại, chỉ bước 3 mới thực sự là kết nối. 4 bước còn lại là việc AI hiểu người hỏi và hiểu dữ liệu nhận về.

Còn một chi tiết dễ bị bỏ qua.

Ở bước 5, AI chỉ được nói những gì dữ liệu trả về. Nếu phần mềm không có ngày giao dự kiến, câu trả lời đúng là "hiện chưa có ngày giao cụ thể", chứ không phải một ngày do AI tự suy ra. Quy tắc này ngăn AI hứa với khách những điều doanh nghiệp không giữ được.

Đọc dữ liệu và ghi dữ liệu có mức rủi ro rất khác nhau

Xem một đơn hàng và hủy một đơn hàng đều đi qua API. Hậu quả khi làm sai thì chênh nhau rất xa.

Giai đoạn đầu chỉ nên mở quyền đọc và quyền tạo mới. Sau 1 đến 2 tháng theo dõi nhật ký, nếu ổn định mới cân nhắc mở quyền cập nhật. Nhóm thao tác cuối bảng thì nhiều doanh nghiệp giữ hẳn cho con người, và đó là lựa chọn hợp lý. Cách phân định việc AI được tự làm và việc phải xin phép có trong bài thiết kế quy trình phê duyệt cho AI Agent.

Thêm một lưu ý hay bị bỏ qua: hãy tạo tài khoản riêng khi cho AI Agent kết nối API, không dùng chung tài khoản quản trị. Mọi thao tác nhờ vậy đều truy vết được, và khi cần thu hồi quyền chỉ việc khóa đúng tài khoản đó.

Phần mềm không có API thì AI Agent kết nối bằng cách nào?

Chuyện này gặp nhiều hơn bạn nghĩ. Phần mềm kế toán cài từ 10 năm trước, file Excel quản lý kho do nhân viên tự dựng, phần mềm đặt riêng mà đơn vị viết ra đã ngừng hỗ trợ. Không có quầy giao dịch thì phải mở lối khác. 4 cách thường dùng, xếp theo thứ tự nên ưu tiên:

• Viết thêm 1 lớp API trung gian: bên triển khai dựng một quầy giao dịch mới đặt trước phần mềm cũ, chỉ mở đúng vài thao tác cần thiết. Tốn công lúc đầu nhưng bền và dễ kiểm soát nhất.

• Đọc trực tiếp cơ sở dữ liệu bằng tài khoản chỉ đọc: dữ liệu luôn mới, nhưng cần người hiểu rõ cấu trúc các bảng và tuyệt đối không cấp quyền ghi.

• Đồng bộ qua file định kỳ: phần mềm xuất dữ liệu mỗi giờ hoặc mỗi ngày sang Google Sheets hay một kho dữ liệu chung để AI đọc. Rẻ và đơn giản, nhưng dữ liệu luôn trễ một nhịp.

• Tự động thao tác trên giao diện: cho máy mô phỏng thao tác nhấp chuột và gõ phím như người. Chỉ nên là phương án cuối cùng, vì phần mềm đổi giao diện một chút là quy trình gãy.

Chọn cách nào phụ thuộc chủ yếu vào tốc độ thay đổi của dữ liệu. Giá khuyến mãi, tồn kho hay lịch trống đổi theo từng giờ thì đồng bộ file mỗi ngày là không đủ, và bài viết về AI Agent với dữ liệu thời gian thực đã phân tích rõ ranh giới này. Ngược lại, chính sách bảo hành hay danh mục sản phẩm vài tháng mới đổi một lần thì file định kỳ vẫn dùng tốt.

Đôi khi câu trả lời thẳng thắn nhất lại là nên nâng cấp phần mềm trước, rồi mới tính chuyện đưa AI vào.

Khi kết nối gặp lỗi, AI Agent phản ứng thế nào mới đúng

Không có kết nối nào chạy trơn tru 100% thời gian. Phần mềm bảo trì, mạng chập chờn, khách gõ nhầm 1 chữ số. Điều đáng quan tâm là AI làm gì khi lỗi xảy ra.

Khi phần mềm không phản hồi, AI nên thử lại 1 đến 2 lần. Vẫn không được thì báo rõ hệ thống đang gián đoạn, ghi nhận thông tin khách và hẹn thời điểm phản hồi. Khi không tìm thấy dữ liệu, AI nên nhờ khách kiểm tra lại thông tin vừa nhập, chứ không vội kết luận "đơn hàng không tồn tại". Còn khi bị từ chối quyền truy cập, đó là tín hiệu chuyển cho nhân viên, không phải lý do để AI tìm đường khác.

Gom lại thành một nguyên tắc: AI Agent kết nối API không thành công thì phải nói thật là chưa lấy được dữ liệu. Câu trả lời bịa nhưng trơn tru là kiểu lỗi nguy hiểm nhất, vì không ai nhận ra ngay. Mỗi lần lỗi nên được ghi vào nhật ký để đội kỹ thuật xem lại hằng tuần.

Câu hỏi thường gặp

AI Agent kết nối API có cần sửa phần mềm đang dùng không?

Không, nếu phần mềm đã có sẵn API. AI chỉ gửi yêu cầu qua những cửa phần mềm đã mở. Chỉ phần mềm không có API mới cần dựng thêm lớp trung gian.

AI Agent có tự ý thay đổi dữ liệu trong phần mềm không?

Không. AI chỉ thực hiện được những thao tác đã được khai báo thành công cụ và được cấp quyền. Thao tác nào không có trong danh sách thì AI không thể làm.

Một AI Agent có kết nối được nhiều phần mềm cùng lúc không?

Có. Mỗi phần mềm là một nhóm công cụ riêng. Trong cùng một cuộc trò chuyện, AI có thể tra đơn ở phần mềm bán hàng rồi tạo phiếu ở phần mềm hỗ trợ.

Kết nối API có làm chậm phần mềm doanh nghiệp đang dùng không?

Không đáng kể với lượng yêu cầu thông thường. Nếu lượng khách lớn, nên đặt giới hạn số lượt gọi mỗi phút để phần mềm luôn chạy ổn định.

Doanh nghiệp có cần đội kỹ thuật riêng để kết nối không?

Không bắt buộc. Doanh nghiệp chỉ cần cung cấp tài liệu API hoặc đầu mối của đơn vị làm phần mềm. Khai báo công cụ và kiểm thử do bên triển khai đảm nhận.