Goose项目与OpenWebUI集成时的工具调用问题分析

问题背景

在使用Goose CLI工具与OpenWebUI的Ollama端点集成时，开发者遇到了一个工具调用失败的问题。具体表现为当执行需要调用工具的命令时，系统会返回400错误，并且会破坏当前会话，导致后续所有命令都无法执行。

问题现象

开发者配置Goose使用AI接口，将主机设置为OpenWebUI实例，路径设置为ollama/v1/chat/completions。在执行会话过程中，任何导致工具调用的命令都会失败，错误信息显示"Request failed: Unknown error (status 400 Bad Request)"。一旦出现此错误，当前会话中的所有后续命令都会失败，必须完全退出会话才能恢复正常。

错误分析

从OpenWebUI的日志中可以清楚地看到问题的根源：系统在处理AI聊天补全请求时遇到了验证错误。具体来说，Pydantic验证器报告messages.2.content字段缺失，而该字段是必需的。这表明Goose发送的请求格式与OpenWebUI期望的格式不匹配。

解决方案探索

开发者尝试了多种环境配置：

1. 在M1 Mac和Ubuntu 22.04.1系统上测试，问题一致
2. 直接使用本地Ollama服务时，工具调用可以正常工作
3. 通过OpenWebUI访问相同的模型时出现失败

最终发现问题的根本原因在于使用了错误的API端点。OpenWebUI有两个不同的端点：

1. /ollama/v1/chat/completions - 专为Ollama接口设计
2. /api/chat/completions - 标准的AI兼容接口

正确配置方法

要解决这个问题，开发者应该：

1. 运行goose configure命令
2. 选择AI作为提供者
3. 将主机设置为OpenWebUI实例地址
4. 将路径设置为/api/chat/completions（而非/ollama/v1/chat/completions）

技术启示

这个案例展示了API端点兼容性的重要性。虽然OpenWebUI提供了Ollama接口，但Goose工具期望的是标准的AI兼容接口。开发者需要注意：

1. 不同接口可能有不同的请求/响应格式要求
2. 错误信息（如400 Bad Request）可能掩盖了真正的兼容性问题
3. 在集成不同系统时，仔细检查API文档和端点设计至关重要

总结

通过这个案例，我们了解到在使用Goose与OpenWebUI集成时，正确选择API端点是成功集成的关键。开发者应该确保使用标准的AI兼容接口（/api/chat/completions）而非Ollama专用接口，以避免工具调用失败的问题。这个经验也提醒我们在集成不同系统时，需要仔细研究各系统的API规范和要求。