Add a connection

For LiveKit, you need the agent’s dispatch name and either project credentials or a token endpoint. Your agent also needs the Egma SDK configured for simulations. For Retell, you need access to the agent through a Retell API key. A phone connection also needs a phone number routed to that agent.

Open Agents and select the agent you want to connect to.
Under Connections, select + Add Connection.
For this LiveKit example, choose Voice, then select Continue.
Select Project credentials as the connection type. Enter your worker’s exact LiveKit agent name, your project’s WebSocket URL, API key, and API secret.
Select Continue to testing and complete the SDK setup instructions. Return to the agent’s Connections list to find the new connection.

First, install the CLI and sign in and register your agent.For a LiveKit voice connection, set EGMA_AGENT_ID to your Egma agent ID. Set LIVEKIT_URL to your project’s WebSocket URL and LIVEKIT_AGENT_NAME to your worker’s exact dispatch name.Load LIVEKIT_API_KEY and LIVEKIT_API_SECRET from your secret store, then add the connection:

export EGMA_LIVEKIT_API_KEY="$LIVEKIT_API_KEY"
export EGMA_LIVEKIT_API_SECRET="$LIVEKIT_API_SECRET"

egma agent connection add \
  --agent "$EGMA_AGENT_ID" \
  --access livekit-project-credentials \
  --modality voice \
  --livekit-url "$LIVEKIT_URL" \
  --livekit-agent-name "$LIVEKIT_AGENT_NAME" \
  --name "Appointment assistant — voice"

Keep the connection ID printed by the command. Use it when starting a run. Before running tests, add the required Egma simulation hook to your worker and keep the worker running. Follow the LiveKit guide for SDK setup, text connections, and token endpoints.

Follow the setup guide for your platform:

Get started

Core Philosophies

Platform

Integrations

Support

Add a connection