Vapi工作流创建教程：可视化节点构建结构化对话流程与API调用指南

create-workflow by vapiai/skills

278 周安装量

22 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vapiai/skills --skill create-workflow

AI/机器学习自动化 API

🇨🇳中文介绍

Vapi 工作流创建

通过可视化基于节点的流程构建结构化对话工作流。工作流提供对对话步骤、分支逻辑和工具执行的确定性控制。

设置： 确保已设置 VAPI_API_KEY。如有需要，请参阅 setup-api-key 技能。

何时使用工作流与助手

功能	助手	工作流
简单对话	最佳选择	过度设计
多步骤流程	通过良好提示可以工作	最佳选择
确定性流程	难以保证	内置
条件分支	依赖提示	可视化节点
复杂状态管理	困难	原生支持

快速开始

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

在通话中使用工作流

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"
    }
  }'

核心构建块 —— 助手在定义的边界内进行对话：

特定于此步骤的 系统提示
模型和语音 配置
触发转换到其他节点的 退出条件
在节点之间提取和传递的变量

执行一个工具（API 调用、函数）并在后续节点中使用结果。

基于变量或对话状态对流程进行分支。

转移到另一个工作流、助手或电话号码。

[问候] → [收集日期] → [检查可用性（工具）] → [确认预订] → [道别]
                                         ↓ (不可用)
                                 [建议替代方案] → [确认预订]

潜在客户筛选流程

[介绍] → [询问预算] → [询问时间线] → [筛选（条件）]
                                                        ↓ (合格)
                                                  [安排演示]
                                                        ↓ (不合格)
                                                  [发送资源]

[问候] → [识别问题（条件）]
                  ↓ (账单)        ↓ (技术)        ↓ (其他)
            [账单流程]    [技术支持流程]    [一般帮助]

附加到电话号码

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 代理能够访问完整的 Vapi 知识库。使用 searchDocs 工具来查找此技能未涵盖的任何内容 —— 高级配置、故障排除、SDK 详细信息等。

自动配置： 如果您克隆或安装了这些技能，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。

🇺🇸English

Vapi Workflow Creation

Build structured conversation workflows with visual node-based flows. Workflows provide deterministic control over conversation steps, branching logic, and tool execution.

Setup: Ensure VAPI_API_KEY is set. See the setup-api-key skill if needed.

When to Use Workflows vs Assistants

Feature	Assistant	Workflow
Simple conversations	Best choice	Over-engineered
Multi-step processes	Can work with good prompting	Best choice
Deterministic flow	Hard to guarantee	Built-in
Conditional branching	Prompt-dependent	Visual nodes
Complex state management	Difficult	Native support

Quick Start

Workflows are best built in the Vapi Dashboard visual editor at https://dashboard.vapi.ai — but they can also be configured via API.

Dashboard Workflow

Go to https://dashboard.vapi.ai
Navigate to Workflows
Click Create Workflow
Add nodes: Conversation, Tool, Condition, Handoff
Connect nodes to define the flow
Publish and attach to a phone number or call

Using a Workflow in a Call

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"
    }
  }'

Node Types

Conversation Node

The core building block — the assistant has a conversation within defined boundaries:

System prompt specific to this step
Model and voice configuration
Exit conditions that trigger transitions to other nodes
Variables to extract and pass between nodes

Tool Node

Execute a tool (API call, function) and use the result in subsequent nodes.

Condition Node

Branch the flow based on variables or conversation state.

Handoff Node

Transfer to another workflow, assistant, or phone number.

Workflow Patterns

Appointment Scheduling Flow

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

Lead Qualification Flow

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

Support Triage Flow

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

Attaching Workflows

To a Phone Number

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"
  }'

In an Outbound Call

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" }
  }'

References

Vapi Workflows Docs — Official guide
Workflow Examples — Common patterns

Additional Resources

This skills repository includes a Vapi documentation MCP server (vapi-docs) that gives your AI agent access to the full Vapi knowledge base. Use the searchDocs tool to look up anything beyond what this skill covers — advanced configuration, troubleshooting, SDK details, and more.

Auto-configured: If you cloned or installed these skills, the MCP server is already configured via .mcp.json (Claude Code), .cursor/mcp.json (Cursor), or .vscode/mcp.json (VS Code Copilot).

Manual setup: If your agent doesn't auto-detect the config, run:

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

See the README for full setup instructions across all supported agents.

Weekly Installs

278

Repository

vapiai/skills

GitHub Stars

First Seen

Feb 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

cursor249

kimi-cli244

gemini-cli244

github-copilot244

amp244

codex244

AI Elements：基于shadcn/ui的AI原生应用组件库，快速构建对话界面

56,200 周安装

Vapi工作流创建教程：可视化节点构建结构化对话流程与API调用指南

🇨🇳中文介绍

Vapi 工作流创建

何时使用工作流与助手

快速开始

相关 Skills

仪表板工作流

在通话中使用工作流

节点类型

对话节点

工具节点

条件节点

转接节点

工作流模式

预约安排流程