循序渐进 · 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(对话式分析)
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=true2
预加载会话
要点:让用户一进来就有上下文。
预填用户的第一条消息,或预加载上下文,让用户一开始就能使用相关资源:
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=true3
视图选项
要点:界面元素的显示控制。
embedded: 设为true时隐藏工作区侧边栏,以获得更简洁的外观。hideSettingsMenu: 设为true时隐藏设置菜单。theme: 设置颜色主题(light或dark)。modelRid: 设置用于分析的特定模型。
URL 参数只覆盖可用设置的一个子集。对于任何无法用参数配置的内容,请创建一个包含单个全页面 AIP Analyst widget 的 Workshop 模块,在那里进行配置,然后改为嵌入该模块。该 widget 暴露的控制要细粒度得多,包括哪些界面元素可见、默认启用哪些工具,以及分析如何保存和加载。
延伸阅读 · 相关页面
按主题横向跳转,不必顺着目录一篇篇读。
本组其他页面 · AIP Analyst(对话式分析)
同一主题下的相邻内容。
- AIP Analyst 总览:对话式分析AIP Analyst 是面向智能体工作流的界面:用自然语言在 Ontology 上做即席分析,不用写查询、不用搭看板。
- AIP Analyst 的能力(工具)AIP Analyst 靠工具(tool)来搜索、分析并呈现答案。工具在 Tools 菜单里按类别分组,可整体或单独启用
- 使用 AIP Analyst这一篇逐个介绍构成一次分析会话的功能与概念,让你知道界面上每个部分在做什么。
- 分析资源(Analysis resources)一次有价值的分析不该用完就丢。把分析保存为 Compass 资源,就能回头再看、共享给协作者、并纳入项目管理。
- AIP Analyst 的计算用量AIP Analyst 是智能体式应用:一个问题可能引发大量模型调用与 Ontology 查询。理解用量来源,才能预测成
- AIP Analyst 的 Workshop 微件把 AIP Analyst 作为 Workshop widget 嵌进业务应用,用户在自己的工作界面里就能用上 AI 分
常见问题速答 · FAQ
关于「嵌入 AIP Analyst」,读者最常问的几个问题。
预加载会话是什么?
让用户一进来就有上下文。预填用户的第一条消息,或预加载上下文,让用户一开始就能使用相关资源。
视图选项是什么?
界面元素的显示控制。URL 参数只覆盖可用设置的一个子集。对于任何无法用参数配置的内容,请创建一个包含单个全页面 AIP Analyst widget 的 Workshop 模块,在那里进行配置,然后改为嵌入该模块。