工具制作指南

本章节介绍如何把你自己的能力封装成 Agent 可调用工具（Tool），并在对话中由 LLM 自动触发执行。

目标与适用场景

通过工具制作，你可以让 Agent 调用本地能力完成具体任务，例如：

  • 设备控制（DAQ、PLC、机械臂）

  • 文件读写与报告生成

  • 数据查询与计算

  • 图像处理与视觉分析

  • 设备数据分析

工具基本组成

一个可调用工具通常由两部分组成：

  1. VI 文件：具体执行逻辑

  2. JSON 描述：工具名称、功能说明、参数定义等元信息

LLM 会先读取 JSON 描述判断是否调用，再把参数传给对应 VI 执行。

制作流程（推荐）

  1. 设计单一职责

  • 一个工具只做一件事（如“查询天气”“获取当前时间”）

  1. 编写并验证 VI

  • 确认输入输出稳定、异常可处理

  1. 编写工具 JSON

  • 定义 name、description、parameters、必填项

  1. 注册到 tools 目录

  • 放到约定工具目录并确保可被加载

  1. 在范例中联调

  • 用 basic_call_tools.vi 或 AI_Agent_Full.vi 验证端到端流程

详细制作步骤

第 1 步：新建 VI 文件

打开 LabVIEW，新建一个 VI 并编写工具逻辑。 在前面板中，务必包含一个字符串输出控件，名称固定为 result，这是 Agent 获取工具执行结果的标准出口。

示例要求（以“获取日期和时间”为例）：

  • 输出控件名称：result

  • 输出类型：字符串

  • 输出内容：工具执行的最终结果文本

第 2 步：保存 VI 到工具目录

将 VI 保存在 tools\basic_tools 下的独立子文件夹中，建议一个工具一个文件夹，且该文件夹与vi同名，名称全英文无空格。 示例路径： C:\Program Files\National Instruments\LabVIEW 2018\examples\VIRobotics\AI Agent\tools\basic_tools\get_date_and_time

第 3 步：生成工具 JSON

为当前 VI 生成对应 JSON 描述文件，使用该工具包内置编辑器：

Tools -> VIRobotics GenAI -> Agent_VI_Editor

操作顺序：

  1. 打开 Agent_VI_Editor

  2. 加载已编写的 VI

  3. 输入 VI 描述和参数说明以及参数描述

  4. 点击“生成 json”

  5. 在 VI 同目录确认 JSON 文件已生成

调试与排错

常见问题：

  • 不触发工具：描述不清晰或参数定义不完整，文件夹名字与VI名字不一样

  • 工具触发但执行失败：VI 输入类型或路径配置不正确

  • 工具执行成功但回复异常：工具结果回传格式不符合预期

建议：

  • 先在本地单独运行 VI

  • 再在 basic_call_tools.vi 验证工具调用

  • 最后放入 AI_Agent_Full.vi 做综合验证

下一步

技术支持

如在使用过程中遇到问题，请先查阅相关章节，或联系技术支持：