Theia AI 工具调用参数缺失问题分析与解决方案

问题背景

在 Theia IDE 的 AI 功能中，用户报告了一个关键性错误：当 AI 代理（如 Architect 或 Coder）尝试调用工具函数时，如果遇到空参数情况，系统会返回 400 错误。这个错误会中断整个对话流程，严重影响用户体验。

错误表现

具体错误信息为：

400 {"type":"error","error":{"type":"invalid_request_error","message":"messages.2.content.0.tool_use.input: Field required"}

该错误在以下场景可稳定复现：

1. 打开一个空工作区
2. 向 Architect 代理发送"查看我的工作区"指令
3. 接着发送"Hi"消息

技术分析

这个问题源于 AI 代理在调用工具函数时，后端服务对参数进行了严格校验。当工具函数被调用但没有传递任何参数时，服务端会拒绝请求并返回 400 状态码。

值得注意的是：

• 该问题主要影响 Anthropic 服务，但也会出现在 OpenAI 服务中
• 特别容易在调用 getDirectoryStructure 或 getWorkspaceDirectoryStructure 函数时触发
• 属于服务端参数校验与客户端调用逻辑不匹配的问题

临时解决方案

对于遇到此问题的用户，可以采取以下临时解决方案：

1. 打开 AI 配置视图
2. 选择"Coder"和"Architect"代理
3. 编辑它们的提示词(prompt)
4. 移除包含"getWorkspaceDirectoryStructure"的行

这个临时方案会使 AI 代理失去高效获取工作区完整概览的能力，但可以避免错误发生。待官方修复后，用户需要记得恢复这些提示词。

修复方案

开发团队已经提交了修复代码，主要改进点包括：

1. 增强工具调用的参数校验逻辑
2. 确保即使空参数也能正确处理
3. 统一不同 AI 服务提供商(Anthropic/OpenAI)的行为

该修复已包含在最新版本中，用户更新后即可恢复正常使用所有功能。

最佳实践建议

为避免类似问题，开发者在使用 AI 工具调用时应注意：

1. 始终为工具函数定义合理的默认参数
2. 在前端增加参数校验逻辑
3. 对可能为空的情况进行特殊处理
4. 保持不同 AI 服务接口的兼容性

Theia 团队将持续优化 AI 功能的稳定性和用户体验，建议用户保持关注最新版本更新。