Kết thúc (End)

Bước Kết thúc đánh dấu điểm hoàn thành của quy trình và ghi lại kết quả cuối cùng vào phiên chạy.

Mục đích

Bước Kết thúc (End) đóng phiên chạy quy trình. Khi luồng điều khiển đến bước này, AgentFlow đánh dấu phiên chạy là hoàn thành và lưu các giá trị đầu ra mà bạn đã khai báo. Những giá trị đó có thể được tích hợp khác đọc lại, dùng để kích hoạt quy trình tiếp theo, hoặc hiển thị trên màn hình kết quả.

Một quy trình có thể có nhiều bước Kết thúc — chẳng hạn một nhánh "Phê duyệt" và một nhánh "Từ chối" — mỗi bước mang nhãn kết quả riêng để phân biệt.

Khi nào dùng

Khi luồng quy trình cần kết thúc và bạn muốn ghi lại kết quả (ví dụ: số đơn hàng được tạo, trạng thái phê duyệt).
Khi có nhiều nhánh có thể kết thúc theo những cách khác nhau (phê duyệt, từ chối, huỷ).
Khi quy trình cha cần đọc kết quả từ một quy trình con thông qua biến đầu ra.

Nếu quy trình của bạn chỉ có một đường kết thúc và không cần truyền dữ liệu ra ngoài, bạn vẫn phải dùng bước Kết thúc — không có cách kết thúc ngầm định.

Cài đặt chính

Trường	Bắt buộc	Mô tả
Nhãn bước	Có	Tên hiển thị trên canvas thiết kế (ví dụ: "Đã phê duyệt").
Nhãn kết quả (Outcome label)	Không	Mã ngắn gọn xác định loại kết thúc, ví dụ `completed`, `rejected_proposal`. Dùng ký tự ASCII, không dấu cách.
Đầu ra (Outputs)	Không	Danh sách cặp khóa–giá trị được ghi vào kết quả của phiên chạy. Mỗi đầu ra có một nguồn giá trị (ba kiểu, bên dưới) và, nếu muốn, một Nhãn và một cài đặt Hiển thị dạng quyết định hành động trên bản ghi cho người dùng thấy nó thế nào.

Ba kiểu nguồn của một đầu ra:

Kiểu	Ý nghĩa	Ví dụ
Literal	Giá trị cố định, gõ trực tiếp	`"Đã duyệt"`
Variable (Biến)	Đường dẫn đến dữ liệu trong phiên chạy, phân cách bằng dấu chấm	`nodes.buoc_phe_duyet.output.comment`
Template (Mẫu)	Chuỗi có nhúng biến theo cú pháp `{{ }}`	`Đơn {{ nodes.khoi_dau.output.ma_don }} đã duyệt`

Tên khóa (key) nên viết bằng chữ thường, không dấu cách, ví dụ approval_status hoặc order_id. Tên khóa này sẽ xuất hiện trong dữ liệu kết quả của phiên chạy.

Nhãn và cách hiển thị đầu ra

Một hành động trên bản ghi có thể được đặt để chờ quy trình chạy xong và hiện kết quả. Khi phiên chạy kết thúc, hộp thoại liệt kê các đầu ra mà bước Kết thúc khai báo, và Nhãn cùng Hiển thị dạng của từng đầu ra quyết định nó trông thế nào.

Cài đặt	Ý nghĩa
Nhãn	Tên hiển thị cho đầu ra. Để trống thì hiện khóa.
Hiển thị dạng: Văn bản	Giá trị dạng văn bản thuần, kèm nút Sao chép. Đầu ra chưa đặt gì cũng hiện theo cách này.
Hiển thị dạng: Văn bản định dạng	Giá trị hiện dưới dạng văn bản có định dạng (danh sách, chữ đậm, trích dẫn), kèm nút Sao chép chép văn bản đúng như đã viết.
Hiển thị dạng: Bản ghi	Một nút Mở dẫn tới bản ghi. Chọn Thực thể mà giá trị là bản ghi của nó. Giá trị phải là mã của một bản ghi thuộc thực thể đó.
Hiển thị dạng: Ẩn	Không hiện cho người đã bấm hành động. Quy trình gọi quy trình này vẫn đọc được.

Các đầu ra xếp theo thứ tự chữ cái của khóa. Đầu ra rỗng sẽ không được hiện.

Nếu hai bước Kết thúc khai báo cùng một khóa, bước mà phiên chạy đã kết thúc qua được xét trước, rồi đến các bước còn lại theo thứ tự các bước được định nghĩa. Nhãn và cách hiển thị được quyết định riêng, nên một bước Kết thúc chỉ đặt nhãn không che mất cách hiển thị do bước khác đặt. Trình thiết kế cảnh báo khi các bước Kết thúc không thống nhất về một đầu ra.

Ví dụ

Trong quy trình Đề xuất mua sắm, sau khi người phê duyệt nhấn "Đồng ý" ở bước Công việc người dùng (Human task), luồng chuyển đến bước Kết thúc với cấu hình:

Nhãn bước: Đã phê duyệt
Nhãn kết quả: approved
Đầu ra:

Khóa	Kiểu	Giá trị	Nhãn	Hiển thị dạng
`approval_status`	Literal	`approved`		Văn bản
`approved_by`	Variable	`nodes.phe_duyet.output.actor_name`		Ẩn
`summary`	Template	`Đề xuất {{ nodes.khoi_dau.output.ten_hang }} đã được phê duyệt`	Tóm tắt	Văn bản định dạng

Nhánh "Từ chối" có một bước Kết thúc riêng với nhãn kết quả rejected và bộ khóa tương ứng, giúp hệ thống phân biệt hai kết quả khi truy vấn lịch sử phiên chạy.

Xem thêm cách kết nối các bước tại Tổng quan quy trình.