Dograh工作流构建器入门：可视化编排语音对话的7大节点全解

Dograh工作流构建器入门可视化编排语音对话的7大节点全解【免费下载链接】dograhOpen source voice AI platform. Self-hosted alternative to Vapi and Retell. On Prem, BYOK across Speech to Speech or LLM/STT/TTS, with a visual workflow builder, MCP native and telephony support.项目地址: https://gitcode.com/GitHub_Trending/do/dograhDograh 是一个开源的语音 AI 平台也是 Vapi 与 Retell 的自托管替代品。它的核心亮点之一是可视化工作流构建器你不需要写一大段提示词而是用节点和路径把一通电话的对话流程画出来。本文带你快速认识这套 Dograh 工作流构建器并逐一拆解 7 大节点——Start Call、Agent、Global、QA、API Trigger、End Call 和 Webhook帮助新手零基础搭建自己的第一个语音 Agent。图模型节点 路径把工作流画出来Dograh 的工作流是一个有向图节点Node对话的某个阶段或动作比如问候来电者、收集地址、转接电话路径Pathway/Edge连接节点之间的路线LLM 会根据对话内容在运行时自动选择走哪条路。官方文档对图模型的定义见 docs/voice-agent/introduction.mdx节点属性规格的实现代码在api/services/workflow/node_specs/目录MCP 侧的发现工具在api/mcp_server/tools/node_types.py。3 步快速上手创建你的第一个工作流从仪表盘新建 Agent选择 Inbound呼入或 Outbound呼出并描述使用场景系统会把描述发给 LLM 自动生成一份带默认提示词和路径的起始工作流编辑节点打开任意节点修改 Prompt、Greeting、路径条件等配置用 Web Call 测试在 Agent 编辑器里直接发起网页通话测试无需配置任何电话系统。完整的节点与路径编辑细节见docs/voice-agent/editing-a-workflow.mdx。测试时你可以实时查看对话历史确认 Agent 的回答是否符合预期节点一Start Call——通话的唯一起点Start Call 是每通对话的入口通话接通的那一刻它就触发。每个工作流有且只能有一个 Start Call 节点。它的关键配置包括Greeting Text接通瞬间用 TTS 播放的固定开场白支持{{模板变量}}Prompt开场对话回合的系统指令必填Detect Voicemail检测到语音信箱自动挂断Delayed Start外呼场景下延迟 0.1~10 秒再开口。每个出边都需要一个Label标签和一段自然语言写的 Condition条件LLM 读取对话后自动选择最匹配的出边。字段详解见docs/voice-agent/start-call.mdx。节点二Agent——核心对话阶段Agent 节点承载某个阶段说什么、做什么的提示词是工作流中出现最多的节点。它支持Allow Interruption开启后用户可以随时打断机器人大多数节点默认开启变量提取在 Agent 和 End Call 节点上可开启LLM 会在该回合结束后把对话中的结构化信息客户姓名、预算、意向等提取到gathered_contextTools为当前阶段挂载 HTTP API、内置工具或 MCP 工具。开启变量提取后你可以为每个变量定义名称、类型和描述节点三Global——全工作流共享的人设Global 节点存放整通电话通用的指令公司背景、Agent 总体目标、语气与性格、常见异议处理等。它不直接参与对话而是把内容前缀注入到每一个开启了Add Global Prompt开关的节点提示词里——这样你改一次人设全链路生效。用法详见docs/voice-agent/global.mdx。节点四End Call——每个分支的出口End Call 节点配置通话结束前 Agent 说的最后一句话。它可以有多个每个分支都可以有不同的结束语例如预约成功和错号分别礼貌收尾每个 End Call 可以有自己的 Prompt也支持变量提取。说明见docs/voice-agent/end-call.mdx。节点五QA——挂断后的自动质检QA 节点在通话结束后运行它读取完整转写文本用 LLM 按你定义的标准做质量评估输出结构化 JSON——标签如USER_FRUSTRATED、USER_DETECTS_AI、1~10 分质量评分、情绪、摘要。你还可以设置采样率如只对 50% 的通话质检和最短通话时长。两个要点QA 节点没有连线不能连到其他节点它也只读不改完全不影响通话行为。配置详见docs/voice-agent/qa.mdx。节点六API Trigger——让外部系统发起外呼API Trigger 为你的工作流暴露一个端点外部系统n8n、Zapier 或你自己的后端发一个请求就能触发外呼并可通过initial_context传入客户姓名、账单金额等变量直接用于开场白。这是从你的系统打电话的核心能力见docs/voice-agent/api-trigger.mdx。节点七Webhook——把通话结果推给外部系统Webhook 节点在每次运行结束时把通话数据推送到你指定的端点典型用途存入 CRM、触发自动化流程、同步下游系统。与 API Trigger 正好构成一进一出一个负责打进来一个负责送出去。配置见docs/voice-agent/webhook.mdx。进阶能力工具、知识库与模板变量节点之外Dograh 还提供四组超能力能力作用文档工具Tools让 LLM 在对话中调用外部 API、转接电话或 MCP 服务docs/voice-agent/tools/introduction.mdx知识库挂载文档通话中 Agent 可检索引用docs/voice-agent/knowledge-base.mdxPre-Call Data Fetch通话开始前先 POST 一次把 JSON 合并进上下文docs/voice-agent/pre-call-data-fetch.mdx预录音在 LLM 语音中混入真实录音片段docs/voice-agent/pre-recorded-audio.mdx模板变量则是贯穿其中的胶水在提示词和载荷中用{{initial_context.字段名}}引用通话上下文。在编辑器里你可以直接添加测试变量注意如果引用了请求载荷中不存在的变量Agent 会把占位符原文念出来——上线前务必用完整载荷测试一遍详见docs/voice-agent/template-variables.mdx。新手常见 4 个坑加了第二个 Start Call一个工作流只能有一个入口重复添加会直接报错Greeting 和 Prompt 都留空通话开头一片寂静把节点名当成 Agent 自我介绍节点名只是画布标签Agent 自报的身份来自提示词或 Global 节点给 QA 节点连线QA 是独立评估器没有出边画布上连不上。写在最后一句话总结 7 大节点的角色分工Start Call 开场 → Agent 推进对话 → Global 统一人设 → End Call 收尾 → QA 事后质检 → API Trigger 负责触发 → Webhook 负责回传。按docs/voice-agent/introduction.mdx中的路径起步先学会编辑工作流再用 Web Call 立即测试配置好电话服务商后即可上线最后用 API Trigger 和 Webhook 打通你自己的业务系统。现在打开仪表盘画出你的第一个语音 Agent 吧 【免费下载链接】dograhOpen source voice AI platform. Self-hosted alternative to Vapi and Retell. On Prem, BYOK across Speech to Speech or LLM/STT/TTS, with a visual workflow builder, MCP native and telephony support.项目地址: https://gitcode.com/GitHub_Trending/do/dograh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考