n8n 中文文档

OpenAI 助理操作

使用此操作可以在 OpenAI 中创建、删除、列出、发送消息或更新助手。有关 OpenAI 节点本身的更多信息,请参阅 OpenAI。

警告

功能可用性

OpenAI 节点 V2 中已弃用助理操作,在 n8n 1.117.0 中引入。 OpenAI 节点 V2 支持 OpenAI 响应 API,并删除了对 即将弃用的助手 API 的支持。

创建助手

使用此操作可以创建一个新的助手。

输入这些参数:

  • 连接凭据:创建或选择现有的 OpenAI凭证。
  • 资源:选择助理。
  • 操作:选择创建助手。
  • 型号:选择助手将使用的型号。如果您不确定使用哪种型号,如果您需要高智能,请尝试gpt-4o;如果您需要最快的速度和最低的成本,请尝试gpt-4o-mini。请参阅 型号概览 | OpenAI 平台 了解更多信息。
  • 姓名:输入助理的姓名。最大长度为 256 个字符。
  • 描述:输入助手的描述。最大长度为 512 个字符。 A virtual assistant that helps users with daily tasks, including setting reminders, answering general questions, and providing quick information.
  • 指令:输入助手使用的系统指令。最大长度为 32,768 个字符。使用它来指定模型在其回复中使用的角色。 Always respond in a friendly and engaging manner. When a user asks a question, provide a concise answer first, followed by a brief explanation or additional context if necessary. If the question is open-ended, offer a suggestion or ask a clarifying question to guide the conversation. Keep the tone positive and supportive, and avoid technical jargon unless specifically requested by the user.
  • 代码解释器:打开可为助手启用代码解释器,它可以在沙箱环境中编写和执行代码。为需要计算、数据分析或任何基于逻辑的处理的任务启用此工具。
  • 知识检索:打开可为助手启用知识检索,允许其访问外部源或连接的知识库。请参阅 文件搜索 | OpenAI 平台 了解更多信息。
    • 文件:选择要上传的文件作为您的外部知识源。使用上传文件操作来添加更多文件。

选项

  • 输出随机性(温度):调整响应的随机性。范围介于 0.0(确定性)和 1.0(最大随机性)之间。我们建议更改此设置或输出随机性(Top P),但不能同时更改两者。从中等温度(大约 0.7)开始,然后根据观察到的输出进行调整。如果响应过于重复或僵化,请提高温度。如果它们太混乱或偏离轨道,请减少它。默认为 1.0。
  • 输出随机性(Top P):调整 Top P 设置以控制助手响应的多样性。例如,0.5 表示考虑所有似然加权选项的一半。我们建议更改此设置或输出随机性(温度),但不能同时更改两者。默认为 1.0。
  • 助手已存在则失败:启用后,如果已存在同名助手,操作将失败。

有关更多信息,请参阅 创建助手 | OpenAI 文档。

删除助手

使用此操作可从您的帐户中删除现有助手。

输入这些参数:

  • 连接凭据:创建或选择现有的 OpenAI凭证。
  • 资源:选择助理。
  • 操作:选择删除助手。
  • 助手:选择您要删除的助手从列表或按ID。

有关更多信息,请参阅 删除助手 | OpenAI 文档。

列表助理

使用此操作检索组织中的助理列表。

  • 连接凭据:创建或选择现有的 OpenAI凭证。
  • 资源:选择助理。
  • 操作:选择列出助手。

选项

  • 简化输出:打开以返回响应的简化版本而不是原始数据。默认情况下启用此选项。

有关更多信息,请参阅 列表助手 | OpenAI 文档。

给助理留言

使用此操作可以向助手发送消息并接收响应。

输入这些参数:

  • 连接凭据:创建或选择现有的 OpenAI凭证。
  • 资源:选择助理。
  • 操作:选择向助理发送消息。
  • 助理:选择您要向其发送消息的助理。
  • 提示:输入您要发送给助理的文本提示或消息。
    • 连接的聊天触发节点:自动使用前一个节点的 chatInput 字段的输入。
    • 在下面定义:通过输入静态文本或使用表达式引用先前节点的数据来手动定义提示。

选项

  • 基本 URL:输入助手用于发出 API 请求的基本 URL。此选项对于指示助手使用其他 LLM 提供商提供的端点非常有用,这些提供商提供 OpenAI 兼容的 API。
  • 最大重试次数:指定助手在失败时应重试操作的次数。
  • 超时:设置助手在超时之前等待响应的最长时间(以毫秒为单位)。使用此选项可以防止操作过程中长时间等待。
  • 保留原始工具:关闭以删除与助手关联的原始工具。如果您想暂时删除用于此特定操作的工具,请使用此选项。

有关更多信息,请参阅 助理 | OpenAI 文档。

更新助手

使用此操作可以更新现有助手的详细信息。

输入这些参数:

  • 连接凭据:创建或选择现有的 OpenAI凭证。
  • 资源:选择助理。
  • 操作:选择更新助手。
  • 助手:选择您要更新的助手。

选项

  • 代码解释器:打开可为助手启用代码解释器,它可以在沙箱环境中编写和执行代码。为需要计算、数据分析或任何基于逻辑的处理的任务启用此工具。
  • 描述:输入助手的描述。最大长度为 512 个字符。 A virtual assistant that helps users with daily tasks, including setting reminders, answering general questions, and providing quick information.
  • 指令:输入助手使用的系统指令。最大长度为 32,768 个字符。使用它来指定模型在其回复中使用的角色。 Always respond in a friendly and engaging manner. When a user asks a question, provide a concise answer first, followed by a brief explanation or additional context if necessary. If the question is open-ended, offer a suggestion or ask a clarifying question to guide the conversation. Keep the tone positive and supportive, and avoid technical jargon unless specifically requested by the user.
  • 知识检索:打开可为助手启用知识检索,允许其访问外部源或连接的知识库。请参阅 文件搜索 | OpenAI 平台 了解更多信息。
  • 文件:选择要上传的文件作为您的外部知识源。使用上传文件操作添加更多文件。请注意,这仅更新 代码解释器 工具,而不更新 文件搜索 工具。
  • 型号:选择助手将使用的型号。如果您不确定使用哪种型号,如果您需要高智能,请尝试gpt-4o;如果您需要最快的速度和最低的成本,请尝试gpt-4o-mini。请参阅 型号概览 | OpenAI 平台 了解更多信息。
  • 姓名:输入助理的姓名。最大长度为 256 个字符。
  • 删除所有自定义工具(功能):开启可从助手中删除所有自定义工具(功能)。
  • 输出随机性(温度):调整响应的随机性。范围介于 0.0(确定性)和 1.0(最大随机性)之间。我们建议更改此设置或输出随机性(Top P),但不能同时更改两者。从中等温度(大约 0.7)开始,然后根据观察到的输出进行调整。如果响应过于重复或僵化,请提高温度。如果它们太混乱或偏离轨道,请减少它。默认为 1.0。
  • 输出随机性(Top P):调整 Top P 设置以控制助手响应的多样性。例如,0.5 表示考虑所有似然加权选项的一半。我们建议更改此设置或输出随机性(温度),但不能同时更改两者。默认为 1.0。

有关更多信息,请参阅 修改助手 | OpenAI 文档。

常见问题

有关常见错误或问题以及建议的解决步骤,请参阅 常见问题。

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