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

Component

core/ai-agent/librechat

A self-hosted LibreChat installation — the browser platform a person holds conversations in, and the tier that turns a bare model endpoint into a working assistant surface. It reaches its model through the `model` uses-socket and adds agents an author assembles without writing code, tool invocation over the tool servers an administrator registers, a code interpreter, and retrieval over files a user uploads. Every agent run, a delegated child run included, is entered from a conversation a person started: the platform runs no background loop of its own. Its accounts, conversations, agents and stored per-user credentials live in a document store wired through the `backend` socket, the system of record; only uploaded files sit on a volume of its own. A store that requires a sign-in, as FerretDB does by default, takes the user and password from the credential attached on that connection. The two token-signing secrets and the credential-encryption pair decide what its sign-ins and stored credentials are worth, and each has a slot of its own. None of the four has a default, and the build halts until each slot is filled. On Kubernetes, reach for `librechat-chart`, rendering the project's own chart, where a chart repository is reachable at build time, and for `librechat`, the workload synthesis, where the build must fetch nothing. With `values.metrics_enabled` true each Recipe turns on the platform's Prometheus metrics, at /metrics on its port and answered only to a bearer token equal to the secret attached to metrics_secret, and publishes the address as `metrics_endpoint`; a scrape presents that secret on its connection's `credential` slot.

버전

출처

공식이 카탈로그가 공식 게시자로 인정하는 서명 ID로 서명되었습니다.
콘텐츠 다이제스트
sha256:592d4a83b2f5fe0574aaf9a1b2b37e6ad350ef54112d34906bd5444e7224c385
게시일
2026-11-12T20:47:23Z
서명 ID
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/dev

서명

  • 공식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/dev

    sha256:fbd85cd707a558aca4a1dc988647ccda749aea924c175cceda57be4559aa7c45

이 버전의 참조

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

개발자 매개변수

개발자가 Aggregate에서 설정하는 값입니다.

BaseComponents#/schemas/BaseAgentParameter 확장

이름타입기본값필수설명
app_titlestringLibreChat아니요Name the platform presents in the browser title and the interface header. Two installations reachable by the same people tell themselves apart by carrying different titles.
database_namestringLibreChat아니요Name of the logical database the platform uses inside the wired document store. Two installations sharing one store keep their data apart by carrying different names.
allow_registrationbooleanfalse아니요Whether a visitor who is not yet a user may create an account from the sign-in page. Left off, accounts are created only by an administrator, which is the posture an installation reachable beyond its own team wants.
metrics_enabledbooleanfalse아니요Turns on LibreChat's own metrics, in the Prometheus format, at /metrics on the platform's port, and publishes their address as `metrics_endpoint`; while false that key is empty. The platform answers them only to the secret attached to metrics_secret, presented as a bearer token, so the build halts when this is true and that slot is unfilled. They carry request counts and timings, never a user's or conversation's identifier or content.

운영자 사이징

운영자가 환경별로 조정하는 인프라 사이징입니다.

이름타입기본값필수설명
portinteger (min 1024, max 65535)3080아니요Listen port the platform serves its interface and API on, and the port consumers connect to. Most operators should omit this and let the Recipe assign the default (3080).
engine_versionstringv0.8.7아니요LibreChat container image tag. Selects the image tag of the platform container on both Recipes.
source_versionstring—아니요Version of the platform's own Helm chart the chart-backed Recipe pulls, defaulting to the version that Recipe was checked against. The workload-synthesis Recipe pulls no chart and reads nothing here.
storageobject—아니요—
external_base_urlstring아니요Externally reachable base URL of the installation, as a browser sees it — the address the ingress tier publishes. The platform composes the links it emits from it and accepts browser requests against it. Left empty, the Recipe supplies the installation's own in-cluster address instead, which suits an installation reached only in-cluster.
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 serving the chat interface and its API. The ingress tier points its upstream at this name.
portinteger—예TCP port that Service serves the interface and API on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
protocolstring—아니요URL scheme to reach `host` and `port` over, which a consumer composes its base URL on.
metrics_endpointstring—아니요The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics`, on the port the interface is served on. Empty while values.metrics_enabled is false.
metrics_credential_requiredboolean—아니요Whether a scrape of `metrics_endpoint` must present a credential: true while values.metrics_enabled is true, because the platform answers its metrics only to the secret attached to metrics_secret, which a scrape presents on its connection's `credential` slot; false while no address is published.

uses 소켓

이 컴포넌트가 연결에 사용하는 의존성 소켓입니다. 소켓을 통해 배선되는 모든 연결의 대상은 해당 소켓의 레이블 셀렉터를 충족해야 하며, 각 연결은 소켓이 선언한 슬롯에 첨부를 전달할 수 있습니다. 필수 슬롯은 Aggregate 또는 Release가 해당 소켓을 통해 배선하는 각 연결이 채워야 합니다.

model

셀렉터
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
주입
—

이 소켓을 통한 각 연결이 채울 수 있는 슬롯

슬롯셀렉터필수주입민감설명
credentialfeature.aggrega.ai/kind=secret아니요env예Optional credential the platform presents to the model this connection reaches. Unattached, the Recipe leaves the platform in its per-user mode, where each person enters their own key in the interface and no key is rendered at all.

backend

셀렉터
component.aggrega.ai/category=datastore
주입
—

이 소켓을 통한 각 연결이 채울 수 있는 슬롯

슬롯셀렉터필수주입민감설명
credentialfeature.aggrega.ai/kind=secret아니요env예Optional sign-in the platform presents to the document store this connection reaches, written as <user>:<password> with any reserved URL character in either part percent-encoded, since it becomes the user-information part of the connection string. Unattached, the connection string carries no user part.

첨부 슬롯

Feature가 이 컴포넌트에 첨부되는 이름 있는 바인딩 지점입니다. 슬롯의 셀렉터는 어떤 Feature가 슬롯을 채울 수 있는지를 제한하고, 슬롯의 inject 목록은 Feature의 자료를 어떻게 전달할 수 있는지를 지정합니다. 필수 슬롯은 인스턴스의 첨부 또는 그 위 범위의 첨부를 통해 모든 인스턴스에서 바인딩되어야 하며, 민감 슬롯은 비밀 자료를 처리하도록 선언됩니다. Feature는 어떤 슬롯도 선언하지 않은 이름으로 첨부될 수도 있습니다.

슬롯셀렉터필수주입민감설명
session_secretfeature.aggrega.ai/kind=secret예env예Required secret the platform signs its access tokens with. There is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change invalidates every session then active.
session_refresh_secretfeature.aggrega.ai/kind=secret예env예Required secret the platform signs its refresh tokens with — the tokens a browser presents to mint a new access token, so it carries the weight of the access-token secret. There is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change makes every person sign in again.
credential_encryption_keyfeature.aggrega.ai/kind=secret예env예Required key the platform encrypts the credentials it stores in the document store under, as 64 hexadecimal characters (a 32-byte key). It encrypts the credentials it supports whether or not the people using the installation ever save one of their own, so this slot is filled even where the model key is supplied centrally. There is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change leaves everything already stored undecryptable.
credential_encryption_ivfeature.aggrega.ai/kind=secret예env예Required initialization vector the platform pairs with the credential-encryption key when it encrypts what it stores, as 32 hexadecimal characters (16 bytes). A vector is not secret by cryptographic design, but one every reader of this catalog held would be the same in every Release, so there is no default: the build halts when nothing fills this slot. Blanking the variable instead, so the platform generates one for itself, is a bootstrap convenience rather than a credential-rotation system: the generated value does not survive a restart and a second replica generates a different one, and each change leaves everything already stored undecryptable.
metrics_secretfeature.aggrega.ai/kind=secret아니요env예Optional secret the platform answers its Prometheus metrics to: a scrape presents it as a bearer token, on its connection's credential slot. It is delivered as METRICS_SECRET only while values.metrics_enabled is true, and is required then: the build halts when the value is true and nothing fills this slot. There is no default. While the value is false it is not delivered, and the platform answers its metrics route 401 to every caller.

자체 주입 허용 목록

선언된 자체 주입 파이프가 없습니다.

관계

게시된 다른 엔터티와 주고받는 타입 지정 에지입니다. 게시된 대상이 없는 참조는 링크가 아닌 끊어진 에지로 표시됩니다.

사용함

사용됨

Component 개념 레퍼런스 →

Aggrega 카탈로그 — 컴포넌트, 기능, 레시피, 그리고 이를 렌더링하는 플러그인의 공개 인덱스입니다.

공유 Aggrega 디자인 시스템으로 구축되었습니다.

개인정보 보호