devportal_guides_overview.guides_seo

SDK 配置参数

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

SDK 鉴权与初始化配置参数
参数	类型	必填	描述
loginId	string	是	您系统中当前登录用户的登录标识，可使用账号体系支持的邮箱或手机号。
email	string	否（兼容旧版）	兼容旧版 SDK 接入的邮箱字段。新接入请使用 loginId。
companyId	string	是	智慧芽提供的公司 ID
publicKey	string	是	智慧芽提供的用于 RSA 加密的公钥
JSEncrypt	constructor	是	来自 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({
  loginId: '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({
  loginId: '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_SOLUTIONTRIZAIR_AI_AGENTNOVELTY_CHECKCOMPANY_SEARCHCOMPETITIVE_LANDSCAPETECHNOLOGY_ROADMAP

知识产权

NOVELTY_SEARCHPATENT_DISCLOSURESEMANTIC_SEARCHAI_SPECIFICATIONIMAGE_FTO_SEARCHFTO_PRO

生物医药

LS_PIALS_PCIELS_PDALS_LCA

材料

FIND_SOLUTIONS_MATERIALS_V2MATERIAL_SCOUTMATERIAL_STRUCTURE_SEARCHMATERIAL_TECHNICAL_QAMATERIAL_SMART_SEARCHMATERIAL_SUBSTANCE_EXPLORATIONMATERIAL_PDAMATERIAL_WORKFLOWMATERIAL_PROPERTYMATERIAL_METALMATERIAL_DFMEA_ASSISTANTMATERIAL_ALLOY_RESEARCHERMATERIAL_FORMULATION_AGENT

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

下一步

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