NeboAI
NeboAI
시작하기

활동

활동은 워크플로의 한 단계입니다. 대부분의 활동은 직원이 수행합니다. 의도를 적어 주면 직원이 스킬과 연결로 일을 해냅니다. 여섯 가지 타입은 모델 없이 실행되므로 라우팅과 타이밍이 정확하게 유지됩니다.

필드

{
  "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와 데이터 경로에 사용됩니다.
typecustom직원 단계, 또는 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경로입니다. 참으로 평가되는 값이면 참입니다.
containspath 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" } }
타입필수동작
waitparams.durations, m, h 단위의 기간 동안 일시 중지합니다. 특정 시점까지 기다리는 기능은 없으므로, 이벤트가 발생할 때 재개하려면 그 이벤트로 두 번째 워크플로를 트리거하세요.
httpparams.url요청을 보냅니다. method, headers, body는 선택 사항입니다.
commandparams.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는 실행이 시작될 때 타입이 지정된 각 활동의 필수 매개변수를 확인하며, 알 수 없는 활동을 가리키는 분기는 거부합니다.