Job status and questions¶
Before solving, the node asks the agent whether it can solve the task
(determineSolvability()). The answer decides what the node does.
job_status |
job_status_label |
What the node does | success |
|---|---|---|---|
1 |
Solvable | Runs the agent and returns response and structured_output. |
true |
4 |
Informs | Returns the agent's answer in response and information. Nothing is written. |
true |
2 |
Needs Answers | Pauses the workflow and asks a person. | n/a |
3 |
Should Answer Question | Same as Needs Answers. | n/a |
0 |
Not Solvable | Returns response and error_message. |
false |
Any other value is labelled Unknown and handled like Not Solvable.
When the agent has a question¶
For statuses 2 and 3 the node does not return output. It throws a FlowDrop interrupt carrying the agent's question, and the workflow stops at that node until someone answers.
sequenceDiagram
participant W as Workflow
participant N as AI Agent Executor
participant A as Agent
participant P as Person
W->>N: run
N->>A: determineSolvability()
A-->>N: Needs Answers + question
N-->>W: interrupt (question)
W->>P: show question form
P-->>W: answer
W->>N: resume(answer)
N->>A: same task, history + answer
A-->>N: Solvable
N-->>W: output, resumed_from_interrupt = true
- The interrupt is a schema form with one multi-line text field. The question text is the agent's
answer from
answerQuestion(), or "The agent needs more information to proceed." when it gives none. - How the question is shown depends on where the workflow runs: the FlowDrop playground, a chat
interface or another interrupt handler from
flowdrop_interrupt. - On resume, FlowDrop rebuilds the node's inputs from upstream and the node runs the agent again
with the reply added as a new
usermessage after the task. The agent can ask again, which pauses the workflow again. - The reply can be a plain string or an object with a
valueortextkey.
The node keeps no state of its own between the pause and the resume. FlowDrop stores the interrupt and routes the reply back to the job that asked.