memory_tools.py 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. """Memory 工具:save_memory / load_memory,供 Agent 通过 Function Calling 操作长期记忆"""
  2. from __future__ import annotations
  3. from typing import Any
  4. from backend.tools.base import Tool
  5. # 懒加载长期记忆单例
  6. _long_term = None
  7. def _get_long_term():
  8. global _long_term
  9. if _long_term is None:
  10. from backend.memory.long_term import LongTermMemory
  11. _long_term = LongTermMemory()
  12. return _long_term
  13. async def save_memory(content: str, memory_type: str = "knowledge", metadata: str = "") -> dict:
  14. """保存知识到长期记忆"""
  15. try:
  16. lt = _get_long_term()
  17. meta = {"source": "agent", "note": metadata} if metadata else {"source": "agent"}
  18. if memory_type == "gap":
  19. await lt.save_knowledge(content, {**meta, "type": "gap"})
  20. elif memory_type == "innovation":
  21. await lt.save_knowledge(content, {**meta, "type": "innovation"})
  22. else:
  23. await lt.save_knowledge(content, meta)
  24. return {"status": "saved", "memory_type": memory_type, "content_length": len(content)}
  25. except Exception as e:
  26. # 降级:长期记忆不可用不影响主流程
  27. return {"status": "failed", "error": str(e)}
  28. async def load_memory(query: str, top_k: int = 5) -> dict:
  29. """从长期记忆检索相关知识"""
  30. try:
  31. lt = _get_long_term()
  32. results = await lt.load_relevant(query, top_k=top_k)
  33. return {"query": query, "memories": results}
  34. except Exception as e:
  35. return {"query": query, "memories": [], "error": str(e)}
  36. save_memory_tool = Tool(
  37. name="save_memory",
  38. description="保存知识/Gap/创新点到长期记忆,供跨会话复用。memory_type 可选 gap/innovation/knowledge",
  39. parameters={
  40. "type": "object",
  41. "properties": {
  42. "content": {"type": "string", "description": "要保存的内容"},
  43. "memory_type": {"type": "string", "enum": ["gap", "innovation", "knowledge"], "default": "knowledge"},
  44. "metadata": {"type": "string", "description": "附加说明,可选"},
  45. },
  46. "required": ["content"],
  47. },
  48. func=save_memory,
  49. )
  50. load_memory_tool = Tool(
  51. name="load_memory",
  52. description="从长期记忆语义检索相关知识/历史 Gap/创新点,用于创新点去重与知识复用",
  53. parameters={
  54. "type": "object",
  55. "properties": {
  56. "query": {"type": "string", "description": "检索查询"},
  57. "top_k": {"type": "integer", "default": 5},
  58. },
  59. "required": ["query"],
  60. },
  61. func=load_memory,
  62. )