1. Giới thiệu
Trong hệ sinh thái RedAI, AI Agent không chỉ dừng ở việc tư vấn hay trả lời câu hỏi. Agent còn có thể thực hiện hành động thực tế trong các hệ thống doanh nghiệp như CRM, Google Sheets, cơ sở dữ liệu nội bộ và nhiều ứng dụng khác.
Để làm được điều đó, RedAI cung cấp lớp Tools & MCP – nơi các công cụ được kết nối, khai báo và để Agent có thể gọi một cách có cấu trúc. Trong số những thành phần quan trọng của lớp này, Project Tool đóng vai trò cốt lõi: biến khả năng của một ứng dụng bên ngoài thành một hành động cụ thể mà Agent có thể chọn và thực thi.
Bài viết này giúp bạn hiểu rõ Project Tool là gì, nằm ở đâu trong hệ sinh thái RedAI, và biến môi trường trong đó dùng để làm gì — theo hướng giới thiệu, không hướng dẫn kỹ thuật chi tiết.
2. Project Tool là gì?
Project Tool là một hành động cụ thể được khai báo trong một dự án (project) của RedAI, cho phép AI Agent gọi đến một API hoặc chức năng của hệ thống bên ngoài.
Thay vì để Agent tự mò cách gọi API phức tạp, doanh nghiệp tạo ra một Tool với tên và mô tả rõ ràng. Khi người dùng đưa ra yêu cầu, Agent sẽ chọn đúng Tool cần thiết và thực hiện hành động tương ứng.
Ví dụ dễ hiểu:
Thay vì để Agent tự viết lệnh gọi API CRM, bạn tạo một Project Tool tên "Tìm khách hàng". Khi người dùng hỏi: "Tìm khách hàng có số điện thoại 090xxxxxxx", Agent sẽ chọn Tool này, truyền số điện thoại vào và trả về kết quả từ CRM.
Công thức vận hành đơn giản:
Hệ thống bên ngoài → Project Tool → Agent gọi → Kết quả trả về
3. Project Schema và Project Tool – sự khác biệt
Hai khái niệm này liên quan chặt chẽ nhưng có vai trò khác nhau:
Một Project Schema có thể sinh ra nhiều Project Tool.
Ví dụ: Schema CRM có thể dùng để tạo cả Tool tìm khách hàng, Tool cập nhật ghi chú và Tool tạo đơn hàng.
4. Các thành phần của Project Tool (giới thiệu khái niệm)
Một Project Tool được hình thành từ các thành phần cấu hình giúp Agent biết chính xác công cụ này dùng để làm gì và khi nào nên chọn:
Tên và mô tả Tool: Giúp Agent xác định mục đích của Tool (ví dụ: "Tìm danh sách khách hàng chưa chăm sóc").
InputSchema: Mô tả dữ liệu mà Tool cần nhận vào (trường nào bắt buộc, kiểu dữ liệu là gì).
Vị trí tham số: Tham số có thể nằm trong đường dẫn (path), trong chuỗi truy vấn (query) hoặc trong nội dung gửi đi (body).
Tham số ghim (pinnedParams): Giá trị cố định được hệ thống thêm vào mỗi lần gọi, không để Agent tự thay đổi (ví dụ: mã doanh nghiệp, khu vực).
Danh sách trường được phép (fieldWhitelist): Giới hạn Agent chỉ đọc hoặc ghi những trường cần thiết, tránh tác động đến dữ liệu nhạy cảm.
Lưu ý: Phần này chỉ giới thiệu khái niệm, không hướng dẫn cấu hình chi tiết hay viết mã.
5. Biến môi trường – ý nghĩa và vai trò
Biến môi trường là gì?
Biến môi trường (environment variable) là giá trị cấu hình được tách riêng khỏi công cụ, thay đổi tùy theo môi trường chạy.
Thay vì viết cứng địa chỉ hệ thống trực tiếp trong Tool, người quản trị có thể dùng biến để đại diện cho địa chỉ đó. Khi chuyển môi trường (ví dụ từ kiểm thử sang vận hành thực), chỉ cần đổi giá trị biến, không cần viết lại cấu trúc Tool.
Vai trò của biến môi trường trong Project Tool
Tách cấu hình khỏi công cụ: Tool chỉ định nghĩa cách gọi API; địa chỉ thực tế nằm ở cấu hình riêng, dễ bảo trì và ít rủi ro khi đổi hệ thống.
Vận hành linh hoạt trên nhiều môi trường: Cùng một Tool có thể chạy ở môi trường phát triển, kiểm thử và vận hành thực với các địa chỉ hệ thống khác nhau.
Quản lý theo dự án: Mỗi workspace hoặc dự án có thể có mã doanh nghiệp, khu vực, phiên bản API riêng, nhưng vẫn tái sử dụng cùng một Tool.
Ví dụ thực tế:
Một Tool tìm đơn hàng trong CRM. Ở môi trường kiểm thử, nó gọi đến địa chỉ API sandbox; ở môi trường vận hành thực, nó gọi đến địa chỉ API chính thức. Hai môi trường này được quản lý thông qua biến môi trường, không cần tạo hai Tool khác nhau.
Lưu ý về bảo mật: Biến môi trường giúp tách cấu hình khỏi công cụ, nhưng không phải mọi giá trị nhạy cảm đều nên để lộ trong mô tả Tool.
6. Sức mạnh và ứng dụng thực tế
Project Tool giúp RedAI Agent chuyển từ AI "tư vấn" sang AI "thực hành" trong các bộ phận doanh nghiệp.
Kịch bản ví dụ:
Agent nhận yêu cầu: "Tìm khách hàng chưa được liên hệ trong 7 ngày" → Agent gọi Project Tool tìm kiếm trong CRM → Lọc danh sách → Chuẩn bị nội dung gọi lại cho đội ventas. Toàn bộ quá trình diễn ra thông qua Tool đã được khai báo an toàn, thay vì để Agent tự mò cách truy xuất dữ liệu.
7. Phân biệt Project Tool, Skill, MCP và Workflow
Để không nhầm lẫn, hãy nhìn vào vai trò của từng thành phần trong hệ sinh thái RedAI:
Project Tool nằm ở lớp hành động cụ thể, được Agent gọi thông qua lớp giao tiếp MCP, trong khi Skill và Workflow đóng vai trò định hướng và điều phối cao hơn.
8. Lợi ích chiến lược khi sử dụng Project Tool
An toàn: Kiểm soát quyền đọc/ghi, giới hạn trường dữ liệu, ghim tham số cố định để Agent không tác động nhầm dữ liệu quan trọng.
Dễ tái sử dụng: Cùng một Tool có thể phục vụ nhiều dự án hoặc nhiều môi trường mà không cần nhân bản cấu hình.
Rõ ràng: Agent biết chính xác Tool này dùng để làm gì, giúp giảm sai chọn công cụ.
Linh hoạt: Thay đổi cấu hình hệ thống mà không phải viết lại Tool từ đầu.
9. Kết luận
Project Tool trong RedAI Tools & MCP không chỉ là "một cái nút gọi API". Nó là lớp cấu hình giúp doanh nghiệp kiểm soát chính xác Agent có thể làm gì, gọi hệ thống nào, truyền dữ liệu như thế nào và trong giới hạn an toàn như thế nào.
Kết hợp với biến môi trường, Project Tool giúp AI Agent vận hành ổn định, dễ bảo trì và phù hợp với nhu cầu thực tế của từng bộ phận trong doanh nghiệp.
Bước tiếp theo: Nếu bạn quan tâm đến cách RedAI giúp đội Marketing và Sales tự động hóa công việc thông qua Tools & MCP, hãy liên hệ đội tư vấn RedAI để được hỗ trợ triển khai cho doanh nghiệp của bạn.