NeboAI
NeboAI
시작하기

워크플로

워크플로는 직원이 요청받지 않아도 하는 일입니다. 아침 요약, 새 메시지마다 보내는 답장, 주간 보고서 같은 것들입니다. 각 워크플로는 트리거와 직원이 수행할 활동을 짝지어 둡니다. 워크플로는 직원의 agent.json에 들어 있으므로 역할과 함께 움직입니다.

첫 워크플로

agent.json에 workflows 맵을 추가하세요. 각 키는 워크플로의 이름이고, 각 값에는 트리거와 활동이 들어갑니다.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

이 워크플로는 평일 08:00에 봇의 현지 시간으로 실행됩니다. 직원은 자신의 페르소나, 스킬, 연결로 활동을 수행합니다.

워크플로 필드

필드의미
trigger필수입니다. 워크플로가 실행되는 시점입니다. 트리거를 참고하세요.
description워크플로의 목적입니다.
activities단계입니다. 활동을 참고하세요.
connections활동을 그래프로 만드는 간선 {from, to, label}입니다. __trigger__는 시작점, __emit__은 끝점입니다.
emit이 워크플로가 끝날 때 알리는 이벤트입니다. 목록이나 쉼표로 구분된 문자열 하나로 씁니다. 이벤트를 참고하세요.
inputs모든 실행에 전달되는 값입니다.
budget{total_per_run, cost_estimate}입니다. 그래프 실행에서는 total_per_run이 출력 토큰의 상한이 되고, 그 외에는 둘 다 추정치입니다.
case사람이나 대상마다 오래 이어지는 케이스 하나로 워크플로를 만듭니다. 케이스를 참고하세요.

트리거만 있고 활동이 없는 워크플로도 유효합니다. 활동이 없는 감시는 이벤트를 다른 워크플로에 전달하기만 합니다.

실행 방식

connections가 없으면 활동은 순서대로 실행되며 직원이 하나씩 수행합니다. 각 활동의 결과는 다음 활동으로 전달됩니다. 출력이 없는 활동은 실행을 끝냅니다.

connections가 있으면 활동이 그래프를 이룹니다. 분기는 병렬로 실행되며, 여섯 가지 활동 타입은 모델 없이 실행됩니다. condition, loop, wait, http, command, decide입니다. 라우팅이 정확해야 할 때 그래프를 사용하세요.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

실행이 받는 값

직원은 항상 자신의 페르소나와 inputs 질문에 대한 소유자의 답을 가지고 있습니다. 실행은 트리거에 따라 다음 값도 받습니다.

입력제공되는 경우
_event_source, _event_payload, _event_origin이벤트 트리거가 실행된 경우입니다. 8KB 이상의 페이로드는 스칼라 필드만 남도록 줄어들며, 이메일 헤더와 첨부 파일 참조는 유지됩니다.
_watch_payload감시 또는 폴더 트리거가 실행된 경우입니다. 감시자 출력의 한 줄이며, 폴더의 경우 {files}입니다.
inputs항상 제공됩니다. 워크플로 자체의 inputs 값입니다.

케이스

어떤 일은 며칠에 걸쳐 이어집니다. 후속 연락이 필요한 리드, 서류를 기다리는 요청 같은 것들입니다. case를 추가하면 워크플로가 매번 새로 시작하지 않고 사람이나 대상마다 열린 케이스 하나를 유지합니다.

필드의미
key필수입니다. 대상을 식별하는 트리거 데이터 안의 점 표기 경로를 쉼표로 구분해 씁니다. 예를 들어 contactEmail,email,phone입니다.
typelead처럼 케이스의 종류입니다. 타입이 같은 워크플로는 케이스를 공유합니다. 기본값은 워크플로 이름입니다.
default_wait턴에서 대기 시간을 지정하지 않을 때 기다리는 시간입니다. 3d, 12h, 45m처럼 씁니다. 기본값은 3일입니다.

케이스의 각 턴은 JSON 객체 하나로 끝나야 하며, 그 뒤에는 아무것도 없어야 합니다. result는 비즈니스 상태이고, next는 엔진에게 wait 또는 close를 지시합니다. 기한은 RFC 3339 형식이나 상대 기간으로 씁니다. 그 밖의 형태는 유효하지 않은 턴입니다.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

제한과 복구

  • params.maxIterations로 따로 정하지 않으면 각 활동은 최대 50번의 모델 턴을 사용할 수 있습니다.
  • 그래프에서 한 활동은 한 번의 실행에서 최대 10,000번 실행될 수 있습니다.
  • 소유자가 정한 직원의 지출 한도에 도달하면 실행이 멈춥니다. 활동의 token_budget은 추정치입니다.
  • 재시작으로 중단된 실행은 중단됨으로 표시되고 한 번 재개됩니다.
  • 직원은 exit 도구로 실행을 일찍 끝낼 수 있습니다.

워크플로 실행과 관리

소유자는 어떤 워크플로든 직접 실행할 수 있습니다. 직원은 run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled와 도우미와 팀에 나열된 다른 워크플로 도구로 워크플로를 관리합니다.