create-workflow について
Vapiの会話ワークフローをビジュアルノードで作成するスキルです。分岐、ツール実行、引き継ぎを含む複数段階の通話フローに向いています。
主な機能
- 01会話、ツール、条件、引き継ぎのノード
- 02会話ステップ間での変数受け渡し
- 03変数や会話状態による分岐
- 04電話番号や通話へのワークフロー設定
活用シーン
- 01予約受付の通話フロー作成
- 02見込み客の評価と次のステップへの分岐
- 03問い合わせ種別に応じたサポート通話の振り分け
MCP 対応
スキルリポジトリには `vapi-docs` という Vapi ドキュメント MCP サーバーが含まれます。`searchDocs` ツールで Vapi のドキュメントを検索できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vapiai/ skills --skill create-workflowインストール後、Claude Code で/create-workflowを入力して読み込まれたか確認します。
詳細
Vapi ワークフローの作成
ビジュアルなノードベースのフローを使って、構造化された会話ワークフローを構築します。ワークフローを使用すると、会話の手順、分岐ロジック、ツールの実行を決定論的に制御できます。
セットアップ:
VAPI_API_KEYが設定されていることを確認してください。必要に応じて、setup-api-keyスキルを参照してください。
ワークフローとアシスタントの使い分け
| 機能 | アシスタント | ワークフロー |
|---|---|---|
| シンプルな会話 | 最適な選択肢 | 過剰な設計 |
| 複数ステップのプロセス | 適切なプロンプトがあれば可能 | 最適な選択肢 |
| 決定論的なフロー | 保証が難しい | 組み込み |
| 条件分岐 | プロンプトに依存 | ビジュアルノード |
| 複雑な状態管理 | 難しい | ネイティブでサポート |
クイックスタート
ワークフローの構築には、https://dashboard.vapi.ai の Vapi ダッシュボードビジュアルエディターが最適ですが、API を使って設定することもできます。
ダッシュボードでのワークフロー
- https://dashboard.vapi.ai にアクセスします
- Workflows に移動します
- Create Workflow をクリックします
- ノードを追加します:Conversation、Tool、Condition、Handoff
- ノードを接続してフローを定義します
- 公開し、電話番号または通話に割り当てます
通話でのワークフローの使用
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 ノード
中核となる構成要素です。定義された範囲内でアシスタントが会話します。
- システムプロンプト:このステップに固有のもの
- モデルと音声の設定
- 終了条件:ほかのノードへの遷移をトリガーします
- 変数:抽出してノード間で渡します
Tool ノード
ツール(API 呼び出し、関数)を実行し、その結果を後続のノードで使用します。
Condition ノード
変数または会話の状態に基づいてフローを分岐させます。
Handoff ノード
別のワークフロー、アシスタント、または電話番号に転送します。
ワークフローのパターン
予約スケジュールのフロー
[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 ワークフローのドキュメント — 公式ガイド
- ワークフローの例 — よくあるパターン
追加リソース
このスキルリポジトリには、AI エージェントが Vapi のナレッジベース全体にアクセスできる Vapi ドキュメント MCP サーバー(vapi-docs)が含まれています。このスキルの対象外となる高度な設定、トラブルシューティング、SDK の詳細などを調べるには、searchDocs ツールを使用してください。
自動設定: これらのスキルをクローンまたはインストールすると、MCP サーバーは .mcp.json(Claude Code)、.cursor/mcp.json(Cursor)、または .vscode/mcp.json(VS Code Copilot)を通じてすでに設定されています。
手動セットアップ: エージェントが設定を自動検出しない場合は、次を実行してください。
claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server
サポートされているすべてのエージェントでのセットアップ手順については、README を参照してください。