@n8n/n8n-nodes-langchain 2.46.4 → 2.46.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/dist/node-definitions/.nodes-hash +1 -1
  2. package/dist/nodes/agents/Agent/V1/AgentV1.node.js +12 -2
  3. package/dist/nodes/agents/Agent/V1/AgentV1.node.js.map +1 -1
  4. package/dist/typecheck.tsbuildinfo +1 -1
  5. package/dist/types/nodes.json +1 -1
  6. package/package.json +6 -6
package/dist/types/nodes.json CHANGED
@@ -11,7 +11,7 @@
11
11
  {"displayName":"Databricks AI Agent","name":"databricksAiAgent","group":["transform"],"version":[2.2],"description":"An AI agent that exports its runs to MLflow Tracing in Databricks","defaults":{"name":"Databricks AI Agent"},"codex":{"categories":["AI"],"subcategories":{"AI":["Agents","Root Nodes"]},"resources":{"primaryDocumentation":[{"url":"https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.databricksaiagent/"}]}},"inputs":"={{\n\t\t\t((hasOutputParser, needsFallback) => {\n\t\t\t\tfunction getInputs(hasMainInput, hasOutputParser, needsFallback) {\n const getInputData = (inputs) => {\n return inputs.map(({ type, filter, displayName, required }) => {\n const input = {\n type,\n displayName,\n required,\n maxConnections: ['ai_languageModel', 'ai_memory', 'ai_outputParser'].includes(type)\n ? 1\n : undefined,\n };\n if (filter) {\n input.filter = filter;\n }\n return input;\n });\n };\n let specialInputs = [\n {\n type: 'ai_languageModel',\n displayName: 'Chat Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n type: 'ai_languageModel',\n displayName: 'Fallback Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n displayName: 'Memory',\n type: 'ai_memory',\n },\n {\n displayName: 'Tool',\n type: 'ai_tool',\n },\n {\n displayName: 'Output Parser',\n type: 'ai_outputParser',\n },\n ];\n if (hasOutputParser === false) {\n specialInputs = specialInputs.filter((input) => input.type !== 'ai_outputParser');\n }\n if (needsFallback === false) {\n specialInputs = specialInputs.filter((input) => input.displayName !== 'Fallback Model');\n }\n const mainInputs = hasMainInput ? ['main'] : [];\n return [...mainInputs, ...getInputData(specialInputs)];\n};\n\t\t\t\treturn getInputs(true, hasOutputParser, needsFallback);\n\t\t\t})($parameter.hasOutputParser === undefined || $parameter.hasOutputParser === true, $parameter.needsFallback !== undefined && $parameter.needsFallback === true)\n\t\t}}","outputs":["main"],"credentials":[{"name":"databricksOAuth2Api","required":false}],"properties":[{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto","builderHint":{"propertyHint":"Use 'auto' when following a chat trigger, 'define' when custom prompt needed"}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["auto"]}},"displayOptions":{"show":{"promptType":["auto"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."},"displayOptions":{"show":{"promptType":["define"]}}},{"displayName":"Require Specific Output Format","name":"hasOutputParser","type":"boolean","default":false,"noDataExpression":true},{"displayName":"Connect an <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='ai_outputParser'>output parser</a> on the canvas to specify the output format you require","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true]}}},{"displayName":"Enable Fallback Model","name":"needsFallback","type":"boolean","default":false,"noDataExpression":true,"displayOptions":{"show":{"@version":[{"_cnd":{"gte":2.1}}]}}},{"displayName":"Connect an additional language model on the canvas to use it as a fallback if the main model fails","name":"fallbackNotice","type":"notice","default":"","displayOptions":{"show":{"needsFallback":[true]}}},{"displayName":"Export Traces to MLflow","name":"exportTraces","type":"boolean","default":false,"noDataExpression":true,"description":"Whether to send each run to MLflow Tracing in your Databricks workspace. Needs the Databricks credential above. Traces include prompts, model outputs and tool results."},{"displayName":"Experiment","name":"experiment","type":"resourceLocator","default":{"mode":"name","value":""},"displayOptions":{"show":{"exportTraces":[true]}},"description":"Where traces are stored. Leave the name empty to create one for this workflow automatically.","modes":[{"displayName":"By Name","name":"name","type":"string","placeholder":"/Shared/my-agent-traces","hint":"Created if it does not exist. Empty means /Shared/n8n-workflows-<workflow ID>."},{"displayName":"By ID","name":"id","type":"string","placeholder":"822142731468161"}]},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]},{"displayName":"Enable Streaming","name":"enableStreaming","type":"boolean","default":true,"description":"Whether this agent will stream the response in real-time as it generates text"}],"displayOptions":{"hide":{"@version":[{"_cnd":{"lt":2.2}}]}}},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]}],"displayOptions":{"show":{"@version":[{"_cnd":{"lt":2.2}}]}}}],"iconUrl":{"light":"icons/@n8n/n8n-nodes-langchain/dist/nodes/vendors/Databricks/databricks.svg","dark":"icons/@n8n/n8n-nodes-langchain/dist/nodes/vendors/Databricks/databricks.dark.svg"}},
12
12
  {"displayName":"AI Agent","name":"agent","icon":"node:ai-agent","iconColor":"black","group":["transform"],"description":"Generates an action plan and executes it. Can use external tools.","codex":{"alias":["LangChain","Chat","Conversational","Plan and Execute","ReAct","Tools"],"categories":["AI"],"subcategories":{"AI":["Agents","Root Nodes"]},"resources":{"primaryDocumentation":[{"url":"https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/"}]}},"defaultVersion":3.1,"builderHint":{"searchHint":"Wire model/memory/tools/outputParser via the SDK `subnodes` config object using factory functions (`languageModel()`, `memory()`, `tool()`, `outputParser()`). Inside subnodes, reference upstream data with `nodeJson(triggerNode, 'path')`, not `$json` — subnodes do not share the main predecessor's item context.","relatedNodes":[{"nodeType":"n8n-nodes-base.aggregate","relationHint":"Use to combine multiple items together before the agent"},{"nodeType":"@n8n/n8n-nodes-langchain.outputParserStructured","relationHint":"Attach for structured output; reference fields as $json.output.fieldName for use in subsequent nodes (conditions, storing data)"},{"nodeType":"@n8n/n8n-nodes-langchain.agentTool","relationHint":"For multi-agent systems using orchestrator pattern"},{"nodeType":"@n8n/n8n-nodes-langchain.memoryBufferWindow","relationHint":"Required for conversational workflows - connect memory to every agent that needs to recall previous messages in the conversation"}],"extraTypeDefContent":[{"content":"<patterns>\n<pattern title=\"Agent with model, memory, structured output parser\">\nconst chatTrigger = trigger({\n type: '@n8n/n8n-nodes-langchain.chatTrigger',\n version: 1.3,\n config: {\n name: 'Chat Trigger',\n parameters: { public: false },\n output: [{ sessionId: 'chat-session-id', chatInput: 'Hello' }]\n }\n});\n\nconst model = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI Chat Model',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } },\n credentials: { openAiApi: { id: 'credId', name: 'OpenAI account' } }\n }\n});\n\nconst parser = outputParser({\n type: '@n8n/n8n-nodes-langchain.outputParserStructured',\n version: 1.3,\n config: {\n name: 'Output Parser',\n parameters: {\n schemaType: 'fromJson',\n jsonSchemaExample: '{ \"score\": 75, \"tier\": \"hot\" }'\n }\n }\n});\n\nconst memoryNode = memory({\n type: '@n8n/n8n-nodes-langchain.memoryBufferWindow',\n version: 1.3,\n config: {\n name: 'Conversation Memory',\n parameters: {\n sessionIdType: 'customKey',\n sessionKey: nodeJson(chatTrigger, 'sessionId'),\n contextWindowLength: 10\n }\n }\n});\n\nconst agent = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n hasOutputParser: true,\n options: { systemMessage: 'You are an expert...' }\n },\n subnodes: { model, memory: memoryNode, outputParser: parser }\n }\n});\n</pattern>\n\n<pattern title=\"Agent with a fallback model (primary + backup provider)\">\n// Give ONE agent a backup model with a FLAT model array: the first entry is the\n// primary, the second fills the agent's Fallback Model input. The agent retries\n// on the second model when the first call fails.\n// Do NOT build a second agent or an error-output branch for this — one agent.\n// A NESTED array (model: [[a, b]]) means something else: both models on the SAME\n// input, which is not a fallback.\n\nconst primaryModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n version: 1.6,\n config: {\n name: 'Claude (Primary)',\n parameters: { model: { __rl: true, mode: 'list', value: 'claude-sonnet-4-5' } }\n }\n});\n\nconst fallbackModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI (Fallback)',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } }\n }\n});\n\nconst agentWithFallback = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n options: { systemMessage: 'You are an expert...' },\n // REQUIRED with a second model: the agent only declares its Fallback Model\n // input when this is on. Without it the second model is wired to an input\n // that does not exist and never runs.\n needsFallback: true\n },\n subnodes: { model: [primaryModel, fallbackModel] }\n }\n});\n</pattern>\n</patterns>"}],"inputs":{"ai_languageModel":{"required":true},"ai_memory":{"required":false},"ai_tool":{"required":false},"ai_outputParser":{"required":false,"displayOptions":{"show":{"hasOutputParser":[true]}}}}},"version":[3,3.1],"defaults":{"name":"AI Agent","color":"#404040"},"inputs":"={{\n\t\t\t\t((hasOutputParser, needsFallback) => {\n\t\t\t\t\tfunction getInputs(hasMainInput, hasOutputParser, needsFallback) {\n const getInputData = (inputs) => {\n return inputs.map(({ type, filter, displayName, required }) => {\n const input = {\n type,\n displayName,\n required,\n maxConnections: ['ai_languageModel', 'ai_memory', 'ai_outputParser'].includes(type)\n ? 1\n : undefined,\n };\n if (filter) {\n input.filter = filter;\n }\n return input;\n });\n };\n let specialInputs = [\n {\n type: 'ai_languageModel',\n displayName: 'Chat Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n type: 'ai_languageModel',\n displayName: 'Fallback Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n displayName: 'Memory',\n type: 'ai_memory',\n },\n {\n displayName: 'Tool',\n type: 'ai_tool',\n },\n {\n displayName: 'Output Parser',\n type: 'ai_outputParser',\n },\n ];\n if (hasOutputParser === false) {\n specialInputs = specialInputs.filter((input) => input.type !== 'ai_outputParser');\n }\n if (needsFallback === false) {\n specialInputs = specialInputs.filter((input) => input.displayName !== 'Fallback Model');\n }\n const mainInputs = hasMainInput ? ['main'] : [];\n return [...mainInputs, ...getInputData(specialInputs)];\n};\n\t\t\t\t\treturn getInputs(true, hasOutputParser, needsFallback);\n\t\t\t\t})($parameter.hasOutputParser === undefined || $parameter.hasOutputParser === true, $parameter.needsFallback !== undefined && $parameter.needsFallback === true)\n\t\t\t}}","outputs":["main"],"properties":[{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Connected Guardrails Node","value":"guardrails","description":"Looks for an input field called 'guardrailsInput' that is coming from a directly connected Guardrails Node"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto","displayOptions":{"show":{"@version":[{"_cnd":{"lt":3.1}}]}}},{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto","builderHint":{"propertyHint":"Use 'auto' when following a chat trigger, 'define' when custom prompt needed"},"displayOptions":{"show":{"@version":[{"_cnd":{"gte":3.1}}]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.guardrailsInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["guardrails"]}},"displayOptions":{"show":{"promptType":["guardrails"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["auto"]}},"displayOptions":{"show":{"promptType":["auto"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."},"displayOptions":{"show":{"promptType":["define"]}}},{"displayName":"Require Specific Output Format","name":"hasOutputParser","type":"boolean","default":false,"noDataExpression":true,"builderHint":{"propertyHint":"Set to `true` when you need structured JSON output. The agent then requires an `outputParser` entry in its `subnodes` config (typically an `outputParserStructured` node defined via the `outputParser({...})` SDK factory). With `hasOutputParser: false` the agent returns a plain string in `$json.output`."}},{"displayName":"Connect an <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='ai_outputParser'>output parser</a> on the canvas to specify the output format you require","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true]}}},{"displayName":"Enable Fallback Model","name":"needsFallback","type":"boolean","default":false,"noDataExpression":true},{"displayName":"Connect an additional language model on the canvas to use it as a fallback if the main model fails","name":"fallbackNotice","type":"notice","default":"","displayOptions":{"show":{"needsFallback":[true]}}},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Auto-save highlighted data","name":"autoSaveHighlightedData","type":"boolean","default":true,"description":"Whether to automatically save <a href=\"https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.executiondata/\" target=\"_blank\">highlighted data</a>. This data can then be used to filter executions in the Executions view. Available on Pro and Enterprise plans in n8n Cloud, and on Enterprise or registered Community Edition for self-hosted. Defaults to true."},{"displayName":"Enable Streaming","name":"enableStreaming","type":"boolean","default":true,"description":"Whether this agent will stream the response in real-time as it generates text"},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]},{"displayName":"Max Tokens To Read From Memory","name":"maxTokensFromMemory","type":"hidden","default":0,"description":"The maximum number of tokens to read from the chat memory history. Set to 0 to read all history."},{"displayName":"Force Tool Call on First Iteration","name":"forceToolCallOnFirstIteration","type":"boolean","default":false,"description":"Whether the model must call at least one tool on its first response of each run. Later responses are unrestricted so the agent can answer. Useful for smaller models that otherwise skip tool calls; the model must support forced tool choice."}]}],"hints":[{"message":"You are using streaming responses. Make sure to set the response mode to \"Streaming Response\" on the connected trigger node.","type":"warning","location":"outputPane","whenToDisplay":"afterExecution","displayCondition":"={{ $parameter[\"enableStreaming\"] === true }}"}]},
13
13
  {"displayName":"AI Agent","name":"agent","icon":"node:ai-agent","iconColor":"black","group":["transform"],"description":"Generates an action plan and executes it. Can use external tools.","codex":{"alias":["LangChain","Chat","Conversational","Plan and Execute","ReAct","Tools"],"categories":["AI"],"subcategories":{"AI":["Agents","Root Nodes"]},"resources":{"primaryDocumentation":[{"url":"https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/"}]}},"defaultVersion":3.1,"builderHint":{"searchHint":"Wire model/memory/tools/outputParser via the SDK `subnodes` config object using factory functions (`languageModel()`, `memory()`, `tool()`, `outputParser()`). Inside subnodes, reference upstream data with `nodeJson(triggerNode, 'path')`, not `$json` — subnodes do not share the main predecessor's item context.","relatedNodes":[{"nodeType":"n8n-nodes-base.aggregate","relationHint":"Use to combine multiple items together before the agent"},{"nodeType":"@n8n/n8n-nodes-langchain.outputParserStructured","relationHint":"Attach for structured output; reference fields as $json.output.fieldName for use in subsequent nodes (conditions, storing data)"},{"nodeType":"@n8n/n8n-nodes-langchain.agentTool","relationHint":"For multi-agent systems using orchestrator pattern"},{"nodeType":"@n8n/n8n-nodes-langchain.memoryBufferWindow","relationHint":"Required for conversational workflows - connect memory to every agent that needs to recall previous messages in the conversation"}],"extraTypeDefContent":[{"content":"<patterns>\n<pattern title=\"Agent with model, memory, structured output parser\">\nconst chatTrigger = trigger({\n type: '@n8n/n8n-nodes-langchain.chatTrigger',\n version: 1.3,\n config: {\n name: 'Chat Trigger',\n parameters: { public: false },\n output: [{ sessionId: 'chat-session-id', chatInput: 'Hello' }]\n }\n});\n\nconst model = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI Chat Model',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } },\n credentials: { openAiApi: { id: 'credId', name: 'OpenAI account' } }\n }\n});\n\nconst parser = outputParser({\n type: '@n8n/n8n-nodes-langchain.outputParserStructured',\n version: 1.3,\n config: {\n name: 'Output Parser',\n parameters: {\n schemaType: 'fromJson',\n jsonSchemaExample: '{ \"score\": 75, \"tier\": \"hot\" }'\n }\n }\n});\n\nconst memoryNode = memory({\n type: '@n8n/n8n-nodes-langchain.memoryBufferWindow',\n version: 1.3,\n config: {\n name: 'Conversation Memory',\n parameters: {\n sessionIdType: 'customKey',\n sessionKey: nodeJson(chatTrigger, 'sessionId'),\n contextWindowLength: 10\n }\n }\n});\n\nconst agent = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n hasOutputParser: true,\n options: { systemMessage: 'You are an expert...' }\n },\n subnodes: { model, memory: memoryNode, outputParser: parser }\n }\n});\n</pattern>\n\n<pattern title=\"Agent with a fallback model (primary + backup provider)\">\n// Give ONE agent a backup model with a FLAT model array: the first entry is the\n// primary, the second fills the agent's Fallback Model input. The agent retries\n// on the second model when the first call fails.\n// Do NOT build a second agent or an error-output branch for this — one agent.\n// A NESTED array (model: [[a, b]]) means something else: both models on the SAME\n// input, which is not a fallback.\n\nconst primaryModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n version: 1.6,\n config: {\n name: 'Claude (Primary)',\n parameters: { model: { __rl: true, mode: 'list', value: 'claude-sonnet-4-5' } }\n }\n});\n\nconst fallbackModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI (Fallback)',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } }\n }\n});\n\nconst agentWithFallback = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n options: { systemMessage: 'You are an expert...' },\n // REQUIRED with a second model: the agent only declares its Fallback Model\n // input when this is on. Without it the second model is wired to an input\n // that does not exist and never runs.\n needsFallback: true\n },\n subnodes: { model: [primaryModel, fallbackModel] }\n }\n});\n</pattern>\n</patterns>"}],"inputs":{"ai_languageModel":{"required":true},"ai_memory":{"required":false},"ai_tool":{"required":false},"ai_outputParser":{"required":false,"displayOptions":{"show":{"hasOutputParser":[true]}}}}},"version":[2,2.1,2.2],"defaults":{"name":"AI Agent","color":"#404040"},"inputs":"={{\n\t\t\t\t((hasOutputParser, needsFallback) => {\n\t\t\t\t\tfunction getInputs(hasMainInput, hasOutputParser, needsFallback) {\n const getInputData = (inputs) => {\n return inputs.map(({ type, filter, displayName, required }) => {\n const input = {\n type,\n displayName,\n required,\n maxConnections: ['ai_languageModel', 'ai_memory', 'ai_outputParser'].includes(type)\n ? 1\n : undefined,\n };\n if (filter) {\n input.filter = filter;\n }\n return input;\n });\n };\n let specialInputs = [\n {\n type: 'ai_languageModel',\n displayName: 'Chat Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n type: 'ai_languageModel',\n displayName: 'Fallback Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n displayName: 'Memory',\n type: 'ai_memory',\n },\n {\n displayName: 'Tool',\n type: 'ai_tool',\n },\n {\n displayName: 'Output Parser',\n type: 'ai_outputParser',\n },\n ];\n if (hasOutputParser === false) {\n specialInputs = specialInputs.filter((input) => input.type !== 'ai_outputParser');\n }\n if (needsFallback === false) {\n specialInputs = specialInputs.filter((input) => input.displayName !== 'Fallback Model');\n }\n const mainInputs = hasMainInput ? ['main'] : [];\n return [...mainInputs, ...getInputData(specialInputs)];\n};\n\t\t\t\t\treturn getInputs(true, hasOutputParser, needsFallback);\n\t\t\t\t})($parameter.hasOutputParser === undefined || $parameter.hasOutputParser === true, $parameter.needsFallback !== undefined && $parameter.needsFallback === true)\n\t\t\t}}","outputs":["main"],"properties":[{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Connected Guardrails Node","value":"guardrails","description":"Looks for an input field called 'guardrailsInput' that is coming from a directly connected Guardrails Node"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto"},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.guardrailsInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["guardrails"]}},"displayOptions":{"show":{"promptType":["guardrails"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["auto"]}},"displayOptions":{"show":{"promptType":["auto"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."},"displayOptions":{"show":{"promptType":["define"]}}},{"displayName":"Require Specific Output Format","name":"hasOutputParser","type":"boolean","default":false,"noDataExpression":true},{"displayName":"Connect an <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='ai_outputParser'>output parser</a> on the canvas to specify the output format you require","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true]}}},{"displayName":"Enable Fallback Model","name":"needsFallback","type":"boolean","default":false,"noDataExpression":true,"displayOptions":{"show":{"@version":[{"_cnd":{"gte":2.1}}]}}},{"displayName":"Connect an additional language model on the canvas to use it as a fallback if the main model fails","name":"fallbackNotice","type":"notice","default":"","displayOptions":{"show":{"needsFallback":[true]}}},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]},{"displayName":"Enable Streaming","name":"enableStreaming","type":"boolean","default":true,"description":"Whether this agent will stream the response in real-time as it generates text"}],"displayOptions":{"hide":{"@version":[{"_cnd":{"lt":2.2}}]}}},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]}],"displayOptions":{"show":{"@version":[{"_cnd":{"lt":2.2}}]}}}],"hints":[{"message":"You are using streaming responses. Make sure to set the response mode to \"Streaming Response\" on the connected trigger node.","type":"warning","location":"outputPane","whenToDisplay":"afterExecution","displayCondition":"={{ $parameter[\"enableStreaming\"] === true }}"}]},
14
- {"version":[1,1.1,1.2,1.3,1.4,1.5,1.6,1.7,1.8,1.9],"displayName":"AI Agent","name":"agent","icon":"node:ai-agent","iconColor":"black","group":["transform"],"description":"Generates an action plan and executes it. Can use external tools.","codex":{"alias":["LangChain","Chat","Conversational","Plan and Execute","ReAct","Tools"],"categories":["AI"],"subcategories":{"AI":["Agents","Root Nodes"]},"resources":{"primaryDocumentation":[{"url":"https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/"}]}},"defaultVersion":3.1,"builderHint":{"searchHint":"Wire model/memory/tools/outputParser via the SDK `subnodes` config object using factory functions (`languageModel()`, `memory()`, `tool()`, `outputParser()`). Inside subnodes, reference upstream data with `nodeJson(triggerNode, 'path')`, not `$json` — subnodes do not share the main predecessor's item context.","relatedNodes":[{"nodeType":"n8n-nodes-base.aggregate","relationHint":"Use to combine multiple items together before the agent"},{"nodeType":"@n8n/n8n-nodes-langchain.outputParserStructured","relationHint":"Attach for structured output; reference fields as $json.output.fieldName for use in subsequent nodes (conditions, storing data)"},{"nodeType":"@n8n/n8n-nodes-langchain.agentTool","relationHint":"For multi-agent systems using orchestrator pattern"},{"nodeType":"@n8n/n8n-nodes-langchain.memoryBufferWindow","relationHint":"Required for conversational workflows - connect memory to every agent that needs to recall previous messages in the conversation"}],"extraTypeDefContent":[{"content":"<patterns>\n<pattern title=\"Agent with model, memory, structured output parser\">\nconst chatTrigger = trigger({\n type: '@n8n/n8n-nodes-langchain.chatTrigger',\n version: 1.3,\n config: {\n name: 'Chat Trigger',\n parameters: { public: false },\n output: [{ sessionId: 'chat-session-id', chatInput: 'Hello' }]\n }\n});\n\nconst model = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI Chat Model',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } },\n credentials: { openAiApi: { id: 'credId', name: 'OpenAI account' } }\n }\n});\n\nconst parser = outputParser({\n type: '@n8n/n8n-nodes-langchain.outputParserStructured',\n version: 1.3,\n config: {\n name: 'Output Parser',\n parameters: {\n schemaType: 'fromJson',\n jsonSchemaExample: '{ \"score\": 75, \"tier\": \"hot\" }'\n }\n }\n});\n\nconst memoryNode = memory({\n type: '@n8n/n8n-nodes-langchain.memoryBufferWindow',\n version: 1.3,\n config: {\n name: 'Conversation Memory',\n parameters: {\n sessionIdType: 'customKey',\n sessionKey: nodeJson(chatTrigger, 'sessionId'),\n contextWindowLength: 10\n }\n }\n});\n\nconst agent = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n hasOutputParser: true,\n options: { systemMessage: 'You are an expert...' }\n },\n subnodes: { model, memory: memoryNode, outputParser: parser }\n }\n});\n</pattern>\n\n<pattern title=\"Agent with a fallback model (primary + backup provider)\">\n// Give ONE agent a backup model with a FLAT model array: the first entry is the\n// primary, the second fills the agent's Fallback Model input. The agent retries\n// on the second model when the first call fails.\n// Do NOT build a second agent or an error-output branch for this — one agent.\n// A NESTED array (model: [[a, b]]) means something else: both models on the SAME\n// input, which is not a fallback.\n\nconst primaryModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n version: 1.6,\n config: {\n name: 'Claude (Primary)',\n parameters: { model: { __rl: true, mode: 'list', value: 'claude-sonnet-4-5' } }\n }\n});\n\nconst fallbackModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI (Fallback)',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } }\n }\n});\n\nconst agentWithFallback = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n options: { systemMessage: 'You are an expert...' },\n // REQUIRED with a second model: the agent only declares its Fallback Model\n // input when this is on. Without it the second model is wired to an input\n // that does not exist and never runs.\n needsFallback: true\n },\n subnodes: { model: [primaryModel, fallbackModel] }\n }\n});\n</pattern>\n</patterns>"}],"inputs":{"ai_languageModel":{"required":true},"ai_memory":{"required":false},"ai_tool":{"required":false},"ai_outputParser":{"required":false,"displayOptions":{"show":{"hasOutputParser":[true]}}}}},"defaults":{"name":"AI Agent","color":"#404040"},"inputs":"={{\n\t\t\t\t((agent, hasOutputParser) => {\n\t\t\t\t\tfunction getInputs(agent, hasOutputParser) {\n const getInputData = (inputs) => {\n const displayNames = {\n ai_languageModel: 'Model',\n ai_memory: 'Memory',\n ai_tool: 'Tool',\n ai_outputParser: 'Output Parser',\n };\n return inputs.map(({ type, filter }) => {\n const isModelType = type === 'ai_languageModel';\n let displayName = type in displayNames ? displayNames[type] : undefined;\n if (isModelType &&\n ['openAiFunctionsAgent', 'toolsAgent', 'conversationalAgent'].includes(agent)) {\n displayName = 'Chat Model';\n }\n const input = {\n type,\n displayName,\n required: isModelType,\n maxConnections: ['ai_languageModel', 'ai_memory', 'ai_outputParser'].includes(type)\n ? 1\n : undefined,\n };\n if (filter) {\n input.filter = filter;\n }\n return input;\n });\n };\n let specialInputs = [];\n if (agent === 'conversationalAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n filter: {\n nodes: [\n '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n '@n8n/n8n-nodes-langchain.lmChatAwsBedrock',\n '@n8n/n8n-nodes-langchain.lmChatGroq',\n '@n8n/n8n-nodes-langchain.lmChatLemonade',\n '@n8n/n8n-nodes-langchain.lmChatOllama',\n '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatGoogleGemini',\n '@n8n/n8n-nodes-langchain.lmChatGoogleVertex',\n '@n8n/n8n-nodes-langchain.lmChatMistralCloud',\n '@n8n/n8n-nodes-langchain.lmChatMinimax',\n '@n8n/n8n-nodes-langchain.lmChatMoonshot',\n '@n8n/n8n-nodes-langchain.lmChatAzureOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatDeepSeek',\n '@n8n/n8n-nodes-langchain.lmChatOpenRouter',\n '@n8n/n8n-nodes-langchain.lmChatVercelAiGateway',\n '@n8n/n8n-nodes-langchain.lmChatXAiGrok',\n '@n8n/n8n-nodes-langchain.modelSelector',\n ],\n },\n },\n {\n type: 'ai_memory',\n },\n {\n type: 'ai_tool',\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'toolsAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n filter: {\n nodes: [\n '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n '@n8n/n8n-nodes-langchain.lmChatAzureOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatAwsBedrock',\n '@n8n/n8n-nodes-langchain.lmChatLemonade',\n '@n8n/n8n-nodes-langchain.lmChatMistralCloud',\n '@n8n/n8n-nodes-langchain.lmChatMinimax',\n '@n8n/n8n-nodes-langchain.lmChatMoonshot',\n '@n8n/n8n-nodes-langchain.lmChatOllama',\n '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatGroq',\n '@n8n/n8n-nodes-langchain.lmChatGoogleVertex',\n '@n8n/n8n-nodes-langchain.lmChatGoogleGemini',\n '@n8n/n8n-nodes-langchain.lmChatDeepSeek',\n '@n8n/n8n-nodes-langchain.lmChatOpenRouter',\n '@n8n/n8n-nodes-langchain.lmChatVercelAiGateway',\n '@n8n/n8n-nodes-langchain.lmChatXAiGrok',\n ],\n },\n },\n {\n type: 'ai_memory',\n },\n {\n type: 'ai_tool',\n required: true,\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'openAiFunctionsAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n filter: {\n nodes: [\n '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatAzureOpenAi',\n ],\n },\n },\n {\n type: 'ai_memory',\n },\n {\n type: 'ai_tool',\n required: true,\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'reActAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n },\n {\n type: 'ai_tool',\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'sqlAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n },\n {\n type: 'ai_memory',\n },\n ];\n }\n else if (agent === 'planAndExecuteAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n },\n {\n type: 'ai_tool',\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n if (hasOutputParser === false) {\n specialInputs = specialInputs.filter((input) => input.type !== 'ai_outputParser');\n }\n return ['main', ...getInputData(specialInputs)];\n};\n\t\t\t\t\treturn getInputs(agent, hasOutputParser)\n\t\t\t\t})($parameter.agent, $parameter.hasOutputParser === undefined || $parameter.hasOutputParser === true)\n\t\t\t}}","outputs":["main"],"credentials":[{"name":"mySql","required":true,"testedBy":"mysqlConnectionTest","displayOptions":{"show":{"agent":["sqlAgent"],"/dataSource":["mysql"]}}},{"name":"postgres","required":true,"displayOptions":{"show":{"agent":["sqlAgent"],"/dataSource":["postgres"]}}}],"properties":[{"displayName":"This node is using Agent that has been deprecated. Please switch to using 'Tools Agent' instead.","name":"deprecated","type":"notice","default":"","displayOptions":{"show":{"agent":["conversationalAgent","openAiFunctionsAgent","planAndExecuteAgent","reActAgent","sqlAgent"]}}},{"displayName":"Agent","name":"agent","type":"options","noDataExpression":true,"options":[{"name":"Conversational Agent","value":"conversationalAgent","description":"Describes tools in the system prompt and parses JSON responses for tool calls. More flexible but potentially less reliable than the Tools Agent. Suitable for simpler interactions or with models not supporting structured schemas."},{"name":"OpenAI Functions Agent","value":"openAiFunctionsAgent","description":"Leverages OpenAI's function calling capabilities to precisely select and execute tools. Excellent for tasks requiring structured outputs when working with OpenAI models."},{"name":"Plan and Execute Agent","value":"planAndExecuteAgent","description":"Creates a high-level plan for complex tasks and then executes each step. Suitable for multi-stage problems or when a strategic approach is needed."},{"name":"ReAct Agent","value":"reActAgent","description":"Combines reasoning and action in an iterative process. Effective for tasks that require careful analysis and step-by-step problem-solving."},{"name":"SQL Agent","value":"sqlAgent","description":"Specializes in interacting with SQL databases. Ideal for data analysis tasks, generating queries, or extracting insights from structured data."}],"default":"conversationalAgent","displayOptions":{"show":{"@version":[{"_cnd":{"lte":1.5}}]}}},{"displayName":"Agent","name":"agent","type":"options","noDataExpression":true,"options":[{"name":"Tools Agent","value":"toolsAgent","description":"Utilizes structured tool schemas for precise and reliable tool selection and execution. Recommended for complex tasks requiring accurate and consistent tool usage, but only usable with models that support tool calling."},{"name":"Conversational Agent","value":"conversationalAgent","description":"Describes tools in the system prompt and parses JSON responses for tool calls. More flexible but potentially less reliable than the Tools Agent. Suitable for simpler interactions or with models not supporting structured schemas."},{"name":"OpenAI Functions Agent","value":"openAiFunctionsAgent","description":"Leverages OpenAI's function calling capabilities to precisely select and execute tools. Excellent for tasks requiring structured outputs when working with OpenAI models."},{"name":"Plan and Execute Agent","value":"planAndExecuteAgent","description":"Creates a high-level plan for complex tasks and then executes each step. Suitable for multi-stage problems or when a strategic approach is needed."},{"name":"ReAct Agent","value":"reActAgent","description":"Combines reasoning and action in an iterative process. Effective for tasks that require careful analysis and step-by-step problem-solving."},{"name":"SQL Agent","value":"sqlAgent","description":"Specializes in interacting with SQL databases. Ideal for data analysis tasks, generating queries, or extracting insights from structured data."}],"default":"toolsAgent","displayOptions":{"show":{"@version":[{"_cnd":{"between":{"from":1.6,"to":1.7}}}]}}},{"displayName":"Agent","name":"agent","type":"hidden","noDataExpression":true,"options":[{"name":"Tools Agent","value":"toolsAgent","description":"Utilizes structured tool schemas for precise and reliable tool selection and execution. Recommended for complex tasks requiring accurate and consistent tool usage, but only usable with models that support tool calling."},{"name":"Conversational Agent","value":"conversationalAgent","description":"Describes tools in the system prompt and parses JSON responses for tool calls. More flexible but potentially less reliable than the Tools Agent. Suitable for simpler interactions or with models not supporting structured schemas."},{"name":"OpenAI Functions Agent","value":"openAiFunctionsAgent","description":"Leverages OpenAI's function calling capabilities to precisely select and execute tools. Excellent for tasks requiring structured outputs when working with OpenAI models."},{"name":"Plan and Execute Agent","value":"planAndExecuteAgent","description":"Creates a high-level plan for complex tasks and then executes each step. Suitable for multi-stage problems or when a strategic approach is needed."},{"name":"ReAct Agent","value":"reActAgent","description":"Combines reasoning and action in an iterative process. Effective for tasks that require careful analysis and step-by-step problem-solving."},{"name":"SQL Agent","value":"sqlAgent","description":"Specializes in interacting with SQL databases. Ideal for data analysis tasks, generating queries, or extracting insights from structured data."}],"default":"toolsAgent","displayOptions":{"show":{"@version":[{"_cnd":{"gte":1.8}}]}}},{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Connected Guardrails Node","value":"guardrails","description":"Looks for an input field called 'guardrailsInput' that is coming from a directly connected Guardrails Node"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto","displayOptions":{"hide":{"@version":[{"_cnd":{"lte":1.2}}],"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.guardrailsInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["guardrails"]}},"displayOptions":{"show":{"promptType":["guardrails"],"@version":[{"_cnd":{"gte":1.7}}]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["auto"]}},"displayOptions":{"show":{"promptType":["auto"],"@version":[{"_cnd":{"gte":1.7}}]},"hide":{"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."},"displayOptions":{"show":{"promptType":["define"]},"hide":{"agent":["sqlAgent"]}}},{"displayName":"For more reliable structured output parsing, consider using the Tools agent","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true],"agent":["conversationalAgent","reActAgent","planAndExecuteAgent","openAiFunctionsAgent"]}}},{"displayName":"Require Specific Output Format","name":"hasOutputParser","type":"boolean","default":false,"noDataExpression":true,"displayOptions":{"hide":{"@version":[{"_cnd":{"lte":1.2}}],"agent":["sqlAgent"]}}},{"displayName":"Connect an <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='ai_outputParser'>output parser</a> on the canvas to specify the output format you require","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true],"agent":["toolsAgent"]}}},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["toolsAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["conversationalAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["conversationalAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["conversationalAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["conversationalAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Human Message","name":"humanMessage","type":"string","default":"TOOLS\n------\nAssistant can ask the user to use tools to look up information that may be helpful in answering the users original question. The tools the human can use are:\n\n{tools}\n\n{format_instructions}\n\nUSER'S INPUT\n--------------------\nHere is the user's input (remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else):\n\n{{input}}","description":"The message that will provide the agent with a list of tools to use","typeOptions":{"rows":6}},{"displayName":"System Message","name":"systemMessage","type":"string","default":"Assistant is a large language model trained by OpenAI.\n\nAssistant is designed to be able to assist with a wide range of tasks, from answering simple questions to providing in-depth explanations and discussions on a wide range of topics. As a language model, Assistant is able to generate human-like text based on the input it receives, allowing it to engage in natural-sounding conversations and provide responses that are coherent and relevant to the topic at hand.\n\nAssistant is constantly learning and improving, and its capabilities are constantly evolving. It is able to process and understand large amounts of text, and can use this knowledge to provide accurate and informative responses to a wide range of questions. Additionally, Assistant is able to generate its own text based on the input it receives, allowing it to engage in discussions and provide explanations and descriptions on a wide range of topics.\n\nOverall, Assistant is a powerful system that can help with a wide range of tasks and provide valuable insights and information on a wide range of topics. Whether you need help with a specific question or just want to have a conversation about a particular topic, Assistant is here to assist.","description":"The message that will be sent to the agent before the conversation starts","typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["openAiFunctionsAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["openAiFunctionsAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["openAiFunctionsAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["openAiFunctionsAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful AI assistant.","description":"The message that will be sent to the agent before the conversation starts","typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["reActAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["reActAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["reActAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["reActAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Human Message Template","name":"humanMessageTemplate","type":"string","default":"{input}\n\n{agent_scratchpad}","description":"String to use directly as the human message template","typeOptions":{"rows":6}},{"displayName":"Prefix Message","name":"prefix","type":"string","default":"Answer the following questions as best you can. You have access to the following tools:","description":"String to put before the list of tools","typeOptions":{"rows":6}},{"displayName":"Suffix Message for Chat Model","name":"suffixChat","type":"string","default":"Begin! Reminder to always use the exact characters `Final Answer` when responding.","description":"String to put after the list of tools that will be used if chat model is used","typeOptions":{"rows":6}},{"displayName":"Suffix Message for Regular Model","name":"suffix","type":"string","default":"Begin!\n\n\tQuestion: {input}\n\tThought:{agent_scratchpad}","description":"String to put after the list of tools that will be used if regular model is used","typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Data Source","name":"dataSource","type":"options","displayOptions":{"show":{"agent":["sqlAgent"],"@version":[{"_cnd":{"lt":1.4}}]}},"default":"sqlite","description":"SQL database to connect to","options":[{"name":"MySQL","value":"mysql","description":"Connect to a MySQL database"},{"name":"Postgres","value":"postgres","description":"Connect to a Postgres database"},{"name":"SQLite","value":"sqlite","description":"Use SQLite by connecting a database file as binary input"}]},{"displayName":"Data Source","name":"dataSource","type":"options","displayOptions":{"show":{"agent":["sqlAgent"],"@version":[{"_cnd":{"gte":1.4}}]}},"default":"postgres","description":"SQL database to connect to","options":[{"name":"MySQL","value":"mysql","description":"Connect to a MySQL database"},{"name":"Postgres","value":"postgres","description":"Connect to a Postgres database"},{"name":"SQLite","value":"sqlite","description":"Use SQLite by connecting a database file as binary input"}]},{"displayName":"Credentials","name":"credentials","type":"credentials","default":""},{"displayName":"Pass the SQLite database into this node as binary data, e.g. by inserting a 'Read/Write Files from Disk' node beforehand","name":"sqLiteFileNotice","type":"notice","default":"","displayOptions":{"show":{"agent":["sqlAgent"],"dataSource":["sqlite"]}}},{"displayName":"Input Binary Field","name":"binaryPropertyName","type":"string","default":"data","required":true,"placeholder":"e.g data","hint":"The name of the input binary field containing the file to be extracted","displayOptions":{"show":{"agent":["sqlAgent"],"dataSource":["sqlite"]}}},{"displayName":"Prompt","name":"input","type":"string","displayOptions":{"show":{"agent":["sqlAgent"],"@version":[{"_cnd":{"lte":1.2}}]}},"default":"","required":true,"typeOptions":{"rows":5}},{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Connected Guardrails Node","value":"guardrails","description":"Looks for an input field called 'guardrailsInput' that is coming from a directly connected Guardrails Node"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto","displayOptions":{"hide":{"@version":[{"_cnd":{"lte":1.2}}]},"show":{"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.guardrailsInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["guardrails"]}},"displayOptions":{"show":{"promptType":["guardrails"],"@version":[{"_cnd":{"gte":1.7}}],"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["auto"]}},"displayOptions":{"show":{"promptType":["auto"],"@version":[{"_cnd":{"gte":1.7}}],"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."},"displayOptions":{"show":{"promptType":["define"],"agent":["sqlAgent"]}}},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["sqlAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Ignored Tables","name":"ignoredTables","type":"string","default":"","description":"Comma-separated list of tables to ignore from the database. If empty, no tables are ignored."},{"displayName":"Include Sample Rows","name":"includedSampleRows","type":"number","description":"Number of sample rows to include in the prompt to the agent. It helps the agent to understand the schema of the database but it also increases the amount of tokens used.","default":3},{"displayName":"Included Tables","name":"includedTables","type":"string","default":"","description":"Comma-separated list of tables to include in the database. If empty, all tables are included."},{"displayName":"Prefix Prompt","name":"prefixPrompt","type":"string","default":"You are an agent designed to interact with an SQL database.\nGiven an input question, create a syntactically correct {dialect} query to run, then look at the results of the query and return the answer.\nUnless the user specifies a specific number of examples they wish to obtain, always limit your query to at most {top_k} results using the LIMIT clause.\nYou can order the results by a relevant column to return the most interesting examples in the database.\nNever query for all the columns from a specific table, only ask for a the few relevant columns given the question.\nYou have access to tools for interacting with the database.\nOnly use the below tools. Only use the information returned by the below tools to construct your final answer.\nYou MUST double check your query before executing it. If you get an error while executing a query, rewrite the query and try again.\n\nDO NOT make any DML statements (INSERT, UPDATE, DELETE, DROP etc.) to the database.\n\nIf the question does not seem related to the database, just return \"I don't know\" as the answer.","description":"Prefix prompt to use for the agent","typeOptions":{"rows":10}},{"displayName":"Suffix Prompt","name":"suffixPrompt","type":"string","default":"Begin!\nChat History:\n{chatHistory}\n\nQuestion: {input}\nThought: I should look at the tables in the database to see what I can query.\n{agent_scratchpad}","description":"Suffix prompt to use for the agent","typeOptions":{"rows":4}},{"displayName":"Limit","name":"topK","type":"number","default":10,"description":"The maximum number of results to return"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["planAndExecuteAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["planAndExecuteAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["planAndExecuteAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["planAndExecuteAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Human Message Template","name":"humanMessageTemplate","type":"string","default":"Previous steps: {previous_steps}\n\nCurrent objective: {current_step}\n\n{agent_scratchpad}\n\nYou may extract and combine relevant data from your previous steps when responding to me.","description":"The message that will be sent to the agent during each step execution","typeOptions":{"rows":6}},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]}]},
14
+ {"version":[1,1.1,1.2,1.3,1.4,1.5,1.6,1.7,1.8,1.9],"displayName":"AI Agent","name":"agent","icon":"node:ai-agent","iconColor":"black","group":["transform"],"description":"Generates an action plan and executes it. Can use external tools.","codex":{"alias":["LangChain","Chat","Conversational","Plan and Execute","ReAct","Tools"],"categories":["AI"],"subcategories":{"AI":["Agents","Root Nodes"]},"resources":{"primaryDocumentation":[{"url":"https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/"}]}},"defaultVersion":3.1,"builderHint":{"searchHint":"Wire model/memory/tools/outputParser via the SDK `subnodes` config object using factory functions (`languageModel()`, `memory()`, `tool()`, `outputParser()`). Inside subnodes, reference upstream data with `nodeJson(triggerNode, 'path')`, not `$json` — subnodes do not share the main predecessor's item context.","relatedNodes":[{"nodeType":"n8n-nodes-base.aggregate","relationHint":"Use to combine multiple items together before the agent"},{"nodeType":"@n8n/n8n-nodes-langchain.outputParserStructured","relationHint":"Attach for structured output; reference fields as $json.output.fieldName for use in subsequent nodes (conditions, storing data)"},{"nodeType":"@n8n/n8n-nodes-langchain.agentTool","relationHint":"For multi-agent systems using orchestrator pattern"},{"nodeType":"@n8n/n8n-nodes-langchain.memoryBufferWindow","relationHint":"Required for conversational workflows - connect memory to every agent that needs to recall previous messages in the conversation"}],"extraTypeDefContent":[{"content":"<patterns>\n<pattern title=\"Agent with model, memory, structured output parser\">\nconst chatTrigger = trigger({\n type: '@n8n/n8n-nodes-langchain.chatTrigger',\n version: 1.3,\n config: {\n name: 'Chat Trigger',\n parameters: { public: false },\n output: [{ sessionId: 'chat-session-id', chatInput: 'Hello' }]\n }\n});\n\nconst model = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI Chat Model',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } },\n credentials: { openAiApi: { id: 'credId', name: 'OpenAI account' } }\n }\n});\n\nconst parser = outputParser({\n type: '@n8n/n8n-nodes-langchain.outputParserStructured',\n version: 1.3,\n config: {\n name: 'Output Parser',\n parameters: {\n schemaType: 'fromJson',\n jsonSchemaExample: '{ \"score\": 75, \"tier\": \"hot\" }'\n }\n }\n});\n\nconst memoryNode = memory({\n type: '@n8n/n8n-nodes-langchain.memoryBufferWindow',\n version: 1.3,\n config: {\n name: 'Conversation Memory',\n parameters: {\n sessionIdType: 'customKey',\n sessionKey: nodeJson(chatTrigger, 'sessionId'),\n contextWindowLength: 10\n }\n }\n});\n\nconst agent = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n hasOutputParser: true,\n options: { systemMessage: 'You are an expert...' }\n },\n subnodes: { model, memory: memoryNode, outputParser: parser }\n }\n});\n</pattern>\n\n<pattern title=\"Agent with a fallback model (primary + backup provider)\">\n// Give ONE agent a backup model with a FLAT model array: the first entry is the\n// primary, the second fills the agent's Fallback Model input. The agent retries\n// on the second model when the first call fails.\n// Do NOT build a second agent or an error-output branch for this — one agent.\n// A NESTED array (model: [[a, b]]) means something else: both models on the SAME\n// input, which is not a fallback.\n\nconst primaryModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n version: 1.6,\n config: {\n name: 'Claude (Primary)',\n parameters: { model: { __rl: true, mode: 'list', value: 'claude-sonnet-4-5' } }\n }\n});\n\nconst fallbackModel = languageModel({\n type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n version: 1.3,\n config: {\n name: 'OpenAI (Fallback)',\n parameters: { model: { __rl: true, mode: 'list', value: 'gpt-5.4' } }\n }\n});\n\nconst agentWithFallback = node({\n type: '@n8n/n8n-nodes-langchain.agent',\n version: 3.1,\n config: {\n name: 'AI Agent',\n parameters: {\n promptType: 'define',\n text: expr('{{ $json.prompt }}'),\n options: { systemMessage: 'You are an expert...' },\n // REQUIRED with a second model: the agent only declares its Fallback Model\n // input when this is on. Without it the second model is wired to an input\n // that does not exist and never runs.\n needsFallback: true\n },\n subnodes: { model: [primaryModel, fallbackModel] }\n }\n});\n</pattern>\n</patterns>"}],"inputs":{"ai_languageModel":{"required":true},"ai_memory":{"required":false},"ai_tool":{"required":false},"ai_outputParser":{"required":false,"displayOptions":{"show":{"hasOutputParser":[true]}}}}},"defaults":{"name":"AI Agent","color":"#404040"},"inputs":"={{\n\t\t\t\t((agent, hasOutputParser) => {\n\t\t\t\t\tfunction getInputs(agent, hasOutputParser) {\n const getInputData = (inputs) => {\n const displayNames = {\n ai_languageModel: 'Model',\n ai_memory: 'Memory',\n ai_tool: 'Tool',\n ai_outputParser: 'Output Parser',\n };\n return inputs.map(({ type, filter }) => {\n const isModelType = type === 'ai_languageModel';\n let displayName = type in displayNames ? displayNames[type] : undefined;\n if (isModelType &&\n ['openAiFunctionsAgent', 'toolsAgent', 'conversationalAgent'].includes(agent)) {\n displayName = 'Chat Model';\n }\n const input = {\n type,\n displayName,\n required: isModelType,\n maxConnections: ['ai_languageModel', 'ai_memory', 'ai_outputParser'].includes(type)\n ? 1\n : undefined,\n };\n if (filter) {\n input.filter = filter;\n }\n return input;\n });\n };\n let specialInputs = [];\n if (agent === 'conversationalAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n filter: {\n nodes: [\n '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n '@n8n/n8n-nodes-langchain.lmChatAwsBedrock',\n '@n8n/n8n-nodes-langchain.lmChatGroq',\n '@n8n/n8n-nodes-langchain.lmChatLemonade',\n '@n8n/n8n-nodes-langchain.lmChatOllama',\n '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatGoogleGemini',\n '@n8n/n8n-nodes-langchain.lmChatGoogleVertex',\n '@n8n/n8n-nodes-langchain.lmChatMistralCloud',\n '@n8n/n8n-nodes-langchain.lmChatMinimax',\n '@n8n/n8n-nodes-langchain.lmChatMoonshot',\n '@n8n/n8n-nodes-langchain.lmChatAzureOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatDeepSeek',\n '@n8n/n8n-nodes-langchain.lmChatOpenRouter',\n '@n8n/n8n-nodes-langchain.lmChatVercelAiGateway',\n '@n8n/n8n-nodes-langchain.lmChatXAiGrok',\n '@n8n/n8n-nodes-langchain.modelSelector',\n ],\n },\n },\n {\n type: 'ai_memory',\n },\n {\n type: 'ai_tool',\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'toolsAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n filter: {\n nodes: [\n '@n8n/n8n-nodes-langchain.lmChatAnthropic',\n '@n8n/n8n-nodes-langchain.lmChatAzureOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatAwsBedrock',\n '@n8n/n8n-nodes-langchain.lmChatLemonade',\n '@n8n/n8n-nodes-langchain.lmChatMistralCloud',\n '@n8n/n8n-nodes-langchain.lmChatMinimax',\n '@n8n/n8n-nodes-langchain.lmChatMoonshot',\n '@n8n/n8n-nodes-langchain.lmChatOllama',\n '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatGroq',\n '@n8n/n8n-nodes-langchain.lmChatGoogleVertex',\n '@n8n/n8n-nodes-langchain.lmChatGoogleGemini',\n '@n8n/n8n-nodes-langchain.lmChatDeepSeek',\n '@n8n/n8n-nodes-langchain.lmChatOpenRouter',\n '@n8n/n8n-nodes-langchain.lmChatVercelAiGateway',\n '@n8n/n8n-nodes-langchain.lmChatXAiGrok',\n ],\n },\n },\n {\n type: 'ai_memory',\n },\n {\n type: 'ai_tool',\n required: true,\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'openAiFunctionsAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n filter: {\n nodes: [\n '@n8n/n8n-nodes-langchain.lmChatOpenAi',\n '@n8n/n8n-nodes-langchain.lmChatAzureOpenAi',\n ],\n },\n },\n {\n type: 'ai_memory',\n },\n {\n type: 'ai_tool',\n required: true,\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'reActAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n },\n {\n type: 'ai_tool',\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n else if (agent === 'sqlAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n },\n {\n type: 'ai_memory',\n },\n ];\n }\n else if (agent === 'planAndExecuteAgent') {\n specialInputs = [\n {\n type: 'ai_languageModel',\n },\n {\n type: 'ai_tool',\n },\n {\n type: 'ai_outputParser',\n },\n ];\n }\n if (hasOutputParser === false) {\n specialInputs = specialInputs.filter((input) => input.type !== 'ai_outputParser');\n }\n return ['main', ...getInputData(specialInputs)];\n};\n\t\t\t\t\treturn getInputs(agent, hasOutputParser)\n\t\t\t\t})($parameter.agent, $parameter.hasOutputParser === undefined || $parameter.hasOutputParser === true)\n\t\t\t}}","outputs":["main"],"credentials":[{"name":"mySql","required":true,"testedBy":"mysqlConnectionTest","displayOptions":{"show":{"agent":["sqlAgent"],"/dataSource":["mysql"]}}},{"name":"postgres","required":true,"displayOptions":{"show":{"agent":["sqlAgent"],"/dataSource":["postgres"]}}}],"properties":[{"displayName":"This mode is deprecated and is removed in n8n v3. After the update, this node will fail when executed. Replace it with an AI Agent on the latest version and reconnect its model, memory and tools.","name":"deprecated","type":"notice","default":"","displayOptions":{"show":{"agent":["conversationalAgent","openAiFunctionsAgent","planAndExecuteAgent","reActAgent"]}}},{"displayName":"This mode is deprecated and is removed in n8n v3. After the update, this node will fail when executed. Replace it with an AI Agent on the latest version, reconnect its model and memory, and connect a database tool, such as Postgres or MySQL, to keep querying your database.","name":"deprecatedSqlAgent","type":"notice","default":"","displayOptions":{"show":{"agent":["sqlAgent"]}}},{"displayName":"Agent","name":"agent","type":"options","noDataExpression":true,"options":[{"name":"Conversational Agent","value":"conversationalAgent","description":"Describes tools in the system prompt and parses JSON responses for tool calls. More flexible but potentially less reliable than the Tools Agent. Suitable for simpler interactions or with models not supporting structured schemas."},{"name":"OpenAI Functions Agent","value":"openAiFunctionsAgent","description":"Leverages OpenAI's function calling capabilities to precisely select and execute tools. Excellent for tasks requiring structured outputs when working with OpenAI models."},{"name":"Plan and Execute Agent","value":"planAndExecuteAgent","description":"Creates a high-level plan for complex tasks and then executes each step. Suitable for multi-stage problems or when a strategic approach is needed."},{"name":"ReAct Agent","value":"reActAgent","description":"Combines reasoning and action in an iterative process. Effective for tasks that require careful analysis and step-by-step problem-solving."},{"name":"SQL Agent","value":"sqlAgent","description":"Specializes in interacting with SQL databases. Ideal for data analysis tasks, generating queries, or extracting insights from structured data."}],"default":"conversationalAgent","displayOptions":{"show":{"@version":[{"_cnd":{"lte":1.5}}]}}},{"displayName":"Agent","name":"agent","type":"options","noDataExpression":true,"options":[{"name":"Tools Agent","value":"toolsAgent","description":"Utilizes structured tool schemas for precise and reliable tool selection and execution. Recommended for complex tasks requiring accurate and consistent tool usage, but only usable with models that support tool calling."},{"name":"Conversational Agent","value":"conversationalAgent","description":"Describes tools in the system prompt and parses JSON responses for tool calls. More flexible but potentially less reliable than the Tools Agent. Suitable for simpler interactions or with models not supporting structured schemas."},{"name":"OpenAI Functions Agent","value":"openAiFunctionsAgent","description":"Leverages OpenAI's function calling capabilities to precisely select and execute tools. Excellent for tasks requiring structured outputs when working with OpenAI models."},{"name":"Plan and Execute Agent","value":"planAndExecuteAgent","description":"Creates a high-level plan for complex tasks and then executes each step. Suitable for multi-stage problems or when a strategic approach is needed."},{"name":"ReAct Agent","value":"reActAgent","description":"Combines reasoning and action in an iterative process. Effective for tasks that require careful analysis and step-by-step problem-solving."},{"name":"SQL Agent","value":"sqlAgent","description":"Specializes in interacting with SQL databases. Ideal for data analysis tasks, generating queries, or extracting insights from structured data."}],"default":"toolsAgent","displayOptions":{"show":{"@version":[{"_cnd":{"between":{"from":1.6,"to":1.7}}}]}}},{"displayName":"Agent","name":"agent","type":"hidden","noDataExpression":true,"options":[{"name":"Tools Agent","value":"toolsAgent","description":"Utilizes structured tool schemas for precise and reliable tool selection and execution. Recommended for complex tasks requiring accurate and consistent tool usage, but only usable with models that support tool calling."},{"name":"Conversational Agent","value":"conversationalAgent","description":"Describes tools in the system prompt and parses JSON responses for tool calls. More flexible but potentially less reliable than the Tools Agent. Suitable for simpler interactions or with models not supporting structured schemas."},{"name":"OpenAI Functions Agent","value":"openAiFunctionsAgent","description":"Leverages OpenAI's function calling capabilities to precisely select and execute tools. Excellent for tasks requiring structured outputs when working with OpenAI models."},{"name":"Plan and Execute Agent","value":"planAndExecuteAgent","description":"Creates a high-level plan for complex tasks and then executes each step. Suitable for multi-stage problems or when a strategic approach is needed."},{"name":"ReAct Agent","value":"reActAgent","description":"Combines reasoning and action in an iterative process. Effective for tasks that require careful analysis and step-by-step problem-solving."},{"name":"SQL Agent","value":"sqlAgent","description":"Specializes in interacting with SQL databases. Ideal for data analysis tasks, generating queries, or extracting insights from structured data."}],"default":"toolsAgent","displayOptions":{"show":{"@version":[{"_cnd":{"gte":1.8}}]}}},{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Connected Guardrails Node","value":"guardrails","description":"Looks for an input field called 'guardrailsInput' that is coming from a directly connected Guardrails Node"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto","displayOptions":{"hide":{"@version":[{"_cnd":{"lte":1.2}}],"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.guardrailsInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["guardrails"]}},"displayOptions":{"show":{"promptType":["guardrails"],"@version":[{"_cnd":{"gte":1.7}}]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["auto"]}},"displayOptions":{"show":{"promptType":["auto"],"@version":[{"_cnd":{"gte":1.7}}]},"hide":{"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."},"displayOptions":{"show":{"promptType":["define"]},"hide":{"agent":["sqlAgent"]}}},{"displayName":"For more reliable structured output parsing, consider using the Tools agent","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true],"agent":["conversationalAgent","reActAgent","planAndExecuteAgent","openAiFunctionsAgent"]}}},{"displayName":"Require Specific Output Format","name":"hasOutputParser","type":"boolean","default":false,"noDataExpression":true,"displayOptions":{"hide":{"@version":[{"_cnd":{"lte":1.2}}],"agent":["sqlAgent"]}}},{"displayName":"Connect an <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='ai_outputParser'>output parser</a> on the canvas to specify the output format you require","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true],"agent":["toolsAgent"]}}},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["toolsAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["conversationalAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["conversationalAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["conversationalAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["conversationalAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Human Message","name":"humanMessage","type":"string","default":"TOOLS\n------\nAssistant can ask the user to use tools to look up information that may be helpful in answering the users original question. The tools the human can use are:\n\n{tools}\n\n{format_instructions}\n\nUSER'S INPUT\n--------------------\nHere is the user's input (remember to respond with a markdown code snippet of a json blob with a single action, and NOTHING else):\n\n{{input}}","description":"The message that will provide the agent with a list of tools to use","typeOptions":{"rows":6}},{"displayName":"System Message","name":"systemMessage","type":"string","default":"Assistant is a large language model trained by OpenAI.\n\nAssistant is designed to be able to assist with a wide range of tasks, from answering simple questions to providing in-depth explanations and discussions on a wide range of topics. As a language model, Assistant is able to generate human-like text based on the input it receives, allowing it to engage in natural-sounding conversations and provide responses that are coherent and relevant to the topic at hand.\n\nAssistant is constantly learning and improving, and its capabilities are constantly evolving. It is able to process and understand large amounts of text, and can use this knowledge to provide accurate and informative responses to a wide range of questions. Additionally, Assistant is able to generate its own text based on the input it receives, allowing it to engage in discussions and provide explanations and descriptions on a wide range of topics.\n\nOverall, Assistant is a powerful system that can help with a wide range of tasks and provide valuable insights and information on a wide range of topics. Whether you need help with a specific question or just want to have a conversation about a particular topic, Assistant is here to assist.","description":"The message that will be sent to the agent before the conversation starts","typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["openAiFunctionsAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["openAiFunctionsAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["openAiFunctionsAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["openAiFunctionsAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful AI assistant.","description":"The message that will be sent to the agent before the conversation starts","typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["reActAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["reActAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["reActAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["reActAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Human Message Template","name":"humanMessageTemplate","type":"string","default":"{input}\n\n{agent_scratchpad}","description":"String to use directly as the human message template","typeOptions":{"rows":6}},{"displayName":"Prefix Message","name":"prefix","type":"string","default":"Answer the following questions as best you can. You have access to the following tools:","description":"String to put before the list of tools","typeOptions":{"rows":6}},{"displayName":"Suffix Message for Chat Model","name":"suffixChat","type":"string","default":"Begin! Reminder to always use the exact characters `Final Answer` when responding.","description":"String to put after the list of tools that will be used if chat model is used","typeOptions":{"rows":6}},{"displayName":"Suffix Message for Regular Model","name":"suffix","type":"string","default":"Begin!\n\n\tQuestion: {input}\n\tThought:{agent_scratchpad}","description":"String to put after the list of tools that will be used if regular model is used","typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Data Source","name":"dataSource","type":"options","displayOptions":{"show":{"agent":["sqlAgent"],"@version":[{"_cnd":{"lt":1.4}}]}},"default":"sqlite","description":"SQL database to connect to","options":[{"name":"MySQL","value":"mysql","description":"Connect to a MySQL database"},{"name":"Postgres","value":"postgres","description":"Connect to a Postgres database"},{"name":"SQLite","value":"sqlite","description":"Use SQLite by connecting a database file as binary input"}]},{"displayName":"Data Source","name":"dataSource","type":"options","displayOptions":{"show":{"agent":["sqlAgent"],"@version":[{"_cnd":{"gte":1.4}}]}},"default":"postgres","description":"SQL database to connect to","options":[{"name":"MySQL","value":"mysql","description":"Connect to a MySQL database"},{"name":"Postgres","value":"postgres","description":"Connect to a Postgres database"},{"name":"SQLite","value":"sqlite","description":"Use SQLite by connecting a database file as binary input"}]},{"displayName":"Credentials","name":"credentials","type":"credentials","default":""},{"displayName":"Pass the SQLite database into this node as binary data, e.g. by inserting a 'Read/Write Files from Disk' node beforehand","name":"sqLiteFileNotice","type":"notice","default":"","displayOptions":{"show":{"agent":["sqlAgent"],"dataSource":["sqlite"]}}},{"displayName":"Input Binary Field","name":"binaryPropertyName","type":"string","default":"data","required":true,"placeholder":"e.g data","hint":"The name of the input binary field containing the file to be extracted","displayOptions":{"show":{"agent":["sqlAgent"],"dataSource":["sqlite"]}}},{"displayName":"Prompt","name":"input","type":"string","displayOptions":{"show":{"agent":["sqlAgent"],"@version":[{"_cnd":{"lte":1.2}}]}},"default":"","required":true,"typeOptions":{"rows":5}},{"displayName":"Source for Prompt (User Message)","name":"promptType","type":"options","options":[{"name":"Connected Chat Trigger Node","value":"auto","description":"Looks for an input field called 'chatInput' that is coming from a directly connected Chat Trigger"},{"name":"Connected Guardrails Node","value":"guardrails","description":"Looks for an input field called 'guardrailsInput' that is coming from a directly connected Guardrails Node"},{"name":"Define below","value":"define","description":"Use an expression to reference data in previous nodes or enter static text"}],"default":"auto","displayOptions":{"hide":{"@version":[{"_cnd":{"lte":1.2}}]},"show":{"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.guardrailsInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["guardrails"]}},"displayOptions":{"show":{"promptType":["guardrails"],"@version":[{"_cnd":{"gte":1.7}}],"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","typeOptions":{"rows":2},"disabledOptions":{"show":{"promptType":["auto"]}},"displayOptions":{"show":{"promptType":["auto"],"@version":[{"_cnd":{"gte":1.7}}],"agent":["sqlAgent"]}}},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."},"displayOptions":{"show":{"promptType":["define"],"agent":["sqlAgent"]}}},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["sqlAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Ignored Tables","name":"ignoredTables","type":"string","default":"","description":"Comma-separated list of tables to ignore from the database. If empty, no tables are ignored."},{"displayName":"Include Sample Rows","name":"includedSampleRows","type":"number","description":"Number of sample rows to include in the prompt to the agent. It helps the agent to understand the schema of the database but it also increases the amount of tokens used.","default":3},{"displayName":"Included Tables","name":"includedTables","type":"string","default":"","description":"Comma-separated list of tables to include in the database. If empty, all tables are included."},{"displayName":"Prefix Prompt","name":"prefixPrompt","type":"string","default":"You are an agent designed to interact with an SQL database.\nGiven an input question, create a syntactically correct {dialect} query to run, then look at the results of the query and return the answer.\nUnless the user specifies a specific number of examples they wish to obtain, always limit your query to at most {top_k} results using the LIMIT clause.\nYou can order the results by a relevant column to return the most interesting examples in the database.\nNever query for all the columns from a specific table, only ask for a the few relevant columns given the question.\nYou have access to tools for interacting with the database.\nOnly use the below tools. Only use the information returned by the below tools to construct your final answer.\nYou MUST double check your query before executing it. If you get an error while executing a query, rewrite the query and try again.\n\nDO NOT make any DML statements (INSERT, UPDATE, DELETE, DROP etc.) to the database.\n\nIf the question does not seem related to the database, just return \"I don't know\" as the answer.","description":"Prefix prompt to use for the agent","typeOptions":{"rows":10}},{"displayName":"Suffix Prompt","name":"suffixPrompt","type":"string","default":"Begin!\nChat History:\n{chatHistory}\n\nQuestion: {input}\nThought: I should look at the tables in the database to see what I can query.\n{agent_scratchpad}","description":"Suffix prompt to use for the agent","typeOptions":{"rows":4}},{"displayName":"Limit","name":"topK","type":"number","default":10,"description":"The maximum number of results to return"},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["planAndExecuteAgent"],"@version":[1]}},"default":"={{ $json.input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["planAndExecuteAgent"],"@version":[1.1]}},"default":"={{ $json.chat_input }}"},{"displayName":"Text","name":"text","type":"string","required":true,"displayOptions":{"show":{"agent":["planAndExecuteAgent"],"@version":[1.2]}},"default":"={{ $json.chatInput }}"},{"displayName":"Options","name":"options","type":"collection","displayOptions":{"show":{"agent":["planAndExecuteAgent"]}},"default":{},"placeholder":"Add Option","options":[{"displayName":"Human Message Template","name":"humanMessageTemplate","type":"string","default":"Previous steps: {previous_steps}\n\nCurrent objective: {current_step}\n\n{agent_scratchpad}\n\nYou may extract and combine relevant data from your previous steps when responding to me.","description":"The message that will be sent to the agent during each step execution","typeOptions":{"rows":6}},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]}]}]},
15
15
  {"displayName":"AI Agent Tool","name":"agentTool","icon":"fa:robot","iconColor":"black","group":["transform"],"description":"Generates an action plan and executes it. Can use external tools.","codex":{"alias":["LangChain","Chat","Conversational","Plan and Execute","ReAct","Tools"],"categories":["AI"],"subcategories":{"AI":["Tools"],"Tools":["Recommended Tools"]}},"defaultVersion":3,"version":[2.2],"defaults":{"name":"AI Agent Tool","color":"#404040"},"inputs":"={{\n\t\t\t\t((hasOutputParser, needsFallback) => {\n\t\t\t\t\tfunction getInputs(hasMainInput, hasOutputParser, needsFallback) {\n const getInputData = (inputs) => {\n return inputs.map(({ type, filter, displayName, required }) => {\n const input = {\n type,\n displayName,\n required,\n maxConnections: ['ai_languageModel', 'ai_memory', 'ai_outputParser'].includes(type)\n ? 1\n : undefined,\n };\n if (filter) {\n input.filter = filter;\n }\n return input;\n });\n };\n let specialInputs = [\n {\n type: 'ai_languageModel',\n displayName: 'Chat Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n type: 'ai_languageModel',\n displayName: 'Fallback Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n displayName: 'Memory',\n type: 'ai_memory',\n },\n {\n displayName: 'Tool',\n type: 'ai_tool',\n },\n {\n displayName: 'Output Parser',\n type: 'ai_outputParser',\n },\n ];\n if (hasOutputParser === false) {\n specialInputs = specialInputs.filter((input) => input.type !== 'ai_outputParser');\n }\n if (needsFallback === false) {\n specialInputs = specialInputs.filter((input) => input.displayName !== 'Fallback Model');\n }\n const mainInputs = hasMainInput ? ['main'] : [];\n return [...mainInputs, ...getInputData(specialInputs)];\n};\n\t\t\t\t\treturn getInputs(false, hasOutputParser, needsFallback)\n\t\t\t\t})($parameter.hasOutputParser === undefined || $parameter.hasOutputParser === true, $parameter.needsFallback !== undefined && $parameter.needsFallback === true)\n\t\t\t}}","outputs":["ai_tool"],"builderHint":{"inputs":{"ai_languageModel":{"required":true},"ai_memory":{"required":false},"ai_tool":{"required":false},"ai_outputParser":{"required":false,"displayOptions":{"show":{"hasOutputParser":[true]}}}}},"properties":[{"displayName":"Description","name":"toolDescription","type":"string","default":"AI Agent that can call other tools","required":true,"typeOptions":{"rows":2},"description":"Explain to the LLM what this tool does, a good, specific description would allow LLMs to produce expected results much more often"},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."}},{"displayName":"Require Specific Output Format","name":"hasOutputParser","type":"boolean","default":false,"noDataExpression":true},{"displayName":"Connect an <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='ai_outputParser'>output parser</a> on the canvas to specify the output format you require","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true]}}},{"displayName":"Enable Fallback Model","name":"needsFallback","type":"boolean","default":false,"noDataExpression":true,"displayOptions":{"show":{"@version":[{"_cnd":{"gte":2.1}}]}}},{"displayName":"Connect an additional language model on the canvas to use it as a fallback if the main model fails","name":"fallbackNotice","type":"notice","default":"","displayOptions":{"show":{"needsFallback":[true]}}},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]}],"displayOptions":{"hide":{"@version":[{"_cnd":{"lt":2.2}}]}}},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]}],"displayOptions":{"show":{"@version":[{"_cnd":{"lt":2.2}}]}}}]},
16
16
  {"displayName":"AI Agent Tool","name":"agentTool","icon":"fa:robot","iconColor":"black","group":["transform"],"description":"Generates an action plan and executes it. Can use external tools.","codex":{"alias":["LangChain","Chat","Conversational","Plan and Execute","ReAct","Tools"],"categories":["AI"],"subcategories":{"AI":["Tools"],"Tools":["Recommended Tools"]}},"defaultVersion":3,"version":[3],"defaults":{"name":"AI Agent Tool","color":"#404040"},"inputs":"={{\n\t\t\t\t((hasOutputParser, needsFallback) => {\n\t\t\t\t\tfunction getInputs(hasMainInput, hasOutputParser, needsFallback) {\n const getInputData = (inputs) => {\n return inputs.map(({ type, filter, displayName, required }) => {\n const input = {\n type,\n displayName,\n required,\n maxConnections: ['ai_languageModel', 'ai_memory', 'ai_outputParser'].includes(type)\n ? 1\n : undefined,\n };\n if (filter) {\n input.filter = filter;\n }\n return input;\n });\n };\n let specialInputs = [\n {\n type: 'ai_languageModel',\n displayName: 'Chat Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n type: 'ai_languageModel',\n displayName: 'Fallback Model',\n required: true,\n filter: {\n excludedNodes: [\n '@n8n/n8n-nodes-langchain.lmCohere',\n '@n8n/n8n-nodes-langchain.lmOllama',\n 'n8n/n8n-nodes-langchain.lmOpenAi',\n '@n8n/n8n-nodes-langchain.lmOpenHuggingFaceInference',\n ],\n },\n },\n {\n displayName: 'Memory',\n type: 'ai_memory',\n },\n {\n displayName: 'Tool',\n type: 'ai_tool',\n },\n {\n displayName: 'Output Parser',\n type: 'ai_outputParser',\n },\n ];\n if (hasOutputParser === false) {\n specialInputs = specialInputs.filter((input) => input.type !== 'ai_outputParser');\n }\n if (needsFallback === false) {\n specialInputs = specialInputs.filter((input) => input.displayName !== 'Fallback Model');\n }\n const mainInputs = hasMainInput ? ['main'] : [];\n return [...mainInputs, ...getInputData(specialInputs)];\n};\n\t\t\t\t\treturn getInputs(false, hasOutputParser, needsFallback)\n\t\t\t\t})($parameter.hasOutputParser === undefined || $parameter.hasOutputParser === true, $parameter.needsFallback !== undefined && $parameter.needsFallback === true)\n\t\t\t}}","outputs":["ai_tool"],"builderHint":{"inputs":{"ai_languageModel":{"required":true},"ai_memory":{"required":false},"ai_tool":{"required":false},"ai_outputParser":{"required":false,"displayOptions":{"show":{"hasOutputParser":[true]}}}}},"properties":[{"displayName":"Description","name":"toolDescription","type":"string","default":"AI Agent that can call other tools","required":true,"typeOptions":{"rows":2},"description":"Explain to the LLM what this tool does, a good, specific description would allow LLMs to produce expected results much more often"},{"displayName":"Prompt (User Message)","name":"text","type":"string","required":true,"default":"","placeholder":"e.g. Hello, how can you help me?","typeOptions":{"rows":2},"builderHint":{"placeholderSupported":false,"propertyHint":"Use expressions to include dynamic data from previous nodes (e.g., expr('{{ $json.input }}')). Static text prompts ignore incoming data."}},{"displayName":"Require Specific Output Format","name":"hasOutputParser","type":"boolean","default":false,"noDataExpression":true,"builderHint":{"propertyHint":"Set to `true` when you need structured JSON output. The agent then requires an `outputParser` entry in its `subnodes` config (typically an `outputParserStructured` node defined via the `outputParser({...})` SDK factory). With `hasOutputParser: false` the agent returns a plain string in `$json.output`."}},{"displayName":"Connect an <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='ai_outputParser'>output parser</a> on the canvas to specify the output format you require","name":"notice","type":"notice","default":"","displayOptions":{"show":{"hasOutputParser":[true]}}},{"displayName":"Enable Fallback Model","name":"needsFallback","type":"boolean","default":false,"noDataExpression":true},{"displayName":"Connect an additional language model on the canvas to use it as a fallback if the main model fails","name":"fallbackNotice","type":"notice","default":"","displayOptions":{"show":{"needsFallback":[true]}}},{"displayName":"Options","name":"options","type":"collection","default":{},"placeholder":"Add Option","options":[{"displayName":"System Message","name":"systemMessage","type":"string","default":"You are a helpful assistant","description":"The message that will be sent to the agent before the conversation starts","builderHint":{"propertyHint":"Must include: agent's purpose, exact names of connected tools, and response instructions"},"typeOptions":{"rows":6}},{"displayName":"Max Iterations","name":"maxIterations","type":"number","default":10,"description":"The maximum number of iterations the agent will run before stopping"},{"displayName":"Return Intermediate Steps","name":"returnIntermediateSteps","type":"boolean","default":false,"description":"Whether or not the output should include intermediate steps the agent took"},{"displayName":"Automatically Passthrough Binary Images","name":"passthroughBinaryImages","type":"boolean","default":true,"description":"Whether or not binary images should be automatically passed through to the agent as image type messages"},{"displayName":"Automatically Passthrough Binary PDFs","name":"passthroughBinaryPdfs","type":"boolean","default":false,"description":"Whether or not binary PDF documents should be automatically passed through to the agent. Useful for models that natively support PDF input (e.g. Google Gemini)."},{"displayName":"Tracing Metadata","name":"tracingMetadata","type":"fixedCollection","typeOptions":{"multipleValues":true},"default":{},"placeholder":"Add Metadata","description":"Custom metadata added to tracing events","options":[{"displayName":"Metadata","name":"values","values":[{"displayName":"Key","name":"key","type":"string","default":""},{"displayName":"Type","name":"type","type":"options","description":"The field value type","options":[{"name":"Array","value":"arrayValue"},{"name":"Boolean","value":"booleanValue"},{"name":"Number","value":"numberValue"},{"name":"Object","value":"objectValue"},{"name":"String","value":"stringValue"}],"default":"stringValue"},{"displayName":"Value","name":"stringValue","type":"string","default":"","displayOptions":{"show":{"type":["stringValue"]}}},{"displayName":"Value","name":"numberValue","type":"string","default":"","displayOptions":{"show":{"type":["numberValue"]}},"validateType":"number"},{"displayName":"Value","name":"booleanValue","type":"options","default":"true","options":[{"name":"True","value":"true"},{"name":"False","value":"false"}],"displayOptions":{"show":{"type":["booleanValue"]}}},{"displayName":"Value","name":"arrayValue","type":"string","default":"","placeholder":"e.g. [ arrayItem1, arrayItem2, arrayItem3 ]","displayOptions":{"show":{"type":["arrayValue"]}},"validateType":"array"},{"displayName":"Value","name":"objectValue","type":"json","default":"={}","typeOptions":{"rows":2},"displayOptions":{"show":{"type":["objectValue"]}},"validateType":"object"}]}]},{"displayName":"Auto-save highlighted data","name":"autoSaveHighlightedData","type":"boolean","default":true,"description":"Whether to automatically save <a href=\"https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.executiondata/\" target=\"_blank\">highlighted data</a>. This data can then be used to filter executions in the Executions view. Available on Pro and Enterprise plans in n8n Cloud, and on Enterprise or registered Community Edition for self-hosted. Defaults to true."},{"displayName":"Enable Streaming","name":"enableStreaming","type":"boolean","default":true,"description":"Whether this agent will stream the response in real-time as it generates text"},{"displayName":"Batch Processing","name":"batching","type":"collection","placeholder":"Add Batch Processing Option","description":"Batch processing options for rate limiting","default":{},"options":[{"displayName":"Batch Size","name":"batchSize","default":1,"type":"number","description":"How many items to process in parallel. This is useful for rate limiting, but might impact the log output ordering."},{"displayName":"Delay Between Batches","name":"delayBetweenBatches","default":0,"type":"number","description":"Delay in milliseconds between batches. This is useful for rate limiting."}]},{"displayName":"Max Tokens To Read From Memory","name":"maxTokensFromMemory","type":"hidden","default":0,"description":"The maximum number of tokens to read from the chat memory history. Set to 0 to read all history."},{"displayName":"Force Tool Call on First Iteration","name":"forceToolCallOnFirstIteration","type":"boolean","default":false,"description":"Whether the model must call at least one tool on its first response of each run. Later responses are unrestricted so the agent can answer. Useful for smaller models that otherwise skip tool calls; the model must support forced tool choice."}]}]},
17
17
  {"displayName":"OpenAI Assistant","name":"openAiAssistant","hidden":true,"icon":"fa:robot","group":["transform"],"version":[1,1.1],"description":"Utilizes Assistant API from Open AI.","subtitle":"Open AI Assistant","defaults":{"name":"OpenAI Assistant","color":"#404040"},"codex":{"alias":["LangChain"],"categories":["AI"],"subcategories":{"AI":["Agents","Root Nodes"]},"resources":{"primaryDocumentation":[{"url":"https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-langchain.openai/assistant-operations"}]}},"inputs":[{"type":"main"},{"type":"ai_tool","displayName":"Tools"}],"outputs":["main"],"builderHint":{"inputs":{"ai_tool":{"required":false}}},"credentials":[{"name":"openAiApi","required":true}],"requestDefaults":{"ignoreHttpStatusErrors":true,"baseURL":"={{ $parameter.options?.baseURL?.split(\"/\").slice(0,-1).join(\"/\") || \"https://api.openai.com\" }}"},"properties":[{"displayName":"Operation","name":"mode","type":"options","noDataExpression":true,"default":"existing","options":[{"name":"Use New Assistant","value":"new"},{"name":"Use Existing Assistant","value":"existing"}]},{"displayName":"Name","name":"name","type":"string","default":"","required":true,"displayOptions":{"show":{"/mode":["new"]}}},{"displayName":"Instructions","name":"instructions","type":"string","description":"How the Assistant and model should behave or respond","default":"","typeOptions":{"rows":5},"displayOptions":{"show":{"/mode":["new"]}}},{"displayName":"Model","name":"model","type":"options","description":"The model which will be used to power the assistant. <a href=\"https://developers.openai.com/api/docs/models\">Learn more</a>. The Retrieval tool requires gpt-3.5-turbo-1106 and gpt-4-1106-preview models.","required":true,"displayOptions":{"show":{"/mode":["new"]}},"typeOptions":{"loadOptions":{"routing":{"request":{"method":"GET","url":"={{ $parameter.options?.baseURL?.split(\"/\").slice(-1).pop() || \"v1\" }}/models"},"output":{"postReceive":[{"type":"rootProperty","properties":{"property":"data"}},{"type":"filter","properties":{"pass":"={{ $responseItem.id.startsWith('gpt-') && !$responseItem.id.includes('instruct') }}"}},{"type":"setKeyValue","properties":{"name":"={{$responseItem.id}}","value":"={{$responseItem.id}}"}},{"type":"sort","properties":{"key":"name"}}]}}}},"routing":{"send":{"type":"body","property":"model"}},"default":"gpt-3.5-turbo-1106"},{"displayName":"Assistant","name":"assistantId","type":"options","noDataExpression":true,"displayOptions":{"show":{"/mode":["existing"]}},"description":"The assistant to use. <a href=\"https://developers.openai.com/api/docs/assistants/migration\">Learn more</a>.","typeOptions":{"loadOptions":{"routing":{"request":{"method":"GET","headers":{"OpenAI-Beta":"assistants=v1"},"url":"={{ $parameter.options?.baseURL?.split(\"/\").slice(-1).pop() || \"v1\" }}/assistants"},"output":{"postReceive":[{"type":"rootProperty","properties":{"property":"data"}},{"type":"setKeyValue","properties":{"name":"={{$responseItem.name}}","value":"={{$responseItem.id}}","description":"={{$responseItem.model}}"}},{"type":"sort","properties":{"key":"name"}}]}}}},"routing":{"send":{"type":"body","property":"assistant"}},"required":true,"default":""},{"displayName":"Text","name":"text","type":"string","required":true,"default":"={{ $json.chat_input }}","displayOptions":{"show":{"@version":[1]}}},{"displayName":"Text","name":"text","type":"string","required":true,"default":"={{ $json.chatInput }}","displayOptions":{"show":{"@version":[1.1]}}},{"displayName":"OpenAI Tools","name":"nativeTools","type":"multiOptions","default":[],"options":[{"name":"Code Interpreter","value":"code_interpreter"},{"name":"Knowledge Retrieval","value":"retrieval"}]},{"displayName":"Connect your own custom tools to this node on the canvas","name":"noticeTools","type":"notice","default":""},{"displayName":"Upload files for retrieval using the <a href=\"https://platform.openai.com/playground\" target=\"_blank\">OpenAI website<a/>","name":"noticeTools","type":"notice","typeOptions":{"noticeTheme":"info"},"displayOptions":{"show":{"/nativeTools":["retrieval"]}},"default":""},{"displayName":"Options","name":"options","placeholder":"Add Option","description":"Additional options to add","type":"collection","default":{},"options":[{"displayName":"Base URL","name":"baseURL","default":"https://api.openai.com/v1","description":"Override the default base URL for the API","type":"string"},{"displayName":"Max Retries","name":"maxRetries","default":2,"description":"Maximum number of retries to attempt","type":"number"},{"displayName":"Timeout","name":"timeout","default":10000,"description":"Maximum amount of time a request is allowed to take in milliseconds","type":"number"}]}]},
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@n8n/n8n-nodes-langchain",
3
- "version": "2.46.4",
3
+ "version": "2.46.5",
4
4
  "description": "",
5
5
  "main": "index.js",
6
6
  "exports": {
@@ -265,8 +265,8 @@
265
265
  "@mistralai/mistralai": "^2.2.1",
266
266
  "@modelcontextprotocol/sdk": "1.31.0",
267
267
  "@mozilla/readability": "^0.6.0",
268
- "@n8n/ai-utilities": "0.39.4",
269
- "@n8n/client-oauth2": "1.28.4",
268
+ "@n8n/ai-utilities": "0.39.5",
269
+ "@n8n/client-oauth2": "1.28.5",
270
270
  "@n8n/config": "2.44.1",
271
271
  "@n8n/di": "0.17.0",
272
272
  "@n8n/json-schema-to-zod": "1.18.0",
@@ -300,9 +300,9 @@
300
300
  "mime-types": "3.0.2",
301
301
  "mongodb": "^6.17.0",
302
302
  "mysql2": "3.23.1",
303
- "n8n-core": "2.46.4",
304
- "n8n-nodes-base": "2.46.4",
305
- "n8n-workflow": "2.46.4",
303
+ "n8n-core": "2.46.5",
304
+ "n8n-nodes-base": "2.46.5",
305
+ "n8n-workflow": "2.46.5",
306
306
  "openai": "6.46.0",
307
307
  "oracledb": "6.10.0",
308
308
  "pg": "8.21.0",