Skip to content

docs: Enhance AI agent description in intro tutorial #4228

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
eric-burel wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: Enhance AI agent description in intro tutorial #4228

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/advanced-ai/intro-tutorial.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,10 +32,10 @@

If you're already familiar with AI, feel free to skip this section. This is a basic introduction to AI concepts and how they can be used in n8n workflows.

An [AI agent](/glossary.md#ai-agent) builds on [Large Language Models (LLMs)](/glossary.md#large-language-model-llm), which generate text based
on input by predicting the next word. While LLMs only process input to produce
output, AI agents add goal-oriented functionality. They can use [tools](/glossary.md#ai-tool), process
their outputs, and make decisions to complete tasks and solve problems.
An [AI agent](/glossary.md#ai-agent) builds on [Large Language Models (LLMs)](/glossary.md#large-language-model-llm). LLMs generate text based
on input by predicting the next word, but they can also be used to select the best tool to achieve a task, or even make complex decisions.

Check warning on line 36 in docs/advanced-ai/intro-tutorial.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[from-write-good.Passive] 'be used' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[from-write-good.Passive] 'be used' may be passive voice. Use active voice if you can.", "location": {"path": "docs/advanced-ai/intro-tutorial.md", "range": {"start": {"line": 36, "column": 57}}}, "severity": "WARNING"}
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot Feb 12, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: The new description says LLMs can select tools and make complex decisions, but the comparison table immediately below still lists LLM decision-making as "None" and tool usage as "No." This contradiction could confuse readers and should be reconciled.

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At docs/advanced-ai/intro-tutorial.md, line 36:

<comment>The new description says LLMs can select tools and make complex decisions, but the comparison table immediately below still lists LLM decision-making as "None" and tool usage as "No." This contradiction could confuse readers and should be reconciled.</comment>

<file context>
@@ -32,10 +32,10 @@ Many people find it easier to take in new information in video format. This tuto
-output, AI agents add goal-oriented functionality. They can use [tools](/glossary.md#ai-tool), process
-their outputs, and make decisions to complete tasks and solve problems.
+An [AI agent](/glossary.md#ai-agent) builds on [Large Language Models (LLMs)](/glossary.md#large-language-model-llm). LLMs generate text based
+on input by predicting the next word, but they can also be used to select the best tool to achieve a task, or even make complex decisions.
+While LLMs only process input to produce text or JSON output, AI agents add goal-oriented functionality. They can use [tools](/glossary.md#ai-tool), process
+their outputs, complete tasks and solve problems.
</file context>
Fix with Cubic

While LLMs only process input to produce text or JSON output, AI agents add goal-oriented functionality. They can use [tools](/glossary.md#ai-tool), process
their outputs, complete tasks and solve problems.

In n8n, the AI agent is represented as a node with some extra connections.

Expand Down
Loading