跳到主要内容

OpenAI 助手操作#

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

OpenAI 节点 V2 中已弃用助手操作

n8n 1.117.0 版本引入了 OpenAI 节点的 V2 版本，该版本支持 OpenAI Responses API 并移除了对即将弃用的 Assistants 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 平台。
  • 文件：选择要上传的文件作为外部知识源。使用上传文件操作可添加更多文件。

选项#​

  • 输出随机性（Temperature）：调整回复的随机程度。取值范围为 0.0（完全确定性）到 1.0（最大随机性）。建议仅调整此参数或输出随机性（Top P） 其中之一。可从中间值（约 0.7）开始，根据实际输出效果进行调整。若回复过于重复或刻板，可提高该值；若过于混乱或偏离主题，则降低该值。默认值为 1.0。
  • 输出随机性（Top P）：调整 Top P 设置以控制助手回复的多样性。例如，0.5 表示考虑前 50% 的概率加权选项。建议仅调整此参数或输出随机性（Temperature） 其中之一。默认值为 1.0。
  • 助手已存在时失败：若启用此选项，当存在同名助手时，操作将失败。

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

删除助手#​

通过此操作可从账户中删除现有助手。

输入以下参数：

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

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

列出助手#​

通过此操作可获取组织内的助手列表。

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

选项#​

  • 简化输出：开启后返回简化版本的响应而非原始数据。此选项默认启用。

更多信息请参阅列出助手 | OpenAI 文档。

向助手发送消息#​

通过此操作可向助手发送消息并获取回复。

输入以下参数：

  • 连接凭据：创建或选择现有的 OpenAI 凭据。
  • 资源：选择助手。
  • 操作：选择向助手发送消息。
  • 助手：选择要发送消息的助手。
  • 提示语：输入要发送给助手的文本提示或消息。
    • 连接的聊天触发节点：自动使用前序节点 chatInput 字段的输入内容。
    • 手动定义：通过输入静态文本或使用表达式引用前序节点数据来手动定义提示语。

选项#​

  • 基础 URL：输入助手用于发起 API 请求的基础 URL。此选项适用于将助手导向至提供 OpenAI 兼容 API 的其他 LLM 服务商端点。
  • 最大重试次数：指定操作失败时助手的重试次数。
  • 超时时间：设置助手等待响应的最长时间（毫秒），超时即终止操作。此选项可避免操作过程中的长时间等待。
  • 保留原始工具：关闭后将移除助手关联的原始工具。若需在此特定操作中临时移除工具，请使用此选项。

更多信息请参阅助手 | 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个字符。
  • 移除所有自定义工具（函数）：开启后将移除助手的全部自定义工具（函数）。
  • 输出随机性（Temperature）：调整回复的随机程度，取值范围为 0.0（确定性输出）至 1.0（最大随机性）。建议仅调整此参数或输出随机性（Top P） 其中之一。初始建议设置为中等随机值（约0.7），并根据实际输出效果进行调整。若回复过于重复或刻板，可提高该值；若回复过于混乱或偏离主题，则降低该值。默认值为 1.0。
  • 输出随机性（Top P）：通过调整Top P值控制助手回复的多样性。例如设置为 0.5 时，系统将考虑概率权重前50%的选项。建议仅调整此参数或输出随机性（Temperature） 其中之一。默认值为 1.0。

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

常见问题#​

关于常见错误/问题及建议解决步骤，请参阅常见问题。