Workforce

Đây là gì

Workforce là một nhóm Agent, Tool và logic trên canvas: ai làm phần nào, ai chuyển việc cho ai, và người duyệt ở chỗ nào. Hãy dùng Workforce khi một Agent không đủ: nhiều Agent chuyên trách chuyển việc cho nhau, một chuỗi Tool luôn phải chạy sau một bước, hoặc cần người duyệt giữa các bước. Workforce nằm ở menu trái, mục Build → Workforces.

Hãy bắt đầu bằng một Agent có Tool và Skill; hộp thoại tạo Workforce sẽ hỏi "Một agent có làm được không?" vì một Agent thường nhanh và rẻ hơn.

Khái niệm chính

Node (từ thanh Thêm node)

Node	Làm gì
Start	Điểm vào, mỗi Workforce có một ("Khi có việc mới"). Chứa các giá trị Input mà một lượt chạy nhận vào và Giới hạn chuyển giao.
Agent	Một Agent chat đã publish của Workspace. Agent được dùng chung: sửa Agent ở đây là sửa ở mọi nơi dùng nó.
Tool	Một Tool đã publish của Workspace, hoặc một action của App, luôn chạy tại vị trí đó.
Condition	Một cửa chặn: điều kiện đúng thì các bước sau chạy, sai thì nhánh đó dừng. Theo LLM: một câu mà LLM trả lời dựa trên dữ liệu của task. Theo quy tắc: các quy tắc trên output trước đó (bằng, khác, lớn hơn, nhỏ hơn, có chứa), khớp Tất cả hoặc Bất kỳ.
Gộp (Join)	Chờ mọi nhánh song song đi vào, rồi chạy tiếp với output của tất cả các nhánh.
Note	Ghi chú cho người đọc; không bao giờ chạy.

Kết nối — chuyện gì xảy ra sau một bước. Chọn loại khi nối hai node:

Loại	Ý nghĩa	Giữa
Bước tiếp	Node đích luôn chạy sau khi node nguồn xong. Không có gì quay lại node nguồn.	Start, Agent, Tool, Condition, Gộp → Agent, Tool, Condition, Gộp
Giao việc	Agent nguồn gọi Agent đích khi cần và nhận lại kết quả, giống như một Tool. Agent nguồn vẫn tiếp tục trả lời người gửi.	Agent → Agent
Chuyển giao	Agent nguồn chuyển hội thoại cho Agent đích, từ đó Agent đích trả lời người gửi.	Agent → Agent

• Giao việc và Chuyển giao cần điền Khi nào gọi / Khi nào chuyển: lời lẽ bình thường để Agent nguồn đọc và quyết định. Hãy viết như khi dặn việc một đồng nghiệp.
• Agent được giao việc thấy Chỉ tham số (mặc định) hoặc Kèm hội thoại. Chuyển giao truyền Toàn bộ lịch sử hội thoại (mặc định) hoặc Tóm tắt.
• Từ hai kết nối Bước tiếp trở lên đi ra từ một node sẽ chạy Song song. Bước nào có nhiều nhánh song song cùng đi vào thì cần một node Gộp đứng trước.

Hội thoại — các mẫu Điều phối, Chuyển giao và Phân loại bắt đầu bằng một hội thoại (node Start có nhãn Hội thoại): Workforce trò chuyện với một người gửi. Khi đó phải có ít nhất một Agent trả lời trực tiếp (có dấu Trả lời trực tiếp): một Agent được nối bằng Bước tiếp từ Start hoặc từ Agent khác, hoặc là đích của một Chuyển giao. Agent chỉ được nối bằng Giao việc, hoặc bằng Bước tiếp từ Tool, Condition hay Gộp, thì làm việc ở chế độ nền. Quy trình và Canvas trống không có người gửi: lượt chạy bắt đầu từ Start với các input của nó.

Map tham số — kết nối đi vào một Tool hoặc một Agent sẽ điền các input của node đích. Gõ {{ để chèn một giá trị: tin nhắn mới nhất, câu trả lời của một Agent trước đó hoặc output của Tool, một input của Start ({{input.<name>}}), các trường của Contact, {{today}} hoặc {{now}}. Tham số Giao việc để trống sẽ do Agent gọi tự điền.

Duyệt — chỉ có trên kết nối Bước tiếp đi vào một Tool:

• Tự chạy — không cần duyệt.
• Cần duyệt — soạn sẵn lần gọi, rồi chờ Người duyệt (một thành viên Workspace có quyền vận hành Agent; khi để Chưa chọn thì là người nhận mặc định của Workspace, hoặc nếu chưa đặt thì là người đã tạo Automation). Yêu cầu duyệt được trả lời trong Agent Inbox.

Kết nối mới vào một Tool ghi bắt đầu ở Cần duyệt, vào một Tool đọc thì ở Tự chạy. Bỏ duyệt khỏi một Tool ghi sẽ phải xác nhận và được ghi vào nhật ký kiểm tra (audit log) của Workspace.

Giới hạn tự chạy — trên một kết nối, số lần kết nối đó được chạy trong một task. Với kết nối vào Tool, vượt giới hạn thì phải xin duyệt; với Giao việc, vượt giới hạn thì Agent nguồn không gọi được Agent đích nữa. Kết nối quay ngược về một node trước đó bắt buộc có giới hạn này (riêng Chuyển giao quay ngược thì bị chặn bởi Giới hạn chuyển giao).

Cách hoạt động

Trạng thái

Trạng thái	Ý nghĩa
Bản nháp	Chưa publish lần nào.
Đã xuất bản	Có phiên bản production.
Đã lưu trữ	Chỉ xem.

Bản nháp, test, publish

1. Các thay đổi trên canvas chỉ nằm trên máy cho tới khi bạn bấm Lưu (⌘S); đầu trang hiện "(Chưa lưu)". Lưu ghi chúng vào bản nháp.
2. Canvas liệt kê các lỗi cần sửa. Publish bị chặn cho tới khi hết lỗi: mọi ô Agent và Tool đều là Agent hoặc Tool thật đã publish; mọi node đều đi tới được từ Start; các App mà Tool dùng đã được kết nối; vòng lặp có Giới hạn tự chạy; các nhánh song song gặp nhau ở một node Gộp; quy tắc dùng các trường có thật; người duyệt là thành viên; hội thoại có một Agent trả lời trực tiếp. "Còn input bắt buộc chưa map" chỉ là cảnh báo.
3. Test chạy bản nháp đã lưu (xem bên dưới).
4. Publish biến bản nháp thành phiên bản production. Workforce luôn chạy phiên bản đã publish của từng Agent và Tool trong đó.

Trước lần publish đầu tiên, thẻ Bắt đầu liệt kê các bước: chọn Agent hoặc Tool cho mọi ô, viết "khi nào gọi" trên các kết nối Agent, nối mọi node từ Start, sửa hết lỗi, chạy một lần test, publish.

Lần chạy thử

Mở Test ở đầu trang. Điền Input của lượt này, hoặc viết một tin nhắn như người gửi sẽ viết, rồi bấm Chạy. Node và kết nối sáng lên trên canvas khi lượt chạy đi qua.

• Chạy thử an toàn (bật sẵn): Tool ghi được giả lập ("An toàn, ghi giả lập"); thao tác đọc là thật.
• Khi tắt, thao tác ghi xảy ra thật ("Ghi thật").
• Yêu cầu duyệt trong lần chạy thử do chính bạn trả lời trong khung test.
• Trạng thái lượt chạy: Đang chạy, Chờ bạn duyệt, Xong, Lỗi, Đã chuyển người. Mỗi bước hiện Đang chạy, Đang chờ, Xong, Lỗi hoặc Đã từ chối, và bước lỗi có ghi lý do (ví dụ "Tool chạy lỗi." hoặc "Thiếu tham số bắt buộc cho bước này.").
• Lần chạy thử cũng cần các Agent và Tool đó đã publish, nhưng không cần Automation.

Lần chạy thật (production)

Workforce đã publish chạy khi có Automation sự kiện app trỏ tới nó (thiết lập ở trang Automations), ví dụ khi có đơn Haravan mới (Event của từng App được liệt kê ở trang của App đó trong Ứng dụng). Kênh tin nhắn do Agent trả lời, không phải Workforce. Yêu cầu duyệt của mỗi lượt chạy chờ trong Agent Inbox; danh sách Workforces cho biết có bao nhiêu mục Chờ duyệt và có link Mở Approvals.

Một lượt chạy dừng khi chạm giới hạn số bước hoặc giới hạn thời gian. Vượt Giới hạn chuyển giao (mặc định 5 lần chuyển giao trong một lượt) thì việc được chuyển cho người.

Thao tác thường gặp

Tạo Workforce

1. Vào Workforces và bấm Workforce mới.
2. Nhập Tên và, nếu muốn, Instructions (mục tiêu và các quy tắc chung; được lưu làm mô tả của Workforce).
3. Chọn một mẫu: Canvas trống, Điều phối (một Agent giao việc cho các Agent chuyên trách), Chuyển giao (mỗi giai đoạn một Agent), Phân loại (một Condition LLM gửi yêu cầu tới đúng Agent, rồi Gộp), hoặc Quy trình (các bước luôn chạy theo thứ tự đã vẽ).
4. Bấm Tạo workforce. Các mẫu đặt sẵn node giữ chỗ: bấm vào từng node để chọn Agent hoặc Tool thật.

Tab Nhờ FLAE Assistant trong hộp thoại này (cũng mở bằng Tạo bằng Assistant) chỉ hiện một đề xuất mẫu. Muốn Assistant xây Workforce cho bạn, hãy hỏi trong Chat (xem Chat với Assistant); Assistant lưu một bản nháp để bạn xem lại, chọn người duyệt và publish.

Dựng sơ đồ

1. Kéo hoặc bấm Agent, Tool, Condition, Gộp hoặc Note từ thanh Thêm node. Tạo agent mới / Tạo tool mới mở trình xây tương ứng.
2. Nối hai node, chọn Bước tiếp, Giao việc hoặc Chuyển giao, rồi bấm Nối.
3. Bấm vào một kết nối để đặt tham số, chế độ duyệt, người duyệt và Giới hạn tự chạy.
4. Bấm vào một node Agent để xem thiết lập của nó; bạn có thể sửa hướng dẫn của Agent ngay trên canvas. Nếu Agent không có bản nháp, Lưu thay đổi sẽ lưu và publish ngay ("Đã lưu và publish agent."); nếu có bản nháp, thay đổi đi vào bản nháp đó để bạn publish trong trình xây Agent.

Giới hạn và quy tắc

• Ai làm được gì: Admin và Builder của Workspace (và Owner, Admin của Organization) tạo, sửa, test và publish Workforce. Thành viên khác xem được. Không thể thay đổi gì trong Workspace đã lưu trữ.
• Chỉ đặt được Agent chat đã publish; Agent voice thì không. Agent và Tool còn ở bản nháp hiện "Chưa publish" và chặn việc publish lẫn chạy thử.
• Start chứa tối đa 20 input. Giới hạn chuyển giao từ 1 đến 50 lần mỗi lượt.
• Workforce có hội thoại không được đặt node Gộp sau một kết nối Cần duyệt.
• Assistant có thể tạo và sửa bản nháp Workforce nhưng không publish được.
• Trang Workforce chưa có nút lưu trữ, xoá hay lịch sử phiên bản.

Liên quan

• Agent — các Agent bạn đặt lên canvas.
• Tool — các bước cố định và chế độ duyệt của chúng.
• Knowledge — Knowledge Base Internal được đọc ở các bước Workforce không có hội thoại.
• Automation — chạy thật từ Event của App.
• Agent Inbox — nơi trả lời yêu cầu duyệt của các lượt chạy Workforce.
• Ứng dụng — các action của App mà node Tool có thể chạy.