Function Call Context
When starting a new conversation session with the Voice Agent, you can provide context about previous function calls using the agent.context
parameter. This allows the agent to maintain awareness of past interactions and function executions, enabling more coherent and contextual conversations.
Overview
Function call history is particularly useful when:
- Resuming a conversation from a previous session
- Providing background context about actions already taken
- Maintaining continuity in multi-session interactions
- Allowing the agent to reference previous function results
Format
Function call history is included in the context using the History
message type with a function_calls
array. Each function call entry contains complete information about the execution, including arguments and results.
Function call history can be disabled by setting settings.flags.history
to false
in the agent configuration. History is enabled by default.
Function Call History Structure
Each function call in the history includes the following fields:
Benefits of Function Call History
Including function call history in your agent context provides several advantages:
Continuity
The agent understands what functions were previously called and their results, enabling natural conversation flow across sessions.
Efficiency
The agent can reference previous function results instead of making redundant calls for the same information.
Context Awareness
The agent can make informed decisions based on the complete interaction history, including both conversations and actions taken.
Natural Interactions
Users can refer to previous actions (“like we did before”) and the agent will understand the context.
Multiple Function Calls
You can include multiple function calls in a single history entry or across multiple entries:
Best Practices
Unique IDs
In most cases the LLM will assign ids. If the LLM does not assign ids, Deepgram will assign ids to the function calls.
Complete Information
Include both the arguments passed to the function and the complete response received.
Chronological Order
Maintain the chronological order of function calls and conversations in your history.
Relevant Context Only
Include only the function call history that’s relevant to the current conversation to avoid overwhelming the context.