Skip to content

Commit e4cc34c

Browse files
authored
Merge branch 'n8n-io:main' into main
2 parents e85d2e9 + ebf5809 commit e4cc34c

File tree

29 files changed

+1818
-1378
lines changed

29 files changed

+1818
-1378
lines changed

.github/workflows/build-test.yml

+39
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
name: Internal PR linkcheck
2+
on:
3+
pull_request:
4+
branches:
5+
- main
6+
permissions:
7+
contents: read
8+
pull-requests: write
9+
jobs:
10+
link-check:
11+
runs-on: ubuntu-latest
12+
13+
steps:
14+
- name: Checkout repository
15+
uses: actions/checkout@v4
16+
- name: Setup Python
17+
uses: actions/setup-python@v2
18+
with:
19+
python-version: 3.12
20+
- name: Install dependencies
21+
run: |
22+
python3 -m venv venv
23+
source venv/bin/activate
24+
pip install -r requirements.txt
25+
pip install mkdocs-material
26+
- name: Run mkdocs in strict mode
27+
id: mkdocs
28+
run: |
29+
source venv/bin/activate
30+
mkdocs build --config-file mkdocs-test.yml --strict 2>&1 | tee mkdocs.out
31+
[[ $(tail -n 1 mkdocs.out) =~ ^Aborted ]] && exit 1 || exit 0
32+
33+
- name: PR comment with file
34+
if: failure()
35+
uses: thollander/actions-comment-pull-request@e4a76dd2b0a3c2027c3fd84147a67c22ee4c90fa # v3.0.1
36+
with:
37+
file-path: mkdocs.out
38+
comment-tag: execution
39+
mode: recreate

.github/workflows/lychee-pr-check.yml

+12-10
Original file line numberDiff line numberDiff line change
@@ -12,20 +12,22 @@ jobs:
1212

1313
steps:
1414
- name: Checkout repository
15-
uses: actions/checkout@v4
16-
- name: Get changed docs files
17-
id: changed-md-files
18-
run: |
19-
CHANGED_FILES=$(git diff --name-only $GITHUB_SHA^ $GITHUB_SHA -- '*.md' | paste -sd "," -)
20-
echo "Changed Markdown files: '$CHANGED_FILES'"
21-
echo "changed_files=${CHANGED_FILES:-}" >> "$GITHUB_OUTPUT"
15+
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
16+
- name: Get all changed markdown files
17+
id: changed-markdown-files
18+
uses: step-security/changed-files@3dbe17c78367e7d60f00d78ae6781a35be47b4a1 # v45.0.1
19+
with:
20+
# Avoid using single or double quotes for multiline patterns
21+
files: |
22+
docs/**/*.md
2223
- name: Run Lychee Link Checker
2324
id: lychee
24-
uses: lycheeverse/lychee-action@v1
25+
if: steps.changed-markdown-files.outputs.any_changed == 'true'
26+
uses: lycheeverse/lychee-action@a99389aeff3c193ffb6f0741178e519569d3f404 # v2.3.0
2527
with:
26-
args: --config lychee.toml ${{ steps.changed-md-files.outputs.changed_files }}
28+
args: --config lychee.toml ${{ steps.changed-markdown-files.outputs.all_changed_files }}
2729
- name: PR comment with file
28-
uses: thollander/actions-comment-pull-request@v3
30+
uses: thollander/actions-comment-pull-request@e4a76dd2b0a3c2027c3fd84147a67c22ee4c90fa # v3.0.1
2931
with:
3032
file-path: lychee/out.md
3133
comment-tag: execution

.github/workflows/support.yml

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
name: 'Support Requests'
2+
3+
on:
4+
issues:
5+
types: [labeled, unlabeled, reopened]
6+
7+
permissions:
8+
issues: write
9+
10+
jobs:
11+
action:
12+
runs-on: ubuntu-latest
13+
steps:
14+
- uses: dessant/support-requests@47d5ea12f6c9e4a081637de9626b7319b415a3bf
15+
with:
16+
github-token: ${{ github.token }}
17+
support-label: 'support'
18+
issue-comment: >
19+
:wave: @{issue-author}. Sorry you are having a problem!
20+
This repository is for the n8n documentation though. Having
21+
looked at your issue we think you'd get quicker help with your
22+
problem by [posting on the community forum](https://community.n8n.io/c/questions/12),
23+
where experts from n8n and our community can provide answers
24+
to your questions.
25+
If you think this issue is specifically to do with the documentation,
26+
please re-open and explain what you would like to see in docs to resolve it.
27+
close-issue: true
28+
issue-close-reason: 'not planned'
29+
lock-issue: false
30+
issue-lock-reason: 'off-topic'
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
/// note | Latest and Next versions
22
n8n releases a new minor version most weeks. The `latest` version is for production use. `next` is the most recent release. You should treat `next` as a beta: it may be unstable. To report issues, use the [forum](https://community.n8n.io/c/questions/12){:target=_blank .external-link}.
33

4-
Current `latest`: 1.83.2
5-
Current `next`: 1.84.1
4+
Current `latest`: 1.84.3
5+
Current `next`: 1.85.4
66
///
145 KB
Loading
Loading
1.14 MB
Binary file not shown.

docs/_workflows/courses/level-one/chapter-5/chapter-5.2.json

+2-4
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,13 @@
3838
"__rl": true,
3939
"value": "app9nOVsRxdypoknP",
4040
"mode": "list",
41-
"cachedResultName": "beginner course",
42-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP"
41+
"cachedResultName": "beginner course"
4342
},
4443
"table": {
4544
"__rl": true,
4645
"value": "tblo2KuMyn5X4jU0s",
4746
"mode": "list",
48-
"cachedResultName": "orders",
49-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP/tblo2KuMyn5X4jU0s"
47+
"cachedResultName": "orders"
5048
},
5149
"columns": {
5250
"mappingMode": "autoMapInputData",

docs/_workflows/courses/level-one/chapter-5/chapter-5.3.json

+2-4
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,13 @@
3838
"__rl": true,
3939
"value": "app9nOVsRxdypoknP",
4040
"mode": "list",
41-
"cachedResultName": "beginner course",
42-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP"
41+
"cachedResultName": "beginner course"
4342
},
4443
"table": {
4544
"__rl": true,
4645
"value": "tblo2KuMyn5X4jU0s",
4746
"mode": "list",
48-
"cachedResultName": "orders",
49-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP/tblo2KuMyn5X4jU0s"
47+
"cachedResultName": "orders"
5048
},
5149
"columns": {
5250
"mappingMode": "autoMapInputData",

docs/_workflows/courses/level-one/chapter-5/chapter-5.4.json

+2-4
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,13 @@
3838
"__rl": true,
3939
"value": "app9nOVsRxdypoknP",
4040
"mode": "list",
41-
"cachedResultName": "beginner course",
42-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP"
41+
"cachedResultName": "beginner course"
4342
},
4443
"table": {
4544
"__rl": true,
4645
"value": "tblTIOsm4BLJD9Tql",
4746
"mode": "list",
48-
"cachedResultName": "processingOrders",
49-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP/tblTIOsm4BLJD9Tql"
47+
"cachedResultName": "processingOrders"
5048
},
5149
"columns": {
5250
"mappingMode": "autoMapInputData",

docs/_workflows/courses/level-one/chapter-5/chapter-5.5.json

+2-4
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,13 @@
3838
"__rl": true,
3939
"value": "app9nOVsRxdypoknP",
4040
"mode": "list",
41-
"cachedResultName": "beginner course",
42-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP"
41+
"cachedResultName": "beginner course"
4342
},
4443
"table": {
4544
"__rl": true,
4645
"value": "tblTIOsm4BLJD9Tql",
4746
"mode": "list",
48-
"cachedResultName": "processingOrders",
49-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP/tblTIOsm4BLJD9Tql"
47+
"cachedResultName": "processingOrders"
5048
},
5149
"columns": {
5250
"mappingMode": "autoMapInputData",

docs/_workflows/courses/level-one/chapter-5/chapter-5.6.json

+2-4
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,13 @@
3838
"__rl": true,
3939
"value": "app9nOVsRxdypoknP",
4040
"mode": "list",
41-
"cachedResultName": "beginner course",
42-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP"
41+
"cachedResultName": "beginner course"
4342
},
4443
"table": {
4544
"__rl": true,
4645
"value": "tblTIOsm4BLJD9Tql",
4746
"mode": "list",
48-
"cachedResultName": "processingOrders",
49-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP/tblTIOsm4BLJD9Tql"
47+
"cachedResultName": "processingOrders"
5048
},
5149
"columns": {
5250
"mappingMode": "autoMapInputData",

docs/_workflows/courses/level-one/finished.json

+2-4
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,13 @@
3838
"__rl": true,
3939
"value": "app9nOVsRxdypoknP",
4040
"mode": "list",
41-
"cachedResultName": "beginner course",
42-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP"
41+
"cachedResultName": "beginner course"
4342
},
4443
"table": {
4544
"__rl": true,
4645
"value": "tblTIOsm4BLJD9Tql",
4746
"mode": "list",
48-
"cachedResultName": "processingOrders",
49-
"cachedResultUrl": "https://airtable.com/app9nOVsRxdypoknP/tblTIOsm4BLJD9Tql"
47+
"cachedResultName": "processingOrders"
5048
},
5149
"columns": {
5250
"mappingMode": "autoMapInputData",

docs/courses/level-one/chapter-4.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,4 @@ You will build this workflow in eight steps:
4040

4141
To build this workflow, you will need the credentials found in the email you received from n8n when you signed up for this course. If you haven't signed up already, you can do it [here](https://n8n-community.typeform.com/to/PDEMrevI?typeform-source=127.0.0.1){:target="_blank" .external-link}. If you haven't received a confirmation email after signing up, [contact us](mailto:[email protected]).
4242

43-
<div style="text-align:center;">
44-
<button style="font-weight: 600;padding: 20px 46px;border-radius: 30px;color: #fff;background-color: #ff6d5a;border-color: #ff6d5a;border: 1px solid #ff6d5a;font-size: 14px;"><a href="/courses/level-one/chapter-5/chapter-5.1/" style="color: #fff;">Start building!</a></button>
45-
</div>
43+
[Start building!](/courses/level-one/chapter-5/chapter-5.1.md){ .md-button }

docs/courses/level-one/chapter-7.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,7 @@ You can test your knowledge by taking a **quiz**, which consists of questions ab
1818
- There's no time limit on answering the quiz questions.
1919

2020
<br/>
21-
<div style="text-align:center;">
22-
<button style="font-weight: 600;padding: 20px 46px;border-radius: 30px;color: #fff;background-color: #ff6d5a;border-color: #ff6d5a;border: 1px solid #ff6d5a;font-size: 14px;"><a href="https://n8n-community.typeform.com/to/JMoBXeGA" target="_blank" style="color: #fff;">Take the quiz!</a></button>
23-
</div>
21+
[Take the quiz!](https://n8n-community.typeform.com/to/JMoBXeGA){ .md-button }
2422

2523

2624
## What's next?

docs/courses/level-one/index.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,4 @@ You can always **check your progress** throughout the course by entering your un
6363

6464
If you complete the milestones above, you will get [**a badge and an avatar**](https://community.n8n.io/badges/104/completed-n8n-course-level-1) in your forum profile. You can then share your profile and course verification ID to showcase your n8n skills to others.
6565

66-
<div style="text-align:center;">
67-
<button style="font-weight: 600;padding: 20px 46px;border-radius: 30px;color: #fff;background-color: #ff6d5a;border-color: #ff6d5a;border: 1px solid #ff6d5a;font-size: 14px;"><a href="/courses/level-one/chapter-1/" style="color: #fff;">Let's get started!</a></button>
68-
</div>
66+
[Let's get started!](/courses/level-one/chapter-1.md){ .md-button }

docs/courses/level-two/chapter-6.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,8 @@ You can test your knowledge by taking a **quiz**, which consists of questions ab
1515
- You can take the quiz as many times as you want.
1616
- There's no time limit on answering the quiz questions.
1717

18-
<div style="text-align:center;">
19-
<button style="font-weight: 600;padding: 20px 46px;border-radius: 30px;color: #fff;background-color: #ff6d5a;border-color: #ff6d5a;border: 1px solid #ff6d5a;font-size: 14px;"><a href="https://n8n-community.typeform.com/to/r9hDbytg" target="_blank" style="color: #fff;">Take the quiz!</a></button>
20-
</div>
18+
<br/>
19+
[Take the quiz!](https://n8n-community.typeform.com/to/r9hDbytg){ .md-button }
2120

2221
## What's next?
2322

docs/courses/level-two/index.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,4 @@ You can always **check your progress** throughout the course by entering your un
5151

5252
If you successfully complete the milestones above, you will get [**a badge and an avatar**](https://community.n8n.io/badges/105/completed-n8n-course-level-2){:target="_blank" .external} in your forum profile. You can then share your profile and course verification ID to showcase your n8n skills to others.
5353

54-
<div style="text-align:center;">
55-
<button style="font-weight: 600;padding: 20px 46px;border-radius: 30px;color: #fff;background-color: #ff6d5a;border-color: #ff6d5a;border: 1px solid #ff6d5a;font-size: 14px;"><a href="/courses/level-two/chapter-1/" style="color: #fff;">Let's get started!</a></button>
56-
</div>
54+
[Let's get started!](/courses/level-two/chapter-1.md){ .md-button }

docs/data/schema-preview.md

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4
3+
title: Schema preview
4+
description:
5+
contentType: overview
6+
---
7+
8+
# Schema Preview
9+
10+
Schema Preview exposes expected schema data from the previous node in the Node Editor without the user having to provide credentials or execute the node. This makes it possible to construct workflows without having to provide credentials in advance. The preview doesn't include mock data, but it does expose the expected fields, making it possible to select and incorporate them into the input of subsequent nodes.
11+
12+
## Using the preview
13+
14+
1. There must be a node with Schema Preview available in your workflow.
15+
1. When clicking on the details of the next node in the sequence, the Schema Preview data will show up in the Node Editor where schema data would typically be exposed.
16+
1. Use data from the Schema Preview just as you would other schemas - drag and drop fields as input into your node parameters and settings.

docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/index.md

+4-24
Original file line numberDiff line numberDiff line change
@@ -8,36 +8,16 @@ priority: critical
88

99
# AI Agent node
1010

11-
An [AI agent](/glossary.md#ai-agent) is an autonomous system that receives data, makes rational decisions, and acts within its environment to achieve specific goals. The AI agent's environment is everything the agent can access that isn't the agent itself, which might include customer queries, tools, or other context.
12-
13-
The AI Agent node gives you six LangChain agent options.
14-
15-
On this page, you'll find a summary of the available agents with links to more detailed pages on each, templates and examples, and links to more resources.
11+
An [AI agent](/glossary.md#ai-agent) is an autonomous system that receives data, makes rational decisions, and acts within its environment to achieve specific goals. The AI agent's environment is everything the agent can access that isn't the agent itself. This agent uses external [tools](/glossary.md#ai-tool) and APIs to perform actions and retrieve information. It can understand the capabilities of different tools and determine which tool to use depending on the task.
1612

1713
/// note | Connect a tool
1814
You must connect at least one tool [sub-node](/integrations/builtin/cluster-nodes/sub-nodes/index.md) to an AI Agent node.
1915
///
2016

21-
## Available agents
22-
23-
n8n provides these agents:
24-
25-
* [**Tools Agent**](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/tools-agent.md) (default): This agent uses external [tools](/glossary.md#ai-tool) and APIs to perform actions and retrieve information. It can understand the capabilities of different tools and determine which tool to use depending on the task. This agent helps integrate LLMs with various external services and databases.
26-
27-
/// note | Begin here
28-
n8n recommends using this agent for most use cases. It will handle most scenarios and provides the best experience when working with [tools](/advanced-ai/examples/understand-tools.md).
29-
///
30-
31-
* [**Conversational Agent**](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/conversational-agent.md): This agent has human-like conversations. It can maintain context, understand user intent, and provide relevant answers. This agent is typically used for building chatbots, virtual assistants and customer support systems. If your preferred AI model doesn't support tool calling or you're handling simpler interactions, this agent is a good option.
32-
* [**OpenAI Functions Agent**](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/openai-functions-agent.md): Use this agent with an [OpenAI functions model](https://platform.openai.com/docs/guides/gpt/function-calling){:target=_blank .external-link}. You must use the [OpenAI Chat Model](/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/index.md) with this agent.
33-
* [**Plan and Execute Agent**](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/plan-execute-agent.md): This agent creates a high-level plan to solve the given task and then executes the plan step by step. It's most useful for tasks that require a structured approach and careful planning.
34-
* [**ReAct Agent**](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/react-agent.md): This agent reasons about a given task, determines the necessary actions, and then executes them. It follows the cycle of reasoning and acting until it completes the task. The ReAct agent can break down complex tasks into smaller sub-tasks, prioritise them, and execute them one after the other.
35-
36-
/// note | No memory
37-
The ReAct agent doesn't support memory sub-nodes. This means it can't recall previous prompts or simulate an ongoing conversation.
38-
///
17+
/// note | Agent type
18+
Prior to version 1.82.0, the AI Agent had a setting for working as different agent types. This has now been removed and all AI Agent nodes work as a `Tools Agent` which was the recommended and most frequently used setting. If you're working with older versions of the AI Agent in workflows or templates, as long as they were set to 'Tools Agent', they should continue to behave as intended with the updated node.
19+
///
3920

40-
* [**SQL Agent**](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/sql-agent.md): This agent uses a SQL database as a data source. It can understand natural language questions, convert them into SQL queries, execute the queries, and present the results in a user-friendly format. This agent is valuable for building natural language interfaces to databases.
4121

4222
## Templates and examples
4323
<!-- see https://www.notion.so/n8n/Pull-in-templates-for-the-integrations-pages-37c716837b804d30a33b47475f6e3780 -->

docs/integrations/builtin/core-nodes/n8n-nodes-base.extractfromfile.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Use the **Operations** drop-down to select the format of the source file to extr
2121
- **Extract From JSON**: Extract JSON data from a binary file.
2222
- **Extract From ICS**: Extract fields from iCalendar format files.
2323
- **Extract From ODS**: Extract fields from ODS spreadsheet files.
24-
- **Extract From PDF**: Extract fields from Porrtable Document Format files.
24+
- **Extract From PDF**: Extract fields from Portable Document Format files.
2525
- **Extract From RTF**: Extract fields from Rich Text Format files.
2626
- **Extract From Text File**: Extract fields from a standard text file format.
2727
- **Extract From XLS**: Extract fields from a Microsoft Excel file (older format).

docs/integrations/builtin/core-nodes/n8n-nodes-base.splitinbatches.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -8,20 +8,21 @@ priority: critical
88

99
# Loop Over Items
1010

11-
The Loop Over Items node helps you loop through data.
11+
The Loop Over Items node helps you loop through data when needed.
1212

1313
The node saves the original incoming data, and with each iteration, returns a predefined amount of data through the **loop** output.
1414

1515
When the node execution completes, it combines all of the processed data and returns it through the **done** output.
1616

1717
## When to use the Loop Over Items node
1818

19-
By default, n8n nodes process input items one at a time. Depending on what you're trying to achieve, you often don't need the Loop Over Items node in your workflow. You can learn more about how n8n processes multiple items on the [looping in n8n](/flow-logic/looping.md) page.
19+
By default, n8n nodes are designed to process a list of input items (with some exceptions, detailed below). Depending on what you're trying to achieve, you often don't need the Loop Over Items node in your workflow. You can learn more about how n8n processes multiple items on the [looping in n8n](/flow-logic/looping.md) page.
2020

21-
In particular, these two sections are of particular interest to the Loop Over Items node:
21+
These links highlight some of the cases where the Loop Over Items node can be useful:
2222

2323
* [Loop until all items are processed](/flow-logic/looping.md#loop-until-all-items-are-processed): describes how the Loop Over Items node differs from normal item processing and when you might want to incorporate this node.
2424
* [Node exceptions](/flow-logic/looping.md#node-exceptions): outlines specific cases and nodes where you may need to use the Loop Over Items node to manually build looping logic.
25+
* [Avoiding rate limiting](/integrations/builtin/rate-limits.md): demonstrates how to batch API requests to avoid rate limits from other services.
2526

2627
## Node parameters
2728

docs/manage-cloud/cloud-ip.md

+1
Original file line numberDiff line numberDiff line change
@@ -31,3 +31,4 @@ Outbound traffic may appear to originate from any of:
3131

3232
* 20.52.126.0/28
3333
* 20.218.238.112/28
34+
* 4.182.64.64/28

0 commit comments

Comments
 (0)