这个 pipe 通过调用 Mistral API 在 OpenWebUI 中实现了对 Mistral AI 智能体的原生支持。
它允许你在 OpenWebUI 实例中直接选择在 Mistral 控制台中创建的智能体并与之对话。
功能特性
- 直接与 Mistral 智能体 API (
/v1/agents/completions) 集成。 - 支持流式响应。
- 通过阀门(valves)轻松配置(导入后无需编辑代码)。
- 适用于在 Mistral 控制台中创建的任何智能体(工具、指令、知识库等)。
前提条件
- 拥有 Mistral 账户并具备 API 访问权限。
- 有效的
MISTRAL_API_KEY(可在 https://console.mistral.ai/ 获取)。 - 已存在的智能体(需要填写
AGENT_ID阀门,通常以ag_开头)。 - 在 OpenWebUI 实例中具备导入/编辑函数的权限。
如何获取智能体 ID
- 访问 https://console.mistral.ai/build/agents。
- 创建(或打开)一个智能体。
- 复制智能体 ID。
注意:在某些地方,智能体 ID 可能显示为 ag:;此 pipe 需要字符串值,最常见的格式是 ag_...。
如何在 OpenWebUI 中导入
通常有两种选择:
选项 A:从 OpenWebUI 页面导入
使用官方函数帖子(一键导入):
https://openwebui.com/posts/mistral_agents_integration_pipe_42bce620
在 OpenWebUI 中:
- 打开上述页面。
- 点击
导入。 - 确认导入。
选项 B:手动导入(复制并粘贴)
- 在 OpenWebUI 中,进入
管理面板。 - 打开
函数。 - 点击
+(或新建)创建新的函数/管道。 - 粘贴下方代码并保存。
配置(阀门)
导入后,配置阀门(通常通过齿轮图标 ⚙️):
MISTRAL_API_KEY:你的 Mistral API 密钥。AGENT_ID:你的智能体 ID(示例:ag_...)。
管道代码
重要说明:
- 不要在文件中硬编码你的真实 API 密钥。
- 导入后在 OpenWebUI 设置中通过阀门设置
MISTRAL_API_KEY和AGENT_ID。
永远不要将你的真实 API 密钥提交到公共仓库。在生产环境中,优先使用环境变量和部署密钥管理器。
如何在聊天中使用
- 在 OpenWebUI 中打开一个聊天。
- 在模型/提供商列表中选择
mistral agent (...)管道。 - 正常发送消息。
OpenWebUI 会将 body["messages"] 转发给 Mistral,并保留角色(user、assistant 等)。
重要说明
- 智能体 ID 与模型:此管道使用智能体路由(
/v1/agents/completions),与标准聊天补全不同。 - 工具:如果你的智能体在 Mistral 控制台中配置了工具,智能体将自动应用这些工具。
流式传输说明
- 当 OpenWebUI 中启用
stream时,负载会发送"stream": true。 - 此
pipe从流式请求(iter_lines)中生成原始响应行。
如果你看到“原始”输出(JSON 行)而不是渲染后的文本,请检查 OpenWebUI 是否期望此管道具有特定的 SSE/块格式。
快速故障排除
- 401 未授权/403 禁止访问:
MISTRAL_API_KEY为空、无效或缺少权限。 - 404/无效智能体:
AGENT_ID错误或智能体已被删除。 - 无响应/超时:验证你的 OpenWebUI 服务器是否可以访问
https://api.mistral.ai。 - 无流式传输:确认 OpenWebUI 在请求体中发送了
stream: true。
参考
- OpenWebUI 上的导入帖子: https://openwebui.com/posts/mistral_agents_integration_pipe_42bce620