Skip to content

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 user message 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 value or text key.

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.