Component
core/ai-agent/livekit-agent-worker
A LiveKit agent worker — the resident process that joins a realtime room as a participant and runs the agent's own code there: the speech pipeline, or the realtime model, that holds the conversation with whoever else is in the room. It registers with the media server and runs one agent session for each job it is handed; it serves no application traffic, so no other component addresses it. Wire here when the conversation inside the cluster's own rooms is to be carried by software it runs and by agent code written for it, rather than handed to a hosted agent platform. Upstream publishes the agent framework as a language package rather than as a container image, and this component pins no image because there is none to pin. The image is a required operational value carrying no default, so using this component means building an image from the framework together with the agent code, publishing it where the cluster can pull it, and naming that reference in the Release. Nothing renders until that reference is supplied. Consumers receive the dispatch name the worker registers under; the worker publishes no host and no port. Realized by a Helm Recipe that synthesizes a Deployment over the supplied image and declares no Service and no volume for state. The connection to the media server needs no `inject:` block; one it writes delivers further names, as variables or files. The worker serves Prometheus metrics only where the agent's own code gives it a metrics port, which no environment variable or setting here reaches, so it publishes no metrics address, and a worker is not a target the catalog's Prometheus scrapes. The component's own `inject:` block takes `env` and `file` entries.
Köken
- İçerik özeti
- sha256:648713c0f2d09a679fa04c037752a2a9f7fa500508eea246e7ebfb4fda644066
- Yayımlanma
- 2026-11-10T10:08:23Z
- İmzalama kimliği
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
İmza
- Resmiapplication/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:ffeddc53edfaf2158dbf9960cf1f25eeaaa0b3a74f99d29b1aceefefe716cbad
Bu sürümdeki referans
oci://hub.aggrega.ai/component/core/ai-agent/livekit-agent-worker:1.0.0Geliştirici parametreleri
Geliştiricinin Aggregate'te ayarladığı değerler.
| Ad | Tip | Varsayılan | Zorunlu | Açıklama |
|---|---|---|---|---|
| agent_name | string | — | hayır | Dispatch name the worker registers under. Naming it turns on explicit dispatch — the server then hands this worker only the rooms a dispatch rule or an access token names it in, so several agents can serve different rooms of one media server. Leaving it unset keeps automatic dispatch, where the worker is offered every room the server opens, which is the shape a Release running a single agent wants. The name reaches the worker as a default the framework reads on startup, so an agent whose own code names itself keeps the name its code sets and this field has no effect on it. |
Operatör boyutlandırması
Operatörün her ortam için ayarladığı altyapı boyutlandırması.
| Ad | Tip | Varsayılan | Zorunlu | Açıklama |
|---|---|---|---|---|
| image | string | — | evet | Container image reference the worker runs, including its tag or digest. It carries no default and the catalog pins nothing, because the agent framework is published as a language package rather than as a container image — an image for this component is built from that framework together with the agent code written for it, published where the cluster can pull it, and named here. A build that omits it halts. |
| log_level | string (debug | info | warn | error) | info | hayır | Worker log verbosity. |
| compute | object | — | hayır | — |
| overrides | object (open) | — | hayır | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Çıktı sözleşmesi
Bu bileşenin uses topolojisi üzerinden tüketicilere yayımladığı değerler.
| Ad | Tip | Varsayılan | Zorunlu | Açıklama |
|---|---|---|---|---|
| agent_name | string | — | hayır | Dispatch name the worker registered under, carried through from the value the Aggregate declared. A consumer names it when it asks for an agent to be sent into a room, which is how the request reaches this worker rather than another. |
Uses soketleri
Bu bileşenin üzerinden bağlandığı bağımlılık soketleri. Bir soket üzerinden kurulan her bağlantının hedefi, soketin etiket seçicisini karşılamalıdır ve her bağlantı, soketin bildirdiği yuvalarda bir ek taşıyabilir. Aggregate'in veya Release'in soket üzerinden kurduğu her bağlantı, zorunlu bir yuvayı doldurmakla yükümlüdür.
media_server
- Seçici
- component.aggrega.ai/category=messaging, component.aggrega.ai/type=server
- Enjeksiyon
- env, file
Bu soket üzerinden kurulan her bağlantının doldurabileceği yuvalar
| Yuva | Seçici | Zorunlu | Enjeksiyon | Hassas | Açıklama |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | evet | env | evet | Signing secret paired with the api_key identifier this connection carries. Attach the same credential the media server holds: the worker authenticates to that server with this pair, so two different secrets leave the worker unable to register. |
Ekleme yuvaları
Bir Feature'ın bu bileşene eklendiği adlandırılmış bağlama noktaları. Bir yuvanın seçicisi, onu hangi Feature'ın doldurabileceğini sınırlar ve inject listesi, Feature'ın malzemesinin nasıl iletilebileceğini belirtir. Zorunlu bir yuva, her örnekte, örnek üzerindeki veya onun üstündeki bir kapsamdaki bir ek aracılığıyla bağlanmalıdır, hassas bir yuva ise gizli malzemeyi işlemek üzere bildirilmiştir. Bir Feature, hiçbir yuvanın bildirmediği bir ad altında da eklenebilir.
Ekleme yuvası bildirilmemiş.
Kendi kendine enjeksiyon izin listesi
env, file
İlişkiler
Diğer yayımlanmış varlıklara giden ve onlardan gelen tipli kenarlar. Yayımlanmış bir hedefi olmayan bir başvuru, bağlantı yerine kopuk bir kenar olarak gösterilir.
Kullanır
- kullanır«media_server» soketini kullanır
component.aggrega.ai/category=messaging, component.aggrega.ai/type=server
Ekleme yuvaları: credential
Kullananlar
«runner» soketini kullanır
«api» soketini kullanır
«runner» soketini kullanır
«api» soketini kullanır
«services» soketini kullanır
«api» soketini kullanır
«services» soketini kullanır
«services» soketini kullanır
«sandbox» soketini kullanır
«plugin_daemon» soketini kullanır
«ssrf_proxy» soketini kullanır
«sandbox» soketini kullanır
«plugin_daemon» soketini kullanır
«ssrf_proxy» soketini kullanır
«api» soketini kullanır
«ssrf_proxy» soketini kullanır
«api» soketini kullanır
«api» soketini kullanır
«sandbox» soketini kullanır
«plugin_daemon» soketini kullanır
«ssrf_proxy» soketini kullanır
«sandbox» soketini kullanır
«plugin_daemon» soketini kullanır
«ssrf_proxy» soketini kullanır
«target_agent» soketini kullanır
«scrape_target» soketini kullanır
uygulanır
uygulanır
uygulanır
uygular