Ask AI

AI Agent Node

Notion image

AI Agent is a component of the Latenode platform designed to build intelligent scenarios based on large language models (LLMs). It allows you to integrate external functions, conduct contextual dialogues, and perform sequential actions based on user input.

Purpose

AI Agent is used for:

  • generating responses to user queries;
  • calling other nodes in a scenario as functions;
  • working with short-term memory within a session;
  • receiving structured JSON responses;
  • executing scenarios with a limited number of iterations.

AI Agent Interface

Notion image

Main Fields

Field
Description
Session ID
Session identifier. Used to preserve context between interactions.
User Prompt
The user's main query. Supports variable interpolation.
System Message
Instruction for the language model. Controls the agent's behavior (tone, style, restrictions, etc.).
Agent ID
Agent identifier. Helps distinguish agents within one session and manage memory scope.

Additional Settings

Field
Description
Max Iterations
Maximum number of iterations for calling external nodes. Prevents infinite loops.
Output JSON Schema
JSON schema of the expected output. Ensures a structured result for further processing.

How It Works

AI Agent implements the concept of Function Calling (as defined by OpenAI) or Tool Call. When launched, it forms a standard chat request with roles (system, user) and a list of available "tools" based on connected nodes.

The request includes:

  • System Message — the system message (role: system),
  • User Prompt — the user’s request (role: user),
  • descriptions of available functions, composed from nodes using the expression:
{{fromAIAgent("argument_name"; "argument description")}}
Example:

Each such node is treated as a callable function with a name, arguments, and description. If the model decides to call one of the functions, Latenode executes the corresponding node and returns the result to the AI Agent.

🧠 The model decides on its own which tools to invoke depending on the meaning of the user request. You can connect multiple nodes — only relevant ones will be triggered based on context.

Connecting Nodes to the Agent

Notion image

To make AI Agent use other scenario blocks, they must be visually connected from the bottom via the constructor interface.

  • Drag the desired node (e.g., HTTP Request, Telegram, Search, etc.) and connect it to AI Agent from the bottom.
  • Inside this node, use the fromAIAgent() expression in one of the input fields, like Request Body, Text, Prompt, etc.

Inside the field, use this format:

{{fromAIAgent("parameter_name"; "description")}}

Example:

Notion image
{{fromAIAgent("city"; "City to get weather forecast for")}}

This expression registers the node as an available tool. The model will know it can call a tool with this node's name and parameter city, and use it according to the description.

⚠️ Each node must have a name. Without it, execution is impossible.

Example: Weather Forecast (No Authorization Required)

Notion image

Let’s see how AI Agent works using a weather forecast request.

  1. Place an AI Agent on the canvas.
  1. In the System Message field, write:
    1. You are an assistant who can get the weather. Use the appropriate tool.
  1. Add an HTTP Request node below it.
  1. Name the node, e.g., weather_forecast
  1. Set method to: GET
  1. In the URL field, insert:
    1. https://wttr.in/{{fromAIAgent("city"; "City name for the weather forecast")}}?format=3
  1. Launch AI Agent with the prompt:
    1. What's the weather like in London?

As a result:

  • The AI Agent receives the user request;
  • analyzes that a weather forecast is needed;
  • finds the node named weather_forecast, which uses fromAIAgent with the city parameter;
  • substitutes the value “London” and makes the HTTP request;
  • receives a brief forecast and sends it back to the user.
Notion image

Example: Flexible Telegram Chatbot

AI Agent also works well in chatbot format. You can connect multiple nodes and let the model decide which to use.

For instance, here’s a basic Telegram chatbot:

Notion image

Telegram trigger connected to AI Agent, and from AI Agent to:

  • search_web (Perplexity);
  • create_image (Recraft AI);
  • send_text (Telegram - Send text);
  • send_photo (Telegram - Send image)]

In this scenario:

  • If the user sends a general message, the agent simply replies with text.
    • Notion image
  • If the user asks to search for something, it uses the search_web node.
    • Notion image
  • If the user asks to generate an image, it uses the create_image node.
    • Notion image

Each node is registered with fromAIAgent() to pass parameters. The model understands which tool to use — and ignores the rest.

This makes the chatbot dynamic and modular.


Setup Recommendations

  • All connected nodes should have unique and descriptive names.
  • Use Agent ID to preserve context between launches or across scenarios.
  • Set Max Iterations to avoid infinite loops from bad prompts.
  • Use Output JSON Schema if you need a formalized response for further processing.

AI Agent is a key component of Latenode for building conversational and automated LLM-based scenarios. With support for context, iterative function calls, and structured data, it suits a wide range of use cases.

⚠️ Don’t forget to set a node name — otherwise the scenario won’t run.
Did this answer your question?
😞
😐
🤩