Refactor activity logging and update Zep integration for real-time processing

- Changed the activity logging format to remove simulation prefixes, ensuring clearer natural language descriptions.
- Updated the `ZepGraphMemoryUpdater` to send activities individually, enhancing the accuracy of entity and relationship extraction.
- Adjusted the README.md to reflect these changes in activity processing and Zep integration, providing clearer instructions for users.

backend/README.md

@@ -598,8 +598,8 @@ backend/
 
 启用 `enable_graph_memory_update` 后:
 - 模拟中所有Agent的活动(发帖、评论、点赞、转发等)会实时更新到Zep图谱
-- 活动会被转换为自然语言描述,例如:`[Twitter模拟 第15轮] 张三: 发布了一条帖子：「...」`
+- 每条活动单独发送,确保Zep能正确解析实体和关系
-- 采用批量更新机制(默认10条或30秒),减少API调用次数
+- 活动会被转换为自然语言描述,例如:`张三: 发布了一条帖子：「...」`
 - Zep会自动从文本中提取实体和关系,丰富图谱知识
 - 需要项目已构建有效的图谱(graph_id)
 
@@ -1295,12 +1295,12 @@ class AgentActivity:
     
     def to_episode_text(self) -> str:
         """
-        将活动转换为自然语言描述
+        将活动转换为自然语言描述(不添加模拟前缀)
         
         示例输出:
-        - "[Twitter模拟 第15轮] 张三: 发布了一条帖子：「官方声明：...」"
+        - "张三: 发布了一条帖子：「官方声明：...」"
-        - "[Reddit模拟 第3轮] 李四: 在帖子#5下评论道：「我认为...」"
+        - "李四: 在帖子#5下评论道：「我认为...」"
-        - "[Twitter模拟 第10轮] 王五: 引用帖子#3并评论：「同意！」"
+        - "王五: 引用帖子#3并评论：「同意！」"
         """
 ```
 
@@ -1310,10 +1310,11 @@ class ZepGraphMemoryUpdater:
     图谱记忆更新器
     
     特性:
-    - 批量更新(BATCH_SIZE=10条或MAX_WAIT_TIME=30秒)
+    - 逐条发送活动到Zep,确保图谱正确解析
     - 后台线程异步处理,不阻塞主模拟流程
     - 带重试的API调用(MAX_RETRIES=3)
     - 自动跳过DO_NOTHING类型的活动
+    - 发送间隔控制(SEND_INTERVAL=0.5秒)
     """
     
     def start(self):
@@ -1381,16 +1382,16 @@ POST /api/simulation/start
 }
 ```
 
-启用后,模拟中的活动会被转换为类似以下格式的文本并发送到Zep:
+启用后,模拟中的活动会被逐条转换为自然语言描述并发送到Zep:
 
 ```
-[Twitter模拟 第0轮] 上级: 发布了一条帖子：「官方声明：经复核并结合司法判决，校方决定撤销对肖某某的处分。学校向当事人致以正式歉意...」
+上级: 发布了一条帖子：「官方声明：经复核并结合司法判决，校方决定撤销对肖某某的处分。学校向当事人致以正式歉意...」
-[Twitter模拟 第0轮] 全国顶尖新闻传播学院的大学: 发布了一条帖子：「武汉大学官方发布：学校已决定撤销此前对当事人的处分...」
+全国顶尖新闻传播学院的大学: 发布了一条帖子：「武汉大学官方发布：学校已决定撤销此前对当事人的处分...」
-[Twitter模拟 第15轮] 全国考生: 引用帖子#5并评论
+全国考生: 引用帖子#5并评论
-[Reddit模拟 第3轮] 教师代表: 在帖子#2下评论道：「此事暴露出高校在程序正义上的问题...」
+教师代表: 在帖子#2下评论道：「此事暴露出高校在程序正义上的问题...」
 ```
 
-Zep会自动从这些文本中提取实体(如人名、机构名)和关系,丰富图谱知识。
+每条活动单独发送,确保Zep能正确从文本中提取实体(如人名、机构名)和关系,丰富图谱知识。
 
 ---
 

backend/app/services/zep_graph_memory_updater.py

@@ -36,9 +36,8 @@ class AgentActivity:
         将活动转换为可以发送给Zep的文本描述
         
         采用自然语言描述格式，让Zep能够从中提取实体和关系
+        不添加模拟相关的前缀，避免误导图谱更新
         """
-        platform_name = "Twitter" if self.platform == "twitter" else "Reddit"
-        
         # 根据不同的动作类型生成不同的描述
         action_descriptions = {
             "CREATE_POST": self._describe_create_post,
@@ -58,8 +57,8 @@ class AgentActivity:
         describe_func = action_descriptions.get(self.action_type, self._describe_generic)
         description = describe_func()
         
-        # 添加时间和平台上下文
+        # 直接返回 "agent名称: 活动描述" 格式，不添加模拟前缀
-        return f"[{platform_name}模拟 第{self.round_num}轮] {self.agent_name}: {description}"
+        return f"{self.agent_name}: {description}"
     
     def _describe_create_post(self) -> str:
         content = self.action_args.get("content", "")
@@ -137,14 +136,11 @@ class ZepGraphMemoryUpdater:
     Zep图谱记忆更新器
     
     监控模拟的actions日志文件，将新的agent活动实时更新到Zep图谱中。
-    使用批量更新机制，将多个活动合并后一次性发送，减少API调用次数。
+    每条活动单独发送到Zep，确保图谱能正确解析实体和关系。
     """
     
-    # 活动缓冲区大小（达到此数量后批量发送）
+    # 发送间隔（秒），避免请求过快
-    BATCH_SIZE = 10
+    SEND_INTERVAL = 0.5
-    
-    # 最大等待时间（秒），即使未达到BATCH_SIZE也会发送
-    MAX_WAIT_TIME = 30
     
     # 重试配置
     MAX_RETRIES = 3
@@ -248,51 +244,31 @@ class ZepGraphMemoryUpdater:
         self.add_activity(activity)
     
     def _worker_loop(self):
-        """后台工作循环"""
+        """后台工作循环 - 逐条发送活动到Zep"""
-        buffer: List[AgentActivity] = []
-        last_send_time = time.time()
-        
         while self._running or not self._activity_queue.empty():
             try:
                 # 尝试从队列获取活动（超时1秒）
                 try:
                     activity = self._activity_queue.get(timeout=1)
-                    buffer.append(activity)
+                    # 立即发送单条活动
+                    self._send_single_activity(activity)
+                    # 发送间隔，避免请求过快
+                    time.sleep(self.SEND_INTERVAL)
                 except Empty:
                     pass
                     
-                # 检查是否应该发送批次
-                current_time = time.time()
-                should_send = (
-                    len(buffer) >= self.BATCH_SIZE or
-                    (len(buffer) > 0 and current_time - last_send_time >= self.MAX_WAIT_TIME)
-                )
-                
-                if should_send:
-                    self._send_batch(buffer)
-                    buffer = []
-                    last_send_time = current_time
-                    
             except Exception as e:
                 logger.error(f"工作循环异常: {e}")
                 time.sleep(1)
     
-        # 发送剩余的活动
+    def _send_single_activity(self, activity: AgentActivity):
-        if buffer:
-            self._send_batch(buffer)
-    
-    def _send_batch(self, activities: List[AgentActivity]):
         """
-        批量发送活动到Zep图谱
+        发送单条活动到Zep图谱
         
         Args:
-            activities: 活动列表
+            activity: 单条Agent活动
         """
-        if not activities:
+        episode_text = activity.to_episode_text()
-            return
-        
-        # 将所有活动合并为一段文本
-        episode_text = "\n".join([a.to_episode_text() for a in activities])
         
         # 带重试的发送
         for attempt in range(self.MAX_RETRIES):
@@ -303,8 +279,8 @@ class ZepGraphMemoryUpdater:
                     data=episode_text
                 )
                 
-                self._total_sent += len(activities)
+                self._total_sent += 1
-                logger.debug(f"成功发送 {len(activities)} 条活动到图谱 {self.graph_id}")
+                logger.debug(f"成功发送活动到图谱 {self.graph_id}: {episode_text[:50]}...")
                 return
                 
             except Exception as e:
@@ -313,20 +289,17 @@ class ZepGraphMemoryUpdater:
                     time.sleep(self.RETRY_DELAY * (attempt + 1))
                 else:
                     logger.error(f"发送到Zep失败，已重试{self.MAX_RETRIES}次: {e}")
-                    self._failed_count += len(activities)
+                    self._failed_count += 1
     
     def _flush_remaining(self):
-        """发送队列中剩余的活动"""
+        """发送队列中剩余的活动（逐条发送）"""
-        remaining = []
         while not self._activity_queue.empty():
             try:
-                remaining.append(self._activity_queue.get_nowait())
+                activity = self._activity_queue.get_nowait()
+                self._send_single_activity(activity)
             except Empty:
                 break
     
-        if remaining:
-            self._send_batch(remaining)
-    
     def get_stats(self) -> Dict[str, Any]:
         """获取统计信息"""
         return {