カスタムコンテンツソースのベストプラクティス

AIP Assist のレスポンスを改善するには、その基盤となる仕組みである検索拡張生成 ↗（RAG）を理解することが重要です。このプロセスでは、コンテンツを簡潔で焦点の絞られた段落に分割します。質問がされると、RAG はその質問に最も関連性の高い段落を特定し、取得します。次に、AIP Assist は選択された段落と公開ドキュメントの情報を使って、レスポンスを作成します。

このアプローチでは、コンテンツの粒度がレスポンスの品質に大きく影響する可能性があります。ベストプラクティスは、見出しと小見出しに基づいてコンテンツを独立したセクションに整理することです。各見出しでは、できるだけ1つのトピックまたは質問に焦点を当て、その配下のコンテンツがその主題と密接に関連し、具体的であるようにします。

わかりやすい構成にする

ソフトウェア製品のさまざまな機能について説明するコンテンツのセクションを考えてみましょう。次のように、複数のトピックを含む長い段落を作成するのではなく、

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.

焦点を絞ったサブセクションに分割します。

Copied!
1
2
3
4
5
6
7
8
9
10
11
## 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 プラットフォームの公開ドキュメントも検索します。そのため、カスタムコンテンツがこれらの公開ドキュメントにある情報と意図せず重複したり、競合したりしないようにすることが重要です。公開ドキュメントにある用語と共通または類似する用語（たとえば、「ビルド」や「コードリポジトリ」）を使用する場合は、そのコンテキストにおける意味を明確に定義するか、曖昧さを解消することが重要です。こうした明確化によって、AIP Assist は類似した名前の概念を区別し、より正確でコンテキストに即したレスポンスを提供できます。

非推奨化やオーバーライドを避ける

プロセスやワークフローが更新されたときは、古くなったドキュメントを非推奨としてマークしたり、オーバーライドを追加したりすることは避けてください。代わりに、元のコンテンツを更新するか、無効なドキュメントを削除します。

たとえば、次のような記述を使用するのではなく、

Copied!
1
2
3
(Note: This document is now deprecated.)

In case of a high priority issue, contact abx@xyz.com directly.

または

Copied!
1
2
3
4
5
6
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.)

次のように、コンテンツを統合した最新の形に更新します。

Copied!
1
In case of a high priority issue, create a service ticket on the management system.