Skip to content

Build an agent

You write two things: a brain behind one WebSocket in your backend, and a page that starts a session with one request and your client. An agent record joins them. How Voqalize works explains the parts; the Quickstart gets you to a first session in ten minutes.

  1. Write the brain. Speech, screen actions, tools, context and history. Bringing logic from another framework instead: Use another agent framework.
  2. Test the brain. Drive it over the real wire with no microphone and no model, before any session is live.
  3. Create the agent and say how it is reached. An inbound wss:// route in production, or the Cortex relay from a laptop or a serverless function.
  4. Mint keys. An sk_ for your server; a pk_ only for a public page.
  5. Connect your app. The sessions.connect request, the response, and the one line of glue.
  6. Pick client libraries. Your client with @voqalize/client-transport, and the mobile path.

Work with a coding agent does these steps from your editor through the Voqalize MCP server.