Recipe
livekit-agent-worker
A LiveKit agent worker on Kubernetes via the helm provider's Workload synthesis, running an image the Release supplies (no external Helm chart, because the project publishes none for this service, and no pinned image, because it publishes none of those either — the agent framework ships as a language package). It renders a stateless Deployment, and a ConfigMap only for files a connection or the component's own `inject:` block dictates: no Service, because the worker serves no application traffic, and no volume for state, because it keeps a session's state in memory. The worker is configured entirely on the environment, in the variables the framework itself reads: the media server's WebSocket address and API key identifier, composed from the host, port and api_key the media server publishes, the dispatch name, and the log level. The one port declared is the framework's own health endpoint, which is a container port the probes reach on the pod address and which no Service publishes, so the worker exposes nothing to the rest of the Release. The token-signing secret arrives from the credential on the media_server connection as an env secretKeyRef, so the plaintext secret never appears in the worker's own manifest. The public key identifier travels over the same edge, so one key pair is authored once. A media_server connection writing an `inject:` block, or the component's own block, also delivers the names it dictates, as variables or as files mounted at the paths it names, beside the framework's variables. provides.agent_name is the dispatch name the Aggregate authored, republished so a consumer writing a dispatch rule reads it rather than repeating it.
Provenance
- Content digest
- sha256:d068e26fde5dcd7c058880bf9b0159a252b9a76d2d9da683364b502c08e44395
- Published
- 2026-11-10T10:25:08Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:197f79ff98e3d2d69ca4acb92beff6dcf2dbc7ecb8096090030a7669c2bee272
Reference at this version
oci://hub.aggrega.ai/recipe/helm/livekit-agent-worker:1.0.0- Target
- —
- Implements
- core/ai-agent/livekit-agent-worker:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| agent_name | {{ .values.agent_name }} |
Workload
Workload · replicas: 1 · containers: main
Locals
No locals declared.
Values mapping
No values mapping declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- implementsimplementscontract compatible
core/ai-agent/livekit-agent-worker:1.0.0
All required outputs are satisfied and every provided output is named in the contract.
Used by
Nothing in the catalog depends on this entity.