Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

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.

Nguồn gốc

Chính thứcĐược ký bởi một danh tính ký mà danh mục này công nhận là nhà phát hành chính thức.
Digest nội dung
sha256:648713c0f2d09a679fa04c037752a2a9f7fa500508eea246e7ebfb4fda644066
Đã xuất bản
2026-11-10T10:08:23Z
Danh tính ký
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Chữ ký

  • Chính thứcapplication/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

Tham chiếu ở phiên bản này

oci://hub.aggrega.ai/component/core/ai-agent/livekit-agent-worker:1.0.0

Tham số của nhà phát triển

Các giá trị mà nhà phát triển đặt trong Aggregate.

TênKiểuMặc địnhBắt buộcMô tả
agent_namestring—khôngDispatch 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.

Định cỡ của người vận hành

Định cỡ hạ tầng mà người vận hành tinh chỉnh theo từng môi trường.

TênKiểuMặc địnhBắt buộcMô tả
imagestring—có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_levelstring (debug | info | warn | error)infokhôngWorker log verbosity.
computeobject—không—
overridesobject (open)—khôngProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Hợp đồng đầu ra

Các giá trị mà thành phần này xuất bản cho bên tiêu thụ qua cấu trúc liên kết uses.

TênKiểuMặc địnhBắt buộcMô tả
agent_namestring—khôngDispatch 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.

Các socket uses

Các socket phụ thuộc mà thành phần này kết nối qua. Đích của mọi kết nối được nối qua một socket phải thỏa mãn bộ chọn nhãn của socket đó, và mỗi kết nối có thể mang theo phần đính kèm trong các slot mà socket khai báo. Một slot bắt buộc phải được đáp ứng bởi mỗi kết nối mà Aggregate hoặc Release nối qua socket.

media_server

Bộ chọn
component.aggrega.ai/category=messaging, component.aggrega.ai/type=server
Tiêm
env, file

Các slot mà mỗi kết nối qua socket này có thể lấp đầy

SlotBộ chọnBắt buộcTiêmNhạy cảmMô tả
credentialfeature.aggrega.ai/kind=secretcóenvcó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.

Slot đính kèm

Các điểm liên kết có tên mà tại đó một Feature được gắn vào thành phần này. Bộ chọn của một slot giới hạn Feature nào có thể lấp đầy nó, và danh sách tiêm của slot nêu cách nội dung của Feature có thể được chuyển giao. Một slot bắt buộc phải được liên kết trên mọi thể hiện, bằng một phần đính kèm trên thể hiện đó hoặc ở một phạm vi phía trên nó, và một slot nhạy cảm được khai báo để xử lý nội dung bí mật. Một Feature cũng có thể được gắn dưới một tên mà không slot nào khai báo.

Chưa khai báo slot đính kèm nào.

Danh sách cho phép tự tiêm

env, file

Quan hệ

Các cạnh có kiểu đi tới và đi từ các thực thể đã xuất bản khác. Một tham chiếu không có đích đã xuất bản được hiển thị là một cạnh bị đứt thay vì một liên kết.

Sử dụng

Được sử dụng bởi

Tài liệu tham khảo khái niệm Component →

Danh mục Aggrega — chỉ mục mở gồm các thành phần, tính năng, công thức và các plugin kết xuất chúng.

Được xây dựng bằng hệ thống thiết kế dùng chung của Aggrega.

Quyền riêng tư