Microsoft Foundry Chat Model 节点
Microsoft Foundry Chat Model 节点可将对话智能体[^1]连接到 Microsoft Foundry 或 Azure OpenAI 资源上的聊天模型。
此节点之前名为 Azure AI Foundry Chat Model 节点和 Azure OpenAI Chat Model 节点。
本页介绍 Microsoft Foundry Chat Model 节点的参数,并提供更多资源链接。
提示
Credentials 凭证
有关此节点的身份验证信息,请参阅 Microsoft Foundry 凭据文档。
提示
Parameter resolution in sub-nodes 子节点参数解析
使用表达式处理多个项目时,子节点的行为与其他节点不同。
大多数节点,包括根节点,接受任意数量的项目作为输入,处理这些项目,并输出结果。您可以使用表达式引用输入项目,节点会依次为每个项目解析表达式。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 会依次解析为每个名称。
在子节点中,表达式始终解析为第一项。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 始终解析为名字。
节点参数
- Authentication 身份验证:选择 API Key 或 Azure Entra ID (OAuth2)。每个选项使用各自的凭据。
- Project 项目:输入拥有该部署的 Microsoft Foundry 项目名称。留空可使用凭据中的 Project 项目。经典 Azure OpenAI 资源不使用此字段。
- Model (Deployment) 模型(部署):选择用于生成补全的部署。
- From List 从列表中选择:从项目的部署中选择。列表仅显示聊天部署。此方式需要 Microsoft Foundry 凭据,并且必须在此字段或凭据中设置 Project 项目。请先设置 Project 项目。
- By ID 按 ID:输入部署名称。经典 Azure OpenAI 凭据或列表中没有的部署请使用此方式。
- Model Family 模型系列:选择该部署使用的 API 系列。Azure 不会报告此信息,因此请设置为与部署匹配的值。
- OpenAI:用于 GPT 和其他兼容 OpenAI 的模型。
- Anthropic:用于 Claude 模型。此选项需要使用 Microsoft Foundry 端点类型的凭据。此系列不支持 Frequency Penalty 频率惩罚、Presence Penalty 存在惩罚和 Response Format 响应格式选项。
- Use Responses API 使用 Responses API:选择节点为 OpenAI 系列部署调用的 API。此选项需要使用 Microsoft Foundry 端点类型的凭据。
- Off 关闭(默认):节点调用 Chat Completions API。大多数部署请使用此选项。
- On 开启:节点调用 Responses API。如果部署仅支持 Responses API,请启用此选项。如果使用 Chat Completions 调用此类部署,Azure 会返回
400 Model not supported错误。
提示
Existing workflows 现有工作流
在此次更改之前创建的工作流会保留 Model (Deployment) Name 模型(部署)名称文本字段,并使用 Chat Completions。如需使用部署列表和 Use Responses API 使用 Responses API 设置,请创建新节点。
节点选项
- Frequency Penalty 频率惩罚:使用此选项控制模型重复自身的机会。较高的值会减少模型重复自身的机会。
- Maximum Number of Tokens 最大令牌数:输入使用的最大令牌数,这设置了补全长度。
- Response Format 响应格式:选择 Text 或 JSON。JSON 确保模型返回有效的 JSON。
- Presence Penalty 存在惩罚:使用此选项控制模型谈论新话题的机会。较高的值会增加模型谈论新话题的机会。
- Sampling Temperature 采样温度:使用此选项控制采样过程的随机性。较高的温度会产生更多样的采样,但会增加幻觉风险。OpenAI 模型系列的最大值为 2,Anthropic 模型系列的最大值为 1。
- Timeout 超时:输入最大请求时间(以毫秒为单位)。
- Max Retries 最大重试次数:输入重试请求的最大次数。
- Top P:使用此选项设置补全应使用的概率。使用较低的值忽略不太可能的选项。
- Extra Body 额外请求体:输入要添加到请求体的额外 JSON 属性。这可用于添加部署支持、但其他选项未涵盖的参数。该值必须是 JSON 对象。
代理限制
此节点不支持 NO_PROXY 环境变量。
模板和示例
浏览 Microsoft Foundry Chat Model 节点集成模板 或搜索所有模板
相关资源
请参考 LangChain 的 Azure OpenAI 文档{:target=_blank .external-link} 获取有关该服务的更多信息。
查看 n8n 的 Advanced AI 高级 AI 文档。
[^1]:AI 代理是能够响应用户请求、做出决策并执行现实世界任务的人工智能系统。他们使用大型语言模型 (LLM) 来解释用户输入,并就如何利用现有的信息和资源最好地处理请求做出决策。