配置指南 | 智慧芽开放平台

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 行为。

DRAFTING_DISCLOSURE、DRAFTING_PATENT_DRAFT、DRAFTING_PROSECUTION 支持认证配置，以及 iframe 或新窗口打开方式。目前不提供导出回调、问题预填或附件配置，请以 Widget Studio 中该组件的可用设置为准。

导出配置

为支持的 Agent（如 NOVELTY_SEARCH）配置报告导出行为，请在 Widget Studio 中确认所选组件的可用设置。

const EXPORT_BEHAVIOR = window.PatsnapAgentSDK.EXPORT_BEHAVIOR;

await agentNewTab.openAgent(AGENT_NAME.NOVELTY_SEARCH, {
  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

访问当前公开上架的研究、知识产权、生物医药和材料 AI 智能体。请使用此处展示的 AGENT_NAME 常量指定要打开的公开 Widget。

研究与创新

RESEARCHTECHNICAL_QAFIND_SOLUTIONTRIZAIR_AI_AGENTCOMPANY_SEARCHCOMPETITIVE_LANDSCAPETECHNOLOGY_ROADMAPNOVELTY_CHECK

知识产权

NOVELTY_SEARCHDRAFTING_DISCLOSURESEMANTIC_SEARCHDRAFTING_PATENT_DRAFTDRAFTING_PROSECUTIONIMAGE_FTO_SEARCHFTO_PRO

生物医药

LS_PIALS_PCIELS_PDALS_LCA

材料

FIND_SOLUTIONS_MATERIALS_V2MATERIAL_STRUCTURE_SEARCHMATERIAL_SMART_SEARCHMATERIAL_SUBSTANCE_EXPLORATIONMATERIAL_PDAMATERIAL_WORKFLOWMATERIAL_PROPERTYMATERIAL_METALMATERIAL_FORMULATION_AGENT

SDK 中可能仍保留部分旧版兼容 Agent，但它们不属于公开推荐列表。

下一步

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