Skip to main content

AI Agent Node - Configuration in ConvyAI FlowDesigner

Overview​

The AI Agent node is the FlowDesigner component that exposes AI Agent capabilities inside a flow. Add it at any point in a flow where you want the LLM to process input, invoke tools, and produce an output that drives the next step.

Node configuration​

AI Agent node configuration

FieldDescription
HookOptional label to link the node to a specific event or use it as a jump target.
QuestionThe main question or instruction sent to the AI model.
Image ListAttach images to be analyzed as part of the prompt. See Image Analysis.
Variable to analyzeOptional variable passed as additional input to the model.
AI ModelThe AI Model used to generate responses.
PromptSystem-level instructions to enrich the context. There is no separate system prompt for this node type - instructions are passed directly via this field.
MCP Server ListConnect one or more external MCP servers. See MCP Servers.
Function Tools ListList of custom JavaScript functions the AI can invoke. See Callable Functions.
Node SettingsOperational settings: initial node flag, maximum number of interactions, and additional toggles.

Notes​

  • The Question field supports dynamic variable interpolation. Use it to pass context gathered earlier in the flow directly into the model's input.
  • Variable to analyze is a dedicated input for passing the value of a previously populated flow variable directly to the model.
  • The AI Agent node counts as a single LLM call per execution, regardless of the number of tools invoked.
  • If no tools are selected in the MCP Server List, all available tools from the connected servers are treated as active.