智慧芽开放平台

SDK 配置参数

两种集成模式均需要相同的核心配置参数用于鉴权和初始化。

参数	类型	必填	描述
email	string	Yes	您系统中当前登录用户的邮箱
companyId	string	Yes	智慧芽提供的公司 ID
publicKey	string	Yes	智慧芽提供的用于 RSA 加密的公钥
JSEncrypt	constructor	Yes	来自 JSEncrypt 库的全局构造函数
iframe	HTMLElement	仅 iframe 模式	嵌入模式所需的 iframe DOM 元素

新窗口模式配置

配置 SDK 在新浏览器窗口中打开 AI 智能体。此模式适合独立工作流和复杂分析任务。

JavaScript

const PatsnapAgentNewTab = window.PatsnapAgentSDK.AgentNewTab;
const AGENT_NAME = window.PatsnapAgentSDK.AGENT_NAME;

// Initialize SDK
const agentNewTab = new PatsnapAgentNewTab({
  email: 'user@yourcompany.com',
  companyId: 'your-company-id',
  publicKey: 'YOUR_PUBLIC_KEY',
  JSEncrypt: window.JSEncrypt,
});

// Login and open agent
document.getElementById('btn').addEventListener('click', async () => {
  try {
    await agentNewTab.login();
    await agentNewTab.openAgent(AGENT_NAME.NOVELTY_SEARCH);
  } catch (error) {
    console.error('Failed to open agent:', error);
  }
});

iframe 嵌入模式配置

配置 SDK 将 AI 智能体直接嵌入页面。此模式可与现有 UI 无缝集成。

HTML

<iframe id="agent-iframe" style="width: 100%; height: 600px; border: none;"></iframe>

JavaScript

const AgentIframe = window.PatsnapAgentSDK.AgentIframe;
const AGENT_NAME = window.PatsnapAgentSDK.AGENT_NAME;

const iframe = document.getElementById('agent-iframe');

// Initialize SDK
const agentIframe = new AgentIframe({
  email: 'user@yourcompany.com',
  companyId: 'your-company-id',
  publicKey: 'YOUR_PUBLIC_KEY',
  JSEncrypt: window.JSEncrypt,
  iframe: iframe,
});

// Login and initialize agent
document.getElementById('btn').addEventListener('click', async () => {
  try {
    await agentIframe.login();
    await agentIframe.init(AGENT_NAME.NOVELTY_SEARCH);
  } catch (error) {
    console.error('Failed to initialize agent:', error);
  }
});

重要: iframe 模式需要配置 CSP（内容安全策略）。请将智慧芽域名添加到白名单，如果无法配置 CSP，请改用新窗口模式。

高级配置

通过导出处理和问题预填充等高级配置选项自定义 Widget 行为。

导出配置

控制 AI 智能体处理报告导出的方式。仅适用于专利交底书 Agent

const EXPORT_BEHAVIOR = window.PatsnapAgentSDK.EXPORT_BEHAVIOR;

await agentNewTab.openAgent(AGENT_NAME.PATENT_DISCLOSURE, {
  exportConfig: {
    behavior: EXPORT_BEHAVIOR.EVENT_ONLY,
  },
  eventListeners: {
    exportReport: (eventData) => {
      console.log('Export task ID:', eventData.taskId);
      // Use taskId to call OpenAPI endpoint for report download
    }
  }
});

问题配置

打开 Agent 时预填充问题，简化用户工作流

await agentNewTab.openAgent(AGENT_NAME.TECHNICAL_QA, {
  questionConfig: {
    input: 'Explain machine learning overfitting',
    enableInputAppendToJob: true  // Use as initial question
  }
});

可用 Agents

访问覆盖多个领域的 30+ AI 智能体。使用 AGENT_NAME 常量指定要打开的 Agent。

研究与创新

RESEARCHTECHNICAL_QAFIND_SOLUTIONNOVELTY_CHECKCOMPANY_SEARCH

知识产权

NOVELTY_SEARCHPATENT_DISCLOSURESEMANTIC_SEARCHFTO_PRO

生物医药与材料

LS_PIAMATERIAL_TECHNICAL_QAMATERIAL_SCOUT

完整的 Agent 列表及其能力说明，请参阅 Agent 集成文档的 API 参考部分。

下一步

配置完成！查看 FAQ 部分了解常见问题和排查技巧，或开始将 Widgets 集成到您的应用中。