跳到主要内容

Tools Agent(工具智能体)

Tools Agent 通过外部工具1和 API 执行操作、获取信息,可理解不同工具的能力,并根据任务决定使用哪种工具,有助于将 LLM 与各种外部服务和数据库集成。

此智能体增强了工具使用能力,并能够确保标准输出格式。

Tools Agent 实现 LangChain 工具调用接口,用于描述可用工具及其架构。它还将解析器作为格式化工具传给模型,从而增强输出解析能力。

AI Agent 节点本身的更多信息,请参阅 AI Agent。

可以将此智能体与 Chat Trigger(聊天触发器)节点配合使用。连接一个记忆子节点,即可让用户进行包含多次提问的连续对话。记忆不会跨会话保留。

此智能体支持以下聊天模型:

Tools Agent 可使用以下工具……

节点参数 ​

使用以下参数配置 Tools Agent。

Prompt(提示词) ​

选择节点构建提示词的方式,提示词也称为用户查询或聊天输入。

可选择:

  • Take from previous node automatically(自动取自上一个节点):选择后,节点期望从上一个节点接收名为 chatInput 的输入。
  • Define below(在下方定义):选择后,在 Prompt (User Message)(提示词,用户消息)字段中提供静态文本或用于动态内容的表达式,作为提示词。

Require Specific Output Format(要求指定输出格式) ​

此参数控制是否要求节点使用指定的输出格式。开启后,n8n 会提示你将以下某个输出解析器连接到节点:

节点选项 ​

使用以下选项调整 Tools Agent 节点的行为:

System Message(系统消息) ​

如果希望在对话开始前向智能体发送消息,请输入要发送的消息。

使用此选项引导智能体的决策。

Max Iterations(最大迭代次数) ​

输入模型为尝试根据用户提示词生成良好答案而运行的次数。

默认为 10。

Return Intermediate Steps(返回中间步骤) ​

选择是否在最终输出中包含智能体执行的中间步骤,开启时包含,关闭时不包含。

可根据智能体执行的步骤,进一步调整其行为。

Tracing Metadata(追踪元数据) ​

为此智能体的追踪事件添加自定义键值元数据,便于在 LangSmith 等追踪工具中筛选和调试运行。

键或值为空的条目会被忽略。

Automatically Passthrough Binary Images(自动传递二进制图像) ​

使用此选项,控制是否自动将二进制图像作为图像类型消息传给智能体,开启时传递,关闭时不传递。

Enable Streaming(启用流式输出) ​

开启后,AI Agent 在生成答案时实时向用户返回数据,适用于耗时较长的生成,默认开启。

信息

流式输出要求

要使用流式输出,工作流必须采用支持流式响应的触发器,例如 Chat Trigger 或 Webhook 节点,并将 Response Mode(响应模式)设为 Streaming(流式)。

模板与示例 ​

请参阅 AI Agent 主节点的模板与示例部分。

使用 $fromAI() 动态设置工具参数 ​

动态填充应用节点工具参数的方法,请参阅让 AI 使用 $fromAI() 指定工具参数。

工具调用的人工审核 ​

可要求 AI Agent 在执行特定工具前获得人工批准,适用于发送消息、修改记录或删除数据等执行敏感操作的工具。

添加人工审核步骤:

  1. 点击 AI Agent 节点的工具连接器。
  2. 在工具面板中找到 Human review(人工审核)部分。
  3. 选择并配置所需审批渠道,例如 Chat、Slack、Telegram 等。
  4. 将需要审批的工具连接到人工审核步骤。

AI 希望使用受审核工具时,工作流会暂停,并通过所选渠道发送审批请求。接收人可批准(执行工具)或拒绝(取消操作)。

详细配置和最佳实践,请参阅 AI 工具调用中的人工审核。

常见问题 ​

常见问题及建议的解决办法,请参阅常见问题。

Footnotes​

  1. 在 AI 场景中,工具是附加资源,AI 可在响应请求时调用它获取特定信息或功能。AI 模型可以通过工具与外部系统交互,或完成具体、专门的任务。 ↩

本文为社区中文翻译。查看对应英文原文