# リアルタイムデバッグ用 AI スキル

Treasure AI Studio は、一般的なリアルタイムの問題の根本原因を迅速に特定するための診断クエリを生成するスキルを提供します。

以下のような場合にこれらのスキルを使用してください。

- **ペアレントセグメント ID** があり、問題を調査する必要がある場合。
- **アクティベーションの失敗**、**プロファイルのマージ**、または**ステッチングの品質**について素早く確認したい場合。
- リアルタイムの問題を診断するための構造化されたアプローチが必要な場合。


前提条件
[`td-skills`](/treasure-code/guide/td-skills) パッケージをインストールしてください。

## 利用可能なスキル

リアルタイムデバッグに利用可能なスキルは以下のとおりです。

| スキル | 回答する質問 | 期待される出力 |
|  --- | --- | --- |
| `activations` | アクティベーションは実行されたか？なぜ失敗したか？ | アクティベーション配信エラーとボリュームの概要を素早く確認 |
| `identity` | イベントは正しいプロファイルにステッチされたか？ | 新規、更新済み、マージ済みのリアルタイムプロファイルを素早く確認 |
| `identify-top-key-values` | 不正なステッチング値がグラフを汚染していないか？ | null や空のパターンを含む、データ品質の問題を引き起こす主要なキー値を表示 |
| `id-graph-canonical-id-size` | 正規グループが異常に大きくなっていないか？ | オーバーステッチングや「メガプロファイル」パターンの検出に役立つ |
| `id-graph-ids-to-canonical-id` | 1つの ID が複数の正規 ID にマッピングされていないか？ | 不整合なステッチングやオーバーステッチングのケースを検出 |
| `rt-journey-monitor` | ジャーニーは期待どおりに実行されているか？どこで失敗しているか？ | ジャーニー実行の監視とアクティベーション失敗のデバッグ |


## デバッグワークフロー

調査している症状に基づいて、適切なスキルを選択してください。

### アクティベーションが実行されない

Webhook、ストリーミング出力、またはダウンストリームアクションが期待どおりに実行されなかった場合、以下のスキルから始めてください。

1. **`activations`** — ペアレントセグメントのアクティベーションログをクエリして、アクティベーションが実行されたかどうかを確認し、配信エラーを特定します。
2. **`rt-journey-monitor`** — アクティベーションがジャーニーの一部である場合、ジャーニー自体が正しく実行されているか、どこで失敗しているかを確認します。


### プロファイルデータの欠損または不正

パーソナライゼーション属性が欠落している、不完全である、または予期しない値を返している場合、根本原因は多くの場合 ID 解決に関連しています。以下のスキルを使用してください。

1. **`identity`** — ペアレントセグメントの最近のプロファイルマージとステッチングアクティビティを確認します。
2. **`identify-top-key-values`** — ステッチングキー値の分布を検査して、データ品質を低下させる null、空、または不正な値を見つけます。
3. **`id-graph-canonical-id-size`** — 正規 ID グループサイズを分析して、多くの ID が単一プロファイルに統合されるオーバーステッチングを検出します。
4. **`id-graph-ids-to-canonical-id`** — 単一の ID が複数の正規 ID にマッピングされていないかを確認します。これは不整合なステッチングを示します。


## プロンプト例

スキルを使用するには、ペアレントセグメント ID と回答したい具体的な質問を提供してください。以下の例ではペアレントセグメント `394649` をプレースホルダーとして使用しています — ご自身のものに置き換えてください。

### アクティベーションのデバッグ


```text
Use the activations skill to query activation logs for parent segment 394649.
```

### ID とプロファイルのデバッグ


```text
Use the identity skill to check recent profile merges for parent segment 394649.
```


```text
Use the identify-top-key-values skill to debug stitching key distributions
for parent segment 394649.
```

### ID グラフ分析


```text
Use the id-graph-canonical-id-size skill to analyze canonical ID group sizes
for parent segment 394649.
```


```text
Use the id-graph-ids-to-canonical-id skill to detect IDs mapping to multiple
canonical IDs.
```

## ベストプラクティス

デバッグセッションを開始する前に、以下の情報を収集してください。

- 調査対象のリアルタイム設定の**ペアレントセグメント ID**。
- 問題を示す**特定のユーザーまたはデバイス ID**。
- 問題が発生した**最近の時間枠**。
- 観察している**症状**：
  - アクティベーションが送信されなかった
  - パーソナライゼーションが空または部分的なデータを返した
  - プロファイルが誤ってステッチされた
  - イベント数やマージが疑わしい


次に、症状に一致するスキルの最小セットを選択してください。

- **アクティベーションの問題** — `activations` から始め、アクティベーションがジャーニートリガーの場合は `rt-journey-monitor` を使用します。
- **ID またはマージの問題** — `identity` から始めます。
- **不正な ID またはオーバーステッチングの疑い** — `identify-top-key-values`、`id-graph-canonical-id-size`、`id-graph-ids-to-canonical-id` を使用します。
- **ジャーニーの進行または配信の問題** — `rt-journey-monitor` を使用します。