[Question]: Variable settings in input does not work in agent

快速结论：在 RAGFlow Agent 中用变量设置向 SQL 节点传入关键字时，SQL 里出现的是变量字面量而非实际值。这通常说明变量替换没有在运行时发生，可优先检查 SQL 节点中的变量引用写法以及 Begin 节点到 SQL 节点的输入映射。

适用环境：Issue 仅确认工具为 RAGFlow Agent 工作流，未提供操作系统、Python、CUDA、显卡或依赖版本信息，因此不做推断。

最快修复方案：暂无确认的一步修复方案。Issue 讨论中给出的处理方向是：确认 SQL 节点以 {{begin@key}} 形式引用变量、确认 Begin 节点输出已显式映射到 SQL 节点输入，并确认运行时 Begin 节点确实输出非空值。

注意事项：上述处理方向来自讨论回复，并非 Issue 中已验证成功的结论；若检查后仍复现，需要借助后端日志或工作流 trace 定位变量在哪一步未被替换，而不要直接认定是单一节点故障。

问题场景

用户创建了一个简单的 RAGFlow Agent，使用变量设置输入关键字，并希望把该关键字传入 SQL 节点的查询语句。实际运行时，SQL 中期望出现的关键字被替换成了 begin@key 这一字面字符串，说明 Begin 节点的变量值没有被正确写入 SQL。

报错原文

[Question]: Variable settings in input does not work in agent
What should be my keyword is replaced by 'begin@key'. What's wrong?

原因分析

可能原因之一是变量替换步骤没有发生：RAGFlow 中 {{begin@key}} 这类变量应在运行时由 Begin 节点的输出值替换；如果 Begin 节点输出未设置、SQL 节点引用写法不正确（例如缺少花括号），或以不正当形式引用变量，SQL 中就会保留变量名本身。

另一种可能原因是节点间的输入映射缺失或配置错误，或者执行时输入为空、未被设置。讨论回复还提到，过去存在部分模型相关的变量传递问题，因此更换 LLM 模型也可作为可优先尝试的排查方向之一；但这尚未在本 Issue 中被验证。

环境排查

确认 RAGFlow Agent 工作流中 Begin 节点已配置输入参数，并在运行时收到非空值。
确认 SQL 节点中的变量引用使用双花括号形式，例如 {{begin@key}}，而不是裸名 begin@key。
确认 Begin 节点的输出已显式映射到 SQL 节点的输入。
如仍异常，可尝试更换 LLM 模型，以排除模型相关的变量传递问题。
检查后端日志或工作流执行 trace，确认各步骤实际传入和传出的值。
Issue 未提供 Python、CUDA、PyTorch、显卡或依赖版本，无需据此推断环境兼容性问题。

解决步骤

打开该 Agent 工作流，定位 SQL 节点中的变量引用位置，确认写法为 {{begin@key}} 且与 Begin 节点参数名一致。
检查 Begin 节点的参数设置，确认关键字参数已正确配置并能由输入端传入。
检查 Begin 节点到 SQL 节点的输入映射，确认输出变量已显式连接到 SQL 节点对应输入。
运行一次简单测试输入，观察 SQL 节点是否仍出现 begin@key 字面量；同时查看 Begin 节点输出是否为空。
若发现 Begin 节点运行时值为空，先修正输入传递；若变量引用与映射均正确但问题仍存在，可优先尝试切换其他 LLM 模型。
若以上仍无法定位，查看后端日志或工作流 trace，逐节点确认变量替换发生在何处中断。

验证方法

使用一个可辨认的关键字重新运行该 Agent，确认 SQL 节点中不再出现 begin@key，而是显示实际输入值；同时在工作流 trace 或后端日志中确认 Begin 节点输出和 SQL 节点输入的值一致。Issue 讨论未说明问题最终由哪项操作解决，因此以实际执行结果显示正确关键字作为验证标准。