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 is a Function Step?
A Function Step runs backend logic without voice interaction:
- Prepare inputs — Gather values from variables
- Execute logic — Run the function’s defined operations
- Produce outputs — Generate results and a boolean outcome
- Navigate — Move to the next step based on success/failure
Why Use Functions?
Functions handle operations that LLMs struggle with:
| Operation | Why Functions Are Better |
|---|
| Email validation | Regex patterns are precise; LLMs guess |
| Phone number formatting | Exact format checking required |
| Date calculations | Math must be exact |
| Data lookups | Database queries need precision |
| Price calculations | Financial math can’t be approximate |
Function Step Structure
| Property | Description | Required |
|---|
function_id | Which function to execute | Yes |
script | Optional message while processing | No |
input_map | Values to pass to the function | Depends |
conditions | Navigation based on result | Yes |
Available Operations
Functions support a range of operations. If you need a function, reach out to the Voxworks team.
We are still working on opening up custom functions to users.
Interrupts
Function steps cannot be interrupted. Functions typically execute very quickly, so this is rarely noticeable to users.
Use the Script to provide a “thinking” message like “Let me check that for you…” which will happen whilst the tool executes, so it is OK to keep it brief.
Best Practices
- Validate before tool calls — Check data formats before sending to external services
- Keep functions focused — Each function should do one thing
- Inform the user — Use the script property to set expectations (“Let me check that for you…”, “Let me see…” or “Ok…”)
- Handle edge cases — Consider empty values, unusual formats
- Test integrations — Verify functions work with your specific configuration
| Aspect | Function | Tool |
|---|
| Purpose | Local logic/validation | External service calls |
| Speed | Very fast | May have latency |
| Reliability | Deterministic | Depends on external service |
| Use Case | Validation, calculation | Integration, booking |
Next Steps
