Các trường
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | Trường | Mặc định | Ý nghĩa |
|---|---|---|
id | bắt buộc | Duy nhất trong quy trình. Dùng trong connections và các đường dẫn dữ liệu. |
type | custom | Một bước của nhân viên, hoặc một trong condition, loop, wait, http, command, decide. |
intent | không có | Điều nhân viên cần đạt được. Bước của nhân viên cần có intent hoặc steps. |
steps | [] | Các chỉ dẫn theo thứ tự, khi một câu là chưa đủ. |
label | không có | Tên hiển thị cho chủ sở hữu. |
skills | [] | Các kỹ năng sẽ dùng. Kỹ năng từ chợ ứng dụng liệt kê ở đây được cài cùng nhân viên. |
tools | [] | Khi được đặt, đây là những công cụ duy nhất bước được phép dùng. |
requires_tools | [] | Các công cụ phải chạy thành công thì bước mới được tính là hoàn tất. |
cmds | [] | Các lệnh plugin được chỉ định cho bước. |
mcps | [] | Các máy chủ MCP được chỉ định cho bước. |
model | không có | Id mô hình cho bước này. |
params | không có | Tham số cho các hoạt động có kiểu, và maxIterations cho các bước của nhân viên. |
min_iterations | không có | Số lượt mô hình tối thiểu trước khi bước có thể hoàn tất. |
token_budget | không có | {max}. Một ước tính. |
on_error | {retry: 1, fallback: notify_owner} | Số lần thử lại, rồi phương án dự phòng. Mọi lỗi sau khi đã thử lại đều kết thúc lượt chạy. |
Các bước của nhân viên
Bước của nhân viên chạy như một lượt của nhân viên: tính cách, bộ nhớ và kết nối của nhân viên đều được áp dụng, và bước có thể dùng tối đa 50 lượt mô hình, hoặc params.maxIterations. Kết quả của các bước trước được truyền vào dưới dạng các khối [Activity 'id' result]. Bước kết thúc quy trình có danh sách emit sẽ được yêu cầu gọi emit_event với các sự kiện đó. Công cụ exit luôn có sẵn để kết thúc lượt chạy.
Ngữ cảnh dữ liệu
Các hoạt động có kiểu đọc giá trị theo đường dẫn dạng dấu chấm từ một đối tượng: inputs chứa các đầu vào của lượt chạy, nodes.<id> chứa đầu ra của từng hoạt động đã hoàn tất (được phân tích thành JSON nếu là JSON), và item chứa phần tử hiện tại bên trong một vòng lặp. Đường dẫn trơn sẽ tìm trong inputs, rồi tới nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression là bắt buộc. Các kết nối đi ra của nó được gắn nhãn True và False. params.mode chọn cách đọc biểu thức:
| Chế độ | Biểu thức |
|---|---|
expression | Mặc định. path op value với ==, !=, >=, <=, > hoặc <, được so sánh như số khi cả hai vế đều là số; hoặc một đường dẫn trơn, đúng khi giá trị của nó là truthy. |
exists | Một đường dẫn; đúng khi nó trỏ tới một giá trị truthy. |
contains | path contains text, hoặc văn bản trơn được so khớp với đầu ra trước đó. |
regex | Một mẫu được so khớp với đầu ra trước đó. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source là đường dẫn tới một danh sách. Kết nối có nhãn Each item dẫn tới phần thân, chạy một lần cho mỗi phần tử với item được đặt; kết nối có nhãn Done chạy sau khi xong mọi phần tử. Các vòng lặp bắt đầu cùng lúc trừ khi bạn đặt concurrency. maxIterations và batchSize cũng được chấp nhận.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http và command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | Kiểu | Bắt buộc | Hành vi |
|---|---|---|
wait | params.duration | Tạm dừng trong một khoảng thời gian tính bằng s, m hoặc h. Không có kiểu chờ đến thời điểm nhất định; để tiếp tục khi có sự kiện, hãy kích hoạt một quy trình thứ hai bằng sự kiện đó. |
http | params.url | Gửi yêu cầu. method, headers và body là tùy chọn. |
command | params.command | Chạy một lệnh shell. Stdout của lệnh là đầu ra của hoạt động. |
decide
Hoạt động decide đặt các câu hỏi có kiểu về công việc đã làm và ghi lại câu trả lời có cấu trúc để một condition có thể định tuyến theo đó.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | Loại câu hỏi | criteria | Câu trả lời |
|---|---|---|
choice | Đối tượng ánh xạ lựa chọn tới mô tả, từ 2 đến 255 lựa chọn. | choice, confidence và probabilities. |
score | Danh sách từ 2 đến 10 mức có thứ tự. | score từ 0 (mức đầu tiên) trở lên, và confidence. |
noul | Không có. | noul, xác suất nhận định là đúng. |
Định tuyến theo câu trả lời bằng một condition, chẳng hạn nodes.triage.urgency.score >= 1.5. params.default đưa ra câu trả lời an toàn cho mỗi câu hỏi khi không thể đưa ra quyết định; câu trả lời mặc định có độ tin cậy 0. Câu hỏi không có giá trị mặc định sẽ không có câu trả lời, nên các condition dựa trên nó sẽ đi theo cạnh False.
Lỗi
on_error.retry đặt số lần thử lại một hoạt động bị lỗi; mặc định là 1. Sau lần thử lại cuối cùng, lượt chạy kết thúc, và với fallback mặc định là notify_owner, chủ sở hữu sẽ được thông báo. Nebo kiểm tra các tham số bắt buộc của từng hoạt động có kiểu khi lượt chạy bắt đầu, và từ chối nhánh trỏ tới một hoạt động không xác định.