Agency-Swarm项目中解决Agent文件传递异常的技术方案

在基于Agency-Swarm框架开发多Agent系统时，开发者可能会遇到Agent尝试传递不存在的文件ID导致的404错误。本文将深入分析该问题的技术背景，并提供两种有效的解决方案。

问题现象与原因分析

当使用Agency-Swarm框架构建的多Agent系统运行时，系统日志中可能出现如下错误：

openai.NotFoundError: Error code: 404 - {'error': {'message': 'Files [file-1] were not found'

这种现象通常源于以下两种技术场景：

1. Agent产生"幻觉"，尝试引用未实际关联的文件ID
2. 开发者希望完全禁用Agent间的文件传递功能

核心解决方案

方案一：优化Agent指令设计（推荐）

对于需要保留文件传递功能的场景，可以通过以下方法优化：

1. 明确文件用途说明：为每个附加文件添加清晰的目的描述
2. 完善检索指令：要求Agent先获取有效的文件ID

   请提供example.txt文件的ID（应以"file-"开头）
   

3. 细化任务分解：将复杂任务拆分为明确的子任务，每个子任务单独传递

方案二：自定义消息传递工具（适用于禁用文件传递）

通过继承SendMessageBase类创建自定义工具：

from agency_swarm.tools.send_message.SendMessageBase import SendMessageBase

class CustomSendMessage(SendMessageBase):
    """定制化的消息传递工具，移除了文件传递功能"""
    my_primary_instructions: str = Field(...)
    message: str = Field(...)
    additional_agent_instructions: Optional[str] = Field(default=None)
    
    def run(self):
        return self._get_completion(
            message=self.message,
            additional_instructions=self.additional_instructions
        )

# 在初始化Agency时指定自定义工具
agency = Agency(
    [agent1, agent2],
    send_message_tool_class=CustomSendMessage
)

技术实现要点

1. 继承机制：通过继承SendMessageBase保持核心功能的同时移除文件处理
2. 字段设计：保留必要的message和instructions字段，确保基础通信功能
3. Agency集成：通过send_message_tool_class参数实现工具替换

最佳实践建议

1. 对于简单任务处理场景，方案二更为简洁高效
2. 需要复杂协作的场景建议采用方案一，保留文件传递的灵活性
3. 定期检查Agent的指令集，确保其与实际业务需求保持一致
4. 在开发阶段添加充分的日志记录，便于追踪文件传递过程

通过以上技术方案，开发者可以灵活应对Agency-Swarm框架中的文件传递异常问题，构建更稳定的多Agent系统。