필드
{
"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" }
} | 필드 | 기본값 | 의미 |
|---|---|---|
id | 필수 | 워크플로 안에서 고유해야 합니다. connections와 데이터 경로에 사용됩니다. |
type | custom | 직원 단계, 또는 condition, loop, wait, http, command, decide 중 하나입니다. |
intent | 없음 | 직원이 달성해야 할 일입니다. 직원 단계에는 intent나 steps가 필요합니다. |
steps | [] | 한 문장으로 부족할 때 쓰는 순서가 있는 지침입니다. |
label | 없음 | 소유자에게 표시되는 이름입니다. |
skills | [] | 사용할 스킬입니다. 여기에 나열된 마켓플레이스 스킬은 직원과 함께 설치됩니다. |
tools | [] | 설정하면 이 단계에서 사용할 수 있는 도구는 이것뿐입니다. |
requires_tools | [] | 단계가 완료된 것으로 인정되려면 성공해야 하는 도구입니다. |
cmds | [] | 이 단계에 지정된 플러그인 명령입니다. |
mcps | [] | 이 단계에 지정된 MCP 서버입니다. |
model | 없음 | 이 단계에 사용할 모델 ID입니다. |
params | 없음 | 타입이 지정된 활동의 매개변수와, 직원 단계의 maxIterations입니다. |
min_iterations | 없음 | 단계가 끝나기 전 최소 모델 턴 수입니다. |
token_budget | 없음 | {max}입니다. 추정치입니다. |
on_error | {retry: 1, fallback: notify_owner} | 재시도 후 대체 동작입니다. 재시도 후에도 실패하면 실행이 끝납니다. |
직원 단계
직원 단계는 직원의 한 턴으로 실행됩니다. 직원의 페르소나, 메모리, 연결이 적용되며, 최대 50번의 모델 턴 또는 params.maxIterations만큼 사용할 수 있습니다. 앞 단계의 결과는 [Activity 'id' result] 블록으로 전달됩니다. emit 목록으로 워크플로를 끝내는 단계는 그 이벤트로 emit_event를 호출하라는 안내를 받습니다. 실행을 끝내는 exit 도구는 항상 사용할 수 있습니다.
데이터 컨텍스트
타입이 지정된 활동은 하나의 객체에서 점 표기 경로로 값을 읽습니다. inputs에는 실행의 입력이, nodes.<id>에는 완료된 각 활동의 출력이(JSON이면 JSON으로 파싱되어) 들어 있고, item에는 루프 안의 현재 항목이 들어 있습니다. 접두사가 없는 경로는 inputs에서 먼저 찾고 이어서 nodes에서 찾습니다.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression은 필수입니다. 나가는 연결에는 True와 False 레이블이 붙습니다. params.mode로 표현식을 읽는 방식을 정합니다.
| 모드 | 표현식 |
|---|---|
expression | 기본값입니다. ==, !=, >=, <=, >, <를 사용하는 path op value 형식이며, 양쪽이 모두 숫자이면 숫자로 비교합니다. 또는 접두사 없는 경로를 쓰면 값이 참으로 평가될 때 참입니다. |
exists | 경로입니다. 참으로 평가되는 값이면 참입니다. |
contains | path contains text, 또는 이전 출력과 대조하는 일반 텍스트입니다. |
regex | 이전 출력과 대조하는 패턴입니다. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source는 목록의 경로입니다. Each item 레이블이 붙은 연결은 본문으로 이어지며, 본문은 item이 설정된 상태로 항목마다 한 번씩 실행됩니다. Done 레이블이 붙은 연결은 모든 항목이 끝난 뒤 실행됩니다. concurrency를 설정하지 않으면 반복이 동시에 시작됩니다. maxIterations와 batchSize도 사용할 수 있습니다.
"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, 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" } } | 타입 | 필수 | 동작 |
|---|---|---|
wait | params.duration | s, m, h 단위의 기간 동안 일시 중지합니다. 특정 시점까지 기다리는 기능은 없으므로, 이벤트가 발생할 때 재개하려면 그 이벤트로 두 번째 워크플로를 트리거하세요. |
http | params.url | 요청을 보냅니다. method, headers, body는 선택 사항입니다. |
command | params.command | 셸 명령을 실행합니다. 명령의 stdout이 활동의 출력이 됩니다. |
decide
decide 활동은 지금까지의 작업에 대해 타입이 지정된 질문을 하고, condition이 라우팅에 쓸 수 있는 구조화된 답을 기록합니다.
{
"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 }
}
} | 질문 유형 | criteria | 답 |
|---|---|---|
choice | 선택지와 설명을 짝지은 객체이며, 선택지는 2~255개입니다. | choice, confidence, probabilities입니다. |
score | 순서가 있는 단계 2~10개의 목록입니다. | 0(첫 번째 단계)부터 올라가는 score와 confidence입니다. |
noul | 없음. | noul, 해당 진술이 참일 확률입니다. |
nodes.triage.urgency.score >= 1.5처럼 condition으로 답에 따라 라우팅하세요. params.default는 결정을 내릴 수 없을 때 각 질문에 사용할 안전한 답을 정합니다. 기본값으로 정해진 답의 신뢰도는 0입니다. 기본값이 없는 질문은 답을 얻지 못하므로, 그 질문에 대한 condition은 False 간선으로 갑니다.
오류
on_error.retry는 실패한 활동을 몇 번 다시 시도할지 정하며, 기본값은 1입니다. 마지막 재시도가 끝나면 실행이 끝나고, fallback이 기본값인 notify_owner이면 소유자에게 알림이 갑니다. Nebo는 실행이 시작될 때 타입이 지정된 각 활동의 필수 매개변수를 확인하며, 알 수 없는 활동을 가리키는 분기는 거부합니다.