让 AI 从只动嘴到真动手Open WebUI 工具调用上手指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个可以自托管的大模型 Web 界面支持 Ollama、OpenAI API 等多种后端。它最值得上手的能力是工具调用模型在对话里能直接检索知识库、抓取网页、执行代码而不是只和你纸上谈兵。下面从一个真实痛点讲起5 分钟带你跑通第一把工具。为什么需要工具聊天模型的天花板没有工具时有多别扭你让 AI翻一下这份文档里关于部署的段落它只能靠上下文硬答你让它算一下这段表达式的值它偶尔还会算错。问题出在两处知识有边界模型不知道你的私有文档写了什么能力有边界不能上网、不能执行代码、不能读写文件工具就是给模型配一双手工具调用的本质是让模型从说到做能查、能算、能动手。模型是怎么决定调哪个工具的先破除一个迷思不是猜关键词你可能听过模式匹配的说法——说白了就是让系统猜你想干什么。但 Open WebUI 里这一步其实由模型自己完成它读取工具清单里的描述再根据你的问题决定调哪个、传什么参数。所以工具好不好用关键在描述写得好不好。工具 一张功能说明书每个工具在后端都以名称 参数 描述的形式存储定义见backend/open_webui/models/tools.py。这份描述就是给模型看的说明书写得清楚调用才准。内置工具开箱即用backend/open_webui/tools/builtin.py里已经备好了不少execute_code执行代码、fetch_url抓取网页、query_knowledge_bases检索知识库、delegate_task委派子任务。只要你的模型支持原生函数调用它们会自动生效。一次工具调用的完整旅程四步走完一个来回你输入问题模型输出一次结构化调用工具名 参数而不是普通文字后端按说明执行执行逻辑在backend/open_webui/utils/tools.py结果回填对话模型据此组织最终回答前端负责看和管src/lib/apis/tools/index.ts支撑管理页面里对工具的增删改查你可以在那里查看每个工具的描述与参数、调整谁能使用它。 4 步写出你的第一个自定义工具步骤不复杂在管理端 Tools 页面新建工具写一个 Python 函数加上装饰器写清 docstring——这是模型判断该不该用的主要依据保存启用用一句话验证它是否被正确调用关键代码就这几行open_webui.tool async def get_time(timezone: str): 获取指定时区的当前时间真正决定成败的是最后那行注释把能干什么、什么时候用写明白命中率会明显提升。动手前容易踩的 3 个坑⚠️ 坑 1模型不支持函数调用选了不支持原生工具调用的基础模型你说得再清楚它也不会动手。先确认模型能力再谈配置。坑 2描述写得太笼统查询数据这种描述模型根本不知道何时该用。改成按关键词检索知识库并返回匹配段落效果天差地别。坑 3权限给得太松工具支持按用户和群组控制访问tools.py里的 access_grants 字段。能写数据的工具建议只授予可信成员。现在就去试一把登录管理端打开 Tools做一个返回今天日期的小工具。当模型真的把它调对的那一刻你就掌握了工具调用的全部核心。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考