n8n 中文文档

使用 GPT 进行 AI 编码

/// info | 功能可用性 在自托管版本中不可用。

不支持 Python。 ///

在Code节点中使用AI

提示

Feature availability 功能可用性

云用户可以使用代码节点中的人工智能辅助。它在自托管 n8n 中不可用。

提示

AI generated code overwrites your code AI生成的代码会覆盖您的代码

如果您已经在 Code 代码 选项卡上编写了一些代码,AI 生成的代码将替换它。 n8n 建议使用 AI 作为创建初始代码的起点,然后根据需要进行编辑。

在代码节点中使用 ChatGPT 生成代码:

  1. 在代码节点中,将语言设置为 JavaScript。
  2. 选择 Ask AI 选项卡。
  3. 编写您的查询。
  4. 选择生成代码。n8n 将您的查询发送给 ChatGPT,然后在代码选项卡中显示结果。

使用限制

在试用阶段没有使用限制。如果 n8n 使该功能永久化,可能会有使用限制作为您的定价层的一部分。

功能限制

n8n 中的 ChatGPT 实现有以下限制:

  • AI 编写操作来自 n8n 工作流的数据的代码。您不能要求它从其他来源拉取数据。
  • AI 不知道您的数据,只知道架构,因此您需要告诉它如何找到您要提取的数据,或如何检查 null。
  • 代码节点之前的节点必须执行并将数据传递给代码节点,然后您才能运行 AI 查询。
  • 不适用于大型传入数据架构。
  • 如果代码节点之前有很多节点,可能会出现问题。

写好提示

编写好的提示增加了获得有用代码的机会。

一些通用提示:

  • 提供示例:如果可能,给出预期输出的样本。这有助于 AI 更好地理解您想要的转换或逻辑。
  • 描述处理步骤:如果有应该应用于数据的特定处理步骤或逻辑,请按顺序列出它们。例如:"首先,过滤掉所有 18 岁以下的用户。然后,按姓氏对剩余用户进行排序。"
  • 避免歧义:虽然 AI 理解各种指令,但清晰直接确保您获得最准确的代码。不要说"获取年长的用户",您可能会说"过滤 60 岁及以上的用户"。
  • 明确您期望的输出。您希望数据被转换、过滤、聚合还是排序?提供尽可能多的详细信息。

以及一些 n8n 特定的指导:

  • 考虑输入数据:确保 ChatGPT 知道您要访问哪些数据,以及传入数据代表什么。您可能需要告诉 ChatGPT n8n 内置方法和变量的可用性。
  • 声明节点之间的交互:如果您的逻辑涉及来自多个节点的数据,请指定它们应如何交互。 “根据‘userID’属性将‘节点 A’的输出与‘节点 B’合并”。如果您希望数据来自某些节点或忽略其他节点,请明确:“仅考虑来自‘购买’节点的数据并忽略‘退款’节点。”
  • 确保输出与n8n兼容。有关 n8n 所需数据结构的更多信息,请参阅数据结构。

示例提示

这些示例显示了一系列可能的提示和任务。

示例 1:在第二个数据集 中查找一条数据

要自己尝试该示例,请下载示例工作流并将其导入 n8n。

在第三个代码节点中,输入此提示:

Slack 数据只包含一个项目。输入数据代表所有 Notion 用户。有时保存电子邮件的人员属性可能为 null。我想找到 Slack 用户的 notionId 并返回它。

查看 AI 生成的代码。

这是您需要的 JavaScript:

const slackUser = $("Mock Slack").all()[0];
const notionUsers = $input.all();
const slackUserEmail = slackUser.json.email;

const notionUser = notionUsers.find(
  (user) => user.json.person && user.json.person.email === slackUserEmail
);

return notionUser ? [{ json: { notionId: notionUser.json.id } }] : [];

示例2:数据转换

要自己尝试该示例,请下载示例工作流并将其导入 n8n。

在连接项目代码节点中,输入此提示:

返回一行文本,其中列出了所有用户名,用逗号分隔。每个用户名都应该用双引号括起来。

查看 AI 生成的代码。

这是您需要的 JavaScript:

const items = $input.all();
const usernames = items.map((item) => `"${item.json.username}"`);
const result = usernames.join(", ");
return [{ json: { usernames: result } }];

示例 3:汇总数据并创建 Slack 消息

要自己尝试该示例,请下载示例工作流并将其导入 n8n。

在总结代码节点中,输入此提示:

为 Slack 创建一个 markdown 文本,计算已提交了多少想法、功能和错误。提交类型保存在 property_type 字段中。功能具有属性"Feature",错误具有属性"Bug",想法具有属性"Idea"。另外,在该消息中列出按投票排名前五的提交。使用""作为链接的 markdown。

查看 AI 生成的代码。

这是您需要的 JavaScript:

const submissions = $input.all();

// 计算想法、功能和错误的数量
let ideaCount = 0;
let featureCount = 0;
let bugCount = 0;

submissions.forEach((submission) => {
  switch (submission.json.property_type[0]) {
    case "Idea":
      ideaCount++;
      break;
    case "Feature":
      featureCount++;
      break;
    case "Bug":
      bugCount++;
      break;
  }
});

// 按投票对提交进行排序并取前 5 名
const topSubmissions = submissions
  .sort((a, b) => b.json.property_votes - a.json.property_votes)
  .slice(0, 5);

let topSubmissionText = "";
topSubmissions.forEach((submission) => {
  topSubmissionText += `<${submission.json.url}|${submission.json.name}> 获得 ${submission.json.property_votes} 票\n`;
});

// 构建 Slack 消息
const slackMessage = `*提交摘要*\n
想法:${ideaCount}\n
功能:${featureCount}\n
错误:${bugCount}\n
前 5 名提交:\n
${topSubmissionText}`;

return [{ json: { slackMessage } }];

显式引用传入节点数据

如果您的传入数据包含嵌套字段,使用点符号引用它们可以帮助 AI 理解您想要什么数据。

代码节点中的 AI 提示使用点表示法引用嵌套数据,例如 personal_info.first_name

要自己尝试该示例,请下载示例工作流并将其导入 n8n。

在第二个代码节点中,输入此提示:

"模拟数据"中的数据代表人员列表。对于每个人,返回一个包含 personal_info.first_name 和 work_info.job_title 的新项目。

这是您需要的 JavaScript:

const items = $input.all();
const newItems = items.map((item) => {
  const firstName = item.json.personal_info.first_name;
  const jobTitle = item.json.work_info.job_title;
  return {
    json: {
      firstName,
      jobTitle,
    },
  };
});
return newItems;

修复代码

AI 生成的代码无需任何更改即可运行,但您可能需要对其进行编辑。您需要了解 n8n 的数据结构。您可能还会发现 n8n 的内置方法和变量很有用。

相关资源

Pluralsight 提供了一份关于如何使用 ChatGPT 编写代码的简短指南,其中包含示例提示词。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。