mirror of
https://github.com/dograh-hq/dograh.git
synced 2026-07-25 12:01:04 +02:00
96cde1b767
* docs: flesh out stub node pages for Global, Start Call, Agent, End Call, QA Each page was previously a stub (1 sentence or a single <Note>). Now contains: - Plain-English explanation of what the node does and when it runs - Fields/configuration reference - Common mistakes section - Next Steps with CardGroup links Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: fix heading structure, Warning placement, variable formatting in node pages - qa.mdx: promote Viewing QA Results from h3 to h2 (was incorrectly nested under Where it sits on the canvas) - end-call.mdx: move Warning inside Common Mistakes, directly after the bullet it relates to - start-call/agent/end-call/qa.mdx: wrap bare gathered_context and initial_context in backticks in Card descriptions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: correct node page errors found by cross-checking against live API + DTO start-call: - Fix Node Name description (canvas label, not agent spoken name) - Split Greeting Text and Prompt into separate documented fields (were conflated) - Add Delayed Start field (real config option, was missing entirely) - Fix Common Mistakes (remove wrong Agent Name claim) - Add Pre-recorded Audio note with link end-call: - Remove incorrect <Note> claiming one End Call per workflow - DTO has no max_instances constraint; llm_hint explicitly says multiple are supported - Fix Common Mistakes to reflect correct guidance (multiple allowed) agent: - Add Extracting variables section documenting extraction_enabled, extraction_prompt, extraction_variables fields with a concrete example Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: fix field names and QA model against live platform schemas - qa.mdx: replace fictional criteria-list concept with accurate qa_system_prompt field; document default output format (tags, score, sentiment, summary); add sampling/duration/voicemail filter settings - global.mdx: correct prompt-merge order (global prepended, not appended) - start-call.mdx: update stale "Greeting Prompt" reference in common mistakes to match renamed field "Greeting Text" Verified against live node schemas via Dograh MCP get_node_type. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: fix em dash violations and appended/prepended contradiction - global.mdx: "silently appended" contradicted "global content first"; changed to "prepended" for internal consistency and schema accuracy - qa.mdx: remove two em dashes (hard no per style rules) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: correct node docs against live workflow SDK evidence - start-call: replace invented fixed edge labels with accurate explanation that edge labels and conditions are user-defined; add real examples - end-call: rename "Final Message" to "Prompt" to match SDK field name used in all real workflows; update all references - global: add Start Call to Add Global Prompt toggle coverage (startCall has add_global_prompt: true by default per schema) - qa: replace informal tag descriptions with actual default tag names from the qa_system_prompt schema All changes verified against live Dograh MCP node schemas and real workflow SDK code (workflow IDs 7764, 8291). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: flesh out all 5 voice agent node pages with accurate UI fields Complete rewrite of stub docs for global, start-call, agent, end-call, and qa nodes. Field names, toggle labels, and section headings now match the actual Dograh UI exactly. Covers all fields visible in each node edit panel including Allow Interruption, Add Global Prompt, Delayed Start, Enable Variable Extraction, Pre-Call Data Fetch, and QA settings table. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: remove Allow Interruption from End Call node End Call does not expose an Allow Interruption toggle in the UI. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: address cubic and greptile review comments on node pages - agent.mdx, end-call.mdx: remove/correct gathered_context claims - it is not available in any node's Prompt, only in Webhook payloads and the run record (confirmed against context-and-variables.mdx) - global.mdx: fix appended -> prepended in frontmatter description and Common Mistakes (contradicted How It Works section) - introduction.mdx: update End Call node-type table - multiple End Call nodes are supported, not just one - agent.mdx, end-call.mdx, qa.mdx, start-call.mdx: tag bare code fences as text for Mintlify syntax highlighting - global.mdx, start-call.mdx, agent.mdx, end-call.mdx, qa.mdx: convert absolute internal links to relative paths per style guide * docs: embed video tutorials on all 5 node pages, fix cubic grammar comment - Add Video Tutorial section (iframe embed) to global, start-call, agent, end-call, and qa node pages, matching the pattern already used in webhook.mdx - global.mdx: fix "Global Node contain" -> "Global Node contains" in frontmatter description, per cubic review on09c5ff31* docs: fix appended/prepended in introduction.mdx node table Global node's node-type summary still said the prompt is "appended" after Add Global Prompt is enabled, contradicting the corrected "prepended" behavior documented everywhere else. Caught by greptile P1 review on commitb7fe2d0d. --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
53 lines
4.1 KiB
Text
53 lines
4.1 KiB
Text
---
|
|
title: "Voice Agent Builder"
|
|
description: "Dograh's voice agent builder lets you design a conversation as a graph of nodes and pathways. Learn the graph model, the available node types, and where to start."
|
|
---
|
|
|
|
|
|
|
|
The Voice Agent Builder is a visual, graph-based editor for designing what your voice agent says and does during a call. Instead of writing one giant prompt, you break the conversation into **nodes** (stages of the conversation) connected by **pathways** (the routes the LLM can take between stages, based on how the conversation is going).
|
|
|
|
You can create a new agent from the [dashboard](https://app.dograh.com/workflow). Describe whether you need an "Inbound" or "Outbound" agent and your use case — this is sent to an LLM to generate a starting workflow with default prompts and pathways, which you can then edit.
|
|
|
|
## The graph model
|
|
|
|
A workflow is a directed graph:
|
|
|
|
- **Nodes** represent a stage of the conversation or an action (e.g. greet the caller, collect an address, transfer the call).
|
|
- **Pathways (edges)** connect nodes and represent the routes the LLM can take depending on what the caller says. The LLM decides at runtime which pathway to follow.
|
|
|
|
A workflow should have only one **Start Call** node and typically ends at an **End Call** node, with **Agent** nodes and other node types in between. See [Editing a Workflow](/voice-agent/editing-a-workflow) for how nodes, pathways, and node-level toggles fit together.
|
|
|
|
## Node types
|
|
|
|
| Node | What it does |
|
|
| --- | --- |
|
|
| [**Start Call**](/voice-agent/start-call) | Starts the call and configures the agent's greeting. Should have only one per workflow. |
|
|
| [**Agent**](/voice-agent/agent) | Holds the prompt that drives conversation at a given stage; connects to other nodes via pathways. |
|
|
| [**Global**](/voice-agent/global) | Common instructions (tone, objection handling) prepended to every node with "Add Global Prompt" enabled. |
|
|
| [**QA**](/voice-agent/qa) | Runs automated post-call quality analysis against criteria you define. |
|
|
| [**API Trigger**](/voice-agent/api-trigger) | Exposes an endpoint so external systems (n8n, Zapier, your backend) can start outbound calls. |
|
|
| [**End Call**](/voice-agent/end-call) | Configures the agent's final message before the call is terminated. A workflow can have multiple End Call nodes, each with a distinct Prompt. |
|
|
| [**Webhook**](/voice-agent/webhook) | Sends call results to an external system (CRM, Zapier, n8n) when a run ends. |
|
|
|
|
Beyond nodes, you can extend an agent with:
|
|
|
|
- [**Tools**](/voice-agent/tools/introduction) — let the LLM call external APIs, transfer calls, or invoke MCP servers mid-conversation.
|
|
- [**Knowledge Base**](/voice-agent/knowledge-base) — attach documents the agent can reference during a call.
|
|
- [**Pre-Call Data Fetch**](/voice-agent/pre-call-data-fetch) — enrich context with an HTTP call before the agent starts speaking.
|
|
- [**Pre-recorded Audio**](/voice-agent/pre-recorded-audio) — mix in real recordings alongside LLM-generated speech.
|
|
- [**Template Variables**](/voice-agent/template-variables) — reference `initial_context` and `gathered_context` values in prompts and payloads.
|
|
|
|
## Where to start
|
|
|
|
1. **New to Dograh?** Follow [Editing a Workflow](/voice-agent/editing-a-workflow) to learn the fundamentals of nodes and pathways.
|
|
2. **Want to test immediately?** Use a [Web Call](/core-concepts/calls-and-runs#web-calls) from the agent editor — no telephony setup required.
|
|
3. **Ready to go live?** Configure a [telephony provider](/integrations/telephony/overview) and add an [API Trigger](/voice-agent/api-trigger) or set up inbound routing.
|
|
4. **Need the call to hit your systems?** Add a [Webhook](/voice-agent/webhook) node to sync results to your CRM or automation tool.
|
|
5. **Want to embed the agent on a website?** See [Add to Website](/voice-agent/add-to-website).
|
|
|
|
## Related
|
|
|
|
- [Core Concepts: Workflows and Agents](/core-concepts/workflows-and-agents)
|
|
- [Core Concepts: Context & Variables](/core-concepts/context-and-variables)
|
|
- [Editing a Workflow](/voice-agent/editing-a-workflow)
|