自定义内容源最佳实践
要让答案好，先得懂原理：AIP Assist 底层用的是检索增强生成（RAG）。这一篇从 RAG 机制反推内容该怎么写。
https://www.palantir.com/docs/foundry/assist/custom-documentation-best-practices/
原始标题：AIP Assist • Power AIP Assist with custom content sources • Custom content source best practices • Palantir · 所属：AIP Assist（平台里的 AI 助手）
先记住这几条
写在前面
为改善 AIP Assist 的回答，理解其底层机制检索增强生成 ↗（retrieval augmented generation，RAG）至关重要。该过程会将你的内容拆分为简洁、聚焦的段落。当提出问题后，RAG 会识别并检索与问题最相关的段落。AIP Assist 随后使用这些选定的段落，连同来自公共文档的信息，来构建回答。
鉴于这种方式，你内容的粒度会显著影响回答的质量。最佳实践是基于标题和子标题将内容组织成离散的章节。每个标题最好专注于单一主题或问题，确保其下的内容与该主题高度相关且具体。
结构清晰
假设你内容中的某个章节讨论了某个软件产品的各项功能。与其创建像这样又长又涉及多个主题的段落：
Feature A helps with productivity by automating tasks. Feature B enhances security through encryption. Feature C offers real-time collaboration tools, and Feature D provides detailed analytics.
不如将其拆分为聚焦的小节：
## Feature A: Automation
Feature A boosts productivity by automating repetitive tasks, streamlining workflows.
## Feature B: Security
Feature B secures data with advanced encryption techniques, protecting against unauthorized access.
## Feature C: Collaboration
Feature C enables real-time collaboration, allowing teams to work together seamlessly.
## Feature D: Analytics
Feature D offers comprehensive analytics, giving insights into performance metrics.以这种方式组织你的内容，能让 AIP Assist 更高效地检索与具体询问相关的信息，从而提升其回答的准确性和有用性。
避免与公开文档冲突
AIP Assist 还会搜索 Palantir 平台的公共文档来构建回答。因此，确保你的自定义内容不会无意中与这些公共文档中的信息重叠或冲突至关重要。当使用与公共文档中常见或相似的术语时（例如 "build"、"code repository"），务必在你的上下文中清晰地定义或区分它们。这种澄清有助于 AIP Assist 区分名称相似的概念，并提供更准确、更具上下文针对性的回答。
避免弃用或覆盖内容
当流程或工作流程发生更新时，避免将过时文档标记为已弃用或添加覆盖说明。相反，应在源处更新内容，或删除任何无效的文档。
例如，与其使用以下内容：
(Note: This document is now deprecated.)
In case of a high priority issue, contact abx@xyz.com directly.或
In case of a high priority issue, contact abx@xyz.com directly.
...
...
(Update: As of July 31, create a service ticket on the management system instead of sending an email to abx@xyz.com.)
不如将内容更新为精炼且最新的形式，例如：
In case of a high priority issue, create a service ticket on the management system.延伸阅读 · 相关页面
按主题横向跳转，不必顺着目录一篇篇读。
本组其他页面 · AIP Assist（平台里的 AI 助手）
同一主题下的相邻内容。
- AIP Assist 总览：平台里的 AI 助手AIP Assist 是内建在平台里的 LLM 支持工具：用自然语言问它怎么用 Palantir，实时拿到答案。它同时是
- AIP Assist 最佳实践同样一个助手，会问的人和不会问的人拿到的答案质量差很多。这一篇讲怎么高效跟它打交道。
- 用自定义内容源驱动 AIP Assist官方文档回答不了你公司内部的问题。这一组讲怎么把私有文档接进去，让助手也能回答运营与流程类问题。
- 注册自定义内容源这一步是把内部文档登记进平台，让 AIP Assist 能检索到它。用它可以加速工作流、改善新人上手、自动回答支持类问题
- 把自定义内容源投递给用户注册完还不够，要在 Control Panel 里配置它对哪些用户可见，才能真正用上。
- 部署由自定义源驱动的 AIP Chatbot自定义内容源还能进一步变成独立的对话机器人（通过 AIP Chatbot Studio），面向特定场景提供聚焦的协助。
- AIP Assist 的应用集成AIP Assist 不只是个浮窗，它与平台各应用有多处集成点，让你在具体应用里就能拿到针对性帮助。
- AIP Assist 的建议动作助手会主动推荐"下一步可以做什么"，包括导航类和操作类建议 —— 对新人尤其友好。
常见问题速答 · FAQ
关于「自定义内容源最佳实践」，读者最常问的几个问题。