このページは機械翻訳されています。英語の原文を読む。

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.

来歴

公式このカタログが公式の公開者として認めている署名 ID によって署名されています。
コンテンツダイジェスト
sha256:fb888f5eccf68284b1e49710d9007a26ec1d52d8009444dc28b557d8c309db9b
公開日
2026-11-10T10:07:20Z
署名 ID
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

署名

  • 公式application/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

このバージョンの参照

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

開発者パラメーター

開発者が Aggregate で設定する値です。

名前型デフォルト必須説明
model_call_timeout_secondsinteger (min 1)120いいえHow 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)16いいえHow many model calls the service will have outstanding at once. It bounds what one container holds open, so it is sized with compute.memory.

運用担当者によるサイジング

運用担当者が環境ごとに調整するインフラストラクチャのサイジングです。

名前型デフォルト必須説明
portinteger (min 1024, max 65535)8080いいえPort 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—いいえExternally 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.1いいえPlatform services container image tag. It tracks the same release as the control-plane API, so a Release moves both together.
web_workersinteger (min 1)2いいえNumber 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)INFOいいえLog verbosity the service emits.
computeobject—いいえ—
overridesobject (open)—いいえProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

出力コントラクト

このコンポーネントが uses トポロジを通じて利用側に公開する値です。

名前型デフォルト必須説明
hoststring—はいIn-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—はいTCP 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—はいFull 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—いいえURL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`.

uses ソケット

このコンポーネントが接続に用いる依存関係ソケットです。ソケットを介して配線される各接続のターゲットは、そのソケットのラベルセレクターを満たす必要があり、各接続はソケットが宣言するスロットにアタッチメントを持つことができます。必須スロットは、Aggregate または Release がそのソケットを介して配線する各接続が満たす必要があります。

backend

セレクター
component.aggrega.ai/category=datastore
注入
env

このソケットを介した各接続が埋めることのできるスロット

スロットセレクター必須注入機密説明
credentialfeature.aggrega.ai/kind=secretいいえenvはいPassword 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

セレクター
component.aggrega.ai/category=datastore
注入
env

このソケットを介した各接続が埋めることのできるスロット

スロットセレクター必須注入機密説明
server_cafeature.aggrega.ai/kind=secretいいえfileはいOptional 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

セレクター
component.aggrega.ai/category=datastore
注入
env

このソケットを介した各接続が埋めることのできるスロット

スロットセレクター必須注入機密説明
server_cafeature.aggrega.ai/kind=secretいいえfileはいOptional 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

セレクター
component.aggrega.ai/category=security
注入
env

このソケットを介した各接続が埋めることのできるスロット

スロットセレクター必須注入機密説明
credentialfeature.aggrega.ai/kind=secretいいえenvはいAPI 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

セレクター
component.aggrega.ai/type=resource,component.aggrega.ai/category=storage
注入
env

このソケットを介した各接続が埋めることのできるスロット

スロットセレクター必須注入機密説明
credential_idfeature.aggrega.ai/kind=secretいいえenvはいAccess-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=secretいいえenvはいSecret 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

セレクター
component.aggrega.ai/category=ai-agent
注入
env

このソケットを介した各接続が埋めることのできるスロット

スロットセレクター必須注入機密説明
credentialfeature.aggrega.ai/kind=secretいいえenvはいToken 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.

アタッチメントスロット

Feature がこのコンポーネントにアタッチされる、名前付きのバインディングポイントです。スロットのセレクターはどの Feature がそのスロットを埋められるかを制約し、その inject リストは Feature のマテリアルをどのように配信できるかを示します。必須スロットは、インスタンス上のアタッチメント、またはその上位のスコープでのアタッチメントによって、すべてのインスタンスでバインドされている必要があります。また、機密スロットは秘密のマテリアルを扱うものとして宣言されます。Feature は、どのスロットも宣言していない名前でアタッチすることもできます。

スロットセレクター必須注入機密説明
auth_keyfeature.aggrega.ai/kind=secretはいenvはいRequired 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=secretはいenvはいRequired 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=secretいいえenvはいKey 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.

自己注入の許可リスト

env

関係

他の公開エンティティとの間の型付きエッジです。公開されたターゲットがない参照は、リンクではなく切れたエッジとして表示されます。

使用先

使用元

Component の概念リファレンス →

Aggrega カタログ — コンポーネント、機能、レシピ、およびそれらをレンダリングするプラグインのオープンなインデックスです。

共有の Aggrega デザインシステムで構築されています。

プライバシー