n8n 中文文档

工具代理

工具代理使用外部工具[^1] 和 API 来执行操作和检索信息。它可以了解不同工具的功能,并根据任务确定使用哪个工具。该代理有助于将法学硕士与各种外部服务和数据库集成。

此代理具有与工具协作的增强能力,可以确保标准输出格式。

Tools Agent 实现了 LangChain 的工具调用{:target=_blank .external-link} 接口。此接口描述了可用的工具及其模式。代理还具有改进的输出解析功能,因为它将解析器作为格式化工具传递给模型。

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

您可以将此代理与聊天触发器节点一起使用。附加一个内存子节点,以便用户可以与多个查询进行持续对话。会话之间的记忆不会持续存在。

此代理支持以下聊天模型:

工具代理可以使用以下工具... * [调用n8n工作流程](../../sub-nodes/n8n-nodes-langchain.toolworkflow.md) * [代码](../../sub-nodes/n8n-nodes-langchain.toolcode.md) * [HTTP 请求](../../../core-nodes/n8n-nodes-base.httprequest/README.md) * [行动网络](../../../app-nodes/n8n-nodes-base.actionnetwork.md) * [ActiveCampaign](../../../app-nodes/n8n-nodes-base.activecampaign.md) * [亲和力](../../../app-nodes/n8n-nodes-base.affinity.md) * [敏捷CRM](../../../app-nodes/n8n-nodes-base.agilecrm.md) * [Airtable](../../../app-nodes/n8n-nodes-base.airtable/README.md) * [APITemplate.io](../../../app-nodes/n8n-nodes-base.apitemplateio.md) * [体式](../../../app-nodes/n8n-nodes-base.asana.md) * [AWS Lambda](../../../app-nodes/n8n-nodes-base.awslambda.md) * [AWS S3](../../../app-nodes/n8n-nodes-base.awss3.md) * [AWS SES](../../../app-nodes/n8n-nodes-base.awsses.md) * [AWS Textract](../../../app-nodes/n8n-nodes-base.awstextract.md) * [AWS Transcribe](../../../app-nodes/n8n-nodes-base.awstranscribe.md) * [Baserow](../../../app-nodes/n8n-nodes-base.baserow.md) * [气泡](../../../app-nodes/n8n-nodes-base.bubble.md) * [计算器](../../sub-nodes/n8n-nodes-langchain.toolcalculator.md) * [ClickUp](../../../app-nodes/n8n-nodes-base.clickup.md) * [CoinGecko](../../../app-nodes/n8n-nodes-base.coingecko.md) * [压缩](../../../core-nodes/n8n-nodes-base.compression.md) * [加密](../../../core-nodes/n8n-nodes-base.crypto.md) * [DeepL](../../../app-nodes/n8n-nodes-base.deepl.md) * [DHL](../../../app-nodes/n8n-nodes-base.dhl.md) * [不和谐](../../../app-nodes/n8n-nodes-base.discord/README.md) * [Dropbox](../../../app-nodes/n8n-nodes-base.dropbox.md) * [Elasticsearch](../../../app-nodes/n8n-nodes-base.elasticsearch.md) * [ERPNext](../../../app-nodes/n8n-nodes-base.erpnext.md) * [Facebook 图形 API](../../../app-nodes/n8n-nodes-base.facebookgraphapi.md) * [FileMaker](../../../app-nodes/n8n-nodes-base.filemaker.md) * [幽灵](../../../app-nodes/n8n-nodes-base.ghost.md) * [Git](../../../core-nodes/n8n-nodes-base.git.md) * [GitHub](../../../app-nodes/n8n-nodes-base.github.md) * [GitLab](../../../app-nodes/n8n-nodes-base.gitlab.md) * [Gmail](../../../app-nodes/n8n-nodes-base.gmail/README.md) * [谷歌分析](../../../app-nodes/n8n-nodes-base.googleanalytics.md) * [Google BigQuery](../../../app-nodes/n8n-nodes-base.googlebigquery.md) * [谷歌日历](../../../app-nodes/n8n-nodes-base.googlecalendar/README.md) * [谷歌聊天](../../../app-nodes/n8n-nodes-base.googlechat.md) * [Google Cloud Firestore](../../../app-nodes/n8n-nodes-base.googlecloudfirestore.md) * [谷歌云实时数据库](../../../app-nodes/n8n-nodes-base.googlecloudrealtimedatabase.md) * [Google 通讯录](../../../app-nodes/n8n-nodes-base.googlecontacts.md) * [Google 文档](../../../app-nodes/n8n-nodes-base.googledocs.md) * [Google 云端硬盘](../../../app-nodes/n8n-nodes-base.googledrive/README.md) * [Google 表格](../../../app-nodes/n8n-nodes-base.googlesheets/README.md) * [谷歌幻灯片](../../../app-nodes/n8n-nodes-base.googleslides.md) * [Google 任务](../../../app-nodes/n8n-nodes-base.googletasks.md) * [谷歌翻译](../../../app-nodes/n8n-nodes-base.googletranslate.md) * [Google Workspace 管理员](../../../app-nodes/n8n-nodes-base.gsuiteadmin.md) * [Gotify](../../../app-nodes/n8n-nodes-base.gotify.md) * [Grafana](../../../app-nodes/n8n-nodes-base.grafana.md) * [GraphQL](../../../core-nodes/n8n-nodes-base.graphql.md) * [黑客新闻](../../../app-nodes/n8n-nodes-base.hackernews.md) * [家庭助理](../../../app-nodes/n8n-nodes-base.homeassistant.md) * [HubSpot](../../../app-nodes/n8n-nodes-base.hubspot.md) * [詹金斯](../../../app-nodes/n8n-nodes-base.jenkins.md) * [Jira 软件](../../../app-nodes/n8n-nodes-base.jira.md) * [JWT](../../../core-nodes/n8n-nodes-base.jwt.md) * [卡夫卡](../../../app-nodes/n8n-nodes-base.kafka.md) * [LDAP](../../../core-nodes/n8n-nodes-base.ldap.md) * [行](../../../app-nodes/n8n-nodes-base.line.md) * [LinkedIn](../../../app-nodes/n8n-nodes-base.linkedin.md) * [邮件检查](../../../app-nodes/n8n-nodes-base.mailcheck.md) * [邮件枪](../../../app-nodes/n8n-nodes-base.mailgun.md) * [Mattermost](../../../app-nodes/n8n-nodes-base.mattermost.md) * [Mautic](../../../app-nodes/n8n-nodes-base.mautic.md) * [中](../../../app-nodes/n8n-nodes-base.medium.md) * [Microsoft Excel (OneDrive)](../../../app-nodes/n8n-nodes-base.microsoftexcel.md) * [Microsoft OneDrive](../../../app-nodes/n8n-nodes-base.microsoftonedrive.md) * [Microsoft Outlook](../../../app-nodes/n8n-nodes-base.microsoftoutlook.md) * [Microsoft SQL](../../../app-nodes/n8n-nodes-base.microsoftsql.md) * [微软团队](../../../app-nodes/n8n-nodes-base.microsoftteams.md) * [微软待办](../../../app-nodes/n8n-nodes-base.microsofttodo.md) * [Monday.com](../../../app-nodes/n8n-nodes-base.mondaycom.md) * [MongoDB](../../../app-nodes/n8n-nodes-base.mongodb.md) * [MQTT](../../../app-nodes/n8n-nodes-base.mqtt.md) * [MySQL](../../../app-nodes/n8n-nodes-base.mysql/README.md) * [NASA](../../../app-nodes/n8n-nodes-base.nasa.md) * [Nextcloud](../../../app-nodes/n8n-nodes-base.nextcloud.md) * [NocoDB](../../../app-nodes/n8n-nodes-base.nocodb.md) * [概念](../../../app-nodes/n8n-nodes-base.notion/README.md) * [Odoo](../../../app-nodes/n8n-nodes-base.odoo.md) * [OpenWeatherMap](../../../app-nodes/n8n-nodes-base.openweathermap.md) * [管道驱动](../../../app-nodes/n8n-nodes-base.pipedrive.md) * [Postgres](../../../app-nodes/n8n-nodes-base.postgres/README.md) * [推送](../../../app-nodes/n8n-nodes-base.pushover.md) * [QuickBooks 在线](../../../app-nodes/n8n-nodes-base.quickbooks.md) * [QuickChart](../../../app-nodes/n8n-nodes-base.quickchart.md) * [RabbitMQ](../../../app-nodes/n8n-nodes-base.rabbitmq.md) * [Reddit](../../../app-nodes/n8n-nodes-base.reddit.md) * [Redis](../../../app-nodes/n8n-nodes-base.redis.md) * [RocketChat](../../../app-nodes/n8n-nodes-base.rocketchat.md) * [S3](../../../app-nodes/n8n-nodes-base.s3.md) * [Salesforce](../../../app-nodes/n8n-nodes-base.salesforce.md) * [发送邮件](../../../core-nodes/n8n-nodes-base.sendemail.md) * [SendGrid](../../../app-nodes/n8n-nodes-base.sendgrid.md) * [SerpApi(谷歌搜索)](../../sub-nodes/n8n-nodes-langchain.toolserpapi.md) * [Shopify](../../../app-nodes/n8n-nodes-base.shopify.md) * [Slack](../../../app-nodes/n8n-nodes-base.slack/README.md) * [Spotify](../../../app-nodes/n8n-nodes-base.spotify.md) * [条纹](../../../app-nodes/n8n-nodes-base.stripe.md) * [Supabase](../../../app-nodes/n8n-nodes-base.supabase/README.md) * [电报](../../../app-nodes/n8n-nodes-base.telegram/README.md) * [Todoist](../../../app-nodes/n8n-nodes-base.todoist.md) * [TOTP](../../../core-nodes/n8n-nodes-base.totp.md) * [Trello](../../../app-nodes/n8n-nodes-base.trello.md) * [Twilio](../../../app-nodes/n8n-nodes-base.twilio.md) * [urlscan.io](../../../app-nodes/n8n-nodes-base.urlscanio.md) * [矢量存储](../../sub-nodes/n8n-nodes-langchain.toolvectorstore.md) * [Webflow](../../../app-nodes/n8n-nodes-base.webflow.md) * [维基百科](../../sub-nodes/n8n-nodes-langchain.toolwikipedia.md) * [Wolfram|Alpha](../../sub-nodes/n8n-nodes-langchain.toolwolframalpha.md) * [WooCommerce](../../../app-nodes/n8n-nodes-base.woocommerce.md) * [Wordpress](../../../app-nodes/n8n-nodes-base.wordpress.md) * [X(以前的 Twitter)](../../../app-nodes/n8n-nodes-base.twitter.md) * [YouTube](../../../app-nodes/n8n-nodes-base.youtube.md) * [Zendesk](../../../app-nodes/n8n-nodes-base.zendesk.md) * [Zoho CRM](../../../app-nodes/n8n-nodes-base.zohocrm.md) * [缩放](../../../app-nodes/n8n-nodes-base.zoom.md)

节点参数

使用以下参数配置 Tools Agent。

提示

选择您希望节点如何构造提示(也称为用户的查询或聊天输入)。

选择:

  • Take from previous node automatically 自动从前一个节点获取:如果选择此选项,节点将期望来自名为 chatInput 的前一个节点的输入。
  • Define below 定义如下:如果选择此选项,请提供静态文本或动态内容表达式,以用作 Prompt (User Message) 提示(用户消息) 字段中的提示。

需要特定输出格式

该参数控制您是否希望节点需要特定的输出格式。打开时,n8n 会提示您将这些输出解析器之一连接到节点:

节点选项

使用这些选项来调整 Tools Agent 节点的行为:

系统消息

如果您想在对话开始之前向客服人员发送消息,请输入您要发送的消息。

使用此选项来指导代理的决策。

最大迭代次数

输入模型应运行的次数,以尝试根据用户提示生成正确的答案。

默认值为 10。

返回中间步骤

选择是否在最终输出中包含代理采取的中间步骤(打开)或不包含(关闭)。

这对于根据代理采取的步骤进一步改进代理的行为可能很有用。

跟踪元数据

为此 agent 的 tracing event 添加自定义键值 metadata。这有助于在 LangSmith 等 tracing 工具中过滤和调试运行。

key 或 value 为空的条目会被忽略。

自动传递二进制图像

使用此选项可以控制二进制图像是否应作为图像类型消息自动传递到代理(打开)或不传递(关闭)。

启用流媒体

启用后,AI Agent 会在生成答案时实时向用户发送数据。这对长时间运行的生成很有用。默认情况下启用此功能。

提示

Streaming requirements 流媒体要求

为了使流式传输正常工作,您的工作流必须使用支持流式响应的触发器,例如 Chat Trigger 或 Webhook 节点,并将 Response Mode 响应模式 设置为Streaming 流媒体。

模板和示例

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

$fromAI() 刀具的动态参数

要了解如何动态填充应用程序节点工具的参数,请参阅让AI使用$fromAI()指定工具参数。

工具调用的人工审核

您可以在 AI Agent 执行特定工具前要求人工批准。这对于执行敏感操作的工具很有用,例如发送消息、修改记录或删除数据。

要添加人工审核步骤:

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

当 AI 想要使用受控工具时,工作流会暂停并通过您选择的渠道发送审批请求。接收者可以批准(工具执行)或拒绝(操作取消)。

有关详细的设置说明和最佳实践,请参阅AI 工具调用的人机交互。

常见问题

有关常见问题和建议的解决方案,请参阅常见问题。

[^1]:在 AI 环境中,工具是一种附加资源,AI 在响应请求时可以参考该资源来获取特定信息或功能。人工智能模型可以使用工具与外部系统交互或完成特定的、有重点的任务。

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