feat: Add AI tool building capabilities (#7336)

Github issue / Community forum post (link here to close automatically): https://community.n8n.io/t/langchain-memory-chat/23733 --------- Signed-off-by: Oleg Ivaniv <me@olegivaniv.com> Co-authored-by: Oleg Ivaniv <me@olegivaniv.com> Co-authored-by: Val <68596159+valya@users.noreply.github.com> Co-authored-by: Alex Grozav <alex@grozav.com> Co-authored-by: कारतोफ्फेलस्क्रिप्ट™ <aditya@netroy.in> Co-authored-by: Deborah <deborah@starfallprojects.co.uk> Co-authored-by: Jesper Bylund <mail@jesperbylund.com> Co-authored-by: Jon <jonathan.bennetts@gmail.com> Co-authored-by: Michael Kret <88898367+michael-radency@users.noreply.github.com> Co-authored-by: Giulio Andreini <andreini@netseven.it> Co-authored-by: Mason Geloso <Mason.geloso@gmail.com> Co-authored-by: Mason Geloso <hone@Masons-Mac-mini.local> Co-authored-by: Mutasem Aldmour <mutasem@n8n.io>
2025-12-17 10:02:05 +00:00 · 2023-11-29 12:13:55 +01:00
parent dbfd617ace
commit 87def60979
243 changed files with 21526 additions and 321 deletions
--- a/packages/@n8n/nodes-langchain/utils/sharedFields.ts
+++ b/packages/@n8n/nodes-langchain/utils/sharedFields.ts
@@ -0,0 +1,141 @@
+import { NodeConnectionType, type INodeProperties } from 'n8n-workflow';
+
+export const metadataFilterField: INodeProperties = {
+	displayName: 'Metadata Filter',
+	name: 'metadata',
+	type: 'fixedCollection',
+	description: 'Metadata to filter the document by',
+	typeOptions: {
+		multipleValues: true,
+	},
+	default: {},
+	placeholder: 'Add filter field',
+	options: [
+		{
+			name: 'metadataValues',
+			displayName: 'Fields to Set',
+			values: [
+				{
+					displayName: 'Name',
+					name: 'name',
+					type: 'string',
+					default: '',
+					required: true,
+				},
+				{
+					displayName: 'Value',
+					name: 'value',
+					type: 'string',
+					default: '',
+				},
+			],
+		},
+	],
+};
+
+export function getTemplateNoticeField(templateId: number): INodeProperties {
+	return {
+		displayName: `Save time with an <a href="/templates/${templateId}" target="_blank">example</a> of how this node works`,
+		name: 'notice',
+		type: 'notice',
+		default: '',
+	};
+}
+
+const connectionsString = {
+	[NodeConnectionType.AiAgent]: {
+		// Root AI view
+		connection: '',
+		locale: 'AI Agent',
+	},
+	[NodeConnectionType.AiChain]: {
+		// Root AI view
+		connection: '',
+		locale: 'AI Chain',
+	},
+	[NodeConnectionType.AiDocument]: {
+		connection: NodeConnectionType.AiDocument,
+		locale: 'Document Loader',
+	},
+	[NodeConnectionType.AiVectorStore]: {
+		connection: NodeConnectionType.AiVectorStore,
+		locale: 'Vector Store',
+	},
+	[NodeConnectionType.AiRetriever]: {
+		connection: NodeConnectionType.AiRetriever,
+		locale: 'Vector Store Retriever',
+	},
+};
+
+type AllowedConnectionTypes =
+	| NodeConnectionType.AiAgent
+	| NodeConnectionType.AiChain
+	| NodeConnectionType.AiDocument
+	| NodeConnectionType.AiVectorStore
+	| NodeConnectionType.AiRetriever;
+
+function determineArticle(nextWord: string): string {
+	// check if the next word starts with a vowel sound
+	const vowels = /^[aeiouAEIOU]/;
+	return vowels.test(nextWord) ? 'an' : 'a';
+}
+const getAhref = (connectionType: { connection: string; locale: string }) =>
+	`<a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='${connectionType.connection}'>${connectionType.locale}</a>`;
+
+export function getConnectionHintNoticeField(
+	connectionTypes: AllowedConnectionTypes[],
+): INodeProperties {
+	const groupedConnections = new Map<string, string[]>();
+
+	// group connection types by their 'connection' value
+	// to not create multiple links
+	connectionTypes.forEach((connectionType) => {
+		const connectionString = connectionsString[connectionType].connection;
+		const localeString = connectionsString[connectionType].locale;
+
+		if (!groupedConnections.has(connectionString)) {
+			groupedConnections.set(connectionString, [localeString]);
+			return;
+		}
+
+		groupedConnections.get(connectionString)?.push(localeString);
+	});
+
+	let displayName;
+
+	if (groupedConnections.size === 1) {
+		const [[connection, locales]] = Array.from(groupedConnections);
+		displayName = `This node must be connected to ${determineArticle(
+			locales[0],
+		)} ${locales[0].toLowerCase()}. <a data-action='openSelectiveNodeCreator' data-action-parameter-connectiontype='${connection}'>Insert one</a>`;
+	} else {
+		const ahrefs = Array.from(groupedConnections, ([connection, locales]) => {
+			// If there are multiple locales, join them with ' or '
+			// use determineArticle to insert the correct article
+			const locale =
+				locales.length > 1
+					? locales
+							.map((localeString, index, { length }) => {
+								return (
+									(index === 0 ? `${determineArticle(localeString)} ` : '') +
+									(index < length - 1 ? `${localeString} or ` : localeString)
+								);
+							})
+							.join('')
+					: `${determineArticle(locales[0])} ${locales[0]}`;
+			return getAhref({ connection, locale });
+		});
+
+		displayName = `This node needs to be connected to ${ahrefs.join(' or ')}.`;
+	}
+
+	return {
+		displayName,
+		name: 'notice',
+		type: 'notice',
+		default: '',
+		typeOptions: {
+			containerClass: 'ndv-connection-hint-notice',
+		},
+	};
+}