Các loại node¶

Các tab cấu hình¶

Chọn một node, panel Cấu hình hiện loại node, id và Nhãn, rồi đến ba tab giống nhau cho mọi node, luôn theo thứ tự này:

Tab mà node không dùng vẫn ở nguyên chỗ, chỉ bị làm mờ. Panel giữ tab bạn đã chọn khi bạn chọn node khác, nên bạn có thể mở Dữ liệu rồi bấm lần lượt các node để xem mỗi node ghi vào đâu. Chấm đỏ trên một tab nghĩa là trong đó có chỗ cần xem lại, ví dụ chưa chọn trường output.

Cấu hình thực thi¶

Node LLM, Agent, Decision, Retriever, Tool, MCP tool và Human có các cấu hình sau trong tab Thực thi:

Để trống là tắt.

Start và End¶

Graph nào cũng có đúng một Start. Node End kết thúc một nhánh. Không xoá và không sao chép được hai node này. Start nhận input của run làm state ban đầu.

LLM¶

Trong lúc chạy, từng đoạn token tới dưới dạng sự kiện node_token và hiện ở dòng Logs lẫn tab Output. Các đoạn này không lưu vào lịch sử run; văn bản cuối cùng thì có. Lỗi từ nhà cung cấp (401, timeout, …) thành sự kiện error của node, không làm sập server.

Model dự phòng¶

Trong Cài đặt node LLM, bật Dùng model dự phòng rồi chọn credential và model. Cặp này phải khác model chính. Credential dự phòng được kiểm tra theo quyền của chủ workflow trước khi gọi model; chỉ chấp nhận credential model chat.

Model chính được thử trước. Nhà cung cấp không kết nối được, thiếu model hoặc trả kết quả sai có thể chuyển sang model dự phòng một lần. Lỗi xác thực/cấu hình hoặc quyền truy cập credential dừng lần thử. Huỷ run hoặc hết thời gian node không khởi động model dự phòng. Cài đặt thử lại của node lặp lại toàn bộ chính sách, nên cần tính cả số lần thử khi ước lượng mức sử dụng.

Khi bật dự phòng, giữ nội dung đến khi một model thành công rồi gửi một đoạn hoàn chỉnh. Node LLM thông thường vẫn stream trực tiếp. model_attempts trong trace ghi nhà cung cấp/model, trạng thái và mã lỗi; nhà cung cấp vẫn có thể tính phí lần gọi lỗi dù không trả usage. Run mock vẫn offline và không đọc credential. Xuất code hiện từ chối workflow có chính sách dự phòng (MODEL_POLICY_EXPORT_UNAVAILABLE) để tránh bỏ sót chính sách. Mẫu xuất ra xoá tham chiếu credential dự phòng; chọn credential của bạn sau khi import.

Agent¶

Một prompt nhiệm vụ, danh sách công cụ (MCP, HTTP, hàm có sẵn, tìm trong kho tri thức) và số vòng tối đa. Model gọi công cụ tới khi trả lời được; một công cụ có thể cần người duyệt trước mỗi lần gọi. Xem Node Agent.

Decision (Jev)¶

Hỏi Jev của TypeSafe về text và nhận câu trả lời có kiểu (một template; nếu đúng bằng một {{state.x}} thì gửi giá trị kèm kiểu). Mỗi câu hỏi có id, instructions và một kiểu:

field của câu hỏi nhận câu trả lời, nên Condition có thể rẽ nhánh theo một lựa chọn. output_field (object) nhận mọi câu trả lời kèm xác suất và độ tin cậy. Node dùng credential TypeSafe, rồi tới TYPESAFE_API_KEY, rồi tới câu trả lời mẫu offline (choice chọn lựa chọn đầu tiên được nhắc trong văn bản). Giá là $0.042 cho mỗi triệu token input; token output miễn phí. Run được khôi phục dùng lại câu trả lời cũ.

Retriever¶

Tool¶

Node Tool có ba chế độ.

MCP tool¶

server_id, tool, arguments và output_field. Chuỗi trong arguments là template; argument nào đúng bằng một {{state.x}} thì giữ nguyên kiểu, nên {{state.items | length}} truyền đi một số. Xem Máy chủ MCP.

Send email¶

Gửi một email qua credential SMTP (Credentials → SMTP: host, port, STARTTLS / SSL / không, tên đăng nhập, người gửi; mật khẩu được mã hoá).

• to, cc, bcc và reply_to là template, các địa chỉ cách nhau bằng dấu phẩy; một {{state.x}} cũng có thể chứa danh sách. Tối đa 50 người nhận.
• subject và body là template. Với định dạng HTML, giá trị lấy từ state được escape và có thêm phần văn bản thường.
• output_field (tuỳ chọn, object) nhận {sent, dry_run, to, cc, bcc, subject, message_id, refused}.
• Không có credential thì node chạy thử (dry run): không gửi gì, kết quả chứa nội dung thư kèm preview dạng văn bản.
• Run được khôi phục không bao giờ gửi lại, và Message-ID lấy từ idempotency key của node.
• Host SMTP private hoặc loopback cần STUDIO_SMTP_ALLOW_PRIVATE=1 (ví dụ Mailpit ở localhost:1025).
• Các node của một chủ workflow gửi tới tối đa STUDIO_EMAIL_NODE_HOURLY_LIMIT người nhận mỗi giờ (mặc định 100).

Đặt node Human phía trước để duyệt bản nháp email.

Condition¶

Đặt Trường state để rẽ nhánh là một trường của state. Nhãn các edge đi ra được so với giá trị của trường:

1. khớp chính xác;
2. khớp không phân biệt hoa thường, sau khi bỏ khoảng trắng và dấu câu;
3. khớp nguyên một từ trong giá trị, nhãn dài nhất thắng.

Thứ tự nhãn không quan trọng: Disapprove. chọn disapprove, không chọn approve. Hai nhãn nguyên từ dài bằng nhau là mơ hồ. Edge default (tuỳ chọn) dùng khi không khớp hoặc khớp mơ hồ.

Condition là node duy nhất được có edge quay về chính nó, và cùng với For each là cách duy nhất để đóng một vòng lặp.

Nhánh song song¶

Nhiều edge đi ra từ một node không phải Condition sẽ chạy trong cùng một superstep. Trường được nhiều nhánh ghi cần reducer (append, merge hoặc add); thiếu reducer thì không qua được kiểm tra. Dùng Join để chờ mọi nhánh.

For each¶

Node cần hai edge đi ra có nhãn each và done; trình soạn thảo tự đặt nhãn each cho edge đầu tiên bạn vẽ và done cho edge thứ hai. Nhánh each là thân vòng lặp và phải quay về node For each. Mỗi lần ghé, node ghi phần tử kế tiếp rồi đi theo each; sau phần tử cuối thì đi theo done.

Các phần tử chạy lần lượt, nên dừng ở Human, khôi phục và idempotency key đều hoạt động theo từng phần tử. Gom kết quả vào một trường danh sách có reducer append. Vòng lặp lồng nhau được; danh sách bên trong bắt đầu lại cho mỗi phần tử bên ngoài. Các bước của vòng lặp không tính vào STUDIO_RECURSION_LIMIT, giới hạn đó chỉ áp cho các vòng lặp khác.

Human¶

prompt (template) và output_field. Run chờ ở trạng thái waiting tới khi có người trả lời Duyệt (approved), Từ chối (rejected) hoặc nhập văn bản tự do. Xem Duyệt bởi người. Một mô hình có thể xem yêu cầu trước, để gợi ý hoặc tự trả lời: xem AI duyệt yêu cầu phê duyệt.

Join¶

Chờ mọi nhánh đi vào, rồi chạy một lần. Cần ít nhất hai edge đi vào, và không nhận edge đi thẳng từ Condition.

Subgraph¶

workflow_id của một workflow đã lưu của bạn. State dùng chung theo tên trường. Node bên trong hiện trong trace dạng Subgraph › node (id sub/node). Vòng tham chiếu, workflow con không tồn tại hoặc là workflow import, và lồng sâu quá năm cấp đều lỗi khi lưu và khi chạy (WORKFLOW_INVALID).

Code (imported)¶

Node chỉ đọc sinh ra khi import repo. Panel phải hiện mã nguồn gốc. Sửa canvas không làm thay đổi file đã import.