tools.py 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408
  1. import os
  2. from pathlib import Path
  3. from typing import Optional
  4. from open_webui.apps.webui.models.tools import ToolForm, ToolModel, ToolResponse, Tools
  5. from open_webui.apps.webui.utils import load_tools_module_by_id, replace_imports
  6. from open_webui.config import CACHE_DIR, DATA_DIR
  7. from open_webui.constants import ERROR_MESSAGES
  8. from fastapi import APIRouter, Depends, HTTPException, Request, status
  9. from open_webui.utils.tools import get_tools_specs
  10. from open_webui.utils.utils import get_admin_user, get_verified_user
  11. from open_webui.utils.access_control import has_access
  12. router = APIRouter()
  13. ############################
  14. # GetTools
  15. ############################
  16. @router.get("/", response_model=list[ToolResponse])
  17. async def get_tools(user=Depends(get_verified_user)):
  18. if user.role == "admin":
  19. tools = Tools.get_tools()
  20. else:
  21. tools = Tools.get_tools_by_user_id(user.id, "read")
  22. return tools
  23. ############################
  24. # GetToolList
  25. ############################
  26. @router.get("/list", response_model=list[ToolResponse])
  27. async def get_tool_list(user=Depends(get_verified_user)):
  28. if user.role == "admin":
  29. tools = Tools.get_tools()
  30. else:
  31. tools = Tools.get_tools_by_user_id(user.id, "write")
  32. return tools
  33. ############################
  34. # ExportTools
  35. ############################
  36. @router.get("/export", response_model=list[ToolModel])
  37. async def export_tools(user=Depends(get_admin_user)):
  38. tools = Tools.get_tools()
  39. return tools
  40. ############################
  41. # CreateNewTools
  42. ############################
  43. @router.post("/create", response_model=Optional[ToolResponse])
  44. async def create_new_tools(
  45. request: Request,
  46. form_data: ToolForm,
  47. user=Depends(get_verified_user),
  48. ):
  49. if not form_data.id.isidentifier():
  50. raise HTTPException(
  51. status_code=status.HTTP_400_BAD_REQUEST,
  52. detail="Only alphanumeric characters and underscores are allowed in the id",
  53. )
  54. form_data.id = form_data.id.lower()
  55. tools = Tools.get_tool_by_id(form_data.id)
  56. if tools is None:
  57. try:
  58. form_data.content = replace_imports(form_data.content)
  59. tools_module, frontmatter = load_tools_module_by_id(
  60. form_data.id, content=form_data.content
  61. )
  62. form_data.meta.manifest = frontmatter
  63. TOOLS = request.app.state.TOOLS
  64. TOOLS[form_data.id] = tools_module
  65. specs = get_tools_specs(TOOLS[form_data.id])
  66. tools = Tools.insert_new_tool(user.id, form_data, specs)
  67. tool_cache_dir = Path(CACHE_DIR) / "tools" / form_data.id
  68. tool_cache_dir.mkdir(parents=True, exist_ok=True)
  69. if tools:
  70. return tools
  71. else:
  72. raise HTTPException(
  73. status_code=status.HTTP_400_BAD_REQUEST,
  74. detail=ERROR_MESSAGES.DEFAULT("Error creating tools"),
  75. )
  76. except Exception as e:
  77. print(e)
  78. raise HTTPException(
  79. status_code=status.HTTP_400_BAD_REQUEST,
  80. detail=ERROR_MESSAGES.DEFAULT(str(e)),
  81. )
  82. else:
  83. raise HTTPException(
  84. status_code=status.HTTP_400_BAD_REQUEST,
  85. detail=ERROR_MESSAGES.ID_TAKEN,
  86. )
  87. ############################
  88. # GetToolsById
  89. ############################
  90. @router.get("/id/{id}", response_model=Optional[ToolModel])
  91. async def get_tools_by_id(id: str, user=Depends(get_verified_user)):
  92. tools = Tools.get_tool_by_id(id)
  93. if tools:
  94. if (
  95. user.role == "admin"
  96. or tools.user_id == user.id
  97. or has_access(user.id, "read", tools.access_control)
  98. ):
  99. return tools
  100. else:
  101. raise HTTPException(
  102. status_code=status.HTTP_401_UNAUTHORIZED,
  103. detail=ERROR_MESSAGES.NOT_FOUND,
  104. )
  105. ############################
  106. # UpdateToolsById
  107. ############################
  108. @router.post("/id/{id}/update", response_model=Optional[ToolModel])
  109. async def update_tools_by_id(
  110. request: Request,
  111. id: str,
  112. form_data: ToolForm,
  113. user=Depends(get_verified_user),
  114. ):
  115. tools = Tools.get_tool_by_id(id)
  116. if not tools:
  117. raise HTTPException(
  118. status_code=status.HTTP_401_UNAUTHORIZED,
  119. detail=ERROR_MESSAGES.NOT_FOUND,
  120. )
  121. if tools.user_id != user.id and user.role != "admin":
  122. raise HTTPException(
  123. status_code=status.HTTP_401_UNAUTHORIZED,
  124. detail=ERROR_MESSAGES.UNAUTHORIZED,
  125. )
  126. try:
  127. form_data.content = replace_imports(form_data.content)
  128. tools_module, frontmatter = load_tools_module_by_id(
  129. id, content=form_data.content
  130. )
  131. form_data.meta.manifest = frontmatter
  132. TOOLS = request.app.state.TOOLS
  133. TOOLS[id] = tools_module
  134. specs = get_tools_specs(TOOLS[id])
  135. updated = {
  136. **form_data.model_dump(exclude={"id"}),
  137. "specs": specs,
  138. }
  139. print(updated)
  140. tools = Tools.update_tool_by_id(id, updated)
  141. if tools:
  142. return tools
  143. else:
  144. raise HTTPException(
  145. status_code=status.HTTP_400_BAD_REQUEST,
  146. detail=ERROR_MESSAGES.DEFAULT("Error updating tools"),
  147. )
  148. except Exception as e:
  149. raise HTTPException(
  150. status_code=status.HTTP_400_BAD_REQUEST,
  151. detail=ERROR_MESSAGES.DEFAULT(str(e)),
  152. )
  153. ############################
  154. # DeleteToolsById
  155. ############################
  156. @router.delete("/id/{id}/delete", response_model=bool)
  157. async def delete_tools_by_id(
  158. request: Request, id: str, user=Depends(get_verified_user)
  159. ):
  160. tools = Tools.get_tool_by_id(id)
  161. if not tools:
  162. raise HTTPException(
  163. status_code=status.HTTP_401_UNAUTHORIZED,
  164. detail=ERROR_MESSAGES.NOT_FOUND,
  165. )
  166. if tools.user_id != user.id and user.role != "admin":
  167. raise HTTPException(
  168. status_code=status.HTTP_401_UNAUTHORIZED,
  169. detail=ERROR_MESSAGES.UNAUTHORIZED,
  170. )
  171. result = Tools.delete_tool_by_id(id)
  172. if result:
  173. TOOLS = request.app.state.TOOLS
  174. if id in TOOLS:
  175. del TOOLS[id]
  176. return result
  177. ############################
  178. # GetToolValves
  179. ############################
  180. @router.get("/id/{id}/valves", response_model=Optional[dict])
  181. async def get_tools_valves_by_id(id: str, user=Depends(get_verified_user)):
  182. tools = Tools.get_tool_by_id(id)
  183. if tools:
  184. try:
  185. valves = Tools.get_tool_valves_by_id(id)
  186. return valves
  187. except Exception as e:
  188. raise HTTPException(
  189. status_code=status.HTTP_400_BAD_REQUEST,
  190. detail=ERROR_MESSAGES.DEFAULT(str(e)),
  191. )
  192. else:
  193. raise HTTPException(
  194. status_code=status.HTTP_401_UNAUTHORIZED,
  195. detail=ERROR_MESSAGES.NOT_FOUND,
  196. )
  197. ############################
  198. # GetToolValvesSpec
  199. ############################
  200. @router.get("/id/{id}/valves/spec", response_model=Optional[dict])
  201. async def get_tools_valves_spec_by_id(
  202. request: Request, id: str, user=Depends(get_verified_user)
  203. ):
  204. tools = Tools.get_tool_by_id(id)
  205. if tools:
  206. if id in request.app.state.TOOLS:
  207. tools_module = request.app.state.TOOLS[id]
  208. else:
  209. tools_module, _ = load_tools_module_by_id(id)
  210. request.app.state.TOOLS[id] = tools_module
  211. if hasattr(tools_module, "Valves"):
  212. Valves = tools_module.Valves
  213. return Valves.schema()
  214. return None
  215. else:
  216. raise HTTPException(
  217. status_code=status.HTTP_401_UNAUTHORIZED,
  218. detail=ERROR_MESSAGES.NOT_FOUND,
  219. )
  220. ############################
  221. # UpdateToolValves
  222. ############################
  223. @router.post("/id/{id}/valves/update", response_model=Optional[dict])
  224. async def update_tools_valves_by_id(
  225. request: Request, id: str, form_data: dict, user=Depends(get_verified_user)
  226. ):
  227. tools = Tools.get_tool_by_id(id)
  228. if tools:
  229. if id in request.app.state.TOOLS:
  230. tools_module = request.app.state.TOOLS[id]
  231. else:
  232. tools_module, _ = load_tools_module_by_id(id)
  233. request.app.state.TOOLS[id] = tools_module
  234. if hasattr(tools_module, "Valves"):
  235. Valves = tools_module.Valves
  236. try:
  237. form_data = {k: v for k, v in form_data.items() if v is not None}
  238. valves = Valves(**form_data)
  239. Tools.update_tool_valves_by_id(id, valves.model_dump())
  240. return valves.model_dump()
  241. except Exception as e:
  242. print(e)
  243. raise HTTPException(
  244. status_code=status.HTTP_400_BAD_REQUEST,
  245. detail=ERROR_MESSAGES.DEFAULT(str(e)),
  246. )
  247. else:
  248. raise HTTPException(
  249. status_code=status.HTTP_401_UNAUTHORIZED,
  250. detail=ERROR_MESSAGES.NOT_FOUND,
  251. )
  252. else:
  253. raise HTTPException(
  254. status_code=status.HTTP_401_UNAUTHORIZED,
  255. detail=ERROR_MESSAGES.NOT_FOUND,
  256. )
  257. ############################
  258. # ToolUserValves
  259. ############################
  260. @router.get("/id/{id}/valves/user", response_model=Optional[dict])
  261. async def get_tools_user_valves_by_id(id: str, user=Depends(get_verified_user)):
  262. tools = Tools.get_tool_by_id(id)
  263. if tools:
  264. try:
  265. user_valves = Tools.get_user_valves_by_id_and_user_id(id, user.id)
  266. return user_valves
  267. except Exception as e:
  268. raise HTTPException(
  269. status_code=status.HTTP_400_BAD_REQUEST,
  270. detail=ERROR_MESSAGES.DEFAULT(str(e)),
  271. )
  272. else:
  273. raise HTTPException(
  274. status_code=status.HTTP_401_UNAUTHORIZED,
  275. detail=ERROR_MESSAGES.NOT_FOUND,
  276. )
  277. @router.get("/id/{id}/valves/user/spec", response_model=Optional[dict])
  278. async def get_tools_user_valves_spec_by_id(
  279. request: Request, id: str, user=Depends(get_verified_user)
  280. ):
  281. tools = Tools.get_tool_by_id(id)
  282. if tools:
  283. if id in request.app.state.TOOLS:
  284. tools_module = request.app.state.TOOLS[id]
  285. else:
  286. tools_module, _ = load_tools_module_by_id(id)
  287. request.app.state.TOOLS[id] = tools_module
  288. if hasattr(tools_module, "UserValves"):
  289. UserValves = tools_module.UserValves
  290. return UserValves.schema()
  291. return None
  292. else:
  293. raise HTTPException(
  294. status_code=status.HTTP_401_UNAUTHORIZED,
  295. detail=ERROR_MESSAGES.NOT_FOUND,
  296. )
  297. @router.post("/id/{id}/valves/user/update", response_model=Optional[dict])
  298. async def update_tools_user_valves_by_id(
  299. request: Request, id: str, form_data: dict, user=Depends(get_verified_user)
  300. ):
  301. tools = Tools.get_tool_by_id(id)
  302. if tools:
  303. if id in request.app.state.TOOLS:
  304. tools_module = request.app.state.TOOLS[id]
  305. else:
  306. tools_module, _ = load_tools_module_by_id(id)
  307. request.app.state.TOOLS[id] = tools_module
  308. if hasattr(tools_module, "UserValves"):
  309. UserValves = tools_module.UserValves
  310. try:
  311. form_data = {k: v for k, v in form_data.items() if v is not None}
  312. user_valves = UserValves(**form_data)
  313. Tools.update_user_valves_by_id_and_user_id(
  314. id, user.id, user_valves.model_dump()
  315. )
  316. return user_valves.model_dump()
  317. except Exception as e:
  318. print(e)
  319. raise HTTPException(
  320. status_code=status.HTTP_400_BAD_REQUEST,
  321. detail=ERROR_MESSAGES.DEFAULT(str(e)),
  322. )
  323. else:
  324. raise HTTPException(
  325. status_code=status.HTTP_401_UNAUTHORIZED,
  326. detail=ERROR_MESSAGES.NOT_FOUND,
  327. )
  328. else:
  329. raise HTTPException(
  330. status_code=status.HTTP_401_UNAUTHORIZED,
  331. detail=ERROR_MESSAGES.NOT_FOUND,
  332. )