Vapi ワークフロー作成

ビジュアルなノードベースのフロー機能を使って、構造化された会話ワークフローを構築します。ワークフローは、会話ステップ、分岐ロジック、ツール実行に対する決定論的な制御を提供します。

セットアップ: VAPI_API_KEY が設定されていることを確認してください。必要に応じて setup-api-key スキルを参照してください。

ワークフローと Assistant の使い分け

機能	Assistant	ワークフロー
シンプルな会話	最適な選択肢	過度な設計
マルチステップ処理	適切なプロンプトでも機能	最適な選択肢
決定論的フロー	保証が難しい	組み込み機能
条件分岐	プロンプト依存	ビジュアルノード
複雑な状態管理	困難	ネイティブサポート

クイックスタート

ワークフローは Vapi ダッシュボード のビジュアルエディタ (https://dashboard.vapi.ai) で構築するのが最適ですが、API経由で設定することもできます。

ダッシュボードワークフロー

1. https://dashboard.vapi.ai にアクセス
2. Workflows に移動
3. Create Workflow をクリック
4. ノードを追加: Conversation、Tool、Condition、Handoff
5. ノードを接続してフローを定義
6. 公開して電話番号またはコールに添付

コール内でワークフローを使用

curl -X POST https://api.vapi.ai/call \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflowId": "your-workflow-id",
    "phoneNumberId": "your-phone-number-id",
    "customer": {
      "number": "+11234567890"
    }
  }'

ノードタイプ

Conversation Node (会話ノード)

コアとなる構成要素 — assistant が定義された範囲内で会話を行います:

• System prompt - このステップ固有のプロンプト
• Model and voice configuration - モデルと音声の設定
• Exit conditions - 他のノードへの遷移をトリガーする終了条件
• Variables - ノード間で抽出して渡す変数

Tool Node (ツールノード)

ツール (API呼び出し、関数) を実行し、その結果を後続のノードで使用します。

Condition Node (条件ノード)

変数または会話の状態に基づいてフローを分岐させます。

Handoff Node (ハンドオフノード)

別のワークフロー、assistant、または電話番号に転送します。

ワークフローパターン

予約スケジューリングフロー

[Greeting] → [Collect Date] → [Check Availability (Tool)] → [Confirm Booking] → [Goodbye]
                                         ↓ (unavailable)
                                 [Suggest Alternatives] → [Confirm Booking]

リード認定フロー

[Introduction] → [Ask Budget] → [Ask Timeline] → [Qualify (Condition)]
                                                        ↓ (qualified)
                                                  [Schedule Demo]
                                                        ↓ (not qualified)
                                                  [Send Resources]

サポート トリアージフロー

[Greeting] → [Identify Issue (Condition)]
                  ↓ (billing)        ↓ (technical)        ↓ (other)
            [Billing Flow]    [Tech Support Flow]    [General Help]

ワークフローの添付

電話番号に添付

curl -X PATCH https://api.vapi.ai/phone-number/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflowId": "your-workflow-id"
  }'

アウトバウンドコール内

curl -X POST https://api.vapi.ai/call \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflowId": "your-workflow-id",
    "phoneNumberId": "your-phone-number-id",
    "customer": { "number": "+11234567890" }
  }'

リファレンス

• Vapi ワークフロー ドキュメント — 公式ガイド
• ワークフロー例 — 一般的なパターン

追加リソース

このスキルリポジトリには、Vapi ドキュメント MCP サーバー (vapi-docs) が含まれており、AI agent に Vapi の知識ベース全体へのアクセスを提供します。searchDocs ツールを使用して、このスキルで扱っていない高度な設定、トラブルシューティング、SDK の詳細情報など、あらゆることを検索できます。

自動設定: これらのスキルをクローンまたはインストールした場合、MCP サーバーは .mcp.json (Claude Code)、.cursor/mcp.json (Cursor)、または .vscode/mcp.json (VS Code Copilot) 経由で既に設定されています。

手動セットアップ: agent が設定を自動検出しない場合は、次のコマンドを実行してください:

claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server

サポートされているすべての agent 全体での設定手順については、README を参照してください。