NVIDIA AI-Q 深度研究
通过 NVIDIA AI-Q Blueprint 连接受信任的研究服务，执行浅层或深度研究并保留来源引用。
技能说明
适合需要先验证研究服务可用性，再让 Agent 发起研究请求的场景。它明确区分研究、部署和故障排查；默认使用本地服务，远程地址必须先确认可信。
关于此技能
NVIDIA 官方 AI-Q Research 技能。它通过随附脚本连接可访问的 AI-Q Blueprint 服务，让 Agent 执行浅层或深度研究，并保留返回结果中的来源链接。技能文件许可证：Apache-2.0；仓库文档另有 CC-BY-4.0 许可。
核心能力
本地研究调用
通过 scripts/aiq.py 调用本地或自托管的 AI-Q Blueprint 后端，不把 API 密钥写进技能。
浅层与深度研究
支持直接问答和异步深度研究任务，并按任务编号查询状态、报告和生成的附件。
明确的信任边界
默认只连接 localhost:8000；非本地地址必须先由用户确认受信任，且不会自动重试失败任务。
适用场景
需要来源的调研
适合让 Agent 对一个主题做深度研究、输出带引用和来源网址的报告。
本地研究服务调用
适合已经部署 NVIDIA AI-Q Blueprint，并希望从 Codex、Claude Code 或 OpenCode 发起研究请求的团队。
使用步骤
- 01
第一步：确认条件
准备 Python 3.11+ 和可访问的 AI-Q Blueprint 后端；非本地服务先确认地址可信。
- 02
第二步：健康检查
先运行 health 检查后端是否可用，再决定是否发送研究请求。
- 03
第三步：发起研究
使用 chat 发起问题；如果返回任务编号，继续轮询直到获得最终报告。
- 04
第四步：保留证据
保留报告里的引用和来源链接；失败或取消时停止，不自动重复提交。
常见问题
没有 AI-Q 服务能直接使用吗？+
不能。这个技能负责调用已有的 AI-Q Blueprint 服务，不负责部署服务；没有可访问后端时应先部署或改用其他研究技能。
远程地址可以直接填吗？+
不可以直接默认信任。非 localhost 地址需要用户先明确确认可信，避免把研究问题发送到未知服务。
需要把 API 密钥写到技能里吗？+
不需要。凭据应配置在 AI-Q 后端环境中，技能本身不收集或管理密钥。
npx skills add nvidia/skills --skill aiq-research --yes