Tools & MCP - Quản lý Tools, cấu hình và trạng thái công cụ
Hướng dẫn quản lý danh sách công cụ, chỉnh sửa tham số, bật/tắt kích hoạt và kiểm soát quyền hạn.
Mở khu vực quản lý
| Bước | Cách thực hiện |
|---|---|
| 1 | Mở Tools & MCP (Công cụ) trên RedAI. |
| 2 | Chọn Tích hợp Tools (External) để mở danh sách các tích hợp hiện có. |
Các tính năng
Tìm, lọc và nhận biết tích hợp
| Khu vực hoặc chức năng | Cách sử dụng |
|---|---|
| Cá nhân, Hệ thống và Cộng đồng | Chuyển giữa danh sách tích hợp thuộc phạm vi cá nhân, tích hợp do hệ thống cung cấp và tích hợp được chia sẻ từ cộng đồng. |
 (Lọc theo thẻ) | Chọn nút bộ lọc trên thanh công cụ để mở danh sách thẻ. Có thể nhập từ khóa vào ô Tìm thẻ… và chọn một hoặc nhiều thẻ phân loại cần lọc (hoặc chọn Tất cả thẻ để hiển thị lại toàn bộ). Các thẻ đang chọn sẽ xuất hiện thành nhãn riêng phía dưới để người dùng tiện theo dõi và nhấp gỡ bỏ khi cần. |
 (Tìm kiếm) | Chọn nút tìm kiếm, sau đó nhập tên tích hợp vào trường Tìm kiếm công cụ…. |
 (Tải lại dữ liệu) | Tải lại danh sách tích hợp đang hiển thị. |
 (Graph) | Rê chuột vào thẻ tích hợp và chọn biểu tượng Graph ở góc dưới để mở cửa sổ Graph RAG Explorer, xem cấu trúc trực quan dạng đồ thị mạng lưới của các tool trong tích hợp. |
Mở chi tiết tích hợp
| Bước | Cách thực hiện |
|---|---|
| 1 | Chọn bộ công cụ tích hợp cần quản lý. |
| 2 | Tại trang Chi tiết ứng dụng, kiểm tra tên, phạm vi, tổng số tool, ngày tạo và ngày cập nhật. |
| 3 | Chọn tab cần xem: mở tab Danh sách tools để xem các tool thuộc tích hợp, hoặc tab Lịch sử sử dụng tool để theo dõi lượt gọi công cụ. |
- Danh sách tools: Hiển thị các thông tin như Tên, Mô tả, URL, Phương thức, Loại xác thực, Ngày tạo, Ngày cập nhật, Trạng thái và Thao tác. Khi cột URL hiển thị, chọn
trong hàng tương ứng để sao chép URL của tool. - Lịch sử sử dụng tool: Hiển thị Agent, Tên tool, Loại, Số lần, Thời gian và Người dùng. Trạng thái Thành công hoặc Lỗi cho biết kết quả của từng lượt chạy.
Sử dụng thanh công cụ trong chi tiết ứng dụng
| Tính năng | Cách thực hiện | Kết quả hoặc lưu ý |
|---|---|---|
 Tạo tích hợp mới | Chọn nút Tạo tích hợp mới. Trong tab Tạo mới, chọn một trong ba cách: Upload File để tải tệp OpenAPI JSON lên; Paste JSON Code để dán trực tiếp đặc tả OpenAPI; hoặc Tạo bằng form để nhập Tên tool, HTTP Method, Endpoint path, Mô tả, Input schema, Output schema, Input example và Output example. Nếu muốn lấy cấu hình từ project, chuyển sang tab Tạo từ project. | Kiểm tra dữ liệu đã nhập hoặc tệp đã tải lên, sau đó chọn  (Xác nhận) để tạo. |
| Tìm kiếm | Chọn nút tìm kiếm và nhập giá trị vào trường vừa mở. | Lọc danh sách tool theo nội dung tìm kiếm. |
 Export OpenAPI JSON | Chọn nút tải xuống. | Xuất đặc tả OpenAPI JSON của bộ công cụ tích hợp hiện tại. |
 Biến môi trường | Chọn nút Biến môi trường trên thanh công cụ. | Mở cửa sổ cấu hình biến môi trường ({{KEY}}) để sử dụng động trong Base URLs hoặc các tham số của tích hợp. |
 Cài đặt project | Mở màn hình Cài đặt project. Chọn  tại tên, Mô tả, Phân loại (Tab), Base URLs hoặc Cấu hình xác thực cần cập nhật; nhập nội dung rồi xác nhận để lưu. | Dùng để cập nhật cấu hình chung của bộ công cụ tích hợp. Nếu chọn Xóa project schema, toàn bộ tools và versions của bộ công cụ tích hợp sẽ bị xóa vĩnh viễn. |
| Tải lại dữ liệu | Chọn nút tải lại. | Tải lại danh sách tool và trạng thái mới nhất. |
Thao tác với từng tool
Tại hàng của tool cần quản lý, chọn 
trong cột Thao tác, sau đó chọn chức năng cần dùng.
| Thao tác | Cách thực hiện | Kết quả hoặc lưu ý |
|---|---|---|
 Xem contract | Chọn Xem contract, sau đó kiểm tra tên, mô tả, phương thức, phiên bản, trạng thái mặc định, Endpoint, Base URLs, Input Schema và Output Schema. | Chọn Sao chép khi cần sao chép schema đang hiển thị. |
| Sửa | Chọn Sửa. Cập nhật Tên Tool, phiên bản, Endpoint, Phương thức, Mô tả, Base URLs, Input Schema, Output Schema, Input Example hoặc Output Example, sau đó chọn Lưu. | Thay đổi cấu hình của đúng tool và phiên bản đang chỉnh sửa. Kiểm tra nhãn Version mặc định trước khi lưu. |
 Cập nhật URL gốc | Chọn Cập nhật URL gốc, sửa URL hiện có hoặc chọn để thêm URL, rồi chọn (Xác nhận). | Có thể thêm nhiều URL để hỗ trợ chuyển đổi dự phòng hoặc cân bằng tải. |
| Cập nhật xác thực | Chọn Cập nhật xác thực, kiểm tra loại xác thực hiện tại, chọn loại xác thực cần dùng rồi chọn (Xác nhận). | Cập nhật cấu hình xác thực cho đúng tool đã chọn. Chọn  (Hủy) nếu không muốn lưu thay đổi. |
Phân biệt phạm vi: