Function Call Context

Voice Agent

When starting a new conversation session with the Voice Agent, you can provide historical context about previous function calls using the agent.context parameter. This allows the agent to maintain awareness of past function executions, enabling more coherent and contextual conversations.

Function call context is particularly useful when:

• Resuming a conversation from a previous session
• Providing background context about function calls already executed
• Maintaining continuity in multi-session interactions
• Allowing the agent to reference previous function results

Function call context is included in the conversation history using the History message type with a function_calls array. Each function call entry contains complete information about the execution, including arguments and results.

{
  "type": "Settings",
  "settings": {
    "flags": {
      "history": true
    }
  },
  "agent": {
    "context": {
      "messages": [
        {
          "type": "History",
          "role": "user",
          "content": "What's the weather like in New York?"
        },
        {
          "type": "History",
          "function_calls": [
            {
              "id": "fc_weather_12345",
              "name": "get_weather",
              "client_side": true,
              "arguments": "{\"location\": \"New York\"}",
              "response": "The current weather in New York is partly cloudy with a temperature of 295.15°K."
            }
          ]
        },
        {
          "type": "History",
          "role": "assistant",
          "content": "The weather in New York is partly cloudy with a temperature of about 72°F (295.15°K)."
        }
      ]
    },
    "think": {
      "provider": {
        "type": "open_ai",
        "model": "gpt-4o-mini"
      },
      "functions": [
        {
          "name": "get_weather",
          "description": "Get the current weather for a specific location",
          "parameters": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "description": "The city or location to get weather for"
              }
            },
            "required": ["location"]
          }
        }
      ]
    }
  }
}

Function call history works seamlessly with Conversation Context to provide complete context. You can mix conversation messages and function call messages in the same context array.

Each function call in the history includes the following fields:

Including function call history in your agent context provides several advantages:

The agent understands what functions were previously called and their results, enabling natural conversation flow across sessions.

The agent can reference previous function results instead of making redundant calls for the same information.

The agent can make informed decisions based on the complete interaction history, including both conversations and actions taken.

Users can refer to previous actions (“like we did before”) and the agent will understand the context.

In most cases the LLM will assign ids. If the LLM does not assign ids, Deepgram will assign ids to the function calls.

Include both the arguments passed to the function and the complete response received.

Maintain the chronological order of function calls and conversations in your history.

Include only the function call history that’s relevant to the current conversation to avoid overwhelming the context.