n8n项目中$fromAI()函数键值重复问题分析与解决方案

问题背景

在n8n工作流自动化平台中，用户在使用AI工具代理节点时遇到了一个关键错误："Duplicate key 'Field_Value' found with different description or type"。这个问题主要出现在使用Supabase子节点工具并尝试自动设置字段时。

问题现象

当用户通过AI工具代理节点自动设置字段时，系统会生成多个$fromAI()函数调用，但这些调用都使用了相同的键名"Field_Value"，尽管它们对应的是不同的字段描述和数据类型。例如：

{{ $fromAI('Field_Value', `An array of suggested gift items...`, 'string') }}
{{ $fromAI('Field_Value', `General description of the intended audience...`, 'string') }}

这种键名重复但描述和类型不同的情况会导致系统抛出错误，阻止工作流的正常执行。

技术原理

$fromAI()是n8n中用于从AI模型获取数据的特殊函数，其参数结构通常为：

1. 键名（用于标识数据字段）
2. 描述（告诉AI需要生成什么内容）
3. 数据类型（指定返回值的类型）

在底层实现上，n8n会将这些定义转换为模式(schema)验证。当检测到相同键名但描述或类型不一致时，系统会认为这是冲突的定义，从而抛出错误。

临时解决方案

在官方修复发布前，用户可以采取以下手动解决方案：

1. 移除自动生成的$fromAI()调用
2. 手动编辑表达式，为每个字段使用唯一的键名
3. 确保每个$fromAI()调用都有：
   • 唯一的键名
   • 清晰的描述
   • 正确的数据类型

例如修改为：

{{ $fromAI('Gift_Suggestions', `An array of suggested gift items...`, 'string') }}
{{ $fromAI('Target_Audience', `General description of the intended audience...`, 'string') }}

官方修复进展

n8n开发团队已经确认此问题并创建了内部追踪编号GHC-1168。根据最新消息，修复将在下一个版本中发布，预计会先进入beta测试，然后在下周一发布稳定版本。

最佳实践建议

为避免类似问题，建议用户：

1. 对于关键业务工作流，优先考虑手动定义字段而非完全依赖自动设置
2. 定期检查工作流中使用的$fromAI()调用
3. 为每个字段使用语义明确的键名
4. 在更新n8n版本后，验证自动设置字段的功能是否正常工作

总结

这个问题展示了在自动化工具中使用AI生成内容时可能遇到的模式验证挑战。虽然临时解决方案需要额外的手动操作，但理解其背后的技术原理有助于用户更好地构建和维护复杂的工作流。随着n8n团队的持续改进，这类问题将得到更好的自动化处理。