Skip to main content

Export as JSON

Every Voiceblox flow can be exported as a JSON file containing the full AgentConfig — a framework-agnostic representation of your agent.

How to export

  1. Click Export in the top toolbar
  2. Download the .json file

File format

{
  "version": "1.0",
  "name": "My Agent",
  "exportedAt": "2025-01-01T12:00:00.000Z",
  "nodes": [
    {
      "id": "node_1",
      "nodeType": "framework",
      "provider": "livekit",
      "position": { "x": 100, "y": 200 }
    },
    {
      "id": "node_2",
      "nodeType": "llm",
      "provider": "openai",
      "model": "gpt-4.1-mini",
      "temperature": 0.7,
      "position": { "x": 300, "y": 100 }
    }
  ],
  "edges": [
    {
      "source": "node_2",
      "sourceHandle": "output",
      "target": "node_1",
      "targetHandle": "llm_in"
    }
  ]
}

Importing a flow

  1. Click Import in the top toolbar
  2. Select your .json file
  3. The flow is loaded onto the canvas

Using the exported config

The exported JSON contains the full node/edge graph. To use it with the LiveKit agent worker:
  1. Export the flow
  2. Set the JSON as the room metadata when creating a LiveKit room
  3. The agent worker reads the metadata, converts it to AgentConfig via graphToConfig(), and starts the session
See LiveKit Worker for the full deployment flow.