Esta página foi traduzida automaticamente. Leia o original em inglês.

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.

Versão

1.0.01.1.0

Procedência

OficialAssinado por uma identidade de assinatura que este catálogo reconhece como publicador oficial.
Digest do conteúdo
sha256:3fe0f7701ed392f6517da04e6d5c7168044cc4ca129ec2430b8abbe34d6969e9
Publicado
2026-11-15T08:08:52Z
Identidade de assinatura
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Assinatura

  • Oficialapplication/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

Referência nesta versão

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

Parâmetros do desenvolvedor

Valores que o desenvolvedor define no Aggregate.

NomeTipoPadrãoObrigatórioDescrição
vector_index_prefixstringVector_indexnãoName 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)4000nãoLongest segment, in tokens, the dataset indexer produces when it splits a document.

Dimensionamento do operador

Dimensionamento de infraestrutura que o operador ajusta por ambiente.

NomeTipoPadrãoObrigatórioDescrição
engine_versionstring1.17.0nãoDify 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)INFOnãoLog verbosity the worker emits.
concurrencyinteger (min 1)4nãoNumber 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_enabledbooleanfalsenãoLets 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_enabledbooleanfalsenãoLets 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—não—
overridesobject (open)—nãoProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contrato de saída

Valores que este componente publica para os consumidores pela topologia uses.

Nenhum valor de saída declarado.

Sockets uses

Os sockets de dependência pelos quais este componente se conecta. O destino de cada conexão ligada por um socket deve satisfazer o seletor de rótulos dele, e cada conexão pode carregar um acoplamento nos slots que o socket declara. Cada conexão que o Aggregate ou a Release liga pelo socket deve preencher os slots obrigatórios.

backend

Seletor
component.aggrega.ai/category=datastore
Injeção
env

Slots que cada conexão por este socket pode preencher

SlotSeletorObrigatórioInjeçãoSensívelDescrição
credentialfeature.aggrega.ai/kind=secretnãoenvsimOptional 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

Seletor
component.aggrega.ai/category=datastore
Injeção
env

Slots que cada conexão por este socket pode preencher

SlotSeletorObrigatórioInjeçãoSensívelDescrição
server_cafeature.aggrega.ai/kind=secretnãofilesimOptional 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

Seletor
datastore.aggrega.ai/engine in (vector, semantic-memory, search)
Injeção
env

Este socket não declara slots de acoplamento, então uma conexão por ele não carrega nenhum acoplamento.

sandbox

Seletor
component.aggrega.ai/category=ai-agent
Injeção
env

Slots que cada conexão por este socket pode preencher

SlotSeletorObrigatórioInjeçãoSensívelDescrição
credentialfeature.aggrega.ai/kind=secretnãoenvsimOptional 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

Seletor
component.aggrega.ai/category=ai-agent
Injeção
env

Slots que cada conexão por este socket pode preencher

SlotSeletorObrigatórioInjeçãoSensívelDescrição
credentialfeature.aggrega.ai/kind=secretnãoenvsimOptional 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

Seletor
component.aggrega.ai/category=ai-agent
Injeção
env

Este socket não declara slots de acoplamento, então uma conexão por ele não carrega nenhum acoplamento.

Slots de acoplamento

Pontos de vinculação nomeados nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual Feature pode preenchê-lo, e sua lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório deve estar vinculado em cada instância, por um acoplamento na instância ou em um escopo acima dela, e um slot sensível é declarado para lidar com material secreto. Uma Feature também pode se acoplar com um nome que nenhum slot declara.

SlotSeletorObrigatórioInjeçãoSensívelDescrição
secret_keyfeature.aggrega.ai/kind=secretsimenvsimRequired 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=secretnãoenvsimOptional 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.

Lista de permissões de autoinjeção

env

Relações

Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é exibida como uma aresta quebrada em vez de um link.

Usa

Usado por

Referência do conceito Component →

O catálogo Aggrega — um índice aberto de componentes, funcionalidades, receitas e dos plugins que os renderizam.

Criado com o sistema de design compartilhado do Aggrega.

Privacidade