关于 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
- 添加节点:对话、工具、条件、移交
- 连接节点以定义流程
- 发布并将其关联到电话号码或通话
在通话中使用工作流
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 调用、函数),并在后续节点中使用结果。
条件节点
根据变量或对话状态对流程进行分支。
移交节点
转到另一个工作流、助手或电话号码。
工作流模式
预约安排流程
[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.json(Claude Code)、.cursor/mcp.json(Cursor)或 .vscode/mcp.json(VS Code Copilot)配置好 MCP 服务。
**手动设置:**如果你的 Agent 未自动检测到配置,请运行:
claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server
请参阅 README,了解所有受支持 Agent 的完整设置说明。
评论
支持 Markdown