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

Component

core/security/fms-guardrails-orchestrator

The FMS Guardrails Orchestrator: a service that runs text detectors around a model call. A caller posts an OpenAI chat-completions request naming the detectors to apply; the orchestrator checks the latest message, answers a detection with the detections and no reply, and otherwise forwards the request to the upstream server in infra.upstream_host and infra.upstream_port, adding any detection on the reply. It also answers detection-only requests over a text. It is not a guard on its own: a request naming no detectors is forwarded unchecked, so it sits behind a component that names them, such as core/security/trustyai-guardrails-gateway. Its Recipes register the one detector wired on the detector socket under values.detector_id. Answering a detection asks the upstream's /tokenize route, which vLLM serves, to count the refused text, so that text reaches the upstream. It authenticates no caller and forwards none of a caller's headers. The Release supplies the image in infra.image and the catalog names none: TrustyAI's build adds the compat-openssl11 package, whose declared licence includes the OpenSSL licence, compiles in root-certificate data published under a data licence, and is published only under a floating tag. Nothing renders until the Release sets `infra.image`. Realized on Kubernetes by its Helm Recipe and for local development by its Compose Recipe, each running that image as a single stateless service.

来歴

公式このカタログが公式の公開者として認めている署名 ID によって署名されています。
コンテンツダイジェスト
sha256:25cf72dcc3f5e2ad828647e0e30c671423a3d2ca6895adc1d3a3ffd0ca676e89
公開日
2026-11-10T10:13:36Z
署名 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:c65574df5e602940b1079c5a4148ffed7e5cdd541fa8f7b0d671dd212818491b

このバージョンの参照

oci://hub.aggrega.ai/component/core/security/fms-guardrails-orchestrator:1.0.0

開発者パラメーター

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

名前型デフォルト必須説明
detector_idstringdetectorいいえId the wired detector is registered under, which a caller names in a request's detectors to have it applied. Published as provides.detector_id, so a component calling the orchestrator reads it from the edge rather than repeating it.
default_thresholdnumber (min 0, max 1)0.5いいえScore at or above which a detection is reported when the caller's request names no threshold for the detector. The orchestrator applies the threshold itself and sends the detector its other parameters, so core/security/trustyai-huggingface-detector reports to it only labels scored at or above its own 0.5, and with that detector a value below 0.5 has no effect.

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

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

名前型デフォルト必須説明
portinteger (min 1024, max 65535)8033いいえPort the orchestrator serves its API on and its Service accepts callers on. Most operators should omit this and let the Recipe assign the default (8033), the product's own.
health_portinteger (min 1024, max 65535)8034いいえPort the orchestrator serves its health route on, which the Recipes' probes ask and no Service publishes. Most operators should omit this and let the Recipe assign the default (8034), the product's own.
upstream_hoststring—はいHost name of the OpenAI-compatible model server the orchestrator forwards the requests it admits to, for example model-server. A deterministic pointer string the orchestrator resolves when it forwards; the compiler never contacts it.
upstream_portinteger (min 1, max 65535)—はいPort of that model server. The orchestrator reaches it over plain HTTP at /v1/chat/completions, and asks its /tokenize route to answer a detection on the input.
imagestring—はいImage the orchestrator runs, supplied by the Release; the catalog names none. The Recipes run the published build's own binary at /app/bin/fms-guardrails-orchestr8, so the image is TrustyAI's FMS Guardrails Orchestrator or a copy of it. That build adds the compat-openssl11 package, compiles in root-certificate data published under a data licence, and is tagged only as latest, so a Release that must keep one build mirrors it and names the copy here.
computeobject—いいえ—

出力コントラクト

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

名前型デフォルト必須説明
hoststring—はいIn-cluster DNS name of the Service fronting the orchestrator. Every caller reaching this name can reach the model through it, with or without a detector applied, so it is an address for the component calling the orchestrator rather than one to publish.
portinteger—はいTCP port that Service accepts callers on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
endpointstring—はいBase URL of the orchestrator's API, with the host and the port already composed and no path. A caller posts chat completions to /api/v2/chat/completions-detection under it.
detector_idstring—はいId the wired detector is registered under, which a caller names in a request's detectors.
protocolstring—いいえURL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`.

uses ソケット

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

detector

セレクター
security.aggrega.ai/text-detection=detector
注入
—

このソケットはアタッチメントスロットを宣言していないため、このソケットを介した接続はアタッチメントを持ちません。

アタッチメントスロット

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

アタッチメントスロットは宣言されていません。

自己注入の許可リスト

自己注入パイプは宣言されていません。

関係

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

使用先

使用元

Component の概念リファレンス →

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

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

プライバシー