voice-ai-integration

Shengwang 統合

ワークフロー

ステップ 0：ドキュメントインデックスが存在することを確認する（必須）

⚠️ ルーティングやコード生成を行う前に、必ず実行してください。

references/docs.txt がすでに存在するか確認します。存在する場合は、このステップを完全にスキップしてください。 存在しない場合は、ダウンロードします。

bash skills/voice-ai-integration/scripts/fetch-docs.sh

これは doc.shengwang.cn から静的なドキュメントインデックスをダウンロードします。ユーザーデータは送信されません。 ダウンロードに失敗した場合は、ローカルのリファレンスドキュメントとフォールバック URL を使用して続行してください。

ステップ 1：適切な製品モジュールにルーティングする

段階的開示のルール： 現在のステップで指定されたファイルのみを読み取ってください。references/ ディレクトリをスキャンしたり、現在のステップからリンクされていないファイルを事前に読んだりしないでください。各製品モジュールの README.md に、次に読み取るファイルとタイミングが記載されています。現在読んでいるドキュメントで参照されていないファイルは開かないでください。

ルートテーブルを使用して、ユーザーのリクエストを製品モジュールに対応付けます。明確に一致する場合は、そのままルーティングしてください。追加の質問は不要です。

ルートテーブル

ユーザーの意図	ルーティング先
認証情報、AppID、REST 認証	general
トークンの生成、トークンサーバー、AccessToken2	token-server
ConvoAI の音声エージェント関連	conversational-ai
RTC SDK の統合	rtc
RTM メッセージング／シグナリング	rtm
クラウド録画	cloud-recording
SDK のダウンロード、サンプルプロジェクト、GitHub リポジトリ	上記の該当する製品モジュールにルーティング

製品の識別に役立つ情報

ユーザーが製品名を指定せずにユースケースを説明した場合は、これを使って該当する製品を推測してください。

製品	機能	ユーザーがよく使う表現
ConvoAI	AI 音声エージェント（RTC 経由の ASR→LLM→TTS）	「AI 音声」、「voice bot」、「対話型 AI」、「AI agent」、「AI カスタマーサポート」
RTC SDK	人同士のリアルタイム音声／ビデオ通話	「ビデオ通話」、「ライブ配信」、「video call」、「live streaming」
RTM	リアルタイムメッセージング／シグナリング	「チャット」、「メッセージ」、「chat」、「signaling」
Cloud Recording	RTC セッションをサーバー側で録画	「録画」、「recording」、「保存」、「再生」
トークン生成	RTC／RTM トークンを生成	「token」、「認証」、「token server」

よくある組み合わせ

ユースケース	必要な製品
AI 音声アシスタント	ConvoAI（メイン）＋ RTC SDK（クライアント）
AI 音声アシスタント＋チャット履歴	ConvoAI ＋ RTC SDK ＋ RTM
1 対 1／グループビデオ通話	RTC SDK
ビデオ通話＋チャット	RTC SDK ＋ RTM
録画付きライブ配信	RTC SDK ＋ Cloud Recording
AI との会話を録画	ConvoAI ＋ RTC SDK ＋ Cloud Recording
チャット／メッセージングのみ	RTM

ルーティングのルール

• 明らかな文脈から推測してください。答えがすでに明らかな場合は質問しないでください
• この段階では、製品固有の設定に関する質問（プロバイダー、SDK バージョン、プロジェクト構成など）をしないでください。製品モジュールに対応させてください
• 製品は明らかでもリクエストの種類（クイックスタート、デバッグ、機能）が曖昧な場合は、製品モジュール内で判断してください
• 複数の製品が必要な場合は、まず主要な製品にルーティングし、次に補助製品を順番に扱ってください
• ConvoAI は内部ルーティングが最も詳細です（README.md を参照）。ConvoAI 固有の判断は必ずそのモジュールに委ねてください

製品がまだ不明な場合

上記のルートテーブルと識別に役立つ情報だけでは製品を特定できない場合：

1. ルーティングの判断を変える不足情報だけを尋ねます
2. 一度に尋ねる質問は最大 1 つにします
3. 質問形式に沿った表現より、自然な言い回しを優先します
4. 製品が明らかになったら、短いルーティングの要約を提示して続行します。

ZH：

已了解的信息
─────────────────────────────
场景：          [use case]
主要产品：      [primary product]
配套产品：      [supporting products / 无]
─────────────────────────────

EN：

What I have so far
─────────────────────────────
Use case:       [use case]
Primary:        [primary product]
Supporting:     [supporting products / none]
─────────────────────────────

別途確認を求めてそこで止めず、自動的に製品モジュールへ進んでください。

ステップ 2：製品モジュールに実装を任せる

各製品モジュールには独自のワークフローがあります。ここで実装ロジックを重複させないでください。

モジュール共通のパターン：

1. まず references/ 内のローカル参照ドキュメントを使用します
2. ローカルの参照ドキュメントで不十分な場合に限り、doc-fetching.md を使ってリモートドキュメントを取得します
3. ドキュメントの取得を試みた後に限り、フォールバックとしてウェブ検索を使用します

実行時の要件

• ローカルのドキュメント取得ヘルパースクリプトには bash と curl
• サンプルに沿った方法を選択した場合のサンプルリポジトリの調査には git
• doc.shengwang.cn、doc-mcp.shengwang.cn、gitee.com へのネットワークアクセス

ネットワークの動作：

• fetch-docs.sh は doc.shengwang.cn/llms.txt から静的ファイルをダウンロードします。ユーザーデータは送信されません
• fetch-doc-content.sh は doc-mcp.shengwang.cn から URI で指定された単一のドキュメントページを取得します。送信されるのはドキュメント URI のみで、ユーザーのコンテキストは送信されません
• git clone は gitee.com からサンプルリポジトリを調査する場合に限り使用します。送信されるのはリポジトリ URL のみです

認証情報とサービスの有効化に関する要件は製品によって異なります。詳細は各製品モジュールと general/credentials-and-auth.md を参照してください。認証情報をハードコードしないでください。

安全性と同意に関するルール

• デフォルトでは外部リポジトリをユーザーのメインワークスペースにクローンせず、一時パスを優先してください
• コード生成をユーザーが明示的に依頼するまで、既存のユーザープロジェクトを変更しないでください
• シークレットをプロジェクトファイルに書き込まず、環境変数と例示用プレースホルダーを優先してください
• ネットワーク経由での取得やリポジトリのクローンを行う前に、ダウンロードする内容を伝えてください
• 必要な依存関係や認証情報が不足している場合は、作業を中止して問題を説明してください

ダウンロードのルール

• HTTPS のリポジトリルート URL のみを使用し、git clone --depth 1 <url> を実行してください
• ダウンロードに失敗した場合は必ずエラーを報告し、手動ダウンロード用の URL を提示してください。黙ってスキップしないでください

リンク

• コンソール：https://console.shengwang.cn/
• ドキュメント（CN）：https://doc.shengwang.cn/
• GitHub：https://github.com/Shengwang-Community