feat(AI Transform Node): New node

[michael-radency]

Summary

This PR introduces a new "AI Transform"* node that generates code snippets based on user instructions. The AI is context-aware, understanding the workflow's nodes and their data types. Users can simply enter their instructions and click the "Generate Code" button to let the AI automatically populate the Code parameter.

---

During development, the node's "button" property was improved:

export type NodePropertyAction = {
	type: 'askAiCodeGeneration';
	handler?: string;
	target?: string;
};

export interface INodePropertyTypeOptions {
	
	buttonConfig?: {
		action?: string | NodePropertyAction;
		label?: string; 
		hasInputField?: boolean;
		inputFieldMaxLength?: number; 
	};
	...
}

This updated interface allows you to specify a label, an optional input field with its maximum input length, and an action. The action can be specified as a string or as a NodePropertyAction, which allows you to set the type of action (currently only 'askAiCodeGeneration') and optionally an action target, such as a parameter that would be affected as a result of this action. Additionally, a handler function defined in methods.actionHandler can be executed on the backend when clicked.

	methods = {
		actionHandler: {
			async generateCode(this: ILoadOptionsFunctions, payload: IDataObject | string | undefined) {
				const url = this.getNodeParameter('url', 0) as string;
				let body: IDataObject = {};
				if (payload) {
					body = typeof payload === 'string' ? jsonParse(payload) : payload;
				}
				const response = (await this.helpers.httpRequest({
					method: 'POST',
					url,
					headers: {
						'Content-Type': 'application/json',
					},
					body,
				})) as {
					data: { code: string };
				};

				return response?.data?.code;
			},
		},
	};

---

• This node is currently available only on the cloud.

Related Linear tickets, Github issues, and Community forum posts

https://linear.app/n8n/issue/NODE-1461/ai-transform-node-p0

[elsmr]

Is this not being used? (this endpoint in general)

[michael-radency]

not currently, but this is part of button parameter where you could use handler assigned in buttonConfig similar to loadOptions, usage example here

[elsmr]

This function is duplicated in utils, but not used

[ShireenMissi]

LGTM 🎉

[cypress]

---

Test summary

395 • 0 • 0 • 0 • 1

---

Run details

Project	n8n
Status	Passed
Commit	0de9d56
Started	Aug 8, 2024 3:12 AM
Ended	Aug 8, 2024 3:17 AM
Duration	04:56 💡
OS	Linux Debian -
Browser	Electron 118

View run in Cypress Cloud ➡️

---

Flakiness

	e2e/5-ndv.cy.ts		1
1	NDV > test output schema view > should display large schema

---

This comment has been generated by cypress-bot as a result of this project's GitHub integration settings. You can manage this integration in this project's settings in the Cypress Cloud

[github-actions]

✅ All Cypress E2E specs passed

[janober]

Got released with n8n@1.55.0