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

Component

core/ai-agent/dify-worker

The Dify task worker — the Celery consumer that runs everything a Dify installation does off the request path: indexing uploaded documents into the vector datastore, executing scheduled and queued workflow runs, generating dataset segments, and delivering mail and webhooks. It takes work from the Redis-compatible broker wired through the `cache` uses-socket, reads and writes the platform's relational model in the PostgreSQL backend wired through `backend`, and writes embeddings into the vector datastore wired through `vector_store`. Workflow code nodes it executes run in the sandbox wired through `sandbox`, and outbound requests to addresses a user supplied are routed through the forward proxy wired through `ssrf_proxy`. It serves no port and nothing connects to it — work reaches it through the broker — so it publishes no provides contract and renders as a stateless worker tier. By default nothing reaches Dify's vendor: infra.telemetry_enabled turns on its daily usage event, and infra.marketplace_enabled its daily plugin upgrade check against the plugin marketplace.

Versione

1.0.01.1.0

Provenienza

UfficialeFirmato da un’identità di firma che questo catalogo riconosce come editore ufficiale.
Digest del contenuto
sha256:3fe0f7701ed392f6517da04e6d5c7168044cc4ca129ec2430b8abbe34d6969e9
Pubblicato
2026-11-15T08:08:52Z
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:9993f64b63ebc9759ad16bdd7e5e06f5750ca9654bc22e50473426a23a092ea8

Riferimento a questa versione

oci://hub.aggrega.ai/component/core/ai-agent/dify-worker:1.1.0

Parametri dello sviluppatore

Valori che lo sviluppatore imposta nell’Aggregate.

NomeTipoPredefinitoObbligatorioDescrizione
vector_index_prefixstringVector_indexnoName prefix the worker gives the collections it creates in the wired vector datastore. It matches the API server's prefix, because the two write the same collections.
indexing_max_segmentation_tokensinteger (min 1)4000noLongest segment, in tokens, the dataset indexer produces when it splits a document.

Dimensionamento dell’operatore

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

NomeTipoPredefinitoObbligatorioDescrizione
engine_versionstring1.17.0noDify API container image tag. The API server, the scheduler and this worker run the same image, so a Release moves all three together.
log_levelstring (DEBUG | INFO | WARNING | ERROR | CRITICAL)INFOnoLog verbosity the worker emits.
concurrencyinteger (min 1)4noNumber of task slots one worker process runs in parallel. Raising it raises throughput and the worker's memory ceiling together, so it is sized with compute.memory.
telemetry_enabledbooleanfalsenoLets the worker send Dify's anonymous daily usage event, and the install event when the server's own was not delivered, to otel.dify.ai, falling back to otel.dify.cn. Unset or false, nothing reaches those hosts. Set it on the server and the scheduler too.
marketplace_enabledbooleanfalsenoLets the worker reach Dify's plugin marketplace (marketplace.dify.ai): the daily plugin upgrade check the scheduler enqueues, and installing the plugins a new workspace is configured with. Model-provider plugins such as OpenAI's install from the marketplace, so a Release whose applications use one sets it. Unset or false, nothing reaches that host. Set it on the server and the scheduler too.
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.

Nessun valore di output dichiarato.

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.

backend

Selettore
component.aggrega.ai/category=datastore
Iniezione
env

Slot che ogni connessione attraverso questo socket può riempire

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
credentialfeature.aggrega.ai/kind=secretnoenvsìOptional password the worker presents to the backend this connection reaches, shared with that backend. When attached, supplies the backend password via the credential subsystem; unattached, the Recipe uses the development literal `apppass`, which this catalog publishes, so every Release that leaves the slot unattached shares that password.

cache

Selettore
component.aggrega.ai/category=datastore
Iniezione
env

Slot che ogni connessione attraverso questo socket può riempire

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
server_cafeature.aggrega.ai/kind=secretnofilesìOptional authority the worker checks the cache's certificate against while the cache publishes protocol valkey-tls or redis-tls, where the image does not already trust the authority that signs it. Its Secret holds ca.crt. The Recipe mounts the whole Secret read-only and points the cache client and the task broker at the file. The build halts on a server_ca publishing no Secret name, and on one wired to a cache served without TLS. Fill it with core/referenced-secret.

vector_store

Selettore
datastore.aggrega.ai/engine in (vector, semantic-memory, search)
Iniezione
env

Questo socket non dichiara slot di aggancio, quindi una connessione attraverso di esso non porta alcun aggancio.

sandbox

Selettore
component.aggrega.ai/category=ai-agent
Iniezione
env

Slot che ogni connessione attraverso questo socket può riempire

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
credentialfeature.aggrega.ai/kind=secretnoenvsìOptional execution-key credential the worker presents on every request to the sandbox this connection reaches. The same credential is attached to the code_execution_key slot on the sandbox, so both ends hold the same value. Unattached, the Recipe uses the pinned development literal `dify-sandbox`, suitable for evaluation only and published in this catalog, so every Release that leaves the slot unattached shares it.

plugin_daemon

Selettore
component.aggrega.ai/category=ai-agent
Iniezione
env

Slot che ogni connessione attraverso questo socket può riempire

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
credentialfeature.aggrega.ai/kind=secretnoenvsìOptional credential the worker presents on every call it makes to the plugin runtime this connection reaches. The runtime holds the same key in its plugin_daemon_key slot and the API server presents it on its own connection, so the credential is attached to all three or to none: attaching it to some of them leaves the rest carrying a different value, which renders cleanly and is refused when the call is made. Unattached, the Recipe uses the pinned development literal `dify-plugin-daemon-server-key`, suitable for evaluation only and published in this catalog, so every Release that leaves the slot unattached shares it.

ssrf_proxy

Selettore
component.aggrega.ai/category=ai-agent
Iniezione
env

Questo socket non dichiara slot di aggancio, quindi una connessione attraverso di esso non porta alcun aggancio.

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
secret_keyfeature.aggrega.ai/kind=secretsìenvsìRequired application-secret credential. The worker decrypts stored model-provider credentials under it, so it carries the same secret as the API server. There is no default: the build halts when nothing fills this slot.
inner_api_keyfeature.aggrega.ai/kind=secretnoenvsìOptional credential the plugin runtime presents on every call back into the internal API, which the worker compares against its own. The worker and the API server declare this slot under the same name and the plugin runtime presents it on its connection to the API server, so the credential is attached to all three or to none: attaching it to some of them leaves the rest carrying a different value, which renders cleanly and is refused when the call is made. Unattached, the Recipe uses the pinned development literal `dify-plugin-inner-api-key`, suitable for evaluation only and published in this catalog, so every Release that leaves the slot unattached shares it.

Elenco consentito di auto-iniezione

env

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