工具工坊
工具工坊是一块可视化画布,用于构建、编辑和测试模型在对话中可以调用的工具定义。
侧边栏位置: 工具工坊 路由: /tools
界面概览
页面的核心是一块由 Vue Flow 驱动的节点式画布。每个工具表现为一个可视化节点,显示它的名称、描述、参数和实现代码。
创建工具
从模板创建
点击模板可浏览 15 多个内置模板,包括:
- 网页抓取(HTTP 请求)
- 计算器
- Google 日历 / Gmail 集成
- 正则表达式测试
- 日期时间工具
- 以及更多
从零创建
点击添加工具创建一个空白工具节点,然后填写:
- 名称 —— 函数名(模型会用到)
- 描述 —— 这个工具做什么(帮助模型判断何时该调用它)
- 参数 —— 用 JSON Schema 定义的输入
- 实现 —— TypeScript 函数体
编辑工具
行内代码编辑
每个工具节点都内嵌一个完整的 CodeMirror 6 编辑器,带 TypeScript 语法高亮。你可以直接在画布上修改实现。
代码面板(双向同步)
打开代码面板,可以把所有工具看作一份合并的 TypeScript 源码。它使用 Recast AST 解析器实现双向同步:
- 在面板中改代码 → 画布上的节点随之更新
- 在画布上改节点 → 面板中的代码随之更新
Schema 查看器
点击任意工具上的 schema 图标,可以查看自动生成的 OpenAI 兼容 JSON schema,并一键复制到其他系统使用。
探测与选取
指向任意 API 地址即可:
- 探测接口 —— 发送请求并查看响应
- 浏览 JSON 树 —— 展开 / 折叠响应结构
- 选取字段 —— 挑出你需要的数据
- 自动生成请求代码与参数映射
OpenAPI 发现
如果某个 API 有 OpenAPI/Swagger 规范:
- 输入规范文件的 URL
- LLMxRay 自动解析该规范
- 浏览可用的接口
- 选择一个接口,自动生成工具定义
实时执行
对话过程中,当模型调用某个工具时:
- 画布上对应的节点会脉动提示
- 执行结果以浮层形式出现在节点上
- 对话诊断中的工具调用时间线可以反向链接回画布
工具调用优化器
当模型在对话中调用工具后,结果上会出现一个**「优化此工具」**按钮。点击它会打开响应优化抽屉:
- 把 API 响应可视化为交互式 JSON 树
- 只选取模型真正需要的字段
- 自动生成带字段提取的优化版请求代码
- 一键在工坊中创建一个优化后的新工具
持久化
工具定义、节点位置、字段映射和探测配置都会被持久化保存,刷新浏览器也不会丢失。
导出工具
点击导出按钮,可把工具定义下载为 JSON。导出内容包含工具名称、描述、参数 schema 和实现代码 —— 重新导入或分享所需的一切。关于全部导出选项,详见导出指南。
小贴士
- 从模板出发再做修改,比从零搭建快得多。
- 用 Schema 查看器确认你的工具定义符合模型的预期。
- 探测与选取流程是把一个 REST API 包装成工具的最快方式。
- 启用后,工具会自动在对话中可用。