Component
core/security/trustyai-huggingface-detector
TrustyAI's Hugging Face detector: a service that runs one text classifier from the Hugging Face Hub and reports what it detects in the texts a caller sends. For each text posted to its content route with a threshold, it answers with every label the classifier scores at or above it, never the classifier's first label, read as the one for harmless text. It changes nothing and forwards nothing: what to do about a detection is the caller's decision, and core/security/nemo-guardrails is one such caller. The classifier is values.model at values.model_revision. The default, protectai/deberta-v3-base-prompt-injection-v2 (Apache-2.0), labels each text SAFE or INJECTION, and its own model card states that the project which published it is archived and no longer maintained. Another model labels and scores differently, so a caller's labels and thresholds follow it. The verdict misses some attacks and flags some ordinary requests. The weights are fetched where the service runs, never at build time. It authenticates no caller and every text reaches it as sent, so it is published on an in-cluster address only. Its own metrics, in the Prometheus format at /metrics on the same port, are published as `metrics_endpoint`. The Release supplies the image in infra.image and the catalog names none: TrustyAI's published build carries NVIDIA's proprietary CUDA runtime, whose licence agreement limits its use to systems with NVIDIA GPUs, and is published only under a floating tag, whose superseded digests stop resolving. Nothing renders until the Release sets `infra.image`.
来源
- 内容摘要
- sha256:8f985fb76602947f3d871a7625d6614d76375528aa12e151d26a51559254d630
- 发布时间
- 2026-11-10T10:13:59Z
- 签名身份
- 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:c34f4d9c71225ccd5e22a7d802c196dda140050af22eb57aa716bedbe73525f8
此版本的引用
oci://hub.aggrega.ai/component/core/security/trustyai-huggingface-detector:1.0.0开发者参数
开发者在 Aggregate 中设置的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| model | string | protectai/deberta-v3-base-prompt-injection-v2 | 否 | Hugging Face model id of the sequence-classification model the service runs. The default is a prompt-injection classifier labelling each text SAFE or INJECTION; another model labels by its own vocabulary, which a caller's refusal labels must then follow. |
| model_revision | string | 90c9989b1a342275dd0d1a95aad283c04e075671 | 否 | Revision of values.model to fetch — a commit id, a tag or a branch. The default is the commit of the default model whose scores a caller's thresholds are measured against; set it together with values.model, and main follows the repository's newest revision. |
运维规格
运维人员按环境调整的基础设施规格。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 8000 | 否 | Port the service listens on and its Service accepts callers on. Most operators should omit this and let the Recipe assign the default (8000), the port the published image listens on unless told otherwise. |
| image | string | — | 是 | Image the service and its weights-pull step run, supplied by the Release; the catalog names none. The Recipes run the published build's own server command, log configuration and Hugging Face command-line tool, so the image is TrustyAI's Hugging Face detector or a copy of it. That build carries NVIDIA's proprietary CUDA runtime, whose licence agreement limits its use to systems with NVIDIA GPUs, and is tagged only as latest, under which the registry stops serving a build once the tag moves on, so a Release that must keep one build mirrors it and names the copy here. |
| compute | object | — | 否 | — |
| model_cache | object | — | 否 | The volume the pull step writes the weights to and the server reads them from. |
输出契约
此组件通过 uses 拓扑向使用方发布的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| host | string | — | 是 | In-cluster DNS name of the Service fronting the detector. Every caller reaching this name can submit text, so it is an address for the component that calls the service rather than one to publish. |
| port | integer | — | 是 | 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 | — | 是 | Base URL of the detector's HTTP API, with the host and the port already composed and no path. A caller posts the texts to check to the content route under it. |
| model | string | — | 是 | Hugging Face model id of the classifier the service loaded, so a caller can record which model gave a verdict. |
| protocol | string | — | 否 | URL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`. |
| metrics_endpoint | string | — | 否 | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics` on the port callers reach. Empty where the component serves none reachable. |
uses 套接字
此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。
未声明 uses 套接字。
附加槽位
Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。
| 槽位 | 选择器 | 必需 | 注入 | 敏感 | 描述 |
|---|---|---|---|---|---|
| model_pull_token | feature.aggrega.ai/kind=secret | 否 | env | 是 | Optional Hugging Face Hub access token for a gated model. When attached, the weights-pull step receives it as an environment variable, and the server itself never does; unattached, weights are pulled anonymously, which the default model allows. |
自注入允许列表
未声明自注入管道。
关系
与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。
使用
此实体未使用目录中的任何内容。
被使用
使用套接字 «auth_core»
使用套接字 «auth_core»
使用套接字 «auth_core»
使用套接字 «auth_core»
使用套接字 «upstream»
使用套接字 «forward_target»
使用套接字 «scrape_target»
使用套接字 «store»
使用套接字 «detector»
使用套接字 «detector»
使用套接字 «jailbreak_detection»
适用于
适用于
适用于
适用于
适用于
适用于
适用于
实现
实现