Skip to main content
機能

スキルと統合

Skill、コネクタ、IM チャネルを通じて Waker の能力を拡張します。スキルのインストール、MCP サービスの設定、インスタントメッセージングセッションの管理を行います。

Skill は再利用可能な作業方法を提供し、コネクタは Waker に外部アプリケーションや MCP ツールを呼び出させ、IM チャネルは外部の会話からメッセージを Waker に届けます。それぞれ異なる役割を持ちます:
エントリーポイントの選択: 作業方法は「スキル」でインストール、外部ツールと DingTalk DWS は「コネクタ」で設定、外部会話は「IM」でペアリング。

Skill のインストールと管理

スキルマーケットからのインストール

  1. 対象の Waker →「スキル」→「スキルマーケット」に入ります。
  2. 対象の Skill を検索して開き、用途とソースを確認してから「インストール」をクリックします。
  3. 「マイスキル」でステータスが「インストール済み」であることを確認します。
Figure 7-1
Waker の職責に直接関連する Skill のみをインストールし、同種の能力の競合を避けてください。

カスタム Skill のアップロード

  1. 「スキル」ページで「Skill をアップロード」をクリックし、.md ファイルまたはサポートされるアーカイブを選択します。
  2. .md ファイルには namedescription が必要です。アーカイブには SKILL.md が含まれている必要があります。
  3. アップロード後、「マイスキル」で結果を確認します。
出所不明の Skill や機密ディレクトリを読み取る Skill をアップロードしないでください。アップロード前に SKILL.md とその参照コンテンツを確認してください。 変更後の検証: ロールバックまたはアンインストールが必要な場合は、「マイスキル」→ 対象の Skill →「その他の操作」に入ります。操作前に、自動タスクや WakerFlow がその Skill に依存しているか確認してください。変更後は新しい会話を開始し、最小限のタスクで検証します。 完了判断: 現在のバージョンまたはインストール状態が期待どおり。新しい会話で能力の変更が有効になっている。その Skill に依存するワークフローで能力欠落エラーが発生していない。 インストールまたはアップロードが失敗した場合は、ネットワーク、ファイル構造、同名バージョンを確認してから再試行してください。

コネクタと MCP サービスの追加

コネクタは外部アプリケーションと MCP サービスを管理します。Waker 詳細 →「コネクタ」に入り、設定ソースに応じて追加方法を選択します:
現在の状況選択
製品内蔵サービスを使用(例:DingTalk DWS)「システム」
ページで提供されるアプリケーション統合を使用「アプリケーション」
単一のカスタム MCP サービスを新規追加「手動設定入力」
完全な mcpServers 設定が既にある「JSON 設定を貼り付け」
Figure 7-2
カスタム MCP の追加:
  1. 「アプリケーション」で「追加」をクリックします。
  2. 単一サービスの情報のみの場合は「手動設定入力」を選択し、名前、起動コマンドまたはサーバーアドレスを入力し、必要に応じて環境変数、Headers、タイムアウトを設定します。
  3. 完全な設定がある場合は「JSON 設定を貼り付け」を選択し、mcpServers を含む完全な JSON を貼り付け、ページがサービスを正しく認識したことを確認して「インポート」をクリックします。
  4. 保存前にコマンドまたは URL が到達可能であることを確認し、必要なディレクトリのみを開放します。資格情報は保護された環境変数に保存します。
認可と検証: 追加またはインポート後、以下の手順で操作します:
  1. ステータスが「認可が必要」の場合は認可を完了します。
  2. 「検出」または「再検出」をクリックし、ステータスが「接続済み」になるのを待ちます。
  3. ツールを更新し、現在の Waker が必要なツールのみを有効にします。
  4. 新しい会話を開始し、最小限のタスクで呼び出しを検証します。
ステータスが「接続済み」でない、またはツール数が 0 の場合は、設定、認可、起動コマンドを再確認してから検出を実行します。

DingTalk DWS MCP の有効化と検証

DingTalk DWS MCP は「システム」コネクタで、認可された範囲内で DingTalk グループメッセージの読み取り、要約、送信が可能です。
  1. 対象の Waker →「コネクタ」→「システム」に入り、「DingTalk DWS」を見つけます。
  2. ページの指示に従って DWS CLI をインストール、更新、または認可します。
  3. ページを更新し、コネクタのステータスが「接続済み」であることを確認します。
Figure 7-3
Figure 7-4
認可後はまず通常の会話で検証します:テストグループの少数のメッセージを読み取り、サマリーを生成し、指定のテストグループに固定テキストを送信します。
Figure 7-5
完了判断: DWS ツールの呼び出しが成功し、読み取りと送信の対象が正しく、サマリーが元のメッセージと一致している。本番で自動メッセージ送信を有効にする前に、対象グループと送信頻度を制限し、タスク説明に「エラー時は送信しない」と明記してください。コネクタの変更後は新しい会話を開いてテストしてください。

IM チャネルとセッションペアリングの設定

メインナビゲーションの「IM」はチャネルとセッションを一元管理するために使用します。Waker 詳細の「IM」はその Waker が現在担当しているセッションを表示します。
Figure 7-6

チャネルの新規追加

  1. 「IM」→「チャネル設定」→「チャネルを追加」に入ります。
  2. チャネルを選択し、ウィザードに従って認可を完了するか資格情報を入力します。
  3. ペアリングモード、応答 Waker、モデル、作業ディレクトリを設定します。本番環境ではペアリングモードを優先的に使用します。
  4. 保存してステータスが「接続済み」であることを確認します。
利用可能なチャネルは現在のアカウントとページによって異なります。

ペアリングリクエストの処理

  1. 「IM」→「セッション管理」→「処理待ちペアリングリクエスト」に入ります。
  2. セッション名、発信者、チャネル、タイプを確認します。
  3. 応答 Waker、モデル、作業ディレクトリを選択し、「許可」をクリックします。信頼できないリクエストは「無視」を選択します。
  4. 「ペアリング済みセッション」でステータスが「アクティブ」であることを確認します。
「ペアリングを追加」を使用してグループチャットやダイレクトメッセージを手動で選択することもできます。
Q&A Specialist のペアリング:Waker ホームのクイック設定から、ボットとグループ接続をまとめて設定します。ペアリング時に WakerFlow を選択する必要はありません。ボットが接続済みで有効なことを確認し、テストグループで @メンションして申請を作成します。手動ペアリングも利用できます。

メッセージパイプラインの検証

  1. チャネルが接続され、対象の Waker が実行中であることを確認します。
  2. ペアリング済みセッションからテストメッセージを送信します。
  3. 返信に使用された Waker、モデル、作業ディレクトリを確認します。必要に応じて機密でない添付ファイルを検証します。
メッセージまたはペアリングに問題がある場合、通常の Waker ではチャネル接続、ペアリング状態、応答 Waker、作業ディレクトリを確認します。Q&A Specialist では、クイック設定のボットとグループ状態、および Q&A 記録も確認します。 「DingTalk ユーザー」などの代理送信モードは、本人の ID で AI の返信を送信します。有効にする前に、監視するセッションの範囲を厳格に制限し、自動返信の内容に対して責任を持ってください。 統合のリリース前チェック:
  • 最小権限で Skill、コネクタ、IM チャネルを有効にします。まず読み取り専用の能力を検証し、その後で書き込みやメッセージ送信の能力を開放します。
  • Token、Cookie、AppSecret、個人アクセストークンは保護された資格情報または環境変数に保存し、本文、ログ、スクリーンショットに記載しないでください。
  • 統合を削除または変更する前に依存関係を確認し、変更後は新しい会話で最小限の検証を行ってください。