Diese Seite wurde maschinell übersetzt. Englisches Original lesen.

Component

core/ai-agent/agenta-services

The model-facing service of an agent workspace: the tier that talks to language-model providers on the platform's behalf. It serves the completion and chat endpoints the console's playground calls, holds the adapter layer that presents one interface over many providers, and starts an agent run by handing it to the runner. It reads the platform's relational model through backend, uses cache and queue as the control-plane API does, keeps the files an agent produces in the object store wired through store, and reaches auth_core to establish who a request belongs to and runner to start, watch and cancel a run. Wire here to invoke a model or start an agent run. That is the line between this service and core/ai-agent/agenta-api, which owns the platform's own data: a caller listing agents or reading a trace talks to that one, and a caller asking for a completion or a run talks to this one. Both are needed, and neither is a superset of the other. Realized on Kubernetes via its Helm Recipe, which synthesizes the service as a stateless Deployment behind a ClusterIP Service on its HTTP port. It exports its host, port, endpoint and protocol to consumers.

Herkunft

OffiziellSigniert von einer Signaturidentität, die dieser Katalog als offiziellen Herausgeber anerkennt.
Inhalts-Digest
sha256:fb888f5eccf68284b1e49710d9007a26ec1d52d8009444dc28b557d8c309db9b
Veröffentlicht
2026-11-10T10:07:20Z
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:5acaba54658deb52fab31ad4eb403335ad11d3bb74e674ded0f2c4defac01a01

Referenz zu dieser Version

oci://hub.aggrega.ai/component/core/ai-agent/agenta-services:1.0.0

Entwicklerparameter

Werte, die der Entwickler im Aggregate festlegt.

NameTypStandardwertErforderlichBeschreibung
model_call_timeout_secondsinteger (min 1)120neinHow long a single model call may take before the service gives up on it. A long-running agent turn needs a wider window than a playground completion does.
max_concurrent_model_callsinteger (min 1)16neinHow many model calls the service will have outstanding at once. It bounds what one container holds open, so it is sized with compute.memory.

Dimensionierung durch den Operator

Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.

NameTypStandardwertErforderlichBeschreibung
portinteger (min 1024, max 65535)8080neinPort the service serves its HTTP API on; consumers connect here. Most operators should omit this and let the Recipe assign the default (8080).
external_base_urlstring—neinExternally reachable base URL of the whole platform, as a browser reaches it through the ingress tier — for example https://agenta.example.com. The service composes the addresses it reports from it. The compiler cannot know a cluster's external hostname, so this carries no default and the Kubernetes realization halts at build until it is set.
engine_versionstringv0.114.1neinPlatform services container image tag. It tracks the same release as the control-plane API, so a Release moves both together.
web_workersinteger (min 1)2neinNumber of request-serving worker processes in one container. Raising it raises throughput and the container's memory ceiling together, so it is sized with compute.memory.
log_levelstring (DEBUG | INFO | WARNING | ERROR | CRITICAL)INFOneinLog verbosity the service emits.
computeobject—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 model-facing tier. The console's playground and anything else asking for a completion dial this name.
portinteger—jaTCP port that Service accepts completion and chat requests on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
endpointstring—jaFull in-cluster base URL of the completion and chat API, with the host and the port already composed. It is the address a peer tier calls, not the address a browser reaches.
protocolstring—neinURL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`.

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=secretneinenvjaPassword the service authenticates to the relational backend this connection reaches with, delivered as an env secret reference and substituted into the connection URL at run time. The same credential is attached to the control-plane API's backend connection, because both reach the same server. Unattached, the Recipe emits the development literal `apppass`, the default the standard-library relational Recipes leave in place; this catalog publishes it, 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 platform's Redis client 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 names the file in the connection's URL. 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.

queue

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 platform's Redis client checks the queue's certificate against while the queue 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 names the file in the connection's URL. The build halts on a server_ca publishing no Secret name, and on one wired to a queue served without TLS. Fill it with core/referenced-secret.

auth_core

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

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

SlotSelektorErforderlichInjektionSensibelBeschreibung
credentialfeature.aggrega.ai/kind=secretneinenvjaAPI key presented to the authentication core this connection reaches. Where a key is attached to the core, the same one is attached here. Unattached, no key is sent.

store

Selektor
component.aggrega.ai/type=resource,component.aggrega.ai/category=storage
Injektion
env

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

SlotSelektorErforderlichInjektionSensibelBeschreibung
credential_idfeature.aggrega.ai/kind=secretneinenvjaAccess-key identifier the S3 client authenticates to the object store this connection reaches with, the identifier half of the pair whose secret half is this connection's credential. Unattached, the Recipe presents the identifier admin.
credentialfeature.aggrega.ai/kind=secretneinenvjaSecret key paired with this connection's credential_id. There is no default: the build halts when nothing fills this slot, unless the connection's values set unauthenticated: true.

runner

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

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

SlotSelektorErforderlichInjektionSensibelBeschreibung
credentialfeature.aggrega.ai/kind=secretneinenvjaToken presented on every call to the runner this connection reaches, which rejects an untokened request. The same credential is attached to the runner's own slot so both ends agree. Unattached, the Recipe emits the pinned development literal `dev-agenta-runner-change-me`, 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
auth_keyfeature.aggrega.ai/kind=secretjaenvjaRequired key the platform signs its own internal tokens with. It carries the same value as the control-plane API's slot. There is no default: the build halts when nothing fills this slot.
crypt_keyfeature.aggrega.ai/kind=secretjaenvjaRequired key stored model-provider credentials are encrypted under. This service decrypts them to call a provider, so it carries the same value as the control-plane API's slot. There is no default: the build halts when nothing fills this slot.
services_internal_keyfeature.aggrega.ai/kind=secretneinenvjaKey this service and the control-plane API present to each other on internal calls. Both ends carry the same value. Unattached, the Recipe emits the pinned development literal `dev-agenta-internal-change-me`, 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