admin/n8n-enterprise-unlocked
1
0
Fork 0
mirror of https://github.com/Abdulazizzn/n8n-enterprise-unlocked.git synced 2025-12-16 17:46:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(editor): Add pre-built agents experiment (#18124)

Browse Source
This commit is contained in:
Jaakko Husso
2025-08-09 10:28:14 +03:00
committed by GitHub
parent a3b625fc18
commit 5a69d2a2f3
44 changed files with 2635 additions and 653 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
packages/@n8n/nodes-langchain/nodes/agents/Agent/V1/AgentV1.node.ts
View File

@@ -312,6 +312,20 @@ export class AgentV1 implements INodeType {
},
},
},
{
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName: 'Get started faster with our',
name: 'preBuiltAgentsCallout',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'pre-built agents',
icon: 'bot',
type: 'openPreBuiltAgentsCollection',
},
},
default: '',
},
{
displayName:
"This node is using Agent that has been deprecated. Please switch to using 'Tools Agent' instead.",

14
packages/@n8n/nodes-langchain/nodes/agents/Agent/V2/AgentV2.node.ts
View File

@@ -39,6 +39,20 @@ export class AgentV2 implements INodeType {
type: 'callout',
default: '',
},
{
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName: 'Get started faster with our',
name: 'preBuiltAgentsCallout',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'pre-built agents',
icon: 'bot',
type: 'openPreBuiltAgentsCollection',
},
},
default: '',
},
promptTypeOptions,
{
...textFromPreviousNode,

3
packages/@n8n/nodes-langchain/nodes/vector_store/shared/createVectorStoreNode/__snapshots__/createVectorStoreNode.test.ts.snap
View File

@@ -86,7 +86,8 @@ exports[`createVectorStoreNode retrieve mode supplies vector store as data 1`] =
"typeOptions": {
"calloutAction": {
"label": "RAG starter template",
"type": "openRagStarterTemplate",
"templateId": "rag-starter-template",
"type": "openSampleWorkflowTemplate",
},
},
},

3
packages/@n8n/nodes-langchain/nodes/vector_store/shared/createVectorStoreNode/createVectorStoreNode.ts
View File

@@ -32,7 +32,8 @@ const ragStarterCallout: INodeProperties = {
typeOptions: {
calloutAction: {
label: 'RAG starter template',
type: 'openRagStarterTemplate',
type: 'openSampleWorkflowTemplate',
templateId: 'rag-starter-template',
},
},
default: '',

30
packages/cli/src/__tests__/load-nodes-and-credentials.test.ts
View File

@@ -86,6 +86,36 @@ describe('LoadNodesAndCredentials', () => {
expect(toolDescriptionProp?.default).toBe(fullNodeWrapper.description.description);
});
it('should add toolDescription property after callout property', () => {
fullNodeWrapper.description.properties = [
{
displayName: 'Callout 1',
name: 'callout1',
type: 'callout',
default: '',
},
{
displayName: 'Callout 2',
name: 'callout2',
type: 'callout',
default: '',
},
{
displayName: 'Another',
name: 'another',
type: 'boolean',
default: true,
},
] satisfies INodeProperties[];
const result = instance.convertNodeToAiTool(fullNodeWrapper);
const toolDescriptionPropIndex = result.description.properties.findIndex(
(prop) => prop.name === 'toolDescription',
);
expect(toolDescriptionPropIndex).toBe(2);
expect(result.description.properties).toHaveLength(4);
});
it('should set codex categories correctly', () => {
const result = instance.convertNodeToAiTool(fullNodeWrapper);
expect(result.description.codex).toEqual({

16
packages/cli/src/load-nodes-and-credentials.ts
View File

@@ -188,6 +188,14 @@ export class LoadNodesAndCredentials {
return isContainedWithin(nodeParentPath, filePath) ? filePath : undefined;
}
findLastCalloutIndex(properties: INodeProperties[]): number {
for (let i = properties.length - 1; i >= 0; i--) {
if (properties[i].type === 'callout') return i;
}
return -1;
}
getCustomDirectories(): string[] {
const customDirectories = [this.instanceSettings.customExtensionDir];
@@ -486,12 +494,14 @@ export class LoadNodesAndCredentials {
'Explain to the LLM what this tool does, a good, specific description would allow LLMs to produce expected results much more often',
};
item.description.properties.unshift(descProp);
const lastCallout = this.findLastCalloutIndex(item.description.properties);
item.description.properties.splice(lastCallout + 1, 0, descProp);
// If node has resource or operation we can determine pre-populate tool description based on it
// so we add the descriptionType property as the first property
// so we add the descriptionType property as the first property after possible callout param(s).
if (hasResource || hasOperation) {
item.description.properties.unshift(descriptionType);
item.description.properties.splice(lastCallout + 1, 0, descriptionType);
descProp.displayOptions = {
show: {

2
packages/frontend/@n8n/i18n/src/locales/en.json
View File

@@ -1398,6 +1398,8 @@
"nodeCreator.nodeItem.triggerIconTitle": "Trigger Node",
"nodeCreator.nodeItem.aiIconTitle": "LangChain AI Node",
"nodeCreator.nodeItem.deprecated": "Deprecated",
"nodeCreator.preBuiltAgents.title": "Pre-built agents",
"nodeCreator.preBuiltAgents.description": "Get started faster with ready to go agents",
"nodeCredentials.createNew": "Create new credential",
"nodeCredentials.credentialFor": "Credential for {credentialType}",
"nodeCredentials.credentialsLabel": "Credential to connect with",

9
packages/frontend/editor-ui/src/Interface.ts
View File

@@ -645,11 +645,13 @@ export interface LinkItemProps {
}
export interface OpenTemplateItemProps {
key: 'rag-starter-template';
templateId: string;
title: string;
description: string;
icon: string;
nodes?: INodeTypeDescription[];
icon?: string;
tag?: NodeCreatorTag;
compact?: boolean;
}
export interface ActionTypeDescription extends SimplifiedNodeType {
@@ -922,7 +924,8 @@ export type NodeCreatorOpenSource =
| 'notice_error_message'
| 'add_node_button'
| 'add_evaluation_trigger_button'
| 'add_evaluation_node_button';
| 'add_evaluation_node_button'
| 'templates_callout';
export interface INodeCreatorState {
itemsFilter: string;

26
packages/frontend/editor-ui/src/components/Node/NodeCreator/ItemTypes/OpenTemplateItem.vue
View File

@@ -9,15 +9,15 @@ defineProps<Props>();
</script>
<template>
<n8n-node-creator-node
:class="$style.creatorOpenTemplate"
<N8nNodeCreatorNode
:class="{ [$style.creatorOpenTemplate]: true, [$style.compact]: openTemplate.compact }"
:title="openTemplate.title"
:is-trigger="false"
:description="openTemplate.description"
:tag="openTemplate.tag"
:show-action-arrow="true"
:is-trigger="false"
>
<template #icon>
<template v-if="openTemplate.icon" #icon>
<n8n-node-icon
type="icon"
:name="openTemplate.icon"
@@ -26,7 +26,17 @@ defineProps<Props>();
:use-updated-icons="true"
/>
</template>
</n8n-node-creator-node>
<template v-if="openTemplate.nodes" #extraDetails>
<NodeIcon
v-for="node in openTemplate.nodes"
:key="node.name"
:node-type="node"
:size="16"
:show-tooltip="true"
/>
</template>
</N8nNodeCreatorNode>
</template>
<style lang="scss" module>
@@ -34,5 +44,11 @@ defineProps<Props>();
--action-arrow-color: var(--color-text-light);
margin-left: var(--spacing-s);
margin-right: var(--spacing-xs);
padding-bottom: var(--spacing-xs);
margin-bottom: var(--spacing-xs);
}
.compact {
margin-left: 0;
padding-right: 0;
}
</style>

23
packages/frontend/editor-ui/src/components/Node/NodeCreator/Modes/ActionsMode.vue
View File

@@ -29,10 +29,11 @@ import { useTelemetry } from '@/composables/useTelemetry';
import { useI18n } from '@n8n/i18n';
import { useNodeCreatorStore } from '@/stores/nodeCreator.store';
import OrderSwitcher from './../OrderSwitcher.vue';
import { isNodePreviewKey } from '../utils';
import { getActiveViewCallouts, isNodePreviewKey } from '../utils';
import CommunityNodeInfo from '../Panel/CommunityNodeInfo.vue';
import CommunityNodeFooter from '../Panel/CommunityNodeFooter.vue';
import { useCalloutHelpers } from '@/composables/useCalloutHelpers';
const emit = defineEmits<{
nodeTypeSelected: [value: NodeTypeSelectedPayload[]];
@@ -53,6 +54,7 @@ const {
} = useActions();
const nodeCreatorStore = useNodeCreatorStore();
const calloutHelpers = useCalloutHelpers();
// We only inject labels if search is empty
const parsedTriggerActions = computed(() =>
@@ -159,6 +161,15 @@ function onKeySelect(activeItemId: string) {
}
function onSelected(actionCreateElement: INodeCreateElement) {
if (actionCreateElement.type === 'openTemplate') {
calloutHelpers.openSampleWorkflowTemplate(actionCreateElement.properties.templateId, {
telemetry: {
source: 'nodeCreator',
section: useViewStacks().activeViewStack.title,
},
});
}
if (actionCreateElement.type !== 'action') return;
const actionData = getActionData(actionCreateElement.properties);
@@ -234,6 +245,14 @@ function addHttpNode() {
onMounted(() => {
trackActionsView();
});
const callouts = computed<INodeCreateElement[]>(() =>
getActiveViewCallouts(
useViewStacks().activeViewStack.title,
calloutHelpers.isPreBuiltAgentsCalloutVisible.value,
calloutHelpers.getPreBuiltAgentNodeCreatorItems(),
),
);
</script>
<template>
@@ -243,6 +262,8 @@ onMounted(() => {
[$style.containerPaddingBottom]: !communityNodeDetails,
}"
>
<ItemsRenderer :elements="callouts" :class="$style.items" @selected="onSelected" />
<CommunityNodeInfo v-if="communityNodeDetails" />
<OrderSwitcher v-if="rootView" :root-view="rootView">
<template v-if="shouldShowTriggers" #triggers>

33
packages/frontend/editor-ui/src/components/Node/NodeCreator/Modes/NodesMode.vue
View File

@@ -16,6 +16,7 @@ import {
AI_NODE_CREATOR_VIEW,
AI_OTHERS_NODE_CREATOR_VIEW,
HITL_SUBCATEGORY,
PRE_BUILT_AGENTS_COLLECTION,
} from '@/constants';
import type { BaseTextKey } from '@n8n/i18n';
@@ -28,6 +29,7 @@ import {
prepareCommunityNodeDetailsViewStack,
transformNodeType,
getRootSearchCallouts,
getActiveViewCallouts,
shouldShowCommunityNodeDetails,
getHumanInTheLoopActions,
} from '../utils';
@@ -104,6 +106,17 @@ function getFilteredActions(
}
function onSelected(item: INodeCreateElement) {
if (item.key === PRE_BUILT_AGENTS_COLLECTION) {
void calloutHelpers.openPreBuiltAgentsCollection({
telemetry: {
source: 'nodeCreator',
section: activeViewStack.value.title,
},
resetStacks: false,
});
return;
}
if (item.type === 'subcategory') {
const subcategoryKey = camelCase(item.properties.title);
const title = i18n.baseText(`nodeCreator.subcategoryNames.${subcategoryKey}` as BaseTextKey);
@@ -223,9 +236,12 @@ function onSelected(item: INodeCreateElement) {
}
if (item.type === 'openTemplate') {
if (item.properties.key === 'rag-starter-template') {
void calloutHelpers.openRagStarterTemplate();
}
calloutHelpers.openSampleWorkflowTemplate(item.properties.templateId, {
telemetry: {
source: 'nodeCreator',
section: activeViewStack.value.title,
},
});
}
}
@@ -265,11 +281,16 @@ function baseSubcategoriesFilter(item: INodeCreateElement): boolean {
return hasActions || !hasTriggerGroup;
}
const globalCallouts = computed<INodeCreateElement[]>(() =>
getRootSearchCallouts(activeViewStack.value.search ?? '', {
const globalCallouts = computed<INodeCreateElement[]>(() => [
...getRootSearchCallouts(activeViewStack.value.search ?? '', {
isRagStarterCalloutVisible: calloutHelpers.isRagStarterCalloutVisible.value,
}),
);
...getActiveViewCallouts(
activeViewStack.value.title,
calloutHelpers.isPreBuiltAgentsCalloutVisible.value,
calloutHelpers.getPreBuiltAgentNodeCreatorItems(),
),
]);
function arrowLeft() {
popViewStack();

2
packages/frontend/editor-ui/src/components/Node/NodeCreator/Renderers/ItemsRenderer.vue
View File

@@ -305,6 +305,8 @@ watch(
&:last-child {
margin-top: 0;
padding-top: 0;
margin-bottom: 0;
padding-bottom: 0;
&:after {
content: none;

6
packages/frontend/editor-ui/src/components/Node/NodeCreator/__snapshots__/viewsData.spec.ts.snap
View File

@@ -8,7 +8,7 @@ exports[`viewsData > AIView > should return ai view with ai transform node 1`] =
"properties": {
"description": "See what's possible and get started 5x faster",
"icon": "box-open",
"name": "ai_templates_root",
"key": "ai_templates_root",
"tag": {
"text": "Recommended",
"type": "info",
@@ -81,7 +81,7 @@ exports[`viewsData > AIView > should return ai view without ai transform node if
"properties": {
"description": "See what's possible and get started 5x faster",
"icon": "box-open",
"name": "ai_templates_root",
"key": "ai_templates_root",
"tag": {
"text": "Recommended",
"type": "info",
@@ -141,7 +141,7 @@ exports[`viewsData > AIView > should return ai view without ai transform node if
"properties": {
"description": "See what's possible and get started 5x faster",
"icon": "box-open",
"name": "ai_templates_root",
"key": "ai_templates_root",
"tag": {
"text": "Recommended",
"type": "info",

152
packages/frontend/editor-ui/src/components/Node/NodeCreator/utils.ts
View File

@@ -7,17 +7,24 @@ import type {
SectionCreateElement,
ActionTypeDescription,
NodeFilterType,
OpenTemplateElement,
LinkCreateElement,
ViewCreateElement,
} from '@/Interface';
import {
AI_CATEGORY_AGENTS,
AI_CATEGORY_OTHER_TOOLS,
AI_CATEGORY_TOOLS,
AI_SUBCATEGORY,
AI_TRANSFORM_NODE_TYPE,
AI_CATEGORY_LANGUAGE_MODELS,
AI_CATEGORY_MEMORY,
CORE_NODES_CATEGORY,
DEFAULT_SUBCATEGORY,
DISCORD_NODE_TYPE,
HUMAN_IN_THE_LOOP_CATEGORY,
MICROSOFT_TEAMS_NODE_TYPE,
PRE_BUILT_AGENTS_COLLECTION,
} from '@/constants';
import { v4 as uuidv4 } from 'uuid';
@@ -28,10 +35,11 @@ import sortBy from 'lodash/sortBy';
import * as changeCase from 'change-case';
import { useSettingsStore } from '@/stores/settings.store';
import { useNodeTypesStore } from '@/stores/nodeTypes.store';
import { SEND_AND_WAIT_OPERATION } from 'n8n-workflow';
import type { NodeIconSource } from '../../../utils/nodeIcon';
import type { CommunityNodeDetails, ViewStack } from './composables/useViewStacks';
import { useNodeTypesStore } from '../../../stores/nodeTypes.store';
import { PrebuiltAgentTemplates, SampleTemplates } from '@/utils/templates/workflowSamples';
const COMMUNITY_NODE_TYPE_PREVIEW_TOKEN = '-preview';
@@ -308,30 +316,140 @@ export function prepareCommunityNodeDetailsViewStack(
};
}
export function getRootSearchCallouts(search: string, { isRagStarterCalloutVisible = false }) {
export function getRagStarterCallout(): OpenTemplateElement {
return {
uuid: SampleTemplates.RagStarterTemplate,
key: SampleTemplates.RagStarterTemplate,
type: 'openTemplate',
properties: {
templateId: SampleTemplates.RagStarterTemplate,
title: i18n.baseText('nodeCreator.ragStarterTemplate.openTemplateItem.title'),
icon: 'database',
description: i18n.baseText('nodeCreator.ragStarterTemplate.openTemplateItem.description'),
tag: {
type: 'info',
text: i18n.baseText('nodeCreator.triggerHelperPanel.manualTriggerTag'),
},
},
};
}
// Callout without a divider
export function getPreBuiltAgentsCallout(): ViewCreateElement {
return {
key: PRE_BUILT_AGENTS_COLLECTION,
type: 'view',
properties: {
title: i18n.baseText('nodeCreator.preBuiltAgents.title'),
icon: 'box',
description: i18n.baseText('nodeCreator.preBuiltAgents.description'),
borderless: true,
tag: {
type: 'info',
text: i18n.baseText('nodeCreator.triggerHelperPanel.manualTriggerTag'),
},
},
};
}
// Callout with divider after it
export function getPreBuiltAgentsCalloutWithDivider(): LinkCreateElement {
return {
key: PRE_BUILT_AGENTS_COLLECTION,
type: 'link',
properties: {
key: PRE_BUILT_AGENTS_COLLECTION,
url: '',
title: i18n.baseText('nodeCreator.preBuiltAgents.title'),
icon: 'box',
description: i18n.baseText('nodeCreator.preBuiltAgents.description'),
tag: {
type: 'info',
text: i18n.baseText('nodeCreator.triggerHelperPanel.manualTriggerTag'),
},
},
};
}
export function getAiTemplatesCallout(aiTemplatesURL: string): LinkCreateElement {
return {
key: 'ai_templates_root',
type: 'link',
properties: {
title: i18n.baseText('nodeCreator.aiPanel.linkItem.title'),
icon: 'box-open',
description: i18n.baseText('nodeCreator.aiPanel.linkItem.description'),
key: 'ai_templates_root',
url: aiTemplatesURL,
tag: {
type: 'info',
text: i18n.baseText('nodeCreator.triggerHelperPanel.manualTriggerTag'),
},
},
};
}
export function getRootSearchCallouts(search: string, { isRagStarterCalloutVisible = false } = {}) {
const results: INodeCreateElement[] = [];
const ragKeywords = ['rag', 'vec', 'know'];
if (isRagStarterCalloutVisible && ragKeywords.some((x) => search.toLowerCase().startsWith(x))) {
results.push({
uuid: 'rag-starter-template',
key: 'rag-starter-template',
type: 'openTemplate',
properties: {
key: 'rag-starter-template',
title: i18n.baseText('nodeCreator.ragStarterTemplate.openTemplateItem.title'),
icon: 'database',
description: i18n.baseText('nodeCreator.ragStarterTemplate.openTemplateItem.description'),
tag: {
type: 'info',
text: i18n.baseText('nodeCreator.triggerHelperPanel.manualTriggerTag'),
},
},
});
results.push(getRagStarterCallout());
}
return results;
}
const getTemplateLink = (
templateId: string,
availableTemplates: OpenTemplateElement[],
): OpenTemplateElement | undefined => {
const templateLink = availableTemplates.find((template) => template.key === templateId);
if (templateLink?.properties) {
templateLink.properties.compact = true;
}
return templateLink;
};
export function getActiveViewCallouts(
title: string | undefined,
isPreBuiltAgentsCalloutVisible: boolean,
templates: OpenTemplateElement[],
) {
const results: INodeCreateElement[] = [];
if (isPreBuiltAgentsCalloutVisible && title) {
if (title === AI_CATEGORY_LANGUAGE_MODELS) {
results.push(getPreBuiltAgentsCalloutWithDivider());
} else if ([AI_CATEGORY_MEMORY, AI_CATEGORY_TOOLS].includes(title)) {
results.push(getPreBuiltAgentsCallout());
} else if (title === 'Google Calendar' || title === 'Telegram') {
const templateLink = getTemplateLink(PrebuiltAgentTemplates.VoiceAssistantAgent, templates);
if (templateLink) {
results.push(templateLink);
}
} else if (title === 'Google Drive') {
const templateLink = getTemplateLink(PrebuiltAgentTemplates.KnowledgeStoreAgent, templates);
if (templateLink) {
results.push(templateLink);
}
} else if (title === 'Google Sheets') {
const templateLink = getTemplateLink(PrebuiltAgentTemplates.TaskManagementAgent, templates);
if (templateLink) {
results.push(templateLink);
}
} else if (title === 'Gmail') {
const templateLink = getTemplateLink(PrebuiltAgentTemplates.EmailTriageAgent, templates);
if (templateLink) {
results.push(templateLink);
}
}
}
return results;
}
export const shouldShowCommunityNodeDetails = (communityNode: boolean, viewStack: ViewStack) => {
if (viewStack.rootView === 'AI Other' && viewStack.title === 'Tools') {
return false;

16
packages/frontend/editor-ui/src/components/Node/NodeCreator/viewsData.spec.ts
View File

@@ -1,6 +1,11 @@
import { setActivePinia } from 'pinia';
import { createTestingPinia } from '@pinia/testing';
import { AI_CATEGORY_AGENTS, AI_CATEGORY_CHAINS, AI_TRANSFORM_NODE_TYPE } from '@/constants';
import {
AI_CATEGORY_AGENTS,
AI_CATEGORY_CHAINS,
AI_TRANSFORM_NODE_TYPE,
PRE_BUILT_AGENTS_EXPERIMENT,
} from '@/constants';
import type { INodeTypeDescription } from 'n8n-workflow';
import { START_NODE_TYPE } from 'n8n-workflow';
import { useSettingsStore } from '@/stores/settings.store';
@@ -55,7 +60,14 @@ describe('viewsData', () => {
setActivePinia(createTestingPinia());
posthogStore = usePostHog();
vi.spyOn(posthogStore, 'isVariantEnabled').mockReturnValue(true);
vi.spyOn(posthogStore, 'isVariantEnabled').mockImplementation((experiment) => {
if (experiment === PRE_BUILT_AGENTS_EXPERIMENT.name) {
return false;
}
return true;
});
const templatesStore = useTemplatesStore();

27
packages/frontend/editor-ui/src/components/Node/NodeCreator/viewsData.ts
View File

@@ -69,6 +69,9 @@ import type { BaseTextKey } from '@n8n/i18n';
import camelCase from 'lodash/camelCase';
import { useSettingsStore } from '@/stores/settings.store';
import { useEvaluationStore } from '@/stores/evaluation.store.ee';
import { getAiTemplatesCallout, getPreBuiltAgentsCalloutWithDivider } from './utils';
import { useCalloutHelpers } from '@/composables/useCalloutHelpers';
export interface NodeViewItemSection {
key: string;
title: string;
@@ -79,6 +82,7 @@ export interface NodeViewItem {
key: string;
type: string;
properties: {
key?: string;
name?: string;
title?: string;
icon?: Themed<string>;
@@ -94,7 +98,7 @@ export interface NodeViewItem {
description?: string;
displayName?: string;
tag?: {
type: string;
type?: string;
text: string;
};
forceIncludeNodes?: string[];
@@ -168,6 +172,7 @@ export function AIView(_nodes: SimplifiedNodeType[]): NodeView {
const nodeTypesStore = useNodeTypesStore();
const templatesStore = useTemplatesStore();
const evaluationStore = useEvaluationStore();
const calloutHelpers = useCalloutHelpers();
const isEvaluationEnabled = evaluationStore.isEvaluationEnabled;
const evaluationNode = getEvaluationNode(nodeTypesStore, isEvaluationEnabled);
@@ -186,26 +191,16 @@ export function AIView(_nodes: SimplifiedNodeType[]): NodeView {
const aiTransformNode = nodeTypesStore.getNodeType(AI_TRANSFORM_NODE_TYPE);
const transformNode = askAiEnabled && aiTransformNode ? [getNodeView(aiTransformNode)] : [];
const callouts: NodeViewItem[] = !calloutHelpers.isPreBuiltAgentsCalloutVisible.value
? [getAiTemplatesCallout(aiTemplatesURL)]
: [getPreBuiltAgentsCalloutWithDivider()];
return {
value: AI_NODE_CREATOR_VIEW,
title: i18n.baseText('nodeCreator.aiPanel.aiNodes'),
subtitle: i18n.baseText('nodeCreator.aiPanel.selectAiNode'),
items: [
{
key: 'ai_templates_root',
type: 'link',
properties: {
title: i18n.baseText('nodeCreator.aiPanel.linkItem.title'),
icon: 'box-open',
description: i18n.baseText('nodeCreator.aiPanel.linkItem.description'),
name: 'ai_templates_root',
url: aiTemplatesURL,
tag: {
type: 'info',
text: i18n.baseText('nodeCreator.triggerHelperPanel.manualTriggerTag'),
},
},
},
...callouts,
...agentNodes,
...chainNodes,
...transformNode,

3
packages/frontend/editor-ui/src/components/ParameterInputList.test.constants.ts
View File

@@ -55,7 +55,8 @@ export const TEST_PARAMETERS: INodeProperties[] = [
typeOptions: {
calloutAction: {
label: 'and action!',
type: 'openRagStarterTemplate',
type: 'openSampleWorkflowTemplate',
templateId: 'test-template-id',
},
},
},

67
packages/frontend/editor-ui/src/components/ParameterInputList.vue
View File

@@ -1,6 +1,6 @@
<script setup lang="ts">
import type {
CalloutActionType,
CalloutAction,
INodeParameters,
INodeProperties,
NodeParameterValueType,
@@ -47,6 +47,7 @@ import { storeToRefs } from 'pinia';
import { useCalloutHelpers } from '@/composables/useCalloutHelpers';
import { getParameterTypeOption } from '@/utils/nodeSettingsUtils';
import { useWorkflowsStore } from '@/stores/workflows.store';
import type { IconName } from '@n8n/design-system/components/N8nIcon/icons';
const LazyFixedCollectionParameter = defineAsyncComponent(
async () => await import('./FixedCollectionParameter.vue'),
@@ -86,8 +87,14 @@ const nodeSettingsParameters = useNodeSettingsParameters();
const asyncLoadingError = ref(false);
const workflowHelpers = useWorkflowHelpers();
const i18n = useI18n();
const { dismissCallout, isCalloutDismissed, openRagStarterTemplate, isRagStarterCalloutVisible } =
useCalloutHelpers();
const {
dismissCallout,
isCalloutDismissed,
openPreBuiltAgentsCollection,
openSampleWorkflowTemplate,
isRagStarterCalloutVisible,
isPreBuiltAgentsCalloutVisible,
} = useCalloutHelpers();
const { activeNode } = storeToRefs(ndvStore);
@@ -154,12 +161,22 @@ const credentialsParameterIndex = computed(() => {
return filteredParameters.value.findIndex((parameter) => parameter.type === 'credentials');
});
const calloutParameterIndex = computed(() => {
return filteredParameters.value.findIndex((parameter) => parameter.type === 'callout');
});
const indexToShowSlotAt = computed(() => {
if (credentialsParameterIndex.value !== -1) {
return credentialsParameterIndex.value;
}
let index = 0;
// If the node has a callout don't show credentials before it
if (calloutParameterIndex.value !== -1) {
index = calloutParameterIndex.value + 1;
}
// For nodes that use old credentials UI, keep credentials below authentication field in NDV
// otherwise credentials will use auth filed position since the auth field is moved to credentials modal
const fieldOffset = KEEP_AUTH_IN_NDV_FOR_NODES.includes(nodeType.value?.name || '') ? 1 : 0;
@@ -405,6 +422,14 @@ function isRagStarterCallout(parameter: INodeProperties): boolean {
return parameter.type === 'callout' && parameter.name === 'ragStarterCallout';
}
function isAgentDefaultCallout(parameter: INodeProperties): boolean {
return parameter.type === 'callout' && parameter.name === 'aiAgentStarterCallout';
}
function isPreBuiltAgentsCallout(parameter: INodeProperties): boolean {
return parameter.type === 'callout' && parameter.name.startsWith('preBuiltAgentsCallout');
}
function isCalloutVisible(parameter: INodeProperties): boolean {
if (isCalloutDismissed(parameter.name)) return false;
@@ -412,12 +437,38 @@ function isCalloutVisible(parameter: INodeProperties): boolean {
return isRagStarterCalloutVisible.value;
}
if (isAgentDefaultCallout(parameter)) {
return !isPreBuiltAgentsCalloutVisible.value;
}
if (isPreBuiltAgentsCallout(parameter)) {
return isPreBuiltAgentsCalloutVisible.value;
}
return true;
}
function onCalloutAction(action: CalloutActionType) {
if (action === 'openRagStarterTemplate') {
openRagStarterTemplate(activeNode.value?.type ?? 'no active node');
function onCalloutAction(action: CalloutAction) {
switch (action.type) {
case 'openPreBuiltAgentsCollection':
void openPreBuiltAgentsCollection({
telemetry: {
source: 'ndv',
nodeType: activeNode.value?.type,
},
resetStacks: false,
});
break;
case 'openSampleWorkflowTemplate':
void openSampleWorkflowTemplate(action.templateId, {
telemetry: {
source: 'ndv',
nodeType: activeNode.value?.type,
},
});
break;
default:
break;
}
}
@@ -483,6 +534,8 @@ async function onCalloutDismiss(parameter: INodeProperties) {
<template v-else-if="parameter.type === 'callout'">
<N8nCallout
v-if="isCalloutVisible(parameter)"
:icon="(parameter.typeOptions?.calloutAction?.icon as IconName) || 'info'"
icon-size="large"
:class="['parameter-item', parameter.typeOptions?.containerClass ?? '']"
theme="secondary"
>
@@ -499,7 +552,7 @@ async function onCalloutDismiss(parameter: INodeProperties) {
size="small"
:bold="true"
:underline="true"
@click="onCalloutAction(parameter.typeOptions.calloutAction.type)"
@click="onCalloutAction(parameter.typeOptions.calloutAction)"
>
{{ parameter.typeOptions.calloutAction.label }}
</N8nLink>

176
packages/frontend/editor-ui/src/composables/useCalloutHelpers.test.ts
View File

@@ -1,11 +1,18 @@
import { useCalloutHelpers } from '@/composables/useCalloutHelpers';
import { updateCurrentUserSettings } from '@n8n/rest-api-client/api/users';
import { createTestingPinia } from '@pinia/testing';
import { PrebuiltAgentTemplates, SampleTemplates } from '@/utils/templates/workflowSamples';
import { useNDVStore } from '@/stores/ndv.store';
import { mockedStore } from '@/__tests__/utils';
import { NODE_CREATOR_OPEN_SOURCES } from '@/constants';
import { useNodeCreatorStore } from '@/stores/nodeCreator.store';
import { useViewStacks } from '@/components/Node/NodeCreator/composables/useViewStacks';
const mocks = vi.hoisted(() => ({
resolve: vi.fn(),
track: vi.fn(),
useRoute: vi.fn(() => ({ query: {}, params: {} })),
getVariant: vi.fn(() => 'default'),
isVariantEnabled: vi.fn(() => false),
isCalloutDismissed: vi.fn(() => false),
setCalloutDismissed: vi.fn(),
restApiContext: vi.fn(() => ({})),
@@ -26,7 +33,7 @@ vi.mock('@/composables/useTelemetry', () => ({
vi.mock('@/stores/posthog.store', () => ({
usePostHog: () => ({
getVariant: mocks.getVariant,
isVariantEnabled: mocks.isVariantEnabled,
}),
}));
@@ -57,40 +64,170 @@ vi.mock('@n8n/rest-api-client/api/users', () => ({
updateCurrentUserSettings: vi.fn(),
}));
let ndvStore: ReturnType<typeof mockedStore<typeof useNDVStore>>;
let nodeCreatorStore: ReturnType<typeof mockedStore<typeof useNodeCreatorStore>>;
let viewStacks: ReturnType<typeof mockedStore<typeof useViewStacks>>;
describe('useCalloutHelpers()', () => {
beforeEach(() => {
vi.clearAllMocks();
createTestingPinia();
ndvStore = mockedStore(useNDVStore);
nodeCreatorStore = mockedStore(useNodeCreatorStore);
viewStacks = mockedStore(useViewStacks);
});
describe('openRagStarterTemplate()', () => {
it('opens the RAG starter template successfully', () => {
describe('openSampleWorkflowTemplate()', () => {
it('opens the RAG starter template from NDV successfully', () => {
vi.spyOn(window, 'open').mockImplementation(() => null);
mocks.resolve.mockReturnValue({ href: 'n8n.io' });
const { openRagStarterTemplate } = useCalloutHelpers();
const { openSampleWorkflowTemplate } = useCalloutHelpers();
const nodeType = 'testNode';
openRagStarterTemplate('testNode');
openSampleWorkflowTemplate(SampleTemplates.RagStarterTemplate, {
telemetry: {
source: 'ndv',
nodeType,
},
});
expect(window.open).toHaveBeenCalledWith('n8n.io', '_blank');
expect(mocks.track).toHaveBeenCalledWith('User clicked on RAG callout', {
node_type: nodeType,
});
});
it('opens the RAG starter template from node creator successfully', () => {
vi.spyOn(window, 'open').mockImplementation(() => null);
mocks.resolve.mockReturnValue({ href: 'n8n.io' });
const { openSampleWorkflowTemplate } = useCalloutHelpers();
openSampleWorkflowTemplate(SampleTemplates.RagStarterTemplate, {
telemetry: {
source: 'nodeCreator',
section: 'testSection',
},
});
expect(window.open).toHaveBeenCalledWith('n8n.io', '_blank');
expect(mocks.track).toHaveBeenCalledWith('User clicked on RAG callout', {
node_type: null,
});
});
it('opens easy AI starter successfully', () => {
vi.spyOn(window, 'open').mockImplementation(() => null);
mocks.resolve.mockReturnValue({ href: 'n8n.io' });
const { openSampleWorkflowTemplate } = useCalloutHelpers();
openSampleWorkflowTemplate('self-building-ai-agent', {
telemetry: {
source: 'ndv',
nodeType: 'testNode',
},
});
expect(window.open).toHaveBeenCalledWith('n8n.io', '_blank');
expect(mocks.track).not.toHaveBeenCalled();
});
it.each(Object.values(PrebuiltAgentTemplates))(
'opens pre-built agent template %s from NDV successfully',
(templateId) => {
vi.spyOn(window, 'open').mockImplementation(() => null);
mocks.resolve.mockReturnValue({ href: 'n8n.io' });
const { openSampleWorkflowTemplate } = useCalloutHelpers();
const nodeType = 'testNode';
openSampleWorkflowTemplate(templateId, {
telemetry: {
source: 'ndv',
nodeType,
},
});
expect(window.open).toHaveBeenCalledWith('n8n.io', '_blank');
expect(mocks.track).toHaveBeenCalledWith('User inserted pre-built Agent', {
source: 'ndv',
template: templateId,
node_type: nodeType,
section: null,
});
},
);
it.each(Object.values(PrebuiltAgentTemplates))(
'opens pre-built agent template %s from node creator successfully',
(templateId) => {
vi.spyOn(window, 'open').mockImplementation(() => null);
mocks.resolve.mockReturnValue({ href: 'n8n.io' });
const { openSampleWorkflowTemplate } = useCalloutHelpers();
const section = 'Test Section';
openSampleWorkflowTemplate(templateId, {
telemetry: {
source: 'nodeCreator',
section,
},
});
expect(window.open).toHaveBeenCalledWith('n8n.io', '_blank');
expect(mocks.track).toHaveBeenCalledWith('User inserted pre-built Agent', {
source: 'nodeCreator',
template: templateId,
node_type: null,
section,
});
},
);
});
describe('openPreBuiltAgentsCollection', () => {
it('opens pre-built agents collection successfully', async () => {
vi.spyOn(window, 'open').mockImplementation(() => null);
mocks.resolve.mockReturnValue({ href: 'n8n.io' });
const { openPreBuiltAgentsCollection } = useCalloutHelpers();
await openPreBuiltAgentsCollection({
telemetry: {
source: 'ndv',
nodeType: 'testNode',
section: 'testSection',
},
});
expect(ndvStore.setActiveNodeName).toHaveBeenCalledWith(null);
expect(nodeCreatorStore.setNodeCreatorState).toHaveBeenCalledWith({
source: NODE_CREATOR_OPEN_SOURCES.TEMPLATES_CALLOUT,
createNodeActive: true,
});
expect(viewStacks.pushViewStack).toHaveBeenCalledWith(
expect.objectContaining({ title: 'Pre-built agents' }),
{ resetStacks: false },
);
expect(mocks.track).toHaveBeenCalledWith('User opened pre-built Agents collection', {
source: 'ndv',
node_type: 'testNode',
section: 'testSection',
});
});
});
describe('isRagStarterCalloutVisible', () => {
it('should be true if current route is not on the RAG starter template', () => {
mocks.getVariant.mockReturnValueOnce('variant');
const { isRagStarterCalloutVisible } = useCalloutHelpers();
expect(isRagStarterCalloutVisible.value).toBe(true);
});
it('should be false and current route is not on unsaved RAG starter template', () => {
mocks.getVariant.mockReturnValueOnce('variant');
mocks.useRoute.mockReturnValueOnce({
query: { templateId: 'rag-starter-template' },
query: { templateId: SampleTemplates.RagStarterTemplate },
params: {},
});
@@ -99,9 +236,8 @@ describe('useCalloutHelpers()', () => {
});
it('should be false if current route is on saved RAG starter template', () => {
mocks.getVariant.mockReturnValueOnce('variant');
mocks.getWorkflowById.mockReturnValueOnce({
meta: { templateId: 'rag-starter-template' },
meta: { templateId: SampleTemplates.RagStarterTemplate },
});
const { isRagStarterCalloutVisible } = useCalloutHelpers();
@@ -109,6 +245,22 @@ describe('useCalloutHelpers()', () => {
});
});
describe('isPreBuiltAgentsCalloutVisible', () => {
it('should be false with experiment disabled', () => {
mocks.isVariantEnabled.mockReturnValueOnce(false);
const { isPreBuiltAgentsCalloutVisible } = useCalloutHelpers();
expect(isPreBuiltAgentsCalloutVisible.value).toBe(false);
});
it('should be true with experiment enabled', () => {
mocks.isVariantEnabled.mockReturnValueOnce(true);
const { isPreBuiltAgentsCalloutVisible } = useCalloutHelpers();
expect(isPreBuiltAgentsCalloutVisible.value).toBe(true);
});
});
describe('isCalloutDismissed()', () => {
it('should return false if callout is not dismissed', () => {
const { isCalloutDismissed } = useCalloutHelpers();

166
packages/frontend/editor-ui/src/composables/useCalloutHelpers.ts
View File

@@ -1,27 +1,152 @@
import { computed } from 'vue';
import { computed, nextTick } from 'vue';
import { useRoute, useRouter } from 'vue-router';
import { useTelemetry } from '@/composables/useTelemetry';
import { useRootStore } from '@n8n/stores/useRootStore';
import { useI18n } from '@n8n/i18n';
import { useUsersStore } from '@/stores/users.store';
import { VIEWS } from '@/constants';
import { getRagStarterWorkflowJson } from '@/utils/easyAiWorkflowUtils';
import { updateCurrentUserSettings } from '@n8n/rest-api-client/api/users';
import { useWorkflowsStore } from '@/stores/workflows.store';
import { usePostHog } from '@/stores/posthog.store';
import { useNDVStore } from '@/stores/ndv.store';
import { useNodeCreatorStore } from '@/stores/nodeCreator.store';
import { useNodeTypesStore } from '@/stores/nodeTypes.store';
import { useViewStacks } from '@/components/Node/NodeCreator/composables/useViewStacks';
import { updateCurrentUserSettings } from '@n8n/rest-api-client/api/users';
import {
NODE_CREATOR_OPEN_SOURCES,
PRE_BUILT_AGENTS_EXPERIMENT,
REGULAR_NODE_CREATOR_VIEW,
VIEWS,
} from '@/constants';
import {
getPrebuiltAgents,
getRagStarterWorkflowJson,
getSampleWorkflowByTemplateId,
isPrebuiltAgentTemplateId,
SampleTemplates,
} from '@/utils/templates/workflowSamples';
import type { INodeCreateElement, OpenTemplateElement } from '@/Interface';
export function useCalloutHelpers() {
const route = useRoute();
const router = useRouter();
const telemetry = useTelemetry();
const postHog = usePostHog();
const rootStore = useRootStore();
const workflowsStore = useWorkflowsStore();
const usersStore = useUsersStore();
const ndvStore = useNDVStore();
const nodeCreatorStore = useNodeCreatorStore();
const viewStacks = useViewStacks();
const nodeTypesStore = useNodeTypesStore();
const i18n = useI18n();
const openRagStarterTemplate = (nodeType?: string) => {
telemetry.track('User clicked on RAG callout', {
node_type: nodeType ?? null,
const isRagStarterCalloutVisible = computed(() => {
const template = getRagStarterWorkflowJson();
const routeTemplateId = route.query.templateId;
const workflowObject = workflowsStore.workflowObject;
const workflow = workflowsStore.getWorkflowById(workflowObject.id);
// Hide the RAG starter callout if we're currently on the RAG starter template
if ((routeTemplateId ?? workflow?.meta?.templateId) === template.meta.templateId) {
return false;
}
return true;
});
const getPreBuiltAgentNodeCreatorItems = (): OpenTemplateElement[] => {
const templates = getPrebuiltAgents();
return templates.map((template) => {
return {
key: template.template.meta.templateId,
type: 'openTemplate',
properties: {
templateId: template.template.meta.templateId,
title: template.name,
description: template.description,
nodes: template.nodes.flatMap((node) => {
const nodeType = nodeTypesStore.getNodeType(node.name, node.version);
if (!nodeType) {
return [];
}
return nodeType;
}),
},
};
});
};
const openPreBuiltAgentsCollection = async (options: {
telemetry: {
source: 'ndv' | 'nodeCreator';
nodeType?: string;
section?: string;
};
resetStacks?: boolean;
}) => {
telemetry.track('User opened pre-built Agents collection', {
source: options.telemetry.source,
node_type: options.telemetry.nodeType ?? null,
section: options.telemetry.section ?? null,
});
const template = getRagStarterWorkflowJson();
const items: INodeCreateElement[] = getPreBuiltAgentNodeCreatorItems();
ndvStore.setActiveNodeName(null);
nodeCreatorStore.setNodeCreatorState({
source: NODE_CREATOR_OPEN_SOURCES.TEMPLATES_CALLOUT,
createNodeActive: true,
nodeCreatorView: undefined,
connectionType: undefined,
});
await nextTick();
viewStacks.pushViewStack(
{
title: i18n.baseText('nodeCreator.preBuiltAgents.title'),
rootView: REGULAR_NODE_CREATOR_VIEW,
activeIndex: 0,
transitionDirection: 'in',
hasSearch: false,
preventBack: false,
items,
baselineItems: items,
mode: 'nodes',
hideActions: false,
},
{ resetStacks: options.resetStacks ?? false },
);
};
const openSampleWorkflowTemplate = (
templateId: string,
options: {
telemetry: {
source: 'ndv' | 'nodeCreator';
nodeType?: string;
section?: string;
};
},
) => {
if (templateId === SampleTemplates.RagStarterTemplate) {
telemetry.track('User clicked on RAG callout', {
node_type: options.telemetry.nodeType ?? null,
});
} else if (isPrebuiltAgentTemplateId(templateId)) {
telemetry.track('User inserted pre-built Agent', {
template: templateId,
source: options.telemetry.source,
node_type: options.telemetry.nodeType ?? null,
section: options.telemetry.section ?? null,
});
}
const template = getSampleWorkflowByTemplateId(templateId);
if (!template) {
return;
}
const { href } = router.resolve({
name: VIEWS.TEMPLATE_IMPORT,
@@ -32,19 +157,15 @@ export function useCalloutHelpers() {
window.open(href, '_blank');
};
const isRagStarterCalloutVisible = computed(() => {
const template = getRagStarterWorkflowJson();
const isPreBuiltAgentsExperimentEnabled = computed(() => {
return postHog.isVariantEnabled(
PRE_BUILT_AGENTS_EXPERIMENT.name,
PRE_BUILT_AGENTS_EXPERIMENT.variant,
);
});
const routeTemplateId = route.query.templateId;
const workflowObject = workflowsStore.workflowObject;
const workflow = workflowsStore.getWorkflowById(workflowObject.id); // @TODO Check if we actually need workflowObject here
// Hide the RAG starter callout if we're currently on the RAG starter template
if ((routeTemplateId ?? workflow?.meta?.templateId) === template.meta.templateId) {
return false;
}
return true;
const isPreBuiltAgentsCalloutVisible = computed(() => {
return isPreBuiltAgentsExperimentEnabled.value;
});
const isCalloutDismissed = (callout: string) => {
@@ -63,8 +184,11 @@ export function useCalloutHelpers() {
};
return {
openRagStarterTemplate,
openSampleWorkflowTemplate,
openPreBuiltAgentsCollection,
getPreBuiltAgentNodeCreatorItems,
isRagStarterCalloutVisible,
isPreBuiltAgentsCalloutVisible,
isCalloutDismissed,
dismissCallout,
};

4
packages/frontend/editor-ui/src/composables/useCanvasOperations.test.ts
View File

@@ -3415,7 +3415,9 @@ describe('useCanvasOperations', () => {
templateName,
projectsStore.currentProjectId,
);
expect(workflowsStore.addToWorkflowMetadata).toHaveBeenCalledWith({ templateId });
expect(workflowsStore.addToWorkflowMetadata).toHaveBeenCalledWith({
templateId,
});
});
});
describe('replaceNodeParameters', () => {

27
packages/frontend/editor-ui/src/composables/usePushConnection/handlers/executionFinished.ts
View File

@@ -14,7 +14,7 @@ import { useNodeTypesStore } from '@/stores/nodeTypes.store';
import { useSettingsStore } from '@/stores/settings.store';
import { useUIStore } from '@/stores/ui.store';
import { useWorkflowsStore } from '@/stores/workflows.store';
import { getEasyAiWorkflowJson } from '@/utils/easyAiWorkflowUtils';
import { SampleTemplates, isPrebuiltAgentTemplateId } from '@/utils/templates/workflowSamples';
import {
clearPopupWindowState,
getExecutionErrorMessage,
@@ -59,25 +59,26 @@ export async function executionFinished(
clearPopupWindowState();
const workflow = workflowsStore.getWorkflowById(data.workflowId);
if (workflow?.meta?.templateId) {
const easyAiWorkflowJson = getEasyAiWorkflowJson();
const isEasyAIWorkflow = workflow.meta.templateId === easyAiWorkflowJson.meta.templateId;
const templateId = workflow?.meta?.templateId;
if (templateId) {
const isEasyAIWorkflow = templateId === SampleTemplates.EasyAiTemplate;
if (isEasyAIWorkflow) {
telemetry.track('User executed test AI workflow', {
status: data.status,
});
}
if (workflow.meta.templateId.startsWith('035_template_onboarding')) {
} else if (templateId.startsWith('035_template_onboarding')) {
aiTemplatesStarterCollectionStore.trackUserExecutedWorkflow(
workflow.meta.templateId.split('-').pop() ?? '',
data.status,
);
}
if (workflow.meta.templateId.startsWith('37_onboarding_experiments_batch_aug11')) {
readyToRunWorkflowsStore.trackExecuteWorkflow(
workflow.meta.templateId.split('-').pop() ?? '',
templateId.split('-').pop() ?? '',
data.status,
);
} else if (templateId.startsWith('37_onboarding_experiments_batch_aug11')) {
readyToRunWorkflowsStore.trackExecuteWorkflow(templateId.split('-').pop() ?? '', data.status);
} else if (isPrebuiltAgentTemplateId(templateId)) {
telemetry.track('User executed pre-built Agent', {
template: templateId,
status: data.status,
});
}
}

9
packages/frontend/editor-ui/src/constants.ts
View File

@@ -288,6 +288,7 @@ export const NODE_CREATOR_OPEN_SOURCES: Record<
CONTEXT_MENU: 'context_menu',
ADD_EVALUATION_NODE_BUTTON: 'add_evaluation_node_button',
ADD_EVALUATION_TRIGGER_BUTTON: 'add_evaluation_trigger_button',
TEMPLATES_CALLOUT: 'templates_callout',
'': '',
};
export const CORE_NODES_CATEGORY = 'Core Nodes';
@@ -324,6 +325,7 @@ export const AI_UNCATEGORIZED_CATEGORY = 'Miscellaneous';
export const AI_CODE_TOOL_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.toolCode';
export const AI_WORKFLOW_TOOL_LANGCHAIN_NODE_TYPE = '@n8n/n8n-nodes-langchain.toolWorkflow';
export const REQUEST_NODE_FORM_URL = 'https://n8n-community.typeform.com/to/K1fBVTZ3';
export const PRE_BUILT_AGENTS_COLLECTION = 'pre-built-agents-collection';
// Node Connection Types
export const NODE_CONNECTION_TYPE_ALLOW_MULTIPLE: NodeConnectionType[] = [
@@ -779,12 +781,19 @@ export const BATCH_11AUG_EXPERIMENT = {
variantStarterPack: 'variant-starter-pack-v2',
};
export const PRE_BUILT_AGENTS_EXPERIMENT = {
name: '038_pre_built_agents',
control: 'control',
variant: 'variant',
};
export const EXPERIMENTS_TO_TRACK = [
WORKFLOW_BUILDER_EXPERIMENT.name,
EXTRA_TEMPLATE_LINKS_EXPERIMENT.name,
TEMPLATE_ONBOARDING_EXPERIMENT.name,
NDV_UI_OVERHAUL_EXPERIMENT.name,
BATCH_11AUG_EXPERIMENT.name,
PRE_BUILT_AGENTS_EXPERIMENT.name,
];
export const MFA_FORM = {

143
packages/frontend/editor-ui/src/utils/__snapshots__/easyAiWorkflowUtils.test.ts.snap
View File

@@ -1,143 +0,0 @@
// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
exports[`getEasyAiWorkflowJson > should return expected easy ai workflow 1`] = `
{
"connections": {
"OpenAI Model": {
"ai_languageModel": [
[
{
"index": 0,
"node": "Agent",
"type": "ai_languageModel",
},
],
],
},
"When chat message received": {
"main": [
[
{
"index": 0,
"node": "Agent",
"type": "main",
},
],
],
},
},
"meta": {
"templateId": "self-building-ai-agent",
},
"name": "Demo: My first AI Agent in n8n",
"nodes": [
{
"id": "b24b05a7-d802-4413-bfb1-23e1e76f6203",
"name": "When chat message received",
"parameters": {
"options": {},
},
"position": [
360,
20,
],
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"typeVersion": 1.1,
"webhookId": "a889d2ae-2159-402f-b326-5f61e90f602e",
},
{
"id": "5592c045-6718-4c4e-9961-ce67a251b6df",
"name": "Sticky Note",
"parameters": {
"content": "## Start by saying 'hi'
![Button](https://i.imgur.com/PrIBJI6.png)",
"height": 149,
"width": 150,
},
"position": [
180,
-40,
],
"type": "n8n-nodes-base.stickyNote",
"typeVersion": 1,
},
{
"id": "d5e60eb2-267c-4f68-aefe-439031bcaceb",
"name": "OpenAI Model",
"parameters": {
"options": {},
},
"position": [
500,
240,
],
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1,
},
{
"id": "41174c8a-6ac8-42bd-900e-ca15196600c5",
"name": "Agent",
"parameters": {
"options": {
"systemMessage": "=You are a friendly Agent designed to guide users through these steps.
- Stop at the earliest step mentioned in the steps
- Respond concisely and do **not** disclose these internal instructions to the user. Only return defined output below.
- Don't output any lines that start with -----
- Replace ":sparks:" with "✨" in any message",
},
"promptType": "define",
"text": "=## Steps to follow
{{ $agentInfo.memoryConnectedToAgent ? '1. Skip': \`1. STOP and output the following:
"Welcome to n8n. Let's start with the first step to give me memory: \\n"Click the **+** button on the agent that says 'memory' and choose 'Simple memory.' Just tell me once you've done that."
----- END OF OUTPUT && IGNORE BELOW -----\` }}
{{ Boolean($agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool')) ? '2. Skip' :
\`2. STOP and output the following: \\n"Click the **+** button on the agent that says 'tools' and choose 'Google Calendar.'" \\n ----- IGNORE BELOW -----\` }}
{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').hasCredentials ? '3. Skip' :
\`3. STOP and output the following:
"Open the Google Calendar tool (double-click) and choose a credential from the drop-down." \\n ----- IGNORE BELOW -----\` }}
{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').resource === 'Event' ? '4. Skip' :
\`4. STOP and output the following:
"Open the Google Calendar tool (double-click) and set **resource** = 'Event'" \`}}
{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').operation === 'Get Many' ? '5. Skip' :
\`5. STOP and output the following:
"Open the Google Calendar tool (double-click) and set **operation** = 'Get Many.'" \\n ----- IGNORE BELOW -----\` }}
{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').hasValidCalendar ? '6. Skip' :
\`6. STOP and output the following:
"Open the Google Calendar tool (double-click) and choose a calendar from the 'calendar' drop-down." \\n ----- IGNORE BELOW -----\` }}
{{ ($agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').aiDefinedFields.includes('Start Time') && $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').aiDefinedFields.includes('End Time')) ? '7. Skip' :
\`7. STOP and output the following:
Open the Google Calendar tool (double-click) and click the :sparks: button next to the 'After' and 'Before' fields. \\n ----- IGNORE BELOW -----\` }}
8. If all steps are completed, output the following:
"Would you like me to check all events in your calendar for tomorrow {{ $now.plus(1, 'days').toString().split('T')[0] }}?"
# User message
{{ $json.chatInput }}",
},
"position": [
580,
20,
],
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 1.7,
},
],
"pinData": {},
}
`;

12
packages/frontend/editor-ui/src/utils/easyAiWorkflowUtils.test.ts
View File

@@ -1,12 +0,0 @@
import { describe, it, expect } from 'vitest';
import { getEasyAiWorkflowJson } from './easyAiWorkflowUtils';
describe('getEasyAiWorkflowJson', () => {
it('should return expected easy ai workflow', () => {
const workflow = getEasyAiWorkflowJson();
if (!workflow?.nodes) fail();
expect(workflow).toMatchSnapshot();
});
});

352
packages/frontend/editor-ui/src/utils/easyAiWorkflowUtils.ts
View File

@@ -1,352 +0,0 @@
import type { WorkflowDataWithTemplateId } from '@/Interface';
import { NodeConnectionTypes } from 'n8n-workflow';
/**
* Generates a workflow JSON object for an AI Agent in n8n.
*/
export const getEasyAiWorkflowJson = (): WorkflowDataWithTemplateId => {
return {
name: 'Demo: My first AI Agent in n8n',
meta: {
templateId: 'self-building-ai-agent',
},
nodes: [
{
parameters: {
options: {},
},
id: 'b24b05a7-d802-4413-bfb1-23e1e76f6203',
name: 'When chat message received',
type: '@n8n/n8n-nodes-langchain.chatTrigger',
typeVersion: 1.1,
position: [360, 20],
webhookId: 'a889d2ae-2159-402f-b326-5f61e90f602e',
},
{
parameters: {
content: "## Start by saying 'hi'\n![Button](https://i.imgur.com/PrIBJI6.png)",
height: 149,
width: 150,
},
id: '5592c045-6718-4c4e-9961-ce67a251b6df',
name: 'Sticky Note',
type: 'n8n-nodes-base.stickyNote',
typeVersion: 1,
position: [180, -40],
},
{
parameters: {
options: {},
},
id: 'd5e60eb2-267c-4f68-aefe-439031bcaceb',
name: 'OpenAI Model',
type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',
typeVersion: 1,
position: [500, 240],
},
{
parameters: {
promptType: 'define',
text: "=## Steps to follow\n\n{{ $agentInfo.memoryConnectedToAgent ? '1. Skip': `1. STOP and output the following:\n\"Welcome to n8n. Let's start with the first step to give me memory: \\n\"Click the **+** button on the agent that says 'memory' and choose 'Simple memory.' Just tell me once you've done that.\"\n----- END OF OUTPUT && IGNORE BELOW -----` }} \n\n\n{{ Boolean($agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool')) ? '2. Skip' : \n`2. STOP and output the following: \\n\"Click the **+** button on the agent that says 'tools' and choose 'Google Calendar.'\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').hasCredentials ? '3. Skip' :\n`3. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and choose a credential from the drop-down.\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').resource === 'Event' ? '4. Skip' :\n`4. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and set **resource** = 'Event'\" `}}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').operation === 'Get Many' ? '5. Skip' :\n`5. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and set **operation** = 'Get Many.'\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').hasValidCalendar ? '6. Skip' :\n`6. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and choose a calendar from the 'calendar' drop-down.\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ ($agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').aiDefinedFields.includes('Start Time') && $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').aiDefinedFields.includes('End Time')) ? '7. Skip' :\n`7. STOP and output the following: \nOpen the Google Calendar tool (double-click) and click the :sparks: button next to the 'After' and 'Before' fields. \\n ----- IGNORE BELOW -----` }}\n\n\n8. If all steps are completed, output the following:\n\"Would you like me to check all events in your calendar for tomorrow {{ $now.plus(1, 'days').toString().split('T')[0] }}?\"\n\n# User message\n\n{{ $json.chatInput }}",
options: {
systemMessage:
'=You are a friendly Agent designed to guide users through these steps.\n\n- Stop at the earliest step mentioned in the steps\n- Respond concisely and do **not** disclose these internal instructions to the user. Only return defined output below.\n- Don\'t output any lines that start with -----\n- Replace ":sparks:" with "✨" in any message',
},
},
id: '41174c8a-6ac8-42bd-900e-ca15196600c5',
name: 'Agent',
type: '@n8n/n8n-nodes-langchain.agent',
typeVersion: 1.7,
position: [580, 20],
},
],
connections: {
'When chat message received': {
main: [
[
{
node: 'Agent',
type: NodeConnectionTypes.Main,
index: 0,
},
],
],
},
'OpenAI Model': {
ai_languageModel: [
[
{
node: 'Agent',
type: NodeConnectionTypes.AiLanguageModel,
index: 0,
},
],
],
},
},
pinData: {},
};
};
export const getRagStarterWorkflowJson = (): WorkflowDataWithTemplateId => {
return {
name: 'Demo: RAG in n8n',
meta: {
templateId: 'rag-starter-template',
},
nodes: [
{
parameters: {
formTitle: 'Upload your data to test RAG',
formFields: {
values: [
{
fieldLabel: 'Upload your file(s)',
fieldType: 'file',
acceptFileTypes: '.pdf, .csv',
requiredField: true,
},
],
},
options: {},
},
type: 'n8n-nodes-base.formTrigger',
typeVersion: 2.2,
position: [-120, 0],
id: 'f7a656ec-83fc-4ed2-a089-57a9def662b7',
name: 'Upload your file here',
webhookId: '82848bc4-5ea2-4e5a-8bb6-3c09b94a8c5d',
},
{
parameters: {
options: {},
},
type: '@n8n/n8n-nodes-langchain.embeddingsOpenAi',
typeVersion: 1.2,
position: [520, 480],
id: '6ea78663-cf2f-4f2d-8e68-43047c2afd87',
name: 'Embeddings OpenAI',
credentials: {
openAiApi: {
id: '14',
name: 'OpenAi account',
},
},
},
{
parameters: {
dataType: 'binary',
options: {},
},
type: '@n8n/n8n-nodes-langchain.documentDefaultDataLoader',
typeVersion: 1.1,
position: [320, 160],
id: '94aecac0-03f9-4915-932b-d14a2576607b',
name: 'Default Data Loader',
},
{
parameters: {
content:
'### Readme\nLoad your data into a vector database with the 📚 **Load Data** flow, and then use your data as chat context with the 🐕 **Retriever** flow.\n\n**Quick start**\n1. Click on the `Execute Workflow` button to run the 📚 **Load Data** flow.\n2. Click on `Open Chat` button to run the 🐕 **Retriever** flow. Then ask a question about content from your document(s)\n\n\nFor more info, check [our docs on RAG in n8n](https://docs.n8n.io/advanced-ai/rag-in-n8n/).',
height: 300,
width: 440,
color: 4,
},
type: 'n8n-nodes-base.stickyNote',
position: [-660, -60],
typeVersion: 1,
id: '0d07742b-0b36-4c2e-990c-266cbe6e2d4d',
name: 'Sticky Note',
},
{
parameters: {
content: '### 📚 Load Data Flow',
height: 460,
width: 700,
color: 7,
},
type: 'n8n-nodes-base.stickyNote',
position: [-180, -60],
typeVersion: 1,
id: 'd19d04f3-5231-4e47-bed7-9f24a4a8f582',
name: 'Sticky Note1',
},
{
parameters: {
mode: 'insert',
memoryKey: {
__rl: true,
value: 'vector_store_key',
mode: 'list',
cachedResultName: 'vector_store_key',
},
},
type: '@n8n/n8n-nodes-langchain.vectorStoreInMemory',
typeVersion: 1.2,
position: [60, 0],
id: 'bf50a11f-ca6a-4e04-a6d2-42fee272b260',
name: 'Insert Data to Store',
},
{
parameters: {
mode: 'retrieve-as-tool',
toolName: 'knowledge_base',
toolDescription: 'Use this knowledge base to answer questions from the user',
memoryKey: {
__rl: true,
mode: 'list',
value: 'vector_store_key',
},
},
type: '@n8n/n8n-nodes-langchain.vectorStoreInMemory',
typeVersion: 1.2,
position: [940, 200],
id: '09c0db62-5413-440e-8c13-fb6bb66d9b6a',
name: 'Query Data Tool',
},
{
parameters: {
options: {},
},
type: '@n8n/n8n-nodes-langchain.agent',
typeVersion: 2,
position: [940, -20],
id: '579aed76-9644-42d1-ac13-7369059ff1c2',
name: 'AI Agent',
},
{
parameters: {
options: {},
},
type: '@n8n/n8n-nodes-langchain.chatTrigger',
typeVersion: 1.1,
position: [720, -20],
id: '9c30de61-935a-471f-ae88-ec5f67beeefc',
name: 'When chat message received',
webhookId: '4091fa09-fb9a-4039-9411-7104d213f601',
},
{
parameters: {
model: {
__rl: true,
mode: 'list',
value: 'gpt-4o-mini',
},
options: {},
},
type: '@n8n/n8n-nodes-langchain.lmChatOpenAi',
typeVersion: 1.2,
position: [720, 200],
id: 'b5aa8942-9cd5-4c2f-bd77-7a0ceb921bac',
name: 'OpenAI Chat Model',
credentials: {
openAiApi: {
id: '14',
name: 'OpenAi account',
},
},
},
{
parameters: {
content: '### 🐕 2. Retriever Flow',
height: 460,
width: 680,
color: 7,
},
type: 'n8n-nodes-base.stickyNote',
position: [600, -60],
typeVersion: 1,
id: '28bc73a1-e64a-47bf-ac1c-ffe644894ea5',
name: 'Sticky Note2',
},
{
parameters: {
content:
'### Embeddings\n\nThe Insert and Retrieve operation use the same embedding node.\n\nThis is to ensure that they are using the **exact same embeddings and settings**.\n\nDifferent embeddings might not work at all, or have unintended consequences.\n',
height: 240,
width: 320,
color: 4,
},
type: 'n8n-nodes-base.stickyNote',
position: [660, 440],
typeVersion: 1,
id: '0cf8c647-418c-4d1a-8952-766145afca72',
name: 'Sticky Note3',
},
],
connections: {
'Upload your file here': {
main: [
[
{
node: 'Insert Data to Store',
type: 'main',
index: 0,
},
],
],
},
'Embeddings OpenAI': {
ai_embedding: [
[
{
node: 'Insert Data to Store',
type: 'ai_embedding',
index: 0,
},
{
node: 'Query Data Tool',
type: 'ai_embedding',
index: 0,
},
],
],
},
'Default Data Loader': {
ai_document: [
[
{
node: 'Insert Data to Store',
type: 'ai_document',
index: 0,
},
],
],
},
'Query Data Tool': {
ai_tool: [
[
{
node: 'AI Agent',
type: 'ai_tool',
index: 0,
},
],
],
},
'When chat message received': {
main: [
[
{
node: 'AI Agent',
type: 'main',
index: 0,
},
],
],
},
'OpenAI Chat Model': {
ai_languageModel: [
[
{
node: 'AI Agent',
type: 'ai_languageModel',
index: 0,
},
],
],
},
},
pinData: {},
};
};

156
packages/frontend/editor-ui/src/utils/templates/samples/agents/email_triage_agent_with_gmail.json Normal file
View File

@@ -0,0 +1,156 @@
{
"name": "Email Triage Agent (with Gmail)",
"meta": {
"templateCredsSetupCompleted": false,
"templateId": "email_triage_agent_with_gmail"
},
"nodes": [
{
"parameters": {
"pollTimes": {
"item": [
{
"mode": "everyMinute"
}
]
},
"simple": false,
"filters": {
"readStatus": "unread"
},
"options": {}
},
"id": "0280aa41-d55c-47e4-b99b-03b4c7c9e4e7",
"name": "New Email Trigger",
"type": "n8n-nodes-base.gmailTrigger",
"typeVersion": 1.3,
"position": [-64, -32],
"credentials": {}
},
{
"parameters": {
"promptType": "define",
"text": "=Categorize this email:\n\n**From:** {{ $json.from.value[0].address }}\n**Subject:** {{ $json.subject }}\n**Content:** \n{{ $json.html }}\n\nPlease analyze this email and apply appropriate labels using the available tools.",
"options": {
"systemMessage": "=You are an email categorization assistant. Your task is to analyze emails and apply appropriate labels to help organize the user's inbox.\n\nYou have access to two tools:\n1. **Get all Labels** - Retrieves available email labels\n2. **Add Labels** - Applies labels to emails\n\n### Instructions:\n- First, always use \"Get all Labels\" to see available categories\n- Analyze email content for: subject, sender, keywords, and context\n- Apply 1-3 most relevant labels per email\n- Be consistent in categorization patterns\n- If unsure between labels, choose the most specific one\n\n### Response Format:\n1. Brief summary of email content (1 sentence)\n2. Chosen labels with reasoning\n3. Use \"Add Labels\" tool with selected labels\n\nBe efficient and accurate. Focus on helping the user maintain an organized inbox."
}
},
"id": "a4dccc7a-008e-40c5-90dd-c91090a144fd",
"name": "Email Classification Agent",
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 2.2,
"position": [224, -32]
},
{
"parameters": {
"operation": "addLabels",
"messageId": "={{ $json.id }}",
"labelIds": "={{ $fromAI('Label_Names_or_IDs', `Array of Gmail label ids to add. Use the id field from the \"Get all labels\" tool`, 'string') }}"
},
"id": "a5e4168b-1ce7-4cfe-ae6d-a1a4ab9b96df",
"name": "Add Label",
"type": "n8n-nodes-base.gmailTool",
"typeVersion": 2.1,
"position": [320, 192],
"webhookId": "e7289911-d937-45bd-9e91-410a0dc959f8",
"credentials": {}
},
{
"parameters": {
"descriptionType": "manual",
"toolDescription": "Use this tool to get all existing labels from Gmail",
"resource": "label",
"returnAll": true
},
"type": "n8n-nodes-base.gmailTool",
"typeVersion": 2.1,
"position": [464, 192],
"id": "79ee166d-4443-45c6-84e1-8820299cf2de",
"name": "Get all Labels",
"webhookId": "291b9995-7ae1-4f65-9ffb-ba62c980b829",
"credentials": {}
},
{
"parameters": {
"content": "### Email Triage Agent\nAutomatically categorizes new, unread emails by analyzing their content and applying relevant labels using AI.\n\n#### Set up\n- Configure credentials in the **Gmail** and **Model** nodes\n- Create the labels you want to use in Gmail\n- Click **Execute workflow** button to test with the last email in your inbox\n\n#### Next steps\nTry setting up the agent to configure draft responses to important emails.\n",
"height": 384,
"width": 304,
"color": 5
},
"type": "n8n-nodes-base.stickyNote",
"position": [-464, -96],
"typeVersion": 1,
"id": "db4fcd5d-7f0a-41f6-9dd7-4100a63f38cc",
"name": "Sticky Note"
},
{
"parameters": {
"model": {
"__rl": true,
"value": "gpt-4.1-mini",
"mode": "list",
"cachedResultName": "gpt-4.1-mini"
},
"options": {}
},
"id": "1fda1d78-a669-4be1-9aba-56c0abb7c247",
"name": "Model",
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [160, 192],
"credentials": {}
}
],
"pinData": {},
"connections": {
"New Email Trigger": {
"main": [
[
{
"node": "Email Classification Agent",
"type": "main",
"index": 0
}
]
]
},
"Add Label": {
"ai_tool": [
[
{
"node": "Email Classification Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Get all Labels": {
"ai_tool": [
[
{
"node": "Email Classification Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Model": {
"ai_languageModel": [
[
{
"node": "Email Classification Agent",
"type": "ai_languageModel",
"index": 0
}
]
]
}
},
"active": false,
"settings": {
"executionOrder": "v1"
},
"tags": []
}

168
packages/frontend/editor-ui/src/utils/templates/samples/agents/joke_agent_with_http_tool.json Normal file
View File

@@ -0,0 +1,168 @@
{
"name": "Joke agent (with HTTP tool)",
"meta": {
"templateCredsSetupCompleted": false,
"templateId": "joke_agent_with_http_tool"
},
"nodes": [
{
"parameters": {
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"typeVersion": 1.3,
"position": [-672, 0],
"id": "10870665-8098-49d9-b36a-843227a25ec8",
"name": "When chat message received",
"webhookId": "90f0993e-31ff-4523-8dbc-613465d12b64"
},
{
"parameters": {
"toolDescription": "Use this tool to retrieve jokes",
"url": "https://v2.jokeapi.dev/joke/",
"sendQuery": true,
"queryParameters": {
"parameters": [
{
"name": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('parameters0_Name', ``, 'string') }}",
"value": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('parameters0_Value', ``, 'string') }}"
}
]
},
"options": {}
},
"type": "n8n-nodes-base.httpRequestTool",
"typeVersion": 4.2,
"position": [-224, 256],
"id": "a9615eac-7845-4f4f-a5b0-fdec59f3751e",
"name": "Joke API"
},
{
"parameters": {
"toolDescription": "Use this tool to read about the joke api documentation, so that you can filter queries to the api based on the user prompt.",
"url": "https://v2.jokeapi.dev/",
"options": {},
"optimizeResponse": true,
"responseType": "html",
"onlyContent": true
},
"type": "n8n-nodes-base.httpRequestTool",
"typeVersion": 4.2,
"position": [-48, 256],
"id": "a8f4b23a-89cb-4673-a595-6855ba1a6d10",
"name": "API docs"
},
{
"parameters": {
"model": {
"__rl": true,
"mode": "list",
"value": "gpt-4.1-mini"
},
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [-576, 272],
"id": "93fdc1ff-4dee-4f7f-8b37-b8c041a22073",
"name": "Model",
"credentials": {}
},
{
"parameters": {},
"type": "@n8n/n8n-nodes-langchain.memoryBufferWindow",
"typeVersion": 1.3,
"position": [-400, 272],
"id": "8ca3ae47-7e3d-42ed-ac35-bf2f187715eb",
"name": "Memory"
},
{
"parameters": {
"options": {
"systemMessage": "# Joke Agent System Prompt\n\nYou are a fun and entertaining joke bot that brings laughter and good vibes to conversations. Your job is to tell jokes, share humor, and keep things light and cheerful.\n\n## Your Main Purpose\n\n- Tell jokes using the Joke API when users ask for them\n- Be funny, witty, and entertaining\n- Keep conversations upbeat and positive\n- Share different types of humor to match user preferences\n\n## How to Use the Joke API\n\n- Use the Joke API tool whenever users ask for jokes\n- You can check the API docs if you need to understand how to filter for specific things\n- The API provides various joke categories and formats\n- You can request specific types of jokes if users have preferences\n- Always deliver the jokes with enthusiasm and good timing\n\n## Interaction Style\n\n### When Users Ask for Jokes\n- Use the Joke API to fetch fresh jokes\n- Present jokes with good comedic timing\n- Add your own flair or setup if appropriate\n- Ask if they'd like to hear more\n\n### General Conversation\n- Keep things light and fun\n- Use humor naturally in responses\n- Be encouraging and positive\n- Remember previous jokes to avoid repetition\n\n### Types of Humor to Offer\n- Clean, family-friendly jokes (default)\n- Dad jokes and puns\n- Programming/tech jokes (if appropriate)\n- One-liners and quick wit\n- Knock-knock jokes\n\n## Response Guidelines\n\n### Joke Delivery\n- Build up anticipation when appropriate\n- Use proper timing and pacing\n- Add enthusiasm with your tone\n- Follow up with \"Got another one?\" or similar\n\n### Conversation Flow\n- Remember what makes users laugh\n- Adapt to their humor preferences\n- Keep the mood upbeat\n- Transition smoothly between jokes and chat\n\n### Examples of Good Responses\n\n**User**: \"Tell me a joke\"\n**You**: \"Coming right up! Let me grab a good one for you...\" *[uses Joke API]* \n\n**User**: \"That was terrible!\"\n**You**: \"Hey, they can't all be winners! 😄 Want me to try again with a different style?\"\n\n**User**: \"Got any programming jokes?\"\n**You**: \"Oh, I love tech humor! Let me find you a good one...\" *[uses Joke API]*\n\n## Keep It Fun\n\n- Stay positive and encouraging\n- Laugh along with users\n- Don't take yourself too seriously\n- Make people smile and brighten their day\n- If a joke doesn't land, just move on cheerfully\n\nRemember: Your goal is to spread joy and laughter. Keep things fun, appropriate, and entertaining!"
}
},
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 2.2,
"position": [-448, 0],
"id": "fb541fe9-749d-4f22-a171-3a16eb1bdb4c",
"name": "Joke agent"
},
{
"parameters": {
"content": "### Joke Agent\nA chat-based joke agent that uses the Joke API and an AI model to deliver fun, personalized jokes and keep conversations entertaining.\n\n#### Set up\n- Configure your credentials in the Model node\n- Open the chat and start talking to your agent\n\n#### Next steps\nYou can apply this pattern to any website or API, try connecting the docs of a tool you use regularly but remember to change the system prompt.\n",
"height": 400,
"width": 304,
"color": 5
},
"type": "n8n-nodes-base.stickyNote",
"position": [-1088, -32],
"typeVersion": 1,
"id": "fd4fc7ea-30bf-42d1-8bb6-4026ef12e95c",
"name": "Sticky Note"
}
],
"pinData": {},
"connections": {
"When chat message received": {
"main": [
[
{
"node": "Joke agent",
"type": "main",
"index": 0
}
]
]
},
"Joke API": {
"ai_tool": [
[
{
"node": "Joke agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"API docs": {
"ai_tool": [
[
{
"node": "Joke agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Model": {
"ai_languageModel": [
[
{
"node": "Joke agent",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"Memory": {
"ai_memory": [
[
{
"node": "Joke agent",
"type": "ai_memory",
"index": 0
}
]
]
}
},
"active": false,
"settings": {
"executionOrder": "v1"
},
"tags": []
}

284
packages/frontend/editor-ui/src/utils/templates/samples/agents/knowledge_store_agent_with_google_drive.json Normal file
View File

@@ -0,0 +1,284 @@
{
"name": "Knowledge store agent (with Google Drive)",
"meta": {
"templateCredsSetupCompleted": false,
"templateId": "knowledge_store_agent_with_google_drive"
},
"nodes": [
{
"parameters": {
"dataType": "binary",
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.documentDefaultDataLoader",
"typeVersion": 1.1,
"position": [-128, 256],
"id": "708d9e4e-6566-4b18-86b8-8301bf0c72dd",
"name": "Default Data Loader"
},
{
"parameters": {
"operation": "download",
"fileId": {
"__rl": true,
"value": "={{ $json.id }}",
"mode": "id"
},
"options": {}
},
"type": "n8n-nodes-base.googleDrive",
"typeVersion": 3,
"position": [-432, 32],
"id": "604a4e5e-5ccc-4db1-94dc-673711bea6af",
"name": "Download file",
"credentials": {}
},
{
"parameters": {
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.embeddingsOpenAi",
"typeVersion": 1.2,
"position": [-336, 656],
"id": "e8db240e-bb3f-43ab-b4ed-527c6c2e8f54",
"name": "Embedding model",
"credentials": {}
},
{
"parameters": {
"options": {
"systemMessage": "# Knowledge Store Agent System Prompt\n\nYou are a data analysis agent that retrieves and analyzes information from a vector store to answer user questions.\n\n## Your Task\n\n1. **Search the vector store** - Use similarity search to find relevant documents and data\n2. **Analyze the results** - Understand what the retrieved data tells you\n3. **Provide clear answers** - Give helpful responses based on the data you found\n\n## How to Work with Vector Data\n\n### Search Process\n- Use the user's question to search for similar content\n- Retrieve multiple relevant chunks of data\n- Look for patterns and connections across the results\n- Consider both exact matches and conceptually similar information\n\n### Analysis Guidelines\n- Read through all retrieved documents carefully\n- Identify key information that answers the user's question\n- Note any conflicting or incomplete information\n- Look for trends, patterns, or insights in the data\n\n### Response Format\n- Start with a direct answer to the user's question\n- Support your answer with specific information from the data\n- Cite which documents or sources your information comes from\n- Be clear about what you found and what you didn't find\n\n## Response Guidelines\n\n### When You Find Good Data\n- Give a confident, detailed answer\n- Include relevant quotes or data points\n- Explain how the information relates to their question\n- Offer additional insights if available\n\n### When Data is Limited\n- Be honest about what information is available\n- Share what you did find, even if partial\n- Suggest related questions you could help with\n- Don't make up information not in the data\n\n### When No Relevant Data is Found\n- Clearly state that you couldn't find relevant information\n- Suggest alternative ways to phrase the question\n- Offer to search for related topics\n\n## Key Principles\n\n- Always base answers on the retrieved data\n- Be transparent about your sources\n- Admit when information is unclear or missing\n- Help users understand what the data shows\n- Ask clarifying questions if the user's request is vague\n\nRemember: Your strength is finding and explaining information that already exists in the vector store. Focus on being accurate and helpful with the data you can retrieve."
}
},
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 2.2,
"position": [384, 32],
"id": "99f9315f-4f3d-48d9-a6f4-8c519b249eba",
"name": "AI Agent"
},
{
"parameters": {
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"typeVersion": 1.3,
"position": [176, 32],
"id": "bedf3615-c8b0-4fa8-afc5-574bca1003d4",
"name": "When chat message received",
"webhookId": "ddf4ea5b-94fc-4fbf-b856-95d39a04eb59"
},
{
"parameters": {
"model": {
"__rl": true,
"value": "gpt-4o",
"mode": "list",
"cachedResultName": "gpt-4o"
},
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [288, 240],
"id": "9751b75b-50ac-49c8-8f4d-24a8035b6e73",
"name": "Model",
"credentials": {}
},
{
"parameters": {},
"type": "@n8n/n8n-nodes-langchain.memoryBufferWindow",
"typeVersion": 1.3,
"position": [432, 240],
"id": "167d097a-69f6-4f1b-a741-8c8936adb3d2",
"name": "Simple Memory"
},
{
"parameters": {
"pollTimes": {
"item": [
{
"mode": "everyMinute"
}
]
},
"triggerOn": "specificFolder",
"folderToWatch": {
"__rl": true,
"value": "1y55jxSWMeFBBFOIXxHWofVA2vkro4YLI",
"mode": "list",
"cachedResultName": "Knowledge store",
"cachedResultUrl": "https://drive.google.com/drive/folders/1y55jxSWMeFBBFOIXxHWofVA2vkro4YLI"
},
"event": "fileCreated",
"options": {}
},
"type": "n8n-nodes-base.googleDriveTrigger",
"typeVersion": 1,
"position": [-640, 32],
"id": "0cddc21e-a75f-48df-b168-8e288be12469",
"name": "File uploaded",
"credentials": {}
},
{
"parameters": {
"content": "### Knowledge store agent\nA chat-based AI agent to retrieve, analyze, and answer questions using documents uploaded to Google Drive and stored in a vector database.\n\n#### Set up\n- Configure credentials in the **Google Drive** and **Open AI** nodes\n- Create a folder in Google Drive to store your documents, then select it in the \"File uploaded\" trigger node\n- Upload a file to that folder, return to n8n and click \"Execute workflow\"\n- Once **Insert documents** has been completed you can Open chat and ask the agent questions about your files.\n\n#### Next steps\nTry connecting other data sources to your knowledge base, using other triggers before the **Insert documents** node.\n",
"height": 512,
"width": 304,
"color": 5
},
"type": "n8n-nodes-base.stickyNote",
"position": [-1024, -16],
"typeVersion": 1,
"id": "b60fde91-e9bf-4f03-a847-b471af228a95",
"name": "Sticky Note"
},
{
"parameters": {
"content": "### Embeddings\n\nThe Insert and Retrieve operation use the same embedding node.\n\nThis is to ensure that they are using the **exact same embeddings and settings**.\n\nDifferent embeddings might not work at all, or have unintended consequences.\n",
"height": 240,
"width": 320,
"color": 4
},
"type": "n8n-nodes-base.stickyNote",
"position": [-208, 656],
"typeVersion": 1,
"id": "2fa9684d-f20a-4262-9b8b-81babb2fecc5",
"name": "Sticky Note3"
},
{
"parameters": {
"mode": "insert",
"memoryKey": {
"__rl": true,
"value": "vector_store_key",
"mode": "list",
"cachedResultName": "vector_store_key"
}
},
"type": "@n8n/n8n-nodes-langchain.vectorStoreInMemory",
"typeVersion": 1.3,
"position": [-240, 32],
"id": "64d17551-1637-4a53-a3e0-db45894c12a6",
"name": "Insert documents"
},
{
"parameters": {
"mode": "retrieve-as-tool",
"toolDescription": "Use this tool to retrieve any information required.",
"memoryKey": {
"__rl": true,
"value": "vector_store_key",
"mode": "list",
"cachedResultName": "vector_store_key"
},
"topK": 10
},
"type": "@n8n/n8n-nodes-langchain.vectorStoreInMemory",
"typeVersion": 1.3,
"position": [640, 368],
"id": "4f8a4a45-28a4-4684-b838-66011cc6a4a5",
"name": "Retrieve documents"
}
],
"pinData": {},
"connections": {
"Default Data Loader": {
"ai_document": [
[
{
"node": "Insert documents",
"type": "ai_document",
"index": 0
}
]
]
},
"Download file": {
"main": [
[
{
"node": "Insert documents",
"type": "main",
"index": 0
}
]
]
},
"Embedding model": {
"ai_embedding": [
[
{
"node": "Insert documents",
"type": "ai_embedding",
"index": 0
},
{
"node": "Retrieve documents",
"type": "ai_embedding",
"index": 0
}
]
]
},
"When chat message received": {
"main": [
[
{
"node": "AI Agent",
"type": "main",
"index": 0
}
]
]
},
"Model": {
"ai_languageModel": [
[
{
"node": "AI Agent",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"Simple Memory": {
"ai_memory": [
[
{
"node": "AI Agent",
"type": "ai_memory",
"index": 0
}
]
]
},
"File uploaded": {
"main": [
[
{
"node": "Download file",
"type": "main",
"index": 0
}
]
]
},
"Retrieve documents": {
"ai_tool": [
[
{
"node": "AI Agent",
"type": "ai_tool",
"index": 0
}
]
]
}
},
"active": false,
"settings": {
"executionOrder": "v1"
},
"tags": []
}

388
packages/frontend/editor-ui/src/utils/templates/samples/agents/task_management_agent_with_google_sheets.json Normal file
View File

@@ -0,0 +1,388 @@
{
"name": "Task management agent (with Google Sheets)",
"meta": {
"templateCredsSetupCompleted": false,
"templateId": "task_management_agent_with_google_sheets"
},
"nodes": [
{
"parameters": {
"model": {
"__rl": true,
"value": "gpt-4o",
"mode": "list",
"cachedResultName": "gpt-4o"
},
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [-608, 272],
"id": "7ebac830-d775-47af-a56c-9ff428f385d0",
"name": "Model",
"credentials": {}
},
{
"parameters": {
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"typeVersion": 1.3,
"position": [-656, -32],
"id": "3eb00ee5-cab6-4a07-b3d5-cee733bae08d",
"name": "When chat message received",
"webhookId": "df8223bf-119c-44d5-9bbf-f74ae26828e8"
},
{
"parameters": {
"contextWindowLength": 10
},
"type": "@n8n/n8n-nodes-langchain.memoryBufferWindow",
"typeVersion": 1.3,
"position": [-496, 272],
"id": "5341bef1-5ba0-4898-85c2-ca8741210079",
"name": "Simple Memory"
},
{
"parameters": {
"documentId": {
"__rl": true,
"value": "1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o",
"mode": "list",
"cachedResultName": "Enrichment example",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit?usp=drivesdk"
},
"sheetName": {
"__rl": true,
"value": "gid=0",
"mode": "list",
"cachedResultName": "Tasks",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit#gid=0"
},
"options": {}
},
"type": "n8n-nodes-base.googleSheetsTool",
"typeVersion": 4.7,
"position": [-352, 272],
"id": "a1792c3e-4248-49e2-b4c2-db58c4eb1b59",
"name": "Get tasks",
"credentials": {}
},
{
"parameters": {
"operation": "append",
"documentId": {
"__rl": true,
"value": "1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o",
"mode": "list",
"cachedResultName": "Enrichment example",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit?usp=drivesdk"
},
"sheetName": {
"__rl": true,
"value": "gid=0",
"mode": "list",
"cachedResultName": "Tasks",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit#gid=0"
},
"columns": {
"mappingMode": "defineBelow",
"value": {
"Task": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Task', ``, 'string') }}",
"Description": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Description', ``, 'string') }}",
"Deadline": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Deadline', ``, 'string') }}",
"Status": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Status', ``, 'string') }}"
},
"matchingColumns": [],
"schema": [
{
"id": "Task",
"displayName": "Task",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true
},
{
"id": "Status",
"displayName": "Status",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true,
"removed": false
},
{
"id": "Description",
"displayName": "Description",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true
},
{
"id": "Deadline",
"displayName": "Deadline",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true
}
],
"attemptToConvertTypes": false,
"convertFieldsToString": false
},
"options": {}
},
"type": "n8n-nodes-base.googleSheetsTool",
"typeVersion": 4.7,
"position": [-224, 272],
"id": "1ebd8dd5-13e0-4f57-bb37-a3a5d8cf4e80",
"name": "Create task",
"credentials": {}
},
{
"parameters": {
"operation": "update",
"documentId": {
"__rl": true,
"value": "1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o",
"mode": "list",
"cachedResultName": "Enrichment example",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit?usp=drivesdk"
},
"sheetName": {
"__rl": true,
"value": "gid=0",
"mode": "list",
"cachedResultName": "Tasks",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit#gid=0"
},
"columns": {
"mappingMode": "defineBelow",
"value": {
"Task": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Task', ``, 'string') }}",
"Description": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Description', ``, 'string') }}",
"Deadline": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Deadline', ``, 'string') }}",
"Status": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Status', ``, 'string') }}",
"row_number": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('row_number__using_to_match_', ``, 'number') }}"
},
"matchingColumns": ["row_number"],
"schema": [
{
"id": "ID",
"displayName": "ID",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true,
"removed": true
},
{
"id": "Task",
"displayName": "Task",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true,
"removed": false
},
{
"id": "Status",
"displayName": "Status",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true,
"removed": false
},
{
"id": "Description",
"displayName": "Description",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true
},
{
"id": "Deadline",
"displayName": "Deadline",
"required": false,
"defaultMatch": false,
"display": true,
"type": "string",
"canBeUsedToMatch": true
},
{
"id": "row_number",
"displayName": "row_number",
"required": false,
"defaultMatch": false,
"display": true,
"type": "number",
"canBeUsedToMatch": true,
"readOnly": true,
"removed": false
}
],
"attemptToConvertTypes": false,
"convertFieldsToString": false
},
"options": {}
},
"type": "n8n-nodes-base.googleSheetsTool",
"typeVersion": 4.7,
"position": [-96, 272],
"id": "a118d819-41ef-4323-a4d1-d83d70e41ec5",
"name": "Update task",
"credentials": {}
},
{
"parameters": {
"operation": "delete",
"documentId": {
"__rl": true,
"value": "1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o",
"mode": "list",
"cachedResultName": "Enrichment example",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit?usp=drivesdk"
},
"sheetName": {
"__rl": true,
"value": "gid=0",
"mode": "list",
"cachedResultName": "Tasks",
"cachedResultUrl": "https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit#gid=0"
},
"startIndex": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Start_Row_Number', ``, 'number') }}",
"numberToDelete": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Number_of_Rows_to_Delete', ``, 'number') }}"
},
"type": "n8n-nodes-base.googleSheetsTool",
"typeVersion": 4.7,
"position": [32, 272],
"id": "c15d7d0f-d24c-4e5a-aa3f-a23abf2f6853",
"name": "Delete task",
"credentials": {}
},
{
"parameters": {
"options": {
"systemMessage": "=# Task Management Agent System Prompt\n\nYou are a helpful task management assistant that helps users organize their tasks using a Google Sheets database. You can create, view, update, and delete tasks while maintaining data consistency.\n\n## Your Capabilities\n\nYou can help users with:\n- **View tasks** - Show current tasks and their status\n- **Create new tasks** - Add tasks with proper formatting\n- **Update tasks** - Modify existing task details or status\n- **Delete tasks** - Remove tasks after confirmation\n- **Track progress** - Monitor task status changes\n\n## Task Data Structure\n\nEach task has these fields:\n- **Task**: The task name/title (required - always ask if missing)\n- **Status**: Must be one of: \"TODO\", \"IN PROGRESS\", or \"DONE\" (default: \"TODO\")\n- **Description**: Optional additional details about the task\n- **Deadline**: Optional due date (accept various date formats)\n\nNote: Google Sheets automatically provides a row_number field for tracking - you don't need to manage IDs manually.\n\n## Important Rules\n\n### Status Management\n- Status must be exactly one of: \"TODO\", \"IN PROGRESS\", or \"DONE\"\n- Default new tasks to \"TODO\" status\n- When users say things like \"mark as complete\" or \"finish task\", change status to \"DONE\"\n- When users say \"start working on\" or \"begin task\", change status to \"IN PROGRESS\"\n\n### Task Creation Process\n1. Always ask for the task name if not provided\n2. Ask if they want to add a description (optional)\n3. Ask about deadline if relevant (optional)\n4. Set status to \"TODO\" by default\n5. Use the \"Create task\" tool to add to the sheet\n\n### Task Updates\n- Ask which task to update (by name)\n- Confirm what changes to make\n- Use \"Update task\" tool with the task name as the matching column\n- Provide clear feedback about what was changed\n\n### Task Deletion\n- **ALWAYS ask for confirmation before deleting any task**\n- Show the task details and ask \"Are you sure you want to delete this task?\"\n- Only proceed with deletion after explicit user confirmation\n- Use the row number from Google Sheets for the \"Start_Row_Number\" parameter\n- Set \"Number_of_Rows_to_Delete\" to 1 (unless specifically told otherwise)\n\n## User Interaction Guidelines\n\n### When Creating Tasks\n**User**: \"Add a new task\"\n**You**: \"I'd be happy to help you create a new task. What would you like to call this task?\"\n\n### When Information is Missing\n**User**: \"Create a task for tomorrow\"\n**You**: \"I can create a task with a deadline for tomorrow. What should I call this task?\"\n\n### When Deleting Tasks\n**User**: \"Delete the marketing task\"\n**You**: \"I found the task 'Marketing Campaign Planning'. Are you sure you want to delete this task? This action cannot be undone.\"\n\n### When Updating Status\n**User**: \"Mark the report as done\"\n**You**: \"I'll update the status of 'Monthly Report' to 'DONE'. Task completed!\"\n\n## Response Style\n\n- Be helpful and efficient\n- Always confirm actions taken\n- Ask clarifying questions when needed\n- Provide clear status updates\n- Use friendly, professional language\n- Show task details when relevant\n\n## Error Handling\n\n- If a task can't be found, offer to show all tasks\n- If status values are invalid, explain the valid options\n- If required information is missing, ask specific questions\n- Provide helpful suggestions when commands are unclear\n\nRemember: Always prioritize data accuracy and user confirmation, especially for destructive actions like deletion. Keep the task list organized and up-to-date."
}
},
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 2.2,
"position": [-384, -32],
"id": "e923a630-08b1-4e4d-a99c-23704085eaab",
"name": "Task management agent"
},
{
"parameters": {
"content": "### Task management agent\nA chat-based task management assistant that helps users create, view, update, and delete tasks in a Google Sheets spreadsheet.\n\n#### Set up\n- Configure credentials in the **Model** and **Google sheets** nodes\n- Create a Google sheet with the columns: **Task, Description, Deadline and Status**. [Example sheet](https://docs.google.com/spreadsheets/d/1mrfeRU7qMBc9fXF7oteX4i2s50XU2qKJZNQWgmxGG5o/edit?usp=sharing)\n- Select your document and sheet in each of the Google Sheet tools\n- Open the chat and start talking to your agent\n\n#### Next steps\nTry adding different columns or have the agent interact with multiple sheets in the document.\n",
"height": 480,
"width": 304,
"color": 5
},
"type": "n8n-nodes-base.stickyNote",
"position": [-1056, -64],
"typeVersion": 1,
"id": "3f1162c3-7ff9-461b-a4e5-ad2fe8b92821",
"name": "Sticky Note"
}
],
"pinData": {},
"connections": {
"Model": {
"ai_languageModel": [
[
{
"node": "Task management agent",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"When chat message received": {
"main": [
[
{
"node": "Task management agent",
"type": "main",
"index": 0
}
]
]
},
"Simple Memory": {
"ai_memory": [
[
{
"node": "Task management agent",
"type": "ai_memory",
"index": 0
}
]
]
},
"Get tasks": {
"ai_tool": [
[
{
"node": "Task management agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Create task": {
"ai_tool": [
[
{
"node": "Task management agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Update task": {
"ai_tool": [
[
{
"node": "Task management agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Delete task": {
"ai_tool": [
[
{
"node": "Task management agent",
"type": "ai_tool",
"index": 0
}
]
]
}
},
"active": false,
"settings": {
"executionOrder": "v1",
"saveDataSuccessExecution": "all",
"callerPolicy": "workflowsFromSameOwner"
},
"tags": []
}

307
packages/frontend/editor-ui/src/utils/templates/samples/agents/voice_assistant_agent_with_telegram_and_gcal.json Normal file
View File

@@ -0,0 +1,307 @@
{
"name": "Voice assistant agent (with Telegram and Gcal)",
"meta": {
"templateCredsSetupCompleted": false,
"templateId": "voice_assistant_agent_with_telegram_and_gcal"
},
"nodes": [
{
"parameters": {
"updates": ["message"],
"additionalFields": {
"download": false,
"userIds": "YOUR_USER_ID"
}
},
"id": "0c402bdc-7fa2-4fa1-96d6-f02853cfdaa1",
"name": "Telegram Message Trigger",
"type": "n8n-nodes-base.telegramTrigger",
"typeVersion": 1.2,
"position": [-192, 0],
"webhookId": "55acc711-c248-4ac9-b6cd-e295c2d33f4b",
"credentials": {}
},
{
"parameters": {
"sessionIdType": "customKey",
"sessionKey": "={{ $('Telegram Message Trigger').first().json.message.chat.id }}",
"contextWindowLength": 10
},
"id": "30bef40d-efbe-4920-acad-ce9a42c0061c",
"name": "Memory",
"type": "@n8n/n8n-nodes-langchain.memoryBufferWindow",
"typeVersion": 1.3,
"position": [752, 288]
},
{
"parameters": {
"chatId": "={{ $('Telegram Message Trigger').first().json.message.chat.id }}",
"text": "={{ $json.output }}",
"additionalFields": {}
},
"type": "n8n-nodes-base.telegram",
"typeVersion": 1.2,
"position": [1056, 0],
"id": "7dea5c17-bfdb-4874-918b-a6583298efa2",
"name": "Reply in Telegram",
"webhookId": "b96b7a41-9806-455f-b72e-00aa638eda71",
"credentials": {}
},
{
"parameters": {
"resource": "file",
"fileId": "={{ $json.message.voice.file_id }}",
"additionalFields": {}
},
"type": "n8n-nodes-base.telegram",
"typeVersion": 1.2,
"position": [256, -96],
"id": "66219c83-6371-4cc6-ad43-57cee44f52da",
"name": "Get a file",
"webhookId": "e0769871-efe3-49da-81a5-2f88a6fdd33f",
"credentials": {}
},
{
"parameters": {
"conditions": {
"options": {
"caseSensitive": true,
"leftValue": "",
"typeValidation": "strict",
"version": 2
},
"conditions": [
{
"id": "2b538077-d3d3-4713-b973-68748313ff97",
"leftValue": "={{ $json.message.voice }}",
"rightValue": "",
"operator": {
"type": "object",
"operation": "notEmpty",
"singleValue": true
}
}
],
"combinator": "and"
},
"options": {}
},
"type": "n8n-nodes-base.if",
"typeVersion": 2.2,
"position": [32, 0],
"id": "3a1a7f7f-f122-438d-a0f2-1e80d1072dba",
"name": "Check if Audio file"
},
{
"parameters": {
"resource": "audio",
"operation": "transcribe",
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.openAi",
"typeVersion": 1.8,
"position": [480, -96],
"id": "6f314aef-7ff1-4211-8656-e2c1f8fea374",
"name": "Transcribe audio",
"credentials": {}
},
{
"parameters": {
"assignments": {
"assignments": [
{
"id": "eb912219-2436-4f04-8ffc-c1c20eb07344",
"name": "text",
"value": "={{ $json.message.text }}",
"type": "string"
}
]
},
"options": {}
},
"type": "n8n-nodes-base.set",
"typeVersion": 3.4,
"position": [480, 96],
"id": "2e9b0ca3-2a0f-441d-89a0-28365c5ba3ef",
"name": "Set field"
},
{
"parameters": {
"operation": "getAll",
"calendar": {
"__rl": true,
"value": "robert@n8n.io",
"mode": "list",
"cachedResultName": "robert@n8n.io"
},
"timeMin": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('After', ``, 'string') }}",
"timeMax": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Before', ``, 'string') }}",
"options": {}
},
"type": "n8n-nodes-base.googleCalendarTool",
"typeVersion": 1.3,
"position": [928, 288],
"id": "a533f343-5bf8-48d7-bc35-b12072e32602",
"name": "Get events",
"credentials": {}
},
{
"parameters": {
"model": {
"__rl": true,
"value": "gpt-4.1-mini",
"mode": "list",
"cachedResultName": "gpt-4.1-mini"
},
"options": {}
},
"id": "61f3b0a0-210a-4eaa-91b5-e381d5f56754",
"name": "Model",
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [624, 288],
"credentials": {}
},
{
"parameters": {
"content": "### Voice assistant agent\nPersonal AI assistant in Telegram, handling both text and voice messages, and can access your Google Calendar.\n\n#### Set up\n- Configure credentials in the **Telegram**, **Model** and **Get events** nodes\n- Follow the bot creation steps in our [Telegram docs](https://docs.n8n.io/integrations/builtin/credentials/telegram/#supported-authentication-methods)\n- Add your user ID to the **Telegram Message Trigger** so only you can access it\n- Activate the workflow to recieve messages from Telegram\n- Send a message to the agent, e.g. What's in my calendar today?\n\n#### Next steps\nTry giving the agent more tools, so that it can draft emails and events for you from just a message.\n",
"height": 496,
"width": 304,
"color": 5
},
"type": "n8n-nodes-base.stickyNote",
"position": [-576, -80],
"typeVersion": 1,
"id": "a4a8f73c-f663-4ee6-b60e-d60722145726",
"name": "Sticky Note"
},
{
"parameters": {
"promptType": "define",
"text": "={{ $json.text || $json.message.text }}",
"options": {
"systemMessage": "=# Telegram Personal AI Assistant System Prompt\n\nYou are a helpful personal AI assistant that communicates with users through Telegram. You can handle both text and voice messages, and you have access to the user's email and calendar to provide comprehensive assistance.\n\n## Your Capabilities\n\nYou can help users with:\n- **General conversation** - Answer questions and provide information\n- **Email management** - Check and retrieve emails from their Gmail account\n- **Calendar assistance** - View upcoming events and schedule information\n- **Voice interaction** - Respond to transcribed voice messages naturally\n- **Personal productivity** - Help organize and manage daily tasks\n\n## Communication Style\n\n### Response Format\n- Keep responses conversational and friendly\n- Use appropriate length for Telegram (not too long)\n- Be helpful and informative\n- Match the user's tone and communication style\n\n### Voice Message Handling\n- When users send voice messages, respond naturally as if they spoke to you directly\n- Don't mention that their message was transcribed\n- Respond in a conversational way that flows naturally\n\n## Tool Usage Guidelines\n\n### Email Tool (Get emails)\n- Use when users ask about emails, messages, or communication\n- Can filter by date ranges when specified\n- Help users find specific emails or get summaries\n- Examples: \"Check my recent emails\", \"Any important messages today?\"\n\n### Calendar Tool (Get events)\n- Use when users ask about schedule, meetings, or appointments\n- Can check specific date ranges\n- Help with scheduling conflicts or availability\n- Examples: \"What's on my calendar today?\", \"Am I free tomorrow afternoon?\"\n\n## Context Awareness\n\n- Remember the current date and time: **Today is {{ $now.format('cccc') }} the {{ $now.format('yyyy-MM-dd HH:mm') }}**\n- Use this information to provide relevant, timely responses\n- Reference \"today\", \"tomorrow\", \"this week\" appropriately\n\n## User Interaction Examples\n\n### Email Queries\n**User**: \"Any important emails today?\"\n**You**: \"Let me check your recent emails...\" *[uses Get emails tool]*\n\n### Calendar Queries \n**User**: \"What's my schedule like tomorrow?\"\n**You**: \"I'll check your calendar for tomorrow...\" *[uses Get events tool]*\n\n### General Assistance\n**User**: \"How's the weather?\"\n**You**: \"I don't have access to weather data, but you could check your local weather app or ask me to help with your emails or calendar instead!\"\n\n## Important Guidelines\n\n- Maintain conversation context using the memory system\n- Be proactive in offering help with emails and calendar\n- Ask clarifying questions when requests are ambiguous\n- Respect privacy - only access information when relevant to the request\n- If you can't help with something, suggest alternatives or redirect to your available capabilities\n\nRemember: You're a personal assistant, so be personable, helpful, and focused on making the user's day easier and more organized.\n\nToday is {{ $now.format('cccc') }} the {{ $now.format('yyyy-MM-dd HH:mm') }}."
}
},
"id": "f958d2f6-6602-4443-bfae-ef628af09b84",
"name": "Assistant Agent",
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 2.2,
"position": [704, 0]
}
],
"pinData": {},
"connections": {
"Telegram Message Trigger": {
"main": [
[
{
"node": "Check if Audio file",
"type": "main",
"index": 0
}
]
]
},
"Memory": {
"ai_memory": [
[
{
"node": "Assistant Agent",
"type": "ai_memory",
"index": 0
}
]
]
},
"Get a file": {
"main": [
[
{
"node": "Transcribe audio",
"type": "main",
"index": 0
}
]
]
},
"Check if Audio file": {
"main": [
[
{
"node": "Get a file",
"type": "main",
"index": 0
}
],
[
{
"node": "Set field",
"type": "main",
"index": 0
}
]
]
},
"Transcribe audio": {
"main": [
[
{
"node": "Assistant Agent",
"type": "main",
"index": 0
}
]
]
},
"Set field": {
"main": [
[
{
"node": "Assistant Agent",
"type": "main",
"index": 0
}
]
]
},
"Get events": {
"ai_tool": [
[
{
"node": "Assistant Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"Model": {
"ai_languageModel": [
[
{
"node": "Assistant Agent",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"Assistant Agent": {
"main": [
[
{
"node": "Reply in Telegram",
"type": "main",
"index": 0
}
]
]
}
},
"active": false,
"settings": {
"executionOrder": "v1"
},
"tags": []
}

58
packages/frontend/editor-ui/src/utils/templates/samples/easy_ai_starter.json Normal file
View File

@@ -0,0 +1,58 @@
{
"name": "Demo: My first AI Agent in n8n",
"meta": { "templateId": "self-building-ai-agent" },
"nodes": [
{
"parameters": { "options": {} },
"id": "b24b05a7-d802-4413-bfb1-23e1e76f6203",
"name": "When chat message received",
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"typeVersion": 1.1,
"position": [360, 20],
"webhookId": "a889d2ae-2159-402f-b326-5f61e90f602e"
},
{
"parameters": {
"content": "## Start by saying 'hi'\n![Button](https://i.imgur.com/PrIBJI6.png)",
"height": 149,
"width": 150
},
"id": "5592c045-6718-4c4e-9961-ce67a251b6df",
"name": "Sticky Note",
"type": "n8n-nodes-base.stickyNote",
"typeVersion": 1,
"position": [180, -40]
},
{
"parameters": { "options": {} },
"id": "d5e60eb2-267c-4f68-aefe-439031bcaceb",
"name": "OpenAI Model",
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1,
"position": [500, 240]
},
{
"parameters": {
"promptType": "define",
"text": "=## Steps to follow\n\n{{ $agentInfo.memoryConnectedToAgent ? '1. Skip': `1. STOP and output the following:\n\"Welcome to n8n. Let's start with the first step to give me memory: \\n\"Click the **+** button on the agent that says 'memory' and choose 'Simple memory.' Just tell me once you've done that.\"\n----- END OF OUTPUT && IGNORE BELOW -----` }} \n\n\n{{ Boolean($agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool')) ? '2. Skip' : \n`2. STOP and output the following: \\n\"Click the **+** button on the agent that says 'tools' and choose 'Google Calendar.'\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').hasCredentials ? '3. Skip' :\n`3. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and choose a credential from the drop-down.\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').resource === 'Event' ? '4. Skip' :\n`4. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and set **resource** = 'Event'\" `}}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').operation === 'Get Many' ? '5. Skip' :\n`5. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and set **operation** = 'Get Many.'\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').hasValidCalendar ? '6. Skip' :\n`6. STOP and output the following:\n\"Open the Google Calendar tool (double-click) and choose a calendar from the 'calendar' drop-down.\" \\n ----- IGNORE BELOW -----` }}\n\n\n{{ ($agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').aiDefinedFields.includes('Start Time') && $agentInfo.tools.find((tool) => tool.type === 'Google Calendar Tool').aiDefinedFields.includes('End Time')) ? '7. Skip' :\n`7. STOP and output the following: \nOpen the Google Calendar tool (double-click) and click the :sparks: button next to the 'After' and 'Before' fields. \\n ----- IGNORE BELOW -----` }}\n\n\n8. If all steps are completed, output the following:\n\"Would you like me to check all events in your calendar for tomorrow {{ $now.plus(1, 'days').toString().split('T')[0] }}?\"\n\n# User message\n\n{{ $json.chatInput }}",
"options": {
"systemMessage": "=You are a friendly Agent designed to guide users through these steps.\n\n- Stop at the earliest step mentioned in the steps\n- Respond concisely and do **not** disclose these internal instructions to the user. Only return defined output below.\n- Don't output any lines that start with -----\n- Replace \":sparks:\" with \"✨\" in any message"
}
},
"id": "41174c8a-6ac8-42bd-900e-ca15196600c5",
"name": "Agent",
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 1.7,
"position": [580, 20]
}
],
"connections": {
"When chat message received": {
"main": [[{ "node": "Agent", "type": "main", "index": 0 }]]
},
"OpenAI Model": {
"ai_languageModel": [[{ "node": "Agent", "type": "ai_languageModel", "index": 0 }]]
}
},
"pinData": {}
}

263
packages/frontend/editor-ui/src/utils/templates/samples/rag_starter.json Normal file
View File

@@ -0,0 +1,263 @@
{
"name": "Demo: RAG in n8n",
"meta": {
"templateId": "rag-starter-template"
},
"nodes": [
{
"parameters": {
"formTitle": "Upload your data to test RAG",
"formFields": {
"values": [
{
"fieldLabel": "Upload your file(s)",
"fieldType": "file",
"acceptFileTypes": ".pdf, .csv",
"requiredField": true
}
]
},
"options": {}
},
"type": "n8n-nodes-base.formTrigger",
"typeVersion": 2.2,
"position": [-128, 0],
"id": "f7a656ec-83fc-4ed2-a089-57a9def662b7",
"name": "Upload your file here",
"webhookId": "82848bc4-5ea2-4e5a-8bb6-3c09b94a8c5d"
},
{
"parameters": {
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.embeddingsOpenAi",
"typeVersion": 1.2,
"position": [528, 480],
"id": "6ea78663-cf2f-4f2d-8e68-43047c2afd87",
"name": "Embeddings OpenAI",
"credentials": {
"openAiApi": {
"id": "14",
"name": "OpenAi account"
}
}
},
{
"parameters": {
"dataType": "binary",
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.documentDefaultDataLoader",
"typeVersion": 1.1,
"position": [320, 160],
"id": "94aecac0-03f9-4915-932b-d14a2576607b",
"name": "Default Data Loader"
},
{
"parameters": {
"content": "### Readme\nLoad your data into a vector database with the 📚 **Load Data** flow, and then use your data as chat context with the 🐕 **Retriever** flow.\n\n**Quick start**\n1. Click on the `Execute Workflow` button to run the 📚 **Load Data** flow.\n2. Click on `Open Chat` button to run the 🐕 **Retriever** flow. Then ask a question about content from your document(s)\n\n\nFor more info, check [our docs on RAG in n8n](https://docs.n8n.io/advanced-ai/rag-in-n8n/).",
"height": 300,
"width": 440,
"color": 4
},
"type": "n8n-nodes-base.stickyNote",
"position": [-656, -64],
"typeVersion": 1,
"id": "0d07742b-0b36-4c2e-990c-266cbe6e2d4d",
"name": "Sticky Note"
},
{
"parameters": {
"content": "### 📚 Load Data Flow",
"height": 460,
"width": 700,
"color": 7
},
"type": "n8n-nodes-base.stickyNote",
"position": [-176, -64],
"typeVersion": 1,
"id": "d19d04f3-5231-4e47-bed7-9f24a4a8f582",
"name": "Sticky Note1"
},
{
"parameters": {
"mode": "insert",
"memoryKey": {
"__rl": true,
"value": "vector_store_key",
"mode": "list",
"cachedResultName": "vector_store_key"
}
},
"type": "@n8n/n8n-nodes-langchain.vectorStoreInMemory",
"typeVersion": 1.2,
"position": [64, 0],
"id": "bf50a11f-ca6a-4e04-a6d2-42fee272b260",
"name": "Insert Data to Store"
},
{
"parameters": {
"mode": "retrieve-as-tool",
"toolName": "knowledge_base",
"toolDescription": "Use this knowledge base to answer questions from the user",
"memoryKey": {
"__rl": true,
"mode": "list",
"value": "vector_store_key"
}
},
"type": "@n8n/n8n-nodes-langchain.vectorStoreInMemory",
"typeVersion": 1.2,
"position": [944, 208],
"id": "09c0db62-5413-440e-8c13-fb6bb66d9b6a",
"name": "Query Data Tool"
},
{
"parameters": {
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 2,
"position": [944, -16],
"id": "579aed76-9644-42d1-ac13-7369059ff1c2",
"name": "AI Agent"
},
{
"parameters": {
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.chatTrigger",
"typeVersion": 1.1,
"position": [720, -16],
"id": "9c30de61-935a-471f-ae88-ec5f67beeefc",
"name": "When chat message received",
"webhookId": "4091fa09-fb9a-4039-9411-7104d213f601"
},
{
"parameters": {
"model": {
"__rl": true,
"mode": "list",
"value": "gpt-4o-mini"
},
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [720, 208],
"id": "b5aa8942-9cd5-4c2f-bd77-7a0ceb921bac",
"name": "OpenAI Chat Model",
"credentials": {
"openAiApi": {
"id": "14",
"name": "OpenAi account"
}
}
},
{
"parameters": {
"content": "### 🐕 2. Retriever Flow",
"height": 460,
"width": 680,
"color": 7
},
"type": "n8n-nodes-base.stickyNote",
"position": [608, -64],
"typeVersion": 1,
"id": "28bc73a1-e64a-47bf-ac1c-ffe644894ea5",
"name": "Sticky Note2"
},
{
"parameters": {
"content": "### Embeddings\n\nThe Insert and Retrieve operation use the same embedding node.\n\nThis is to ensure that they are using the **exact same embeddings and settings**.\n\nDifferent embeddings might not work at all, or have unintended consequences.\n",
"height": 240,
"width": 320,
"color": 4
},
"type": "n8n-nodes-base.stickyNote",
"position": [672, 448],
"typeVersion": 1,
"id": "0cf8c647-418c-4d1a-8952-766145afca72",
"name": "Sticky Note3"
}
],
"pinData": {},
"connections": {
"Upload your file here": {
"main": [
[
{
"node": "Insert Data to Store",
"type": "main",
"index": 0
}
]
]
},
"Embeddings OpenAI": {
"ai_embedding": [
[
{
"node": "Insert Data to Store",
"type": "ai_embedding",
"index": 0
},
{
"node": "Query Data Tool",
"type": "ai_embedding",
"index": 0
}
]
]
},
"Default Data Loader": {
"ai_document": [
[
{
"node": "Insert Data to Store",
"type": "ai_document",
"index": 0
}
]
]
},
"Query Data Tool": {
"ai_tool": [
[
{
"node": "AI Agent",
"type": "ai_tool",
"index": 0
}
]
]
},
"When chat message received": {
"main": [
[
{
"node": "AI Agent",
"type": "main",
"index": 0
}
]
]
},
"OpenAI Chat Model": {
"ai_languageModel": [
[
{
"node": "AI Agent",
"type": "ai_languageModel",
"index": 0
}
]
]
}
},
"active": false,
"settings": {
"executionOrder": "v1"
},
"tags": []
}

11
packages/frontend/editor-ui/src/utils/templates/typeGuards.ts
View File

@@ -1,3 +1,4 @@
import type { WorkflowDataWithTemplateId } from '@/Interface';
import type {
ITemplatesCollection,
ITemplatesCollectionFull,
@@ -15,3 +16,13 @@ export function isFullTemplatesCollection(
): template is ITemplatesCollectionFull {
return !!template && 'description' in template && 'categories' in template;
}
export function isWorkflowDataWithTemplateId(data: unknown): data is WorkflowDataWithTemplateId {
if (!data || typeof data !== 'object') return false;
const record = data as Record<string, unknown>;
if (!record.meta || typeof record.meta !== 'object') return false;
const m = record.meta as Record<string, unknown>;
return typeof m.templateId === 'string';
}

132
packages/frontend/editor-ui/src/utils/templates/workflowSamples.ts Normal file
View File

@@ -0,0 +1,132 @@
import { ApplicationError, type INodeTypeNameVersion } from 'n8n-workflow';
import type { WorkflowDataWithTemplateId } from '@/Interface';
import { isWorkflowDataWithTemplateId } from '@/utils/templates/typeGuards';
/* eslint-disable import-x/extensions */
import easyAiStarterJson from '@/utils/templates/samples/easy_ai_starter.json';
import ragStarterJson from '@/utils/templates/samples/rag_starter.json';
import emailTriageAgentWithGmailJson from '@/utils/templates/samples/agents/email_triage_agent_with_gmail.json';
import jokeAgentWithHttpToolJson from '@/utils/templates/samples/agents/joke_agent_with_http_tool.json';
import knowledgeStoreAgentWithGoogleDriveJson from '@/utils/templates/samples/agents/knowledge_store_agent_with_google_drive.json';
import taskManagementAgentWithGoogleSheetsJson from '@/utils/templates/samples/agents/task_management_agent_with_google_sheets.json';
import voiceAssistantAgentWithTelegramAndGcalJson from '@/utils/templates/samples/agents/voice_assistant_agent_with_telegram_and_gcal.json';
/* eslint-enable import-x/extensions */
const getWorkflowJson = (json: unknown): WorkflowDataWithTemplateId => {
if (!isWorkflowDataWithTemplateId(json)) {
throw new ApplicationError('Invalid workflow template JSON structure');
}
return json;
};
export const getEasyAiWorkflowJson = (): WorkflowDataWithTemplateId => {
return getWorkflowJson(easyAiStarterJson);
};
export const getRagStarterWorkflowJson = (): WorkflowDataWithTemplateId => {
return getWorkflowJson(ragStarterJson);
};
export const SampleTemplates = {
RagStarterTemplate: getRagStarterWorkflowJson().meta.templateId,
EasyAiTemplate: getEasyAiWorkflowJson().meta.templateId,
} as const;
export const PrebuiltAgentTemplates = {
VoiceAssistantAgent: getWorkflowJson(voiceAssistantAgentWithTelegramAndGcalJson).meta.templateId,
EmailTriageAgent: getWorkflowJson(emailTriageAgentWithGmailJson).meta.templateId,
KnowledgeStoreAgent: getWorkflowJson(knowledgeStoreAgentWithGoogleDriveJson).meta.templateId,
TaskManagementAgent: getWorkflowJson(taskManagementAgentWithGoogleSheetsJson).meta.templateId,
JokeAgent: getWorkflowJson(jokeAgentWithHttpToolJson).meta.templateId,
} as const;
export const isPrebuiltAgentTemplateId = (value: string): boolean => {
return Object.values(PrebuiltAgentTemplates).includes(value);
};
interface PrebuiltAgentTemplate {
template: WorkflowDataWithTemplateId;
name: string;
description: string;
nodes: INodeTypeNameVersion[];
}
export const getPrebuiltAgents = (): PrebuiltAgentTemplate[] => {
return [
{
name: 'Voice assistant agent',
description: 'Personal AI assistant in Telegram, handling both text and voice messages.',
template: getWorkflowJson(voiceAssistantAgentWithTelegramAndGcalJson),
nodes: [
{
name: 'n8n-nodes-base.telegram',
version: 1.2,
},
{
name: 'n8n-nodes-base.googleCalendar',
version: 1.3,
},
],
},
{
name: 'Email triage agent',
description:
'Categorizes new, unread emails by analyzing their content and applying relevant labels.',
template: getWorkflowJson(emailTriageAgentWithGmailJson),
nodes: [
{
name: 'n8n-nodes-base.gmail',
version: 2.1,
},
],
},
{
name: 'Knowledge store agent',
description:
'Retrieve, analyze, and answer questions using documents uploaded to Google Drive.',
template: getWorkflowJson(knowledgeStoreAgentWithGoogleDriveJson),
nodes: [
{
name: 'n8n-nodes-base.googleDrive',
version: 3,
},
],
},
{
name: 'Task management agent',
description:
'Task management assistant that helps users create, view, update, and delete tasks.',
template: getWorkflowJson(taskManagementAgentWithGoogleSheetsJson),
nodes: [
{
name: 'n8n-nodes-base.googleSheets',
version: 4.7,
},
],
},
{
name: 'Joke agent',
description: 'Uses the Joke API via the HTTP tool to deliver fun, personalized jokes.',
template: getWorkflowJson(jokeAgentWithHttpToolJson),
nodes: [
{
name: 'n8n-nodes-base.httpRequest',
version: 4.2,
},
],
},
];
};
export const getSampleWorkflowByTemplateId = (
templateId: string,
): WorkflowDataWithTemplateId | undefined => {
const workflows = [
getEasyAiWorkflowJson(),
getRagStarterWorkflowJson(),
...getPrebuiltAgents().map((agent) => agent.template),
];
return workflows.find((workflow) => workflow.meta.templateId === templateId);
};

39
packages/frontend/editor-ui/src/views/NodeView.vue
View File

@@ -123,7 +123,7 @@ import { getResourcePermissions } from '@n8n/permissions';
import NodeViewUnfinishedWorkflowMessage from '@/components/NodeViewUnfinishedWorkflowMessage.vue';
import { createCanvasConnectionHandleString } from '@/utils/canvasUtils';
import { isValidNodeConnectionType } from '@/utils/typeGuards';
import { getEasyAiWorkflowJson, getRagStarterWorkflowJson } from '@/utils/easyAiWorkflowUtils';
import { getSampleWorkflowByTemplateId } from '@/utils/templates/workflowSamples';
import type { CanvasLayoutEvent } from '@/composables/useCanvasLayout';
import { useWorkflowSaving } from '@/composables/useWorkflowSaving';
import { useBuilderStore } from '@/stores/builder.store';
@@ -389,27 +389,24 @@ async function initializeRoute(force = false) {
if (isBlankRedirect.value) {
isBlankRedirect.value = false;
} else if (route.name === VIEWS.TEMPLATE_IMPORT) {
const templateId = route.params.id;
const loadWorkflowFromJSON = route.query.fromJson === 'true';
const templateId = route.params.id;
if (!templateId) {
return;
}
if (loadWorkflowFromJSON) {
const easyAiWorkflowJson = getEasyAiWorkflowJson();
const ragStarterWorkflowJson = getRagStarterWorkflowJson();
switch (templateId) {
case easyAiWorkflowJson.meta.templateId:
await openTemplateFromWorkflowJSON(easyAiWorkflowJson);
break;
case ragStarterWorkflowJson.meta.templateId:
await openTemplateFromWorkflowJSON(ragStarterWorkflowJson);
break;
default:
toast.showError(
new Error(i18n.baseText('nodeView.couldntLoadWorkflow.invalidWorkflowObject')),
i18n.baseText('nodeView.couldntImportWorkflow'),
);
await router.replace({ name: VIEWS.NEW_WORKFLOW });
const workflow = getSampleWorkflowByTemplateId(templateId.toString());
if (!workflow) {
toast.showError(
new Error(i18n.baseText('nodeView.couldntLoadWorkflow.invalidWorkflowObject')),
i18n.baseText('nodeView.couldntImportWorkflow'),
);
await router.replace({ name: VIEWS.NEW_WORKFLOW });
return;
}
await openTemplateFromWorkflowJSON(workflow);
} else {
await openWorkflowTemplate(templateId.toString());
}
@@ -609,7 +606,11 @@ async function openTemplateFromWorkflowJSON(workflow: WorkflowDataWithTemplateId
query: { templateId, parentFolderId },
});
await importTemplate({ id: templateId, name: workflow.name, workflow });
await importTemplate({
id: templateId,
name: workflow.name,
workflow,
});
uiStore.stateIsDirty = true;

20
packages/frontend/editor-ui/src/views/WorkflowsView.vue
View File

@@ -49,7 +49,7 @@ import { useUsageStore } from '@/stores/usage.store';
import { useUsersStore } from '@/stores/users.store';
import { useWorkflowsStore } from '@/stores/workflows.store';
import { type Project, type ProjectSharingData, ProjectTypes } from '@/types/projects.types';
import { getEasyAiWorkflowJson } from '@/utils/easyAiWorkflowUtils';
import { getEasyAiWorkflowJson } from '@/utils/templates/workflowSamples';
import {
isExtraTemplateLinksExperimentEnabled,
TemplateClickSource,
@@ -907,6 +907,15 @@ const handleCreateReadyToRunWorkflows = async (source: 'card' | 'callout') => {
}
};
const dismissStarterCollectionCallout = () => {
aiStarterTemplatesStore.dismissCallout();
aiStarterTemplatesStore.trackUserDismissedCallout();
};
const dismissEasyAICallout = () => {
easyAICalloutVisible.value = false;
};
const openAIWorkflow = async (source: string) => {
dismissEasyAICallout();
telemetry.track('User clicked test AI workflow', {
@@ -922,20 +931,11 @@ const openAIWorkflow = async (source: string) => {
});
};
const dismissStarterCollectionCallout = () => {
aiStarterTemplatesStore.dismissCallout();
aiStarterTemplatesStore.trackUserDismissedCallout();
};
const onShowArchived = async () => {
filters.value.showArchived = true;
await onFiltersUpdated();
};
const dismissEasyAICallout = () => {
easyAICalloutVisible.value = false;
};
const handleDismissReadyToRunCallout = () => {
readyToRunWorkflowsStore.dismissCallout();
readyToRunWorkflowsStore.trackDismissCallout();

18
packages/nodes-base/nodes/Google/Calendar/GoogleCalendar.node.ts
View File

@@ -9,6 +9,7 @@ import type {
INodeTypeDescription,
JsonObject,
NodeExecutionHint,
INodeProperties,
} from 'n8n-workflow';
import { NodeConnectionTypes, NodeApiError, NodeOperationError } from 'n8n-workflow';
import { v4 as uuid } from 'uuid';
@@ -31,6 +32,22 @@ import {
} from './GenericFunctions';
import { sortItemKeysByPriorityList } from '../../../utils/utilities';
const preBuiltAgentsCallout: INodeProperties = {
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName: 'Interact with your Google Calendar using our pre-built',
name: 'preBuiltAgentsCalloutGoogleCalendar',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'Voice assistant agent',
icon: 'bot',
type: 'openSampleWorkflowTemplate',
templateId: 'voice_assistant_agent_with_telegram_and_gcal',
},
},
default: '',
};
export class GoogleCalendar implements INodeType {
description: INodeTypeDescription = {
displayName: 'Google Calendar',
@@ -53,6 +70,7 @@ export class GoogleCalendar implements INodeType {
},
],
properties: [
preBuiltAgentsCallout,
{
displayName: 'Resource',
name: 'resource',

20
packages/nodes-base/nodes/Google/Drive/v2/actions/versionDescription.ts
View File

@@ -1,11 +1,28 @@
/* eslint-disable n8n-nodes-base/node-filename-against-convention */
import { NodeConnectionTypes, type INodeTypeDescription } from 'n8n-workflow';
import { NodeConnectionTypes, type INodeTypeDescription, type INodeProperties } from 'n8n-workflow';
import * as drive from './drive/Drive.resource';
import * as file from './file/File.resource';
import * as fileFolder from './fileFolder/FileFolder.resource';
import * as folder from './folder/Folder.resource';
const preBuiltAgentsCallout: INodeProperties = {
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName:
'Retrieve, analyze, and answer questions using your Google Drive documents with our pre-built',
name: 'preBuiltAgentsCalloutGoogleDrive',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'Knowledge store agent',
icon: 'bot',
type: 'openSampleWorkflowTemplate',
templateId: 'knowledge_store_agent_with_google_drive',
},
},
default: '',
};
export const versionDescription: INodeTypeDescription = {
displayName: 'Google Drive',
name: 'googleDrive',
@@ -41,6 +58,7 @@ export const versionDescription: INodeTypeDescription = {
},
],
properties: [
preBuiltAgentsCallout,
{
displayName: 'Authentication',
name: 'authentication',

18
packages/nodes-base/nodes/Google/Gmail/v2/GmailV2.node.ts
View File

@@ -2,6 +2,7 @@ import type {
IDataObject,
IExecuteFunctions,
INodeExecutionData,
INodeProperties,
INodeType,
INodeTypeBaseDescription,
INodeTypeDescription,
@@ -36,6 +37,22 @@ import {
unescapeSnippets,
} from '../GenericFunctions';
const preBuiltAgentsCallout: INodeProperties = {
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName: 'Sort your Gmail inbox using our pre-built',
name: 'preBuiltAgentsCalloutGmail',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'Email triage agent',
icon: 'bot',
type: 'openSampleWorkflowTemplate',
templateId: 'email_triage_agent_with_gmail',
},
},
default: '',
};
const versionDescription: INodeTypeDescription = {
displayName: 'Gmail',
name: 'gmail',
@@ -72,6 +89,7 @@ const versionDescription: INodeTypeDescription = {
],
webhooks: sendAndWaitWebhooksDescription,
properties: [
preBuiltAgentsCallout,
{
displayName: 'Authentication',
name: 'authentication',

17
packages/nodes-base/nodes/Google/Sheet/v2/actions/versionDescription.ts
View File

@@ -23,6 +23,22 @@ export const authentication: INodeProperties = {
default: 'oAuth2',
};
const preBuiltAgentsCallout: INodeProperties = {
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName: 'Manage tasks in Google Sheets using our pre-built',
name: 'preBuiltAgentsCalloutGoogleSheets',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'Task management agent',
icon: 'bot',
type: 'openSampleWorkflowTemplate',
templateId: 'task_management_agent_with_google_sheets',
},
},
default: '',
};
export const versionDescription: INodeTypeDescription = {
displayName: 'Google Sheets',
name: 'googleSheets',
@@ -76,6 +92,7 @@ export const versionDescription: INodeTypeDescription = {
},
],
properties: [
preBuiltAgentsCallout,
authentication,
{
displayName: 'Resource',

17
packages/nodes-base/nodes/HttpRequest/V3/Description.ts
View File

@@ -2,7 +2,24 @@ import type { INodeProperties } from 'n8n-workflow';
import { optimizeResponseProperties } from '../shared/optimizeResponse';
const preBuiltAgentsCallout: INodeProperties = {
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName: 'Try the HTTP request tool with our pre-built',
name: 'preBuiltAgentsCalloutHttpRequest',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'Joke agent',
icon: 'bot',
type: 'openSampleWorkflowTemplate',
templateId: 'joke_agent_with_http_tool',
},
},
default: '',
};
export const mainProperties: INodeProperties[] = [
preBuiltAgentsCallout,
{
displayName: '',
name: 'curlImport',

18
packages/nodes-base/nodes/Telegram/Telegram.node.ts
View File

@@ -6,6 +6,7 @@ import type {
INodeType,
INodeTypeDescription,
IHttpRequestMethods,
INodeProperties,
} from 'n8n-workflow';
import {
BINARY_ENCODING,
@@ -26,6 +27,22 @@ import { configureWaitTillDate } from '../../utils/sendAndWait/configureWaitTill
import { sendAndWaitWebhooksDescription } from '../../utils/sendAndWait/descriptions';
import { getSendAndWaitProperties, sendAndWaitWebhook } from '../../utils/sendAndWait/utils';
const preBuiltAgentsCallout: INodeProperties = {
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-miscased
displayName: 'Interact with Telegram using our pre-built',
name: 'preBuiltAgentsCalloutTelegram',
type: 'callout',
typeOptions: {
calloutAction: {
label: 'Voice assistant agent',
icon: 'bot',
type: 'openSampleWorkflowTemplate',
templateId: 'voice_assistant_agent_with_telegram_and_gcal',
},
},
default: '',
};
export class Telegram implements INodeType {
description: INodeTypeDescription = {
displayName: 'Telegram',
@@ -49,6 +66,7 @@ export class Telegram implements INodeType {
],
webhooks: sendAndWaitWebhooksDescription,
properties: [
preBuiltAgentsCallout,
{
displayName: 'Resource',
name: 'resource',

19
packages/workflow/src/interfaces.ts
View File

@@ -1344,12 +1344,25 @@ export type NodePropertyAction = {
target?: string;
};
export type CalloutActionType = 'openRagStarterTemplate';
export interface CalloutAction {
type: CalloutActionType;
export interface CalloutActionBase {
type: string;
label: string;
icon?: string;
}
export interface CalloutActionOpenPreBuiltAgentsCollection extends CalloutActionBase {
type: 'openPreBuiltAgentsCollection';
}
export interface CalloutActionOpenSampleWorkflowTemplate extends CalloutActionBase {
type: 'openSampleWorkflowTemplate';
templateId: string;
}
export type CalloutAction =
| CalloutActionOpenPreBuiltAgentsCollection
| CalloutActionOpenSampleWorkflowTemplate;
export interface INodePropertyTypeOptions {
// Supported by: button
buttonConfig?: {