NeboAI
NeboAI
Bắt đầu

Hoạt động

Hoạt động là một bước của quy trình làm việc. Phần lớn hoạt động do nhân viên thực hiện: bạn nêu mục đích và nhân viên làm việc bằng kỹ năng và kết nối của mình. Sáu loại chạy mà không cần mô hình, nên việc định tuyến và thời gian luôn chính xác.

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ườngMặc địnhÝ nghĩa
idbắt buộcDuy nhất trong quy trình. Dùng trong connections và các đường dẫn dữ liệu.
typecustomMột bước của nhân viên, hoặc một trong condition, loop, wait, http, command, decide.
intentkhô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 đủ.
labelkhô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.
modelkhông cóId mô hình cho bước này.
paramskhô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_iterationskhông cóSố lượt mô hình tối thiểu trước khi bước có thể hoàn tất.
token_budgetkhô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
expressionMặ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.
existsMột đường dẫn; đúng khi nó trỏ tới một giá trị truthy.
containspath contains text, hoặc văn bản trơn được so khớp với đầu ra trước đó.
regexMộ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ểuBắt buộcHành vi
waitparams.durationTạ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 đó.
httpparams.urlGửi yêu cầu. method, headers và body là tùy chọn.
commandparams.commandChạ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ỏicriteriaCâ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.
scoreDanh sách từ 2 đến 10 mức có thứ tự.score từ 0 (mức đầu tiên) trở lên, và confidence.
noulKhô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.