base.py 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061
  1. """工具基类与注册表:统一管理 Function Calling 工具"""
  2. from __future__ import annotations
  3. import inspect
  4. from typing import Any, Callable, Optional
  5. class Tool:
  6. """单个工具:名称 + 描述 + JSON schema + 可调用函数"""
  7. def __init__(
  8. self,
  9. name: str,
  10. description: str,
  11. parameters: dict,
  12. func: Callable,
  13. ):
  14. self.name = name
  15. self.description = description
  16. self.parameters = parameters
  17. self.func = func
  18. def to_schema(self) -> dict:
  19. """转为 DeepSeek/OpenAI function calling schema"""
  20. return {
  21. "type": "function",
  22. "function": {
  23. "name": self.name,
  24. "description": self.description,
  25. "parameters": self.parameters,
  26. },
  27. }
  28. class ToolRegistry:
  29. """工具注册表:管理多个工具,供 ToolLoop 使用"""
  30. def __init__(self):
  31. self._tools: dict[str, Tool] = {}
  32. def register(self, tool: Tool):
  33. self._tools[tool.name] = tool
  34. return tool
  35. def get(self, name: str) -> Optional[Tool]:
  36. return self._tools.get(name)
  37. def get_callable(self, name: str) -> Optional[Callable]:
  38. tool = self._tools.get(name)
  39. return tool.func if tool else None
  40. def get_callables(self) -> dict[str, Callable]:
  41. """返回 name -> func 字典,供 ToolLoop 使用"""
  42. return {name: tool.func for name, tool in self._tools.items()}
  43. def get_schemas(self) -> list[dict]:
  44. """返回所有工具的 JSON schema 列表"""
  45. return [tool.to_schema() for tool in self._tools.values()]
  46. def names(self) -> list[str]:
  47. return list(self._tools.keys())