Waker 管理

この章では、Waker の作成と設定について説明します。Q&A Specialist 固有の設定は、章の最後にまとめています。

​

Waker 管理リスト

入口： 左側メインナビゲーション → 「Waker 管理」。 ページには Waker の名前、概要、実行環境、オンライン状態、タスク入口がカード形式で表示されます。

「マイ Wakers / マイグループ」を切り替え、状態、環境、または名前でフィルターできます。結果が表示されない場合は、まずフィルター条件をクリアしてください。 タスクを開始する前に、ローカル/リモートの表示とオンライン状態を確認してください。名前だけで実行場所を判断しないでください。

​

Waker の作成

作成時にロールテンプレートを選択し、基本情報を入力します。プロジェクト、スキル、コネクターは作成後に設定できます。

​

プリセットロールテンプレートを使用した作成

入口： Waker 管理 → 右上の「新規 Waker」ボタン。

操作手順：

1. 対象の職責に最も近いテンプレートを選択します。
2. 名前、アイコン、概要を入力します。概要には職責、入力、出力、境界を明記してください。
3. ページに実行環境が表示されたら、必要なプロジェクトと依存関係を持つデバイスを選択します。
4. 「保存して有効化」をクリックします。

完了判定：

• 新しい Waker が管理リストに表示され、名前、概要、実行環境が正しい。
• 詳細ページに入ると設定メニューが表示される。

​

カスタムロールテンプレートの作成

適用シナリオ： プリセットロールが長期的な職責に合わず、再利用可能なロール設定を保存する必要がある場合。 入口： 「新規 Waker」ダイアログ → 「カスタムロール」。 操作手順：

1. ロール名、説明、アイコンを入力します。
2. コア職責（IDENTITY.md）、ワークスタイル（PERSONA.md）、業務規範（BIBLE.md）を設定します。
3. 必要に応じて Skill または MCP を選択します。資格情報はセキュアな認可入口からのみ設定してください。
4. テンプレートを保存し、ロールリストに戻ってそのテンプレートを選択し、Waker を作成します。

完了判定： カスタムテンプレートがロールリストに表示される。それを使用して作成した Waker にはロールコンテキストと選択した機能が引き継がれる。テンプレートを変更しても既存の Waker は自動更新されない。

​

Waker 詳細の表示と設定項目の選択

入口： Waker 管理 → 対象の Waker カードをクリック。

まずページに表示されているのが対象の Waker であることを確認し、次に実行したい操作に応じて左側メニューを選択します。 通常の Waker では、メインナビゲーションの「IM」からチャネル追加、ペアリング承認、グローバル設定を行います。Q&A Specialist では、Waker ホームのクイック設定からボットとグループ接続を一括設定します。最小範囲で設定し、最初にテストグループで検証してください。

​

状態の確認と基本情報のメンテナンス

1. Waker 詳細 → 「ホーム」に入り、名前、ID、ローカル/リモート表示、オンライン状態を確認します。
2. 「編集」をクリックして名前、アイコン、概要を変更します。概要には職責、入力、出力、境界を明記してください。
3. 保存後、ホームページと管理リストに戻り、表示が更新されていることを確認します。

完了判定： ページに対象 Waker が表示され、状態が実際の環境と一致し、変更が保存されている。

​

再利用可能なワークコンテキストの設定

プロジェクトは再利用可能なワークコンテキストを保存するために使用します。「公開プロジェクト」は複数の Waker で使用可能です。Waker 詳細内のプライベートプロジェクトは現在の Waker のみで使用できます。

1. 使用範囲に応じて公開プロジェクトまたはプライベートプロジェクトの入口を選択します。
2. 名前と概要を入力し、作業パスを追加します。
3. デバイスと環境が正しいことを確認して保存し、対象 Waker でそのプロジェクトを選択します。

完了判定： 公開プロジェクトが公開プロジェクトリストに表示され、プライベートプロジェクトが対象 Waker の「プロジェクト」ページに表示される。どちらも対応する Waker または Chat のワークスペースセレクターで見つけることができる。 プロジェクトを使用する際は、Waker 詳細 → 「プロジェクト」でプロジェクトを選択または作成します。タスク開始時に再度選択し、まず読み取り専用タスクでパスを検証してください。プロジェクトを作成しても後続のタスクに自動的に適用されません。

​

権限の設定

入口： Waker 詳細 → 「権限」。 権限ページには現在以下が含まれます：

• ツール防御
• ファイル防御
• 組み込みツール
• モデルセキュリティ

推奨設定順序：

1. まず Waker の職責と実行する必要がある操作を明確にします。
2. ファイル防御で、タスクに必要なディレクトリ範囲のみを開放します。
3. ツール防御と組み込みツールで、必要なツールのみを保持します。
4. モデルセキュリティで、組織の要件に従って利用可能な範囲を設定します。
5. 保存後、読み取り専用のテストタスクを実行します。
6. 次に認可が必要な操作を実行し、高リスクアクションがブロックされるか、ユーザー確認を求めることを確認します。

完了判定： 通常の認可範囲内のタスクが完了できる。範囲外のアクセス、高リスクツール、制限された操作は設定したルールに従ってブロックまたは確認を要求される。

​

Q&A Specialist

Q&A Specialist の作成、ボット設定、テストグループ接続、ナレッジベースと専門家の追加、基本設定と返信設定、Q&A 記録での検証、という順に設定します。リリース後も Q&A 記録を継続して確認してください。 使用範囲を広げる前に、テストグループで検証します。

​

Q&A Specialist を作成する

1. 「Waker 管理」>「新しい Waker」を開き、「Q&A Specialist」を選択します。
2. 名前を入力し、必要に応じてテンプレートのアバターと説明を調整して、実行環境を選択します。
3. 「保存して有効化」を選択します。作成完了ページに主要機能が表示され、「後で設定」と「設定を完了」が選択できます。
4. 「設定を完了」を選択し、ボット設定、グループチャット接続、オプション設定の 3 ステップを開始します。

作成しただけではグループ内で回答できません。ボットと少なくとも 1 つのテストグループをペアリングしてから、Q&A を検証してください。

​

グループチャットボットを設定してグループを接続する

1. クイックスタートのステップ 1 で「ボットを追加」を選択します。ボット管理コンソールまたは設定ガイドを直接開けます。
2. DingTalk でグループチャットボットを作成し、メッセージ受信方式を Stream に設定します。「セキュリティ設定」で許可リストのデフォルト 1.1.1.1 を削除します。
3. AppKey と AppSecret をコピーし、QoderWake で表示名と認証情報を入力します。表示名は QoderWake 内だけで使用されます。DingTalk の実際の名前と合わせることを推奨します。
4. 受け入れポリシーを「ペアリングモード / 承認必須」にします。保存後、状態が「接続済み」でチャネルが有効であることを確認します。
5. ステップ 2 でボットをテストグループに追加し、グループ内で @メンションします。「ペアリング申請」に戻り、送信元、会話名、種類を確認して承認します。
6. IM の「ペアリングを追加」でチャネルと応答する Waker を選択し、手動ペアリングすることもできます。会話検索には対応する DWS バージョンが必要です。または、10 分間有効なペアリングコードを生成して対象会話に送信します。

確認：ボットが「接続済み」で有効になり、設定済みグループの表にボット、応答 Waker、グループ名、状態が表示されます。1 つ以上のテストグループがペアリングされ、@メンションしたメッセージが Q&A フローへ到達します。

​

ナレッジベースを追加する

1. クイックスタートのステップ 3、または Q&A Specialist の詳細 >「ナレッジベース」>「ナレッジベースを関連付け」を開きます。
2. 「自分が作成」「共有」「おすすめ」から既存のナレッジベースを選択します。「作成して関連付け」に切り替えて名前を入力することもできます。
3. 作成後に「資料を追加」を選択します。500 MB 未満の対応ドキュメント、表計算、プレゼンテーション、テキスト、画像をアップロードするか、Web ページの URL を貼り付けます。
4. 資料の処理が完了したら Waker のナレッジベースページに戻り、状態が「接続済み」で資料数が正しいことを確認します。

ナレッジベースページで関連付けと解除を行います。クイックスタートの「追加済みナレッジベース」には名前、資料数、更新日時が表示され、「資料を追加」も選択できます。解除してもナレッジベースや資料は削除されません。 確認：ナレッジ内の質問は資料を根拠に回答され、資料不足の内容は確認済みの事実として扱われません。

​

専門家を設定する

1. 利用可能なグループを 1 つ以上接続し、クイックスタートのステップ 3「専門家設定」または Waker 詳細 >「専門家設定」を開きます。
2. 「専門家を追加」を選択し、IM チャネルとボットを選びます。専門家は選択したボットを通じて支援依頼を受け取り、訂正に参加します。ボットごとに個別設定が必要です。
3. チャネル機能に応じて検索または手動で追加します。AliDing では社員 ID と名前を手動入力します。DingTalk ボットには 1 対 1 チャット権限も必要です。
4. 簡潔な専門タグを追加し、有効化、支援依頼の受信、回答の確認などの連携設定を確認します。

専門家は Specialist が確認できない質問を処理します。専門家がグループで回答を訂正すると、システムはプライベートチャットで確認を依頼し、ナレッジを修正できます。専門家リストには専門家、IM チャネル、専門タグが表示されます。専門家を削除しても、以後その専門家に依頼しなくなるだけです。

​

基本設定と返信設定を完了する

Q&A Specialist 詳細 >「設定」を開きます。「基本設定」と「返信設定」の 2 つのタブがあります。最初に Specialist の役割と回答原則を定義し、次に出力方法を設定します。 「基本設定」>「ID」で呼称、アバター、主な責任を確認します。名前、アバター、主な責任は編集できますが、テンプレートの説明は参照専用です。 「基本設定」>「ペルソナ」で口調、詳細度、Markdown の使用、不明な質問の扱いを定義します。エディターは Markdown に対応し、保存した内容は継続的な行動指針になります。 「基本設定」>「ルールセット」で「機密境界」「回答根拠」「追加ガイダンス」を個別に管理します。開示できない内容、優先する根拠、チーム固有の方針を定義し、各項目を個別に保存します。 「返信設定」に切り替え、「専門的で慎重」「簡潔で直接的」「明るく親しみやすい」から選択します。言語はユーザーの質問に合わせる、中国語、English から選択できます。業務範囲、機密情報の処理、回答形式を入力し、必要に応じて 11 桁の電話番号、6 桁以上の社員 ID、メールアドレスの送信前マスクを有効にして、「変更を保存」を選択します。 返信設定は「変更を保存」を選択した場合だけ反映されます。「リセット」で今回の編集を破棄できます。回答形式は最大 1,000 文字です。実行可能なルールを記述し、テストアカウント、シークレット、実際の機密情報を例に含めないでください。 ペアリング済みのテストグループで、既知、未知、機密、範囲外の質問を順に検証します。 確認：口調と言語が設定どおりで、既知の質問は現在の方針を参照し、未知または範囲外の質問を確認済みの事実として回答しません。

​

Q&A 記録を確認して継続的に改善する

Q&A Specialist 詳細 >「Q&A 記録」を開きます。「すべて / 処理中 / 処理済み / 専門家支援 / 失敗」で絞り込み、質問、グループまたは 1 対 1 チャット、状態、ユーザーで検索できます。左側でグループを選択し、右側で処理詳細を確認します。

グループと記録を選択し、元の質問、処理状態、返信詳細、専門家連携、失敗理由を確認します。ナレッジや設定を修正後、同様の質問で再検証します。 失敗、未回答、専門家支援の記録を定期的に確認し、停止した位置からボット接続、グループペアリング、ナレッジ検索、専門家フローを診断します。

​

設定が反映されたことを確認する

1. Q&A Specialist のホームで、クイック設定の「ボット設定」と「グループチャット接続」が完了していることを確認します。オプション設定は後で追加できます。
2. 未完了の項目は「設定」を選択します。ボットでは認証情報、接続状態、有効状態を確認します。グループでは「ペアリング済み」と表示されるまで再度ペアリングします。
3. テストグループでボットを @メンションして既知の質問を送り、Q&A 記録で元の質問、処理状態、返信が表示されることを確認します。

​

設定を更新または削除する

​

リリース前の確認リスト

• 基本設定：ボットが「接続済み」で有効になり、1 つ以上のテストグループが「ペアリング済み」です。
• メッセージ：テストグループから送ったメッセージが Q&A 記録に表示され、処理結果を確認できます。
• 返信設定：ID、ペルソナ、返信言語、業務範囲、機密情報処理ルールが保存されています。
• ナレッジベース（必要に応じて）：有効な資料を含むナレッジベースが関連付けられ、既知の質問を検証済みです。
• 専門家支援（必要に応じて）：専門家、IM チャネル、専門タグ、1 対 1 チャット権限が設定され、未知の質問を検証済みです。
• リリース範囲：少数のグループで試用し、回答品質を確認してから接続範囲を拡大します。