Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Component

core/ai-agent/open-webui

A self-hosted Open WebUI installation — the browser platform a person holds conversations in, and the tier that turns a bare model endpoint into a working assistant surface. It reaches its model through the `model` uses-socket and calls it as an OpenAI-compatible API, adding retrieval over the documents a user loads, tool invocation over the tool servers an administrator registers, and per-user and per-group access control. The conversation loop is always started by a person: the platform runs no background loop of its own. It keeps its accounts, conversations and document index on one durable volume, so a realization gives it storage that outlives its container. It exports its host, port and protocol, which is how an ingress tier publishes it. On Kubernetes there are two realizations and the Manifest chooses between them. `open-webui` synthesizes the platform as a workload and fetches nothing, so it is the one to reach for where the build must complete with no chart repository reachable. `open-webui-chart` renders the platform's own Helm chart, which additionally carries single sign-on against several identity providers and per-component log levels, both set through `infra.overrides`, so reach for it where a chart repository is reachable at build time.

Provenienza

UfficialeFirmato da un’identità di firma che questo catalogo riconosce come editore ufficiale.
Digest del contenuto
sha256:76dfc1edab6c8fb232ada4258a0c23a92dd990face11a3088ede03670eb6c02a
Pubblicato
2026-11-10T10:08:33Z
Identità di firma
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Firma

  • Ufficialeapplication/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:30887ad87efb6bf3e287d36426d33d0ae812eb83b43a53e6eebe133f9268d6d0

Riferimento a questa versione

oci://hub.aggrega.ai/component/core/ai-agent/open-webui:1.0.0

Parametri dello sviluppatore

Valori che lo sviluppatore imposta nell’Aggregate.

Estende BaseComponents#/schemas/BaseAgentParameter

NomeTipoPredefinitoObbligatorioDescrizione
instance_titlestringOpen WebUInoName the platform presents in the browser title and the interface header. Two installations reachable by the same people tell themselves apart by carrying different titles.
enable_signupbooleanfalsenoWhether a visitor who is not yet a user may create an account from the sign-in page. Left off, accounts are created only by an administrator, which is the posture an installation reachable beyond its own team wants.
default_user_rolestring (pending | user | admin)pendingnoRole a newly created account receives. The default withholds access until an administrator grants it, so enabling signup does not by itself grant anyone the platform.
enable_web_searchbooleanfalsenoWhether the platform offers web search as a retrieval source inside a conversation. Left off, retrieval draws only on documents a user loaded, so no conversation content reaches a search provider.

Dimensionamento dell’operatore

Dimensionamento dell’infrastruttura che l’operatore regola per ogni ambiente.

NomeTipoPredefinitoObbligatorioDescrizione
portinteger (min 1024, max 65535)8080noListen port the platform serves its interface and API on, and the port consumers connect to. Most operators should omit this and let the Recipe assign the default (8080).
engine_versionstringv0.11.1noOpen WebUI container image tag. Selects the image tag on the synthesized platform container; the chart-backed realization pins its own image tag.
source_versionstring—noVersion of the Helm chart the chart-backed realization pulls. Read only by that realization; the workload-synthesis realization pulls no source artifact and ignores it. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart.
storageobject—no—
external_base_urlstringnoExternally reachable base URL of the installation, as a browser sees it — the address the ingress tier publishes. The platform composes the links it emits from it, which is what makes a shared conversation link resolve from outside the cluster. Left empty, no link base is set and the platform derives each address from the incoming request, which suits an installation reached only in-cluster.
computeobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contratto di output

Valori che questo componente pubblica verso i consumatori attraverso la topologia uses.

NomeTipoPredefinitoObbligatorioDescrizione
hoststring—sìIn-cluster DNS name of the Service serving the chat interface and its API. The ingress tier points its upstream at this name.
portinteger—sìTCP port that Service serves the interface and API on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
protocolstring—noURL scheme to reach `host` and `port` over, which a consumer composes its base URL on.

Socket uses

I socket di dipendenza attraverso cui questo componente si connette. La destinazione di ogni connessione collegata attraverso un socket deve soddisfare il suo selettore di etichette, e ogni connessione può portare un aggancio negli slot che il socket dichiara. Uno slot obbligatorio deve essere riempito da ogni connessione che l’Aggregate o la Release collega attraverso il socket.

model

Selettore
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Iniezione
—

Slot che ogni connessione attraverso questo socket può riempire

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
credentialfeature.aggrega.ai/kind=secretnoenvsìOptional credential the platform presents to the model this connection reaches. Unattached, the Recipe delivers no key at all, which suits an in-cluster endpoint that authenticates callers by network position rather than by key.

Slot di aggancio

Punti di associazione con nome in cui una Feature si aggancia a questo componente. Il selettore di uno slot limita quale Feature può riempirlo e la sua lista inject indica come può essere consegnato il materiale della Feature. Uno slot obbligatorio deve essere associato su ogni istanza, da un aggancio sull’istanza o a un ambito superiore, e uno slot sensibile è dichiarato per gestire materiale segreto. Una Feature può anche agganciarsi con un nome che nessuno slot dichiara.

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
session_secretfeature.aggrega.ai/kind=secretsìenvsìRequired secret the platform signs its session tokens with. There is no default: the build halts when nothing fills this slot. Leaving the variable unset instead, so the platform mints a key of its own, is a bootstrap convenience rather than a credential-rotation system: the minted key does not survive a restart, so each restart invalidates every sign-in then active.

Elenco consentito di auto-iniezione

Nessuna pipe di auto-iniezione dichiarata.

Relazioni

Archi tipizzati da e verso altre entità pubblicate. Un riferimento senza una destinazione pubblicata viene mostrato come arco interrotto anziché come link.

Usa

Usato da

Riferimento al concetto Component →

Il catalogo Aggrega — un indice aperto di componenti, funzionalità, ricette e dei plugin che li renderizzano.

Realizzato con il design system condiviso di Aggrega.

Privacy