FlowDrop Agents¶
FlowDrop Agents runs AI Agents from the AI Agents module as nodes in FlowDrop workflows. It adds one node type, AI Agent Executor, that hands a task to an agent, reports the agent's job status, and returns what the agent created, edited or deleted. When an agent needs an answer from a person, the node pauses the workflow and resumes it once someone replies.
Features¶
- AI Agent Executor node in the Agents category of the FlowDrop editor. It runs any agent the AI Agents plugin manager knows about, plugin-based or config-based.
- Job status output. Every run reports the agent's job status as a number and a label.
- Structured output. Lists of created, edited and deleted configuration and content entities.
- Human in the loop. When the agent needs answers, the workflow pauses with a FlowDrop interrupt and resumes with the reply appended to the conversation.
- Chat history input for multi-turn conversations, with roles limited to
user,assistantandtool. - Direct or blueprint mode. The agent either writes changes immediately or returns a blueprint.
- Per-node overrides for the LLM provider and model, and for tool usage limits on config-based agents.
- Agent selector widget in the node configuration form, with search and a preview of the agent's description and tools.
How it fits together¶
flowchart LR
Upstream[Upstream nodes] -->|task_description, chat_history| Node[AI Agent Executor]
Node -->|createInstance| AM[AI Agents plugin manager]
AM --> Agent[Agent]
Agent -->|solve| Drupal[(Config and content)]
Node -->|response, structured_output, job_status| Downstream[Downstream nodes]
Node -.->|needs answers| Interrupt[FlowDrop interrupt]
Interrupt -.->|reply| Node
Requirements¶
- Drupal 10, 11 or 12
- FlowDrop with its
flowdrop_interruptsubmodule - AI with at least one configured chat provider
- AI Agents
See Installation.