이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

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 디자인 시스템으로 구축되었습니다.

개인정보 보호