安装与配置
Q：SDK 加载失败，应该检查哪些内容？
请验证以下几点：
- 确认 HTML 中已包含 JSEncrypt 和 Agent SDK 两个 script 标签
- 确保脚本按正确顺序加载（先 JSEncrypt，再 Agent SDK）
- 验证 SDK URL 正确且在您的环境中可访问
- 检查浏览器控制台是否有加载错误
Q：如何验证 SDK 是否正确加载？
打开浏览器控制台，检查全局对象：
console.log(window.PatsnapAgentSDK);
如果 SDK 已加载，您应该能看到包含 AgentNewTab、AgentIframe 和 AGENT_NAME 属性的对象。
鉴权问题
Q：遇到鉴权失败错误，是什么原因？
常见原因：
- 您的 IP 地址不在 智慧芽 白名单中——联系 智慧芽 添加
- 公钥或公司 ID 不正确——请与 智慧芽 核实这些值
- 邮箱格式无效——确保使用有效的邮箱地址
- 租户未启用 JWT 鉴权——联系 智慧芽 支持
Q：应该在代码中硬编码用户邮箱吗？
不应该。请始终从您的鉴权系统动态获取当前登录用户的邮箱。示例：
const userEmail = getCurrentUser().email;
硬编码邮箱会导致其他用户鉴权失败。
iframe 集成
Q：iframe 模式在无痕/隐私浏览模式下登录失败，为什么？
隐私浏览模式通常会阻止第三方 Cookie 和跨域存储，而 iframe 鉴权需要这些功能。
解决方案: 使用普通浏览模式进行 iframe 集成，或切换到没有此限制的新窗口模式。
Q：遇到 CSP（内容安全策略）拦截错误，如何修复？
您需要将 智慧芽 域名添加到 CSP 白名单。更新 CSP 头以包含：
frame-src 'self' *.patsnap.com;
如果您的环境无法配置 CSP，请改用新窗口模式。
Q：iframe 显示空白或无法加载内容，应该检查什么？
排查步骤：
- 确认初始化前 iframe 元素已存在于 DOM 中
- 确认调用 init() 前 login() 已成功完成
- 确保 iframe 设置了合适的宽度和高度样式
- 检查浏览器控制台是否有 CSP 或 CORS 错误
- 确认您的 IP 已在 智慧芽 白名单中
高级功能
Q：导出事件未触发，是什么原因？
请检查以下几点：
- 导出配置仅支持 PATENT_DISCLOSURE Agent
- 确保 behavior 设置为 EXPORT_BEHAVIOR.EVENT_ONLY
- 确认 exportReport 监听器已在 eventListeners 中注册
- 确认调用 openAgent() 或 init() 时传入了配置
Q：收到导出事件后如何下载报告？
导出事件会提供 taskId。使用此 ID 调用 OpenAPI 接口下载报告：
exportReport: (eventData) => {
fetch(`/api/reports/${eventData.taskId}`)
.then(res => res.blob())
.then(blob => /* download */)
}
fetch(`/api/reports/${eventData.taskId}`)
.then(res => res.blob())
.then(blob => /* download */)
}
Q：问题配置不生效，哪些 Agent 支持此功能？
并非所有 Agent 都支持问题配置。支持的 Agent 包括：
- TECHNICAL_QA、RESEARCH、FIND_SOLUTION
- NOVELTY_SEARCH、PATENT_DISCLOSURE、SEMANTIC_SEARCH
- MATERIAL_TECHNICAL_QA、MATERIAL_SCOUT
完整列表请参阅 Agent 集成文档的 API 参考部分。
通用问题
Q：应该选择哪种集成模式？
根据使用场景选择：
- 新窗口模式: 适合独立工作流、复杂分析任务，或 CSP 配置困难的场景
- iframe 模式: 适合与现有 UI 无缝集成、保持用户上下文或嵌入式工作流的场景
Q：可以自定义 Widget 外观以匹配我的品牌吗？
可以。SDK 支持完全去除 智慧芽 品牌元素。请联系 智慧芽 支持讨论您的集成定制方案。
Q：可以同时使用多少个 Widget？
您可以打开多个 Widget，但使用限制取决于您的 OpenAPI 容量配置。请联系 智慧芽 根据您购买的套餐调整限制。
Q：在哪里可以找到完整的可用 Agent 列表？
包含描述、使用场景和功能支持的完整 Agent 列表，请参阅 Agent 集成文档的 API 参考部分。您也可以查看 SDK 中的 AGENT_NAME 常量。
仍需帮助？
如果这里没有解答您的问题，请联系 智慧芽 支持团队获取帮助。
提交技术问题时，请附上浏览器控制台日志、SDK 版本和问题描述。