lytics-agent

Lytics エージェントルーター

目的

Lytics CDP 操作の最上位インテント分類器およびディスパッチャーです。ユーザーのリクエストを分析し、適切な専門スキルに振り分けます。

環境

認証済みの API アクセスが必要です。認証情報の解決と事前チェックについては、../references/auth.md を参照してください。

インテントの分類

キーワードとインテントに基づいて振り分けます。

オーディエンス／セグメント操作

トリガー：「オーディエンスを作成」「セグメントを作成」「〜に該当するユーザーを検索」「〜の人」「〜の顧客」「ターゲットオーディエンス」「〜のオーディエンス」 振り分け先：audience-builder skill

トリガー：「セグメントを一覧表示」「オーディエンスを表示」「セグメントを取得」「セグメントの詳細」「セグメントを削除」「セグメントを更新」 振り分け先：segment-manager skill

オーディエンス分析／スナップショット

トリガー：「オーディエンスを説明」「オーディエンスのスナップショット」「セグメントの概要」「オーディエンスの内訳」「セグメントを分析」「オーディエンスのプロファイル」「オーディエンス分析」「オーディエンスの属性」「このセグメントに含まれる人」 振り分け先：audience-snapshot skill

オーディエンス戦略／アドバイザー

トリガー：「〜に最適なオーディエンス」「オーディエンスを最適化」「ターゲティングを支援」「誰をターゲットにすべきか」「セグメントを改善」「オーディエンス戦略」「どのオーディエンスにすべきか」「〜に適したオーディエンス」「リーチする方法」「より良いオーディエンス」「セグメントを調整」 振り分け先：audience-advisor skill

プロファイルの診断

トリガー：「ユーザーが〜に含まれる理由」「ユーザーが〜に含まれない理由」「セグメントに含まれない理由」「プロファイルを診断」「ユーザーに何が起きたか」「セグメントへの所属をデバッグ」「セグメントを説明」「ユーザーを追跡」 振り分け先：profile-investigator skill

プロファイル／エンティティの探索

トリガー：「ユーザーを検索」「プロファイルを検索」「〜は誰か」「ユーザーを表示」「〜のプロファイル」「エンティティ検索」 振り分け先：profile-explorer skill

スキーマ／データモデル

トリガー：「どのフィールド」「スキーマ」「データモデル」「フィールドの種類」「利用可能なデータ」「どのようなデータがあるか」 振り分け先：schema-manager skill

スキーマの最適化

トリガー：「スキーマを最適化」「未使用フィールド」「スキーマの整理」「フィールドの使用状況」「スキーマの健全性」「スキーマを改善」「未使用のフィールド」「不足しているマッピング」 振り分け先：schema-optimizer skill

スキーマの検出（フィールドのマッピング用）

トリガー：「〜に対応するフィールドを検索」「一致するフィールドは何か」「フィールドにマッピング」 振り分け先：schema-discovery skill

インテグレーション戦略／アドバイザー

トリガー：「〜に接続」「インテグレーションを設定」「〜にエクスポート」「〜からインポート」「〜と同期」「〜にデータを送信」「〜からデータを取得」「最適な接続方法」「インテグレーションの方法」 振り分け先：integration-advisor skill

データインテグレーション／ジョブ（既存）

トリガー：「ジョブを一覧表示」「ジョブのステータス」「ジョブを一時停止」「ジョブを再開」「ジョブを再実行」「ジョブを強制終了」「ジョブのログ」 振り分け先：job-manager skill

キャンペーン／ジャーニーの作成

トリガー：「フローを作成」「キャンペーンを作成」「ジャーニーを設定」「ウェルカムシリーズ」「ナーチャリングキャンペーン」「メールシーケンス」「複数ステップのキャンペーン」「A/B テストフロー」 振り分け先：campaign-flow-builder skill

フローの CRUD 操作

トリガー：「フローを一覧表示」「フローを取得」「フローを削除」「フローのステータス」「フローを更新」「フローを一時停止」 振り分け先：flow-manager skill

エクスポートのデバッグ

トリガー：「ユーザーがエクスポートされなかった理由」「エクスポートをデバッグ」「〜に表示されない」「〜に同期されなかった」「エクスポートに含まれていない」「エクスポートされない理由」「エクスポートを追跡」「エクスポートに失敗」 振り分け先：export-debugger skill

データの健全性

トリガー：「データの健全性」「データは流れているか」「ヘルスチェック」「データに問題はあるか」「パイプラインのステータス」「何が壊れているか」「データの問題」「データを確認」「データの状況」 振り分け先：data-health-monitor skill

ストリーム／イベント

トリガー：「ストリーム」「イベント」「データの流れ」「受信データ」「イベントログ」 振り分け先：stream-inspector skill

接続／認証

トリガー：「接続」「認証」「認証情報」「プロバイダー」 振り分け先：connection-manager skill

Webhook テンプレート

トリガー: "webhook template", "send to a webhook", "custom webhook destination", "Qualtrics webhook", "Slack webhook", "transform profile to webhook payload", "build a webhook payload", "webhook integration for", "send profiles to a custom URL" ルーティング先: webhook-template-builder skill

アカウント間の同期／昇格

トリガー: "copy from sandbox to prod", "promote to prod", "sync to prod", "copy segment to another account", "sandbox to production", "promote audience", "promote flow", "copy schema between accounts", "move segment from X to Y", "sync from to ", "copy account settings", "promote settings", "sync settings between accounts", "copy idconfig", "sync account config", "promote account settings", "copy field rankings between accounts" ルーティング先: account-sync skill

複数のインテントへの対応

リクエストには複数のインテントが含まれることがあります。スキルを次の順序で実行してください。

• "Create an audience and export to Facebook"

  1. audience-builder skill -> セグメントを作成
  2. integration-advisor skill -> 新しいセグメントを使ってエクスポートを設定

• "Find users in the high-value segment and show me one"

  1. segment-manager skill -> セグメントの詳細を取得
  2. profile-explorer skill -> メンバーを検索

• "What fields do we have for purchase data and build a segment from it"

  1. schema-discovery skill -> 購入関連のフィールドを検索
  2. audience-builder skill -> 見つかったフィールドを使ってセグメントを作成

• "Build a segment in sandbox and promote it to prod"

  1. audience-builder skill -> sandbox でセグメントを作成
  2. account-sync skill -> 新しいセグメントを sandbox から prod にコピー

意図の明確化

意図が不明確な場合：

1. 確認の質問をします
2. 最も可能性の高い解釈を提案します
3. 別の解釈も提示します

例："Show me data" は次のいずれかを意味する可能性があります。

• スキーマ／フィールド -> schema-manager
• ストリームイベント -> stream-inspector
• プロファイルデータ -> profile-explorer

次のように尋ねます。「スキーマフィールド、最近のストリーミングイベント、特定のプロファイルのどれを確認しますか？」

共通規約

すべてのスキルは次の規約に従います。

• 認証: 認証情報の解決方法については ../references/auth.md を参照してください
• ベース URL: URL の構築方法については ../references/api-client.md を参照してください
• 読み取り: すぐに実行し、結果を表示します
• 書き込み: 常に確認ゲートのパターン（概要 + ペイロード + 承認）を使用します
• エラー: API エラーを解析して修正方法を提案し、エラーを黙って無視しません