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.
Nguồn gốc
- Digest nội dung
- sha256:25cf72dcc3f5e2ad828647e0e30c671423a3d2ca6895adc1d3a3ffd0ca676e89
- Đã xuất bản
- 2026-11-10T10:13:36Z
- Danh tính ký
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Chữ ký
- Chính thứcapplication/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
Tham chiếu ở phiên bản này
oci://hub.aggrega.ai/component/core/security/fms-guardrails-orchestrator:1.0.0Tham số của nhà phát triển
Các giá trị mà nhà phát triển đặt trong Aggregate.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| detector_id | string | detector | không | 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_threshold | number (min 0, max 1) | 0.5 | không | 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. |
Định cỡ của người vận hành
Định cỡ hạ tầng mà người vận hành tinh chỉnh theo từng môi trường.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 8033 | không | 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_port | integer (min 1024, max 65535) | 8034 | không | 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_host | string | — | có | 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_port | integer (min 1, max 65535) | — | có | 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. |
| image | string | — | có | 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. |
| compute | object | — | không | — |
Hợp đồng đầu ra
Các giá trị mà thành phần này xuất bản cho bên tiêu thụ qua cấu trúc liên kết uses.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| host | string | — | có | 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. |
| port | integer | — | có | 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. |
| endpoint | string | — | có | 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_id | string | — | có | Id the wired detector is registered under, which a caller names in a request's detectors. |
| protocol | string | — | không | URL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`. |
Các socket uses
Các socket phụ thuộc mà thành phần này kết nối qua. Đích của mọi kết nối được nối qua một socket phải thỏa mãn bộ chọn nhãn của socket đó, và mỗi kết nối có thể mang theo phần đính kèm trong các slot mà socket khai báo. Một slot bắt buộc phải được đáp ứng bởi mỗi kết nối mà Aggregate hoặc Release nối qua socket.
detector
- Bộ chọn
- security.aggrega.ai/text-detection=detector
- Tiêm
- —
Socket này không khai báo slot đính kèm nào, nên một kết nối qua nó không mang theo phần đính kèm nào.
Slot đính kèm
Các điểm liên kết có tên mà tại đó một Feature được gắn vào thành phần này. Bộ chọn của một slot giới hạn Feature nào có thể lấp đầy nó, và danh sách tiêm của slot nêu cách nội dung của Feature có thể được chuyển giao. Một slot bắt buộc phải được liên kết trên mọi thể hiện, bằng một phần đính kèm trên thể hiện đó hoặc ở một phạm vi phía trên nó, và một slot nhạy cảm được khai báo để xử lý nội dung bí mật. Một Feature cũng có thể được gắn dưới một tên mà không slot nào khai báo.
Chưa khai báo slot đính kèm nào.
Danh sách cho phép tự tiêm
Chưa khai báo đường ống tự tiêm nào.
Quan hệ
Các cạnh có kiểu đi tới và đi từ các thực thể đã xuất bản khác. Một tham chiếu không có đích đã xuất bản được hiển thị là một cạnh bị đứt thay vì một liên kết.
Sử dụng
- sử dụngsử dụng socket «detector»
security.aggrega.ai/text-detection=detector
Không khai báo slot đính kèm nào.
Được sử dụng bởi
sử dụng socket «auth_core»
sử dụng socket «auth_core»
sử dụng socket «auth_core»
sử dụng socket «auth_core»
sử dụng socket «upstream»
sử dụng socket «forward_target»
sử dụng socket «scrape_target»
sử dụng socket «store»
sử dụng socket «jailbreak_detection»
sử dụng socket «orchestrator»
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
triển khai
triển khai