Tra cứu các nút trong Studio
Mọi loại nút có trong bảng nút của FAOS Studio, sắp xếp theo nhóm. Mỗi mục liệt kê nút đó làm gì, các trường cấu hình chính của nó, và trạng thái hỗ trợ runtime — cột cuối cùng này được lấy từ chính bảng minh bạch (honesty manifest) mà Studio dùng để cảnh báo bạn ngay trên canvas, nên trang này không bao giờ khẳng định nhiều hơn những gì sản phẩm thực sự làm.
Giữ trang này đồng bộ
Tài liệu tra cứu này được lấy từ chính các mục trong bảng nút (NodePalette.tsx) và bảng minh
bạch hỗ trợ runtime phía server. Nếu bạn thêm hoặc thay đổi một loại nút trong bảng nút, hãy cập
nhật trang này trong cùng một thay đổi.
Các trạng thái hỗ trợ runtime
| Trạng thái | Ý nghĩa |
|---|---|
| ✅ Đầy đủ (Full) | Runtime thực thi nút này với đúng ngữ nghĩa thật, dự kiến, ngay hôm nay. |
| 🟡 Chỉ để thiết kế (Authoring-only) | Bạn có thể vẽ và cấu hình nút này, và nó xuất ra đầy đủ ngữ nghĩa sang LangGraph/ADK — nhưng bản thân runtime của FAOS chưa thực thi hành vi riêng biệt của nó. Studio báo cho bạn biết điều này ngay trên canvas; nó không bao giờ giả vờ đạt (pass). |
(Hiện không có trạng thái "suy giảm" (degraded) — mọi loại nút từng ở trạng thái suy giảm đều đã được nâng cấp lên hỗ trợ đầy đủ.)
Điều khiển luồng (Flow Control)
| Nút | Mô tả | Cấu hình chính | Trạng thái |
|---|---|---|---|
| Start | Điểm bắt đầu | triggerType (thủ công / theo lịch / theo sự kiện / webhook) | — (ranh giới luồng, không phải một bước) |
| End | Nút kết thúc | outputVariable | — (ranh giới luồng, không phải một bước) |
| Loop | Lặp lại | maxIterations, condition, loopVariable | 🟡 Chỉ để thiết kế — chưa có cấu trúc vòng lặp trong executor |
| Parallel Branch | Các nhánh chạy đồng thời | branches[], joinStrategy (tất cả / bất kỳ / đầu tiên) | ✅ Đầy đủ — được biên dịch thành depends_on fan-out/fan-in thật; executor đã chạy đồng thời các bước cùng cấp |
| Condition (Rule) | Rẽ nhánh theo quy tắc | ruleExpression, trueLabel, falseLabel | ✅ Đầy đủ — biên dịch thành bước dmn |
| Condition (Agent) | Rẽ nhánh do tác nhân đánh giá | agentId, evaluationPrompt, trueLabel, falseLabel | 🟡 Chỉ để thiết kế — chưa có cấu trúc rẽ nhánh theo LLM (chỉ có dmn theo quy tắc) |
AI
| Nút | Mô tả | Cấu hình chính | Trạng thái |
|---|---|---|---|
| Agent | Tác vụ tác nhân AI | agentId, model, skills[], timeout, systemPrompt | ✅ Đầy đủ |
| LLM | Gọi LLM trực tiếp (không qua roster tác nhân) | promptTemplate, model, temperature, maxTokens, responseFormat | ✅ Đầy đủ — một bước mỏng gọi trực tiếp resolve_model(); thiếu cấu hình model sẽ làm bước thất bại một cách trung thực thay vì âm thầm dùng phương án dự phòng |
Mẫu chuyển giao (Handoff Patterns)
| Nút | Mô tả | Cấu hình chính | Trạng thái |
|---|---|---|---|
| Manager Agent | Ủy quyền cho các tác nhân con | agentId, model, skills[], sub_agent_pool[], delegation_criteria | ✅ Đầy đủ — biên dịch thành một lệnh gọi tác nhân với prompt có cấu trúc (ngữ nghĩa của nó chính là một bước tác nhân được quản trị) |
| A2A Delegate | Ủy quyền cho một tác nhân bên ngoài qua giao thức A2A | endpoint_url, agent_card_url, protocol_version, timeout_seconds | ✅ Đầy đủ — cùng cách biên dịch prompt có cấu trúc như Manager Agent |
Tuân thủ (Compliance)
| Nút | Mô tả | Cấu hình chính | Trạng thái |
|---|---|---|---|
| Compliance Gate | Cổng kiểm tra đa tiêu chí | checks[] (loại, hành động, ngưỡng), failStrategy | ✅ Đầy đủ — chạy DefaultComplianceEvaluator thật; các loại kiểm tra chưa có hậu thuẫn được ghi nhận not_evaluated, không bao giờ giả vờ đạt |
| Audit Log | Ghi lại dấu vết kiểm toán | retentionYears, logInputs, logOutputs, hashSensitive | ✅ Đầy đủ — ghi một AuditLogEntry thật |
| Policy Check | Kiểm tra khung pháp lý | frameworks[] (SOX / GDPR / CCPA / MiFID II / Dodd-Frank / ECOA / FINRA), action | ✅ Đầy đủ |
| PII Scanner | Phát hiện và che dữ liệu cá nhân (PII) | entityTypes[] (SSN, ngày sinh, số tài khoản, tên, địa chỉ, số điện thoại, email), action, redactionPattern | ✅ Đầy đủ — phát hiện PII thật qua bộ quét DLP chuẩn |
| Bias Check | Phát hiện thiên lệch | domain (cho vay / bảo hiểm / tuyển dụng / tổng quát), regulations[], sensitivity | ✅ Đầy đủ — các loại kiểm tra pháp lý/thiên lệch trung thực ghi nhận not_evaluated khi chưa gắn mô hình chấm điểm, thay vì giả vờ đạt |
Tương tác (Interaction)
| Nút | Mô tả | Cấu hình chính | Trạng thái |
|---|---|---|---|
| Human Input | Yêu cầu người dùng nhập liệu giữa luồng | inputPrompt, inputType (văn bản / lựa chọn / tệp), timeout | 🟡 Chỉ để thiết kế — executor chưa có khả năng thu nhận đầu vào giữa luồng (khác với Approval Gate, vốn tạm dừng để chờ quyết định có/không và đã được triển khai) |
| Approval Gate | Yêu cầu con người phê duyệt trước khi tiếp tục | requiredApprovers[], approvalType (bất kỳ / tất cả), timeout, escalationEmail | ✅ Đầy đủ |
| Direct Reply | Gửi phản hồi cho người dùng | responseTemplate, channel (chat / email / webhook) | ✅ Đầy đủ — biên dịch thành bước delivery |
Thực thi (Execution)
| Nút | Mô tả | Cấu hình chính | Trạng thái |
|---|---|---|---|
| Tool Call | Thực thi một công cụ đã cấu hình | toolName, parameters, retryOnFailure, maxRetries | ✅ Đầy đủ — gọi qua tầng MCP với chính sách tenant được thực thi; một công cụ chưa được gắn sẽ thất bại một cách trung thực thay vì âm thầm chạy như một bước tác nhân chung chung |
Quản lý Case (Case Management)
| Nút | Mô tả | Cấu hình chính | Trạng thái |
|---|---|---|---|
| Create Case | Mở một case mới | caseType, initialPriority (P1-P4), sla (mục tiêu/hạn chót) | ✅ Đầy đủ — gửi tới engine case thật |
| Update Case | Cập nhật các trường của case | fields[] (cặp trường/giá trị) | ✅ Đầy đủ |
| Route Case | Định tuyến case đến một tác nhân | strategy (theo kỹ năng / xoay vòng / thủ công), agentPool[], requiredSkills[] | ✅ Đầy đủ |
| Escalate | Leo thang case | reason, targetTier, urgency | ✅ Đầy đủ |
| Resolve | Giải quyết case | resolutionCode, summaryTemplate | ✅ Đầy đủ |
| SLA Timer | Theo dõi case theo SLA | goalHours, deadlineHours, passedDeadlineHours, autoEscalate | 🟡 Chỉ để thiết kế — việc tính giờ SLA hiện nằm trong chính các giai đoạn của case-lifecycle workflow, chưa phải một bước playbook độc lập |
| Satisfaction Survey | Gửi khảo sát khách hàng | surveyTemplate, channel (email / SMS / trong ứng dụng) | 🟡 Chỉ để thiết kế — hạ tầng gửi khảo sát đã có, nhưng việc thu thập phản hồi vào playbook thì chưa |
Xem thêm
- Bắt đầu nhanh với Studio — Journey đầu tiên của bạn trong 10 phút, đi qua năm trong số các nhóm nút này trên một ví dụ thật.