Tool

Đây là gì

Tool là một việc cố định, dùng lại được, mà Agent hoặc Workforce gọi tới: tra cứu đơn hàng, gửi tin Zalo, thêm một dòng dữ liệu, tóm tắt văn bản bằng LLM. Lần nào Tool cũng chạy đúng các bước như nhau và không tự phán đoán; việc phán đoán thuộc về Agent gọi nó. Tool nằm ở menu trái, mục Build → Tools.

Khái niệm chính

• Các bước — Tool chạy theo một đường thẳng: Tool input → các bước → Tool output. Bạn dựng Tool trên canvas trong trình xây Tool.
• Tool input — các giá trị bên gọi truyền vào (mã đơn hàng, số điện thoại). Mỗi input có tên, kiểu (Text, Long text, Number, Boolean, Array, JSON Object), mô tả, có bắt buộc hay không, và giá trị mặc định. Agent đọc phần mô tả để điền khi gọi.
• Tool output — các trường Tool trả về, được map từ các bước trước đó.
• "Agent nên dùng tool này khi nào?" — phần mô tả Agent đọc để quyết định Tool này có hợp với yêu cầu không. Bắt buộc phải có trước khi lưu hoặc publish.
• Các loại bước, chọn từ Add step:
  • Apps — một action của App đã kết nối (Gmail, Facebook, Haravan, Zalo). Xem Ứng dụng để biết input và output của mọi action. Bước này cho biết App đã Đã kết nối chưa; bấm Mở Integrations để kết nối.
  • AI model (LLM) — xử lý văn bản bằng một model: một Prompt, Kiểu đầu ra là Văn bản hoặc Có cấu trúc (JSON với các Trường đầu ra bạn đặt tên), và có thể chỉnh Temperature và Mức thinking.
  • HTTP request — một request GET, POST, PUT, PATCH hoặc DELETE. Bước này lưu và publish được nhưng chưa chạy được.
  • Branch — các điều kiện được kiểm tra từ trên xuống; điều kiện đúng đầu tiên chạy các bước của nó, nếu không thì chạy Trường hợp khác.
  • Loop — chạy các bước của nó một lần cho mỗi phần tử trong một danh sách, Tuần tự hoặc Song song, với Số item tối đa và cách xử lý Khi một item lỗi (dừng cả lượt chạy, hoặc bỏ qua item đó).
  • Tools của bạn — một Tool khác đã publish, chạy như một bước Sub-tool.
• Giá trị — trong tham số của một bước, bạn gõ giá trị cố định hoặc chèn biến: {{input.<name>}} cho một Tool input, {{steps.<key>.output}} cho kết quả của một bước trước. Chèn biến liệt kê những gì dùng được tại vị trí đó.
• Đọc và ghi — bước làm thay đổi dữ liệu trong App là thao tác ghi; còn lại là đọc. Trình xây cho thấy mức rủi ro của Tool (thấp, trung bình, cao), Tool có ghi dữ liệu không, và khi nào FLAE khuyên nên duyệt ("Nên duyệt vì …").

Cách hoạt động

Trạng thái

Trạng thái	Ý nghĩa
Draft	Chưa publish lần nào. Agent chưa dùng được.
Published	Có phiên bản production để Agent và Workforce gọi.
Archived	Chỉ xem; Agent và Workforce không dùng được. App chưa có nút cho trạng thái này: chỉ Admin và Builder của Workspace (và Owner, Admin của Organization) đặt được, qua API của FLAE, Assistant không làm được.

Bản nháp, test, publish

1. Mọi thay đổi trên canvas được tự lưu vào bản nháp ("Đang lưu…", "Đã lưu"); Lưu thì lưu ngay.
2. Test chạy bản nháp hiện tại với input bạn đưa vào.
3. Publish biến bản nháp thành phiên bản production. Agent và Workforce chỉ gọi phiên bản production; bản nháp của một Tool đã publish không thay đổi gì cho tới khi bạn publish nó.
4. Lịch sử mở lịch sử phiên bản: Khôi phục đưa một phiên bản đã publish trước đó trở lại làm production (bản nháp của bạn giữ nguyên), còn Bỏ bản nháp xoá các thay đổi chưa publish.

Bạn chưa publish được khi các bước còn lỗi, ví dụ một tham số App bắt buộc chưa có giá trị, prompt LLM trống, Branch chưa có điều kiện, các Sub-tool gọi vòng lẫn nhau, hoặc các khối lồng nhau sâu quá 3 cấp. Ở tab Test, Publish chỉ mở khi bản nháp hiện tại đã qua test; Publish ở tab Build thì không cần test.

Duyệt khi Tool ghi dữ liệu

Tool không tự quyết chuyện duyệt; việc này được đặt ở nơi dùng Tool:

• Trên Agent, bằng mục Khi nào cần duyệt (Hỏi trước hoặc Tự chạy) cho Tool đó. Xem Agent.
• Trên Workforce, ở kết nối đi vào Tool (Cần duyệt hoặc Tự chạy). Xem Workforce.

Thao tác thường gặp

Xây một Tool

1. Vào Tools và bấm Tool mới.
2. Đặt tên và điền Agent nên dùng tool này khi nào? (Tạo bằng AI viết sẵn một đoạn mở đầu từ tên và các bước để bạn sửa).
3. Chọn Tool input và thêm các input mà bên gọi sẽ biết.
4. Bấm dấu + (Add step) trên đường nối giữa hai bước, chọn một bước và điền tham số bằng giá trị cố định hoặc biến. Thêm bước khác nếu cần.
5. Chọn Tool output và map các trường cần trả về.
6. Bấm Tạo tool.

Test một Tool

1. Mở tab Test và nhập input dưới dạng JSON.
2. Bấm Chạy test. Mỗi bước hiện Thành công, Lỗi hoặc Bỏ qua, kèm output và thời gian chạy; lượt chạy kết thúc bằng Test đạt hoặc Test thất bại.
3. Thao tác đọc chạy thật. Lượt test luôn dừng trước bước ghi đầu tiên ("Bước tiếp theo sẽ thực thi thật:"): Duyệt & chạy tiếp thực hiện thao tác ghi thật, Từ chối thì dừng lại.

Publish một Tool

Bấm Publish và xác nhận. Bản nháp trở thành phiên bản Agent gọi tới; các phiên bản trước vẫn nằm trong lịch sử.

Xoá một Tool

Dùng Xoá tool trong menu "…" ở danh sách Tools. Thao tác này xoá vĩnh viễn Tool, các phiên bản và lịch sử chạy của nó. Bạn không xoá được khi còn Agent đang dùng Tool ("Tool này vẫn đang được dùng bởi: …"); hãy gỡ Tool khỏi các Agent đó trước. Workforce và các Tool khác từng dùng nó sẽ bỏ qua nó từ đó về sau.

Nhờ Assistant tạo Tool

Trong Chat, hãy nhờ Assistant tạo Tool. Assistant có thể tạo Tool một action từ một action của App; nếu đã có một Tool đã publish giống hệt, nó dùng lại Tool đó thay vì tạo bản sao.

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, publish và xoá Tool. Thành viên khác xem được. Không thể thay đổi gì trong Workspace đã lưu trữ.
• Agent chỉ chọn được Tool đã publish, và tổng cộng tối đa 20 Tool.
• Các khối (Branch, Loop) lồng nhau tối đa 3 cấp; Sub-tool gọi nhau sâu tối đa 3 Tool và không bao giờ được gọi vòng.
• Tên input approval_reason đã được dành riêng.
• Assistant chỉ publish một Tool sau khi đúng bản nháp đó qua test, và không bao giờ publish Tool đang được một Agent hay Workforce đã publish dùng; những Tool đó bạn tự publish trong app.
• AI client (kết nối qua MCP) chỉ chạy được một Tool sau khi quyền truy cập AI được bật cho phiên bản production của nó. Chỉ bật được cho Tool không có bước LLM và có tối đa một bước ghi nằm ngoài các khối Branch, Loop và Sub-tool. Bật cho Tool có ghi dữ liệu cần Admin của Workspace (hoặc Owner, Admin của Organization). Publish phiên bản mới sẽ tắt quyền này cho tới khi được bật lại. Trang Tool chưa có công tắc cho việc này.
• Số liệu sử dụng và Evals cho Tool chưa có.

Liên quan

• Agent — thêm Tool vào Agent và đặt chế độ duyệt.
• Workforce — Tool như các bước cố định trên canvas.
• Skill — Skill có thể nhắc tới Tool.
• Ứng dụng — mọi action của App mà một bước có thể chạy.
• Chat với Assistant — nhờ Assistant xây và test Tool.