循序渐进 · AIP 教学 · AIP Analyst(七)

嵌入 AIP Analyst

通过 iframe 把 AIP Analyst 嵌到 Workshop 或 OSDK 应用里,并用 URL 参数做定制化。这篇列出可用参数。

本文来源 · Source 内容整理自 Palantir Foundry 官方文档:
https://www.palantir.com/docs/foundry/aip-analyst/embed/
原始标题:AIP Analyst • Embed AIP Analyst • Palantir · 所属:AIP Analyst(对话式分析)

先记住这几条

① iframe 嵌入方式
比微件更通用的集成路径。
② 支持 URL 参数定制
控制显示内容与行为。
③ 多值参数用逗号分隔
例如指定多个对象类型组。
0

写在前面

AIP Analyst 可以通过 iframe 嵌入到 Workshop 或 OSDK 应用中。它支持若干 URL 参数以实现定制化。接受多个值的参数使用逗号分隔的列表(例如 objectTypeGroupRids=group1,group2)。

关于 Workshop 模块内更深入的集成,请参阅 AIP Analyst Workshop widget

1

控制 AIP Analyst 能访问哪些数据

要点:边界配置。
  • ontologyRid 设置 AIP Analyst 可以探索的 Ontology,例如 ri.ontology.main...
  • objectTypeGroupRids 将 AIP Analyst 限制为在特定对象类型组中搜索。
  • compassProjectRids 将 AIP Analyst 限制为在特定 Compass 项目或文件夹内的资源中搜索。
  • hideManualContextMenu 设为 true 时,阻止用户手动添加其他数据源。
/workspace/aip-analyst?ontologyRid=ri.ontology.main.abc123&objectTypeGroupRids=group1,group2&hideManualContextMenu=true
2

预加载会话

要点:让用户一进来就有上下文。

预填用户的第一条消息,或预加载上下文,让用户一开始就能使用相关资源:

  • workshopRids 从你的 Workshop 模块加载对象类型、链接和 functions,例如 ri.workshop.main.module...
  • objectSetRids 加载已保存的对象集,例如 ri.object-set.main...
  • datasetRids 加载特定数据集。
  • objectTypeIds 加载单个对象类型。
  • objectRids 加载单个对象。
  • functionRids 加载单个 functions。
  • actionTypeRids 加载单个 action types。
  • autoSubmitActionTypeRids 加载单个 action types,并允许 AIP Analyst 在无需用户批准的情况下执行它们。
  • notepadRids 加载 Notepad 文档。
  • initialMessage 在 AIP Analyst 加载时预填第一条用户消息。
  • autoStart 当设为 true 且设置了 initialMessage 时,AIP Analyst 会在页面加载后立即发送初始消息并开始分析。用它来嵌入「提问并回答」式的体验,以响应宿主应用的上下文。
/workspace/aip-analyst?workshopRids=ri.workshop.main.module.xyz789&initialMessage=Summarize+sales+by+region&autoStart=true
3

视图选项

要点:界面元素的显示控制。
  • embedded 设为 true 时隐藏工作区侧边栏,以获得更简洁的外观。
  • hideSettingsMenu 设为 true 时隐藏设置菜单。
  • theme 设置颜色主题(lightdark)。
  • modelRid 设置用于分析的特定模型。

URL 参数只覆盖可用设置的一个子集。对于任何无法用参数配置的内容,请创建一个包含单个全页面 AIP Analyst widget 的 Workshop 模块,在那里进行配置,然后改为嵌入该模块。该 widget 暴露的控制要细粒度得多,包括哪些界面元素可见、默认启用哪些工具,以及分析如何保存和加载。

延伸阅读 · 相关页面

按主题横向跳转,不必顺着目录一篇篇读。

本组其他页面 · AIP Analyst(对话式分析)

同一主题下的相邻内容。

常见问题速答 · FAQ

关于「嵌入 AIP Analyst」,读者最常问的几个问题。

预加载会话是什么?
让用户一进来就有上下文。预填用户的第一条消息,或预加载上下文,让用户一开始就能使用相关资源。
视图选项是什么?
界面元素的显示控制。URL 参数只覆盖可用设置的一个子集。对于任何无法用参数配置的内容,请创建一个包含单个全页面 AIP Analyst widget 的 Workshop 模块,在那里进行配置,然后改为嵌入该模块。