Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What are Guidelines?

Guidelines define condition-response pairs for handling edge cases:
  • Condition — When this situation occurs…
  • Response — …the assistant should respond this way
Guidelines are best suited for behavioral guidance (how to handle a situation), not factual information (what to say). Put specific data like pricing, hours, or product details in the Knowledge Base. Guidelines are a fallback for information not available in the Knowledge Base. For specific facts, data, or detailed information the assistant should know, use the Knowledge Base instead.

​
How Guidelines Work

Guidelines can be input from the script builder under the “Guidelines” section. When generating a response, the AI considers all active guidelines and applies relevant ones based on the conversation context. Guidelines directly influence the assistant’s behaviour, shaping tone, personality, and how it handles specific situations. However, some behaviours have inherent limitations — see Assistant Behaviour for details.

​
Writing Guidelines

Each guideline has two parts:
FieldPurposeExample
ConditionDescribes when the guideline applies”User asks about pricing”
ResponseDescribes how the assistant should respond”Direct them to the website”

​
Examples

Handling Pricing Questions: 
Condition: User asks about pricing or costs
Response: Explain that pricing varies by needs and offer to have a specialist follow up with detailed pricing information
Technical Questions: 
Condition: User asks highly technical questions beyond scope of knowledge
Response: Note their question and offer to have a technical specialist contact them with detailed information
Emotional Situations: 
Condition: User expresses frustration or anger
Response: Acknowledge their feelings, apologize for any inconvenience, and focus on finding a resolution

​
Best Practices

Guidelines shape assistant behaviour including tone and response style, but some behaviours have limitations. Keep these tips in mind:
  1. Be specific with conditions — Vague conditions may trigger unexpectedly or be missed entirely
  2. Keep responses actionable — Tell the assistant what to do, not just what to avoid
  3. Don’t duplicate flow logic — Use guidelines for cross-cutting concerns, not primary conversation paths
  4. Test edge cases — Verify guidelines work as expected in real conversations
  5. Prioritize safety — Include guidelines for handling sensitive topics appropriately

​
Common Use Cases

Use CaseExample ConditionExample Response
Scope boundariesUser asks about unrelated servicesPolitely explain our focus and offer relevant alternatives
ComplianceUser requests medical/legal/financial adviceClarify we cannot provide professional advice and recommend consulting a specialist
EscalationUser requests to speak with a humanAcknowledge the request and initiate warm handoff
Data privacyUser asks what data we collectExplain our privacy practices and offer to send our privacy policy

​
Next Steps