Hướng dẫn AgentFlow

Trợ lý AI (Agent)

Dùng bước Trợ lý AI để gọi mô hình ngôn ngữ lớn nhằm soạn thảo, trích xuất, phân loại hoặc ra quyết định tự động trong quy trình.

Mục đích

Bước Trợ lý AI (Agent) gửi một yêu cầu đến mô hình ngôn ngữ lớn (LLM) và nhận về kết quả có cấu trúc. Bước này có thể gọi công cụ, tra cứu tài liệu nội bộ, kết nối với máy chủ MCP bên ngoài, và tự lặp nhiều lượt cho đến khi hoàn thành nhiệm vụ.

Khi nào dùng

  • Soạn thảo nội dung đầu tiên (ví dụ: tóm tắt đề xuất mua sắm để người quản lý duyệt).
  • Trích xuất thông tin từ biểu mẫu, tài liệu tải lên hoặc dữ liệu từ bước trước.
  • Phân loại hoặc đánh giá yêu cầu trước khi chuyển đến bước Quyết định (Decision).
  • Điền trước các trường biểu mẫu cho bước Công việc người dùng (Human task) phía sau.

Cài đặt chính

TrườngMô tả
NhãnTên hiển thị của bước trên canvas.
Mô hình AINhà cung cấp và mô hình (ví dụ: Claude Sonnet, GPT-4o). Để trống sẽ dùng mô hình mặc định của hệ thống triển khai.
System promptChỉ dẫn vai trò và phong cách trả lời, gửi mỗi lượt. Dùng @ hoặc {{ }} để chèn giá trị từ bước trước.
InstructionsNội dung yêu cầu cụ thể gửi đến trợ lý. Hỗ trợ biến {{ nodes.bước.output.trường }}.
Trả về gì?Lược đồ đầu ra có cấu trúc: chọn Form (dùng biểu mẫu đã xuất bản) hoặc Custom (tự định nghĩa JSON Schema).
Công cụ (Tools)Các công cụ đã đăng ký mà trợ lý được phép gọi trong phiên chạy.
Tài liệu tham khảo (Knowledge)Tệp đính kèm dùng để tra cứu ngữ nghĩa. Khi có ít nhất một tài liệu, công cụ knowledge_search được bật tự động.
Máy chủ MCPKết nối đến máy chủ MCP bên ngoài; có thể lọc danh sách công cụ được phép.
Trường nhạy cảmĐường dẫn đến các trường cần che trước khi gửi cho mô hình (ví dụ: số tài khoản ngân hàng).
Giới hạnMax tokens, max tool calls, max iterations (số lượt tối đa, mặc định 8).

Người dùng không có quyền instance.admin sẽ không thấy dữ liệu đầu ra của bước Trợ lý AI trong phiên chạy — hệ thống tự động che phủ nội dung này để bảo vệ thông tin nhạy cảm.

Chế độ Drafts (review) đã bị ngừng hỗ trợ. Nếu bạn cần người duyệt xem lại kết quả của trợ lý, hãy thêm bước Công việc người dùng (Human task) ngay sau bước Trợ lý AI và dùng tính năng điền trước (prefill) để chuyển đầu ra sang biểu mẫu duyệt.

Ví dụ

Trong quy trình Đề xuất mua sắm, bước Trợ lý AI đặt giữa bước Bắt đầu và bước Quyết định:

System prompt:

Bạn là chuyên viên kiểm soát mua sắm. Chỉ dùng thông tin có trong đề xuất; đừng tự suy diễn giá trị.

Instructions:

Đề xuất mua sắm: {{ nodes.start.output.ten_hang }}, số lượng {{ nodes.start.output.so_luong }}, tổng giá trị {{ nodes.start.output.gia_tri }} VND.
Hãy đánh giá: (1) có hợp lệ theo ngân sách không, (2) có nhà cung cấp phù hợp không, (3) đề xuất phê duyệt hay từ chối.

Trả về gì? — Chọn Form: biểu mẫu "Kết quả kiểm tra mua sắm" (gồm các trường hop_le, ly_do, de_xuat).

Kết quả từ bước này được bước Quyết định (Decision) dùng để chọn nhánh phê duyệt hoặc từ chối, và được điền trước vào biểu mẫu duyệt của bước Công việc người dùng (Human task) để người quản lý xem xét.

Để xem cách nối đầu ra của bước này sang bước tiếp theo, xem Biến và biểu thức.

On this page