| 타입 | 실행 시점 |
|---|---|
schedule | cron 표현식이 일치할 때입니다. |
heartbeat | 일정 간격이 지날 때이며, 하루 중 정해진 시간대로 제한할 수도 있습니다. |
event | 소스가 일치하는 이벤트가 발생할 때입니다. |
watch | 플러그인 감시자가 출력 한 줄을 쓸 때입니다. |
folder | 폴더의 파일이 바뀔 때입니다. |
manual | 소유자나 직원이 실행할 때입니다. |
call | 전화 회선이 울릴 때입니다. 전화 응답 트리에서만 사용합니다. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron은 분, 시, 일, 월, 요일의 다섯 필드로 된 cron 표현식입니다. schedule은 사람이 읽을 선택적 설명입니다. 일정은 봇의 현지 시간대로 실행됩니다. Nebo는 5초마다 일정을 확인합니다. 봇이 꺼져 있는 동안 놓친 실행은 1시간 이내로 늦었다면 한 번 따라잡아 실행합니다. 이전 실행이 아직 진행 중이면 이번 실행은 건너뜁니다.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval은 30m, 1h, 2h30m 같은 기간입니다. window(HH:MM-HH:MM)는 실행을 업무 시간 안으로 제한합니다. 다음 실행 시각은 마지막 실행 시각에 간격을 더한 뒤 시간대 안으로 옮긴 시각이며, 첫 실행은 워크플로가 불러와진 뒤 한 간격이 지난 시각입니다. 타이머는 재시작 후에도 유지됩니다. 이전 실행이 아직 진행 중이면 이번 실행은 건너뛰며, 유효하지 않은 간격은 실행되지 않습니다.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources에는 정확히 일치시키거나 끝에 .* 와일드카드를 붙여 일치시킬 이벤트 이름을 나열합니다. 목록이 비어 있으면 오류가 되어 agent.json 전체가 거부됩니다. 실행은 _event_source, _event_payload, _event_origin을 받습니다. 이름이 만들어지는 방식은 이벤트를 참고하세요.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } 감시는 플러그인 프로세스를 계속 실행해 두고, 프로세스가 쓰는 줄마다 실행을 시작합니다. 각 줄은 _watch_payload로 전달됩니다. 10분 이내의 동일한 줄은 버려집니다.
| 필드 | 기본값 | 의미 |
|---|---|---|
plugin | 필수 | mail 같은 기능이나 플러그인 slug입니다. 맞는 기능이 있으면 항상 기능 이름을 쓰세요. |
event | 없음 | 플러그인의 events 목록에 있는 이벤트입니다. Nebo는 그 이벤트의 명령을 사용하며, 각 줄을 <plugin>.<event>로도 내보냅니다. |
command | 없음 | 감시자를 시작하는 인수입니다. 설정하면 이 값을 사용하고, 그렇지 않으면 event에서 가져옵니다. |
restart_delay_secs | 5 | 종료된 감시자를 다시 시작하기 전에 기다리는 시간입니다. |
기능은 그 기능을 제공하는 설치된 플러그인으로 연결되며, 이 직원이 계정을 가진 플러그인이 우선합니다. 그런 플러그인이 없으면 워크플로가 기능 저하 상태로 표시되고, 소유자에게 무엇을 연결해야 하는지 알려줍니다. 계속 충돌하는 감시자는 최대 300초까지 두 배씩 늘어나는 지연 후 다시 시작되며, 30초 동안 정상 실행되면 지연이 초기화됩니다.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } command의 {{key}}는 직원의 입력 항목에 대한 소유자의 답변으로 채워집니다. 답변이 없는 자리표시자가 있으면 감시가 시작되지 않습니다.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | 필드 | 기본값 | 의미 |
|---|---|---|
path | 필수 | 절대 폴더 경로입니다. {{key}}는 입력값으로 채워집니다. |
extensions | 모든 파일 | 일치시킬 파일 확장자이며, 점은 빼고 씁니다. |
recursive | true | 하위 폴더를 포함합니다. |
debounce_secs | 2 | 이 시간 안의 변경은 하나의 실행으로 묶입니다. |
실행은 변경된 경로를 _watch_payload.files로 받습니다.
manual
{ "type": "manual" } 수동 워크플로는 소유자가 실행하거나 직원이 run_workflow를 호출할 때만 실행됩니다. 트리거와 상관없이 모든 워크플로를 이 방법으로 실행할 수도 있습니다.
call
{"type": "call", "line": "..."}는 직원이 전화 회선에 응답하는 방식을 구성하는 "type": "call_tree" 워크플로에서만 유효합니다. line이 비어 있으면 더 구체적인 트리가 없는, 직원이 응답하는 모든 회선에 적용됩니다. 통화 트리에는 인사말이 정확히 하나, 이름이 지정된 인텐트가 하나 이상 있어야 합니다.
웹훅
소유자는 직원용 웹훅을 만들 수도 있습니다. 워크플로에 연결된 웹훅은 그 워크플로를 실행하고, 워크플로가 없는 웹훅은 페이로드를 직원의 채팅으로 전달합니다.