常见问题解答（FAQ）

本章节汇总 Agent for LabVIEW 在安装、激活、API 配置、范例运行、工具调用和部署过程中的高频问题。

一、安装与环境

Q：支持哪些 LabVIEW 版本？
A：支持 LabVIEW 2018 及以上版本，32 位和 64 位均可（需安装对应位数工具包）。

Q：安装时报错 This package is not compatible with any LabVIEW version on this computer 怎么办？
A：通常是位数或版本不匹配。请检查：

  • LabVIEW 版本是否 >= 2018

  • 安装包位数与 LabVIEW 位数是否一致（32 对 32，64 对 64）

  • VIPM 是否为 2021 及以上版本（建议管理员模式运行）

Q：为什么安装后看不到函数面板 VIRobotics -> AI Agent？
A：请重启 LabVIEW 后再检查；若仍不可见，建议重新安装工具包并确认安装成功状态为 No Errors。

Q：是否必须安装 Python？
A：不是必须。Agent 核心功能可在 LabVIEW 中直接使用；仅在你需要运行额外 Python 脚本时才需要 Python 环境。

二、许可证与激活

Q：可以试用吗？
A：可以，支持试用。具体时长与策略以当前发布说明为准。

Q：License State 显示 No license 怎么办？
A：在 Tools -> VIRobotics License Manager 中选择对应产品（如 genai），点击 Apply 申请试用，或执行正式激活。

Q：在线激活失败怎么办？
A：优先检查：

  • License ID / Key 是否输入正确

  • Product Name 是否选对

  • 设备网络是否可用

Q：离线激活失败怎么办？
A：离线授权文件与设备绑定。请确认 .lic 与当前机器 Computer ID 一致，不一致需重新申请。

三、API Key 与模型调用

Q：配置了 API Key 但调用失败怎么办？
A：依次检查：

  1. Key 是否完整无误（无空格、无截断）

  2. 服务商账户是否有余额/调用权限

  3. 在 LLM Keys 中选择的 Server 是否与 Key 来源一致

  4. 网络/代理/防火墙是否拦截请求

Q：basic.vi 有回复，但 stream.vi 没有输出，怎么排查？
A：通常是模型流式能力或网络问题。请先换一个确认支持流式的模型，并检查 API 余额与网络稳定性。

Q：支持哪些模型服务商？
A：支持阿里、百度、DeepSeek、豆包、Kimi、Ollama、Siliconflow、智谱等（以实际版本为准）。

四、范例与开发

Q：范例在哪里打开？
A：Help -> Find Examples -> Directory Structure -> VIRobotics -> AI Agent。

Q：按厂家看范例还是按能力看范例？
A：建议按能力学习（基础对话 -> 流式 -> 工具调用 -> 综合 Agent），按厂家快速索引用于“只使用单一 API Key”的场景。

Q：AI_Agent_Full.vi 适合什么时候用？
A：适合做综合验证。它通常覆盖流式输出、工具调用、上下文管理，是推荐的主练习范例。

Q：可以直接改官方范例吗？
A：可以，但建议“另存为”新文件后再改，避免覆盖原始范例。

五、工具调用（Tool Calling）

Q：为什么模型不调用我写的工具？
A：常见原因是 JSON 描述不清晰。请重点检查：

  • name 是否明确

  • description 是否写清“何时使用该工具”

  • parameters 是否完整且类型正确

Q：工具被调用了，但执行报错怎么办？
A：先单独运行 VI，确认输入输出和依赖正常；再放回 Agent 联调。

Q：工具执行成功，但模型回复异常怎么办？
A：检查工具结果回传格式是否符合 Generate_Tool_Call_Results 的要求。

六、图像理解与图像生成

Q：ImageGeneration 相关范例为什么运行失败？
A：请确认以下前置条件：

  • 已开通豆包相关模型能力（含 doubao-seedream）

  • 已正确配置豆包 API

  • 已安装 AI Vision Toolkit for GPU

Q：text_to_img_test.vi 可以生成图像，但效果不稳定怎么办？
A：建议：

  • 提示词写得更具体（主体、风格、约束）

  • 需要时增加负面提示词

  • 保持固定参数做对比测试

Q：图生图或图文融合结果不符合预期怎么办？
A：先降低任务复杂度（分两步做），并提高输入图片质量。

七、部署与运行

Q：部署端一定要安装 LabVIEW 开发环境吗？
A：通常不需要开发环境，但需要满足运行依赖（如 Runtime、授权、外部依赖文件）。

Q：打包 EXE 后运行报“未授权”怎么办？
A：请在部署端执行授权流程，并确认部署许可证状态正常。

Q：开发端正常、部署端异常怎么处理？
A：重点检查：

  • 依赖文件是否完整打包

  • 路径是否写死为开发机路径

  • 环境变量与运行库是否齐全

八、仍无法解决怎么办

请联系技术支持，并附带以下信息：

  • LabVIEW 版本与位数

  • 操作系统版本

  • 工具包版本号

  • 出问题的 VI 名称

  • 报错截图与复现步骤

联系方式：