mcpField
B
build-zoom-virtual-agent

build-zoom-virtual-agent

github.com/anthropics開発33.6k2.1k 回インストール1 日前に更新
リポジトリ

build-zoom-virtual-agent について

Zoom Virtual AgentをWebサイトやモバイルアプリのWebViewに組み込み、ナレッジベースを同期する開発者向けのリファレンススキルです。Web、Android、iOSの実装経路と関連スキルへの振り分けを扱います。

主な機能

  1. 01Web、Android、iOSの連携ガイド
  2. 02チャットの初期化とライフサイクル
  3. 03ネイティブブリッジとサポートへの引き継ぎ
  4. 04ナレッジベース同期とカスタムAPI連携
  5. 05トラブルシューティングと運用手順

活用シーン

  1. 01顧客属性を付けたWebサイトのチャット起動
  2. 02モバイルアプリのWebViewへのチャット追加
  3. 03ボット会話から有人サポートへの引き継ぎ
  4. 04外部システムからのナレッジベース同期

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/anthropics/knowledge-work-plugins --skill build-zoom-virtual-agent

インストール後、Claude Code で/build-zoom-virtual-agentを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

RUNBOOK.md
android/concepts/
webview-lifecycle.md
android/examples/
js-bridge-patterns.md
android/references/
android-reference-map.md
android/troubleshooting/
common-issues.md
concepts/
architecture-and-lifecycle.md
ios/concepts/
webview-lifecycle.md
ios/examples/
js-bridge-patterns.md
ios/references/
ios-reference-map.md
ios/troubleshooting/
common-issues.md
references/
environment-variables.md
samples-validation.md
versioning-and-drift.md
scenarios/
high-level-scenarios.md
troubleshooting/
common-drift-and-breaks.md
web/concepts/
lifecycle-and-events.md
web/examples/
campaign-and-entry-patterns.md
web/references/
web-reference-map.md
web/troubleshooting/
common-issues.md

詳細

/build-zoom-virtual-agent

以下の分野における Zoom Virtual Agent の背景情報です。

  • Web キャンペーン／チャットの埋め込み。
  • Android WebView ラッパー。
  • iOS WKWebView ラッパー。
  • ナレッジベースの同期とカスタム API による取り込み。

公式ドキュメント：

ルーティングのガードレール

  • Zoom クライアント内に Contact Center アプリの画面を実装する場合は、../contact-center/SKILL.md と連携してください。
  • バックエンドでのナレッジベースの CRUD や自動化スクリプトが必要な場合は、../rest-api/SKILL.md と ../oauth/SKILL.md と連携してください。
  • Web サイトへのボットの埋め込みとキャンペーン制御のみを求めている場合は、web/SKILL.md を使用してください。
  • Web チャットをネイティブアプリでラップする方法について尋ねている場合は、android/SKILL.md または ios/SKILL.md に案内してください。

クイックリンク

  1. concepts/architecture-and-lifecycle.md
  2. scenarios/high-level-scenarios.md
  3. references/versioning-and-drift.md
  4. references/samples-validation.md
  5. references/environment-variables.md
  6. troubleshooting/common-drift-and-breaks.md
  7. RUNBOOK.md

プラットフォーム別スキル：

一般的なライフサイクルパターン

  1. Virtual Agent の管理画面で、キャンペーンまたはエントリー ID を設定します。
  2. Web または WebView のコンテナで SDK を初期化します。
  3. API を呼び出す前に、準備完了（zoomCampaignSdk:ready または waitForReady()）を待ちます。
  4. ネイティブ側での制御が必要な場合は、ブリッジハンドラー（exitHandler、commonHandler、support_handoff）を登録します。
  5. 会話のライフサイクル（engagement_started、engagement_ended）と UI の状態を処理します。
  6. チャットを終了し（endChat）、リスナーをクリーンアップします。

概要シナリオ

  • コンテキストに応じた顧客属性を使用する Web サイトのキャンペーン起動機能。
  • ネイティブの閉じる／引き継ぎブリッジを備えた、モバイルアプリの WebView チャット。
  • システムブラウザーとアプリ内ブラウザーのポリシーに基づく、外部 URL の処理。
  • カスタム API コネクターを使用した、外部システムからのナレッジベース同期。
  • ボットからライブサポートへ、引き継ぎペイロードを使ってエスカレーションする、チーム横断のサポートフロー。

連携

運用

  • RUNBOOK.md - 5 分で実施できる事前確認とデバッグのチェックリスト。

コメント

Markdown 対応