crewAI项目内存搜索功能异常分析与修复方案

crewAI是一个基于Python的智能代理框架，近期在0.114.0版本中出现了一个关于内存搜索功能的重要Bug。本文将深入分析该问题的技术细节，并提供完整的解决方案。

问题现象

当用户使用mem0内存存储模块进行查询时，系统会抛出TypeError: string indices must be integers, not 'str'异常。这种情况特别容易在新创建的项目中出现，因为这些项目尚未存储任何记忆数据。

根本原因

通过分析crewAI的源代码，发现问题出在mem0_storage.py文件的第121行。该行代码尝试直接遍历查询结果对象，但实际上返回的数据结构是一个包含两个键的字典：

{
    'results': [], 
    'relations': []
}

原代码错误地假设查询结果可以直接遍历，而实际上需要访问字典中的'results'键才能获取真正的搜索结果列表。

技术细节

在Python中，当尝试使用字符串作为索引访问另一个字符串时，就会产生这个特定的TypeError。例如：

text = "hello"
print(text["score"])  # 这将引发相同的错误

在crewAI的上下文中，错误发生在内存搜索功能尝试评估每个结果的"score"字段时，但传入的数据结构层级不正确。

解决方案

修复方法很简单但很有效：需要修改代码以正确访问嵌套的results列表。具体修改如下：

原错误代码：

return [r for r in results if r["score"] >= score_threshold]

修正后的代码：

return [r for r in results['results'] if r["score"] >= score_threshold]

影响范围

这个Bug会影响所有使用以下配置的用户：

• crewAI版本0.114.0
• 使用mem0作为内存存储后端
• 进行内存查询操作

临时解决方案

对于无法立即升级的用户，可以手动修改虚拟环境中的文件：

1. 找到虚拟环境中的mem0_storage.py文件
2. 定位到第121行
3. 按照上述方案进行修改

最佳实践

为了避免类似问题，建议：

1. 在使用前总是检查API返回的数据结构
2. 添加适当的类型检查和错误处理
3. 对新创建的项目进行边界条件测试

总结

这个Bug虽然修复简单，但提醒我们在处理API响应时需要注意数据结构的一致性。crewAI团队已经在新版本中修复了这个问题，建议用户及时更新到最新版本以获得最佳体验。