첫 워크플로
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입니다. |
type | lead처럼 케이스의 종류입니다. 타입이 같은 워크플로는 케이스를 공유합니다. 기본값은 워크플로 이름입니다. |
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와 도우미와 팀에 나열된 다른 워크플로 도구로 워크플로를 관리합니다.