OpenAI Assistant 操作(OpenAI Assistant operations)#
使用此操作可以在 OpenAI 中创建、删除、列出、发送消息或更新助手。有关 OpenAI 节点本身的更多信息，请参阅 OpenAI。
🌐 Use this operation to create, delete, list, message, or update an assistant in OpenAI. Refer to OpenAI for more information on the OpenAI node itself.
OpenAI 节点 V2 中的助手操作已弃用
n8n 版本 1.117.0 引入了 OpenAI 节点的 V2，支持 OpenAI Responses API，并移除了对即将弃用的 Assistants API 的支持。
创建助手(Create an Assistant)#
使用此操作创建新的助手。
🌐 Use this operation to create a new assistant.
请输入以下参数：
🌐 Enter these parameters:
- 连接凭证：创建或选择一个现有的 OpenAI 凭证。
- 资源：选择助手。
- 操作：选择创建助手。
- 模型：选择助手将使用的模型。如果你不确定要使用哪个模型，请在需要高智力时尝试使用
gpt-4o，在需要最快速度和最低成本时尝试使用gpt-4o-mini。有关更多信息，请参阅 模型概述 | OpenAI 平台。 - 名称：输入助手的名称。最大长度为256个字符。
- 描述：输入助手的描述。最大长度为512个字符。
1 | |
- 说明：输入助手使用的系统指令。最长可达32,768个字符。使用此项可指定模型在回复中使用的角色设定。
1 | |
- 代码解释器：开启以启用助理的代码解释器，助理可以在沙盒环境中编写和执行代码。为需要计算、数据分析或任何基于逻辑的处理的任务启用此工具。
- 知识检索：开启后，可启用助手的知识检索功能，使其能够访问外部资源或连接的知识库。更多信息请参阅 文件搜索 | OpenAI 平台。
- 文件：选择一个文件以上传到你的外部知识源。使用 上传文件 操作来添加更多文件。
选项(Options)#
- 输出随机性（温度）：调整响应的随机性。范围在
0.0（确定性）到1.0（最大随机性）之间。建议调整此参数或 输出随机性（Top P），但不要同时调整两者。初始可设置中等温度（约 0.7），然后根据观察到的输出进行调整。如果响应过于重复或僵硬，请提高温度；如果响应过于混乱或偏离主题，请降低温度。默认值为1.0。 - 输出随机性（Top P）：调整 Top P 设置以控制助手回答的多样性。例如，
0.5表示会考虑所有按概率加权选项的一半。我们建议只调整此项或 输出随机性（温度），但不要同时修改。默认值为1.0。 - 如果助手已存在则失败：如果启用，当已有同名助手存在时，操作将失败。
有关更多信息，请参考 Create assistant | OpenAI 文档。
🌐 Refer to Create assistant | OpenAI documentation for more information.
删除助手(Delete an Assistant)#
使用此操作可从你的账户中删除现有助手。
🌐 Use this operation to delete an existing assistant from your account.
请输入以下参数：
🌐 Enter these parameters:
- 连接凭证：创建或选择一个现有的 OpenAI 凭证。
- 资源：选择助手。
- 操作：选择删除助手。
- 助手：选择你要删除的助手 从列表中 或 通过ID。
有关更多信息，请参考 Delete assistant | OpenAI 文档。
🌐 Refer to Delete assistant | OpenAI documentation for more information.
列出助手(List Assistants)#
使用此操作可检索组织中的助理列表。
🌐 Use this operation to retrieve a list of assistants in your organization.
- 连接凭证：创建或选择一个现有的 OpenAI 凭证。
- 资源：选择助手。
- 操作：选择列出助手。
选项(Options)#
- 简化输出：开启后将返回简化版本的响应，而不是原始数据。此选项默认启用。
有关更多信息，请参考 列出助手 | OpenAI 文档。
🌐 Refer to List assistants | OpenAI documentation for more information.
向助手发送消息(Message an Assistant)#
使用此操作向助手发送消息并接收响应。
🌐 Use this operation to send a message to an assistant and receive a response.
请输入以下参数：
🌐 Enter these parameters:
- 连接凭证：创建或选择一个现有的 OpenAI 凭证。
- 资源：选择助手。
- 操作：选择向助手发送消息。
- 助手：选择你想要发送消息的助手。
- 提示：输入你想发送给助手的文本提示或消息。
- 已连接聊天触发节点：自动使用来自前一个节点的
chatInput字段的输入。 - 如下定义：通过输入静态文本或使用表达式引用前一个节点的数据来手动定义提示。
- 已连接聊天触发节点：自动使用来自前一个节点的
选项(Options)#
- 基础 URL：输入助手用于发起 API 请求的基础 URL。此选项对于指导助手使用由其他提供 OpenAI 兼容 API 的大型语言模型提供的端点非常有用。
- 最大重试次数：指定助手在操作失败时应重试的次数。
- 超时：设置助手在超时之前等待响应的最长时间（毫秒）。使用此选项可以防止操作过程中等待时间过长。
- 保留原始工具：关闭以移除与助手相关的原始工具。如果你想在此特定操作中暂时移除工具，请使用此选项。
有关更多信息，请参考 助理 | OpenAI 文档。
🌐 Refer to Assistants | OpenAI documentation for more information.
更新助手(Update an Assistant)#
使用此操作更新现有助手的详细信息。
🌐 Use this operation to update the details of an existing assistant.
请输入以下参数：
🌐 Enter these parameters:
- 连接凭证：创建或选择一个现有的 OpenAI 凭证。
- 资源：选择助手。
- 操作：选择更新助手。
- 助手：选择你想要更新的助手。
选项(Options)#
- 代码解释器：开启以启用助理的代码解释器，助理可以在沙盒环境中编写和执行代码。为需要计算、数据分析或任何基于逻辑的处理的任务启用此工具。
- 描述：输入助手的描述。最大长度为512个字符。
1 | |
- 说明：输入助手使用的系统指令。最长可达32,768个字符。使用此项可指定模型在回复中使用的角色设定。
1 | |
- 知识检索：开启后，可启用助手的知识检索功能，使其能够访问外部资源或连接的知识库。更多信息请参阅 文件搜索 | 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 文档。
🌐 Refer to Modify assistant | OpenAI documentation for more information.
常见问题(Common issues)#
有关常见错误或问题及建议的解决步骤，请参考 常见问题。
🌐 For common errors or issues and suggested resolution steps, refer to Common Issues.