Diese Seite wurde maschinell übersetzt. Englisches Original lesen.

Component

core/ai-agent/dify-plugin-daemon

The Dify plugin runtime — the service that installs and runs the plugins a Dify installation's model providers and tools are delivered as. Every model call and every tool invocation an application makes is dispatched through it, so an installation with no plugin runtime can edit a workflow but cannot run one. It keeps its own plugin catalogue and installation records in a dedicated database on the PostgreSQL backend wired through the `backend` uses-socket, coordinates through the Redis-compatible cache wired through `cache`, and calls back into the API server over the internal API on the `api` socket to resolve workspace and credential context. Installed plugin packages and their prepared runtime environments live on its own volume, and it verifies each package's signature before running it, so it renders as a single-replica stateful server with a persistent claim. Exports its host, port and protocol to consumers via the uses topology. It serves its own metrics in the Prometheus format at /metrics/ on that port, on by default and asking no key, and its Recipe publishes that address as `metrics_endpoint`.

Herkunft

OffiziellSigniert von einer Signaturidentität, die dieser Katalog als offiziellen Herausgeber anerkennt.
Inhalts-Digest
sha256:235db0a06173e63ea780afee705f161b356137d9bb23b70ec6ded021a2a2ce76
Veröffentlicht
2026-11-10T10:07:46Z
Signaturidentität
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signatur

  • Offiziellapplication/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:6b10147c2e908f21a543eea128ac8d8c25ebff57f5816ccadcbed892b88011ba

Referenz zu dieser Version

oci://hub.aggrega.ai/component/core/ai-agent/dify-plugin-daemon:1.0.0

Entwicklerparameter

Werte, die der Entwickler im Aggregate festlegt.

NameTypStandardwertErforderlichBeschreibung
plugin_databasestringdify_pluginneinName of the database the runtime keeps its plugin catalogue in. It sits on the same backend as the platform's own database and is separate from it, so an installation that reuses one server for both keeps the two schemas apart.
verify_signaturebooleantrueneinWhether a plugin package must carry a valid signature before the runtime will install it. Left at the default, an unsigned package is refused, which is what stops arbitrary code entering the installation through the plugin path. Set it false only for an installation that develops its own unsigned plugins.
max_package_sizeinteger (min 1)52428800neinLargest plugin package, in bytes, the runtime accepts for installation.
max_execution_timeoutinteger (min 1)600neinHow long, in seconds, one plugin invocation may run before the runtime stops it.

Dimensionierung durch den Operator

Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.

NameTypStandardwertErforderlichBeschreibung
portinteger (min 1024, max 65535)5002neinHTTP listen port the plugin-dispatch API is served on.
engine_versionstring0.6.10-localneinDify plugin-runtime container image tag. The runtime is released on its own cadence, so this tag moves independently of the API server's.
computeobject—nein—
storageobject—nein—
overridesobject (open)—neinProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Ausgabevertrag

Werte, die diese Komponente über die uses-Topologie an Konsumenten veröffentlicht.

NameTypStandardwertErforderlichBeschreibung
hoststring—jaIn-cluster DNS name of the Service fronting the plugin runtime. The API server dials this name to dispatch a model call or a tool invocation.
portinteger—jaTCP port that Service accepts dispatch requests on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
protocolstring—neinURL scheme to reach `host` and `port` over, which a consumer composes its base URL on.
metrics_endpointstring—neinThe full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics/` on the dispatch port. Empty where the component serves none reachable.

uses-Sockets

Die Abhängigkeits-Sockets, über die sich diese Komponente verbindet. Das Ziel jeder über einen Socket verdrahteten Verbindung muss dessen Label-Selektor erfüllen, und jede Verbindung kann in den Slots, die der Socket deklariert, eine Anbindung tragen. Einen erforderlichen Slot muss jede Verbindung füllen, die das Aggregate oder das Release über den Socket verdrahtet.

backend

Selektor
component.aggrega.ai/category=datastore
Injektion
env

Slots, die jede Verbindung über diesen Socket füllen kann

SlotSelektorErforderlichInjektionSensibelBeschreibung
credentialfeature.aggrega.ai/kind=secretneinenvjaOptional password the runtime 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

Selektor
component.aggrega.ai/category=datastore
Injektion
env

Slots, die jede Verbindung über diesen Socket füllen kann

SlotSelektorErforderlichInjektionSensibelBeschreibung
server_cafeature.aggrega.ai/kind=secretneinfilejaOptional authority the runtime 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 runtime's cache client 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.

api

Selektor
component.aggrega.ai/category=ai-agent
Injektion
env

Slots, die jede Verbindung über diesen Socket füllen kann

SlotSelektorErforderlichInjektionSensibelBeschreibung
credentialfeature.aggrega.ai/kind=secretneinenvjaOptional credential the runtime presents on every call back into the internal API of the API server this connection reaches, which the server compares against its own. The API server and the task worker hold the same key in their inner_api_key slots, 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.

Anbindungs-Slots

Benannte Bindungspunkte, an denen ein Feature an diese Komponente angebunden wird. Der Selektor eines Slots schränkt ein, welches Feature ihn füllen darf, und seine inject-Liste benennt, wie das Feature sein Material liefern darf. Ein erforderlicher Slot muss auf jeder Instanz gebunden sein, durch eine Anbindung an der Instanz oder in einem darüberliegenden Geltungsbereich, und ein sensibler Slot ist für den Umgang mit geheimem Material deklariert. Ein Feature kann auch unter einem Namen angebunden werden, den kein Slot deklariert.

SlotSelektorErforderlichInjektionSensibelBeschreibung
plugin_daemon_keyfeature.aggrega.ai/kind=secretneinenvjaOptional credential the runtime requires of every caller, and which the API server and the task worker present on every call they make, each on its own connection to the runtime. The same credential is attached here and on both connections, or on 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.

Zulassungsliste für Selbstinjektion

env

Beziehungen

Typisierte Kanten zu und von anderen veröffentlichten Entitäten. Eine Referenz ohne veröffentlichtes Ziel wird als unterbrochene Kante statt als Link dargestellt.

Verwendet

Verwendet von

Konzeptreferenz zu Component →

Der Aggrega-Katalog — ein offener Index von Komponenten, Funktionen, Rezepten und den Plugins, die sie rendern.

Erstellt mit dem gemeinsamen Aggrega-Designsystem.

Datenschutz