> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiceblox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompting Tips

> Best practices and example prompts for getting great results from the AI flow generator.

# Prompting Tips

## Be specific about conversation structure

The AI works best when you describe the flow structure explicitly.

**Too vague:**

> Make a customer support agent

**Better:**

> Build a customer support agent with: a greeting step, a single triage question (billing or technical), and two branches — billing goes to a Burst node for 3 exchanges then End, technical goes to Open Talk then End.

## Describe branches explicitly

When you want conditional logic, describe the condition and both outcomes.

```
Add an If/Else node after the first Burst step.
Condition: "Did the user say they want to upgrade?"
- If true: go to a new Burst node with command "Great! Let me walk you through our plans."
- If false: go to End with command "No problem, let me know if you need anything else."
```

## Reference existing nodes

When editing, you can refer to nodes by their role or command content.

```
Change the greeting in the Start node to: "Hi! Welcome to Acme Support. How can I help you today?"
```

```
Add a Webhook node after the End node that posts to https://example.com/webhook
```

## Use cases and example prompts

### Customer support triage

```
Build a voice agent for Acme SaaS support:
1. Greeting step (literal): "Thank you for calling Acme Support."
2. Burst (1 round): ask the customer for their account email
3. Categorize into: Billing, Technical, Cancel — each routing to a separate Burst
4. Each branch ends with an End node
Use OpenAI GPT-4 for LLM, ElevenLabs for TTS, Deepgram for STT.
```

### Sales qualification

```
Build a sales qualification agent:
1. Start: introduce the agent and ask what the prospect is looking for
2. Open Talk: let them describe their needs freely
3. If/Else: "Is the prospect a good fit for our enterprise plan?"
   - Yes: Burst with 2 rounds to schedule a demo
   - No: End with a polite message
```

### Appointment reminder

```
Build a short outbound reminder agent:
1. Start (literal): "Hi [name], this is a reminder about your appointment tomorrow at 2pm."
2. Burst (1 round): ask if they can make it
3. If/Else: "Did they confirm the appointment?"
   - Yes: End with "Great, see you then!"
   - No: Burst to reschedule, then End
```

## Common mistakes

* **Putting If/Else directly after Start** — not allowed. You need at least one Burst, Open Talk, or Timer between Start and a branching node.
* **Forgetting to specify a separate LLM for branching nodes** — If/Else and Categorize need their own LLM connection.
* **Not specifying `isLiteral`** — if you want the agent to speak exact words, say "speak this verbatim" or "set isLiteral to true".