本页面为机器翻译。阅读英文原文。

Component

core/ai-tool/datastore-query

A read-only tool that answers an agent's questions by querying a datastore the topology has wired to it. The query dialect is chosen by the developer and defaults to SQL. It declares a required socket onto a datastore component, so the store it reads is resolved as a topology edge rather than supplied as a connection string in a prompt, and its effect is pinned read-only in its own schema — it cannot be widened to write. Realized on Kubernetes as a Knative Service, which admits an inbound call while the tool is running no replicas, so the tool occupies no compute between the calls that invoke it. It publishes a host, port, endpoint and protocol, and a consumer wires to those without naming how the tool runs. The catalog pins no image, so nothing renders until the Release sets `infra.image`. The store's address reaches the tool's code under default variable names; an `inject:` block on the connection delivers instead, as variables or files, the names that code reads. A store served over TLS alone halts the build on a connection writing none. The component's own `inject:` block takes `env` and `file` entries too, and one reading a value of the tool alone replaces that value's default variable name.

来源

官方由本目录认定为官方发布者的签名身份签名。
内容摘要
sha256:854f1ad3438f95aa0e35e8b2cd7f957e0882fb971b191b48d09abc5349ddf34a
发布时间
2026-11-10T10:09:52Z
签名身份
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:6caa9488c89e18da3ed706679927efe50d215f5c66051cbb0c419516d26e3347

此版本的引用

oci://hub.aggrega.ai/component/core/ai-tool/datastore-query:1.0.0

开发者参数

开发者在 Aggregate 中设置的值。

扩展 BaseComponents#/schemas/BaseToolParameter

名称类型默认值必需描述
dialectstringsql是—
side_effectsstring (read_only)read_only是—

运维规格

运维人员按环境调整的基础设施规格。

名称类型默认值必需描述
imagestring—否Container image serving the query over HTTP.
portinteger (min 1024, max 65535)8080否Port the tool's own container listens on. A consumer does not necessarily connect here: the realization publishes the address callers use, and a control plane that fronts the tool routes from its own port to this one.
computeobject—否—
min_replicasinteger (min 0)0否Replica floor. Zero is what lets the tool run no replicas between calls, which the realization reaches through its control plane.
max_replicasinteger (min 1)5否Replica ceiling the realization's autoscaler may reach.
control_plane_presentbooleanfalse否Operator affirmation that Knative Serving, the control plane the realization needs, is installed in the target cluster. The build halts unless this is set true, so a custom resource is never emitted as an orphan into a cluster that cannot reconcile it.
overridesobject (open)—否Realization-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

输出契约

此组件通过 uses 拓扑向使用方发布的值。

名称类型默认值必需描述
hoststring—是In-cluster DNS name an agent calls to query the wired datastore. A consumer that composes its own address dials this name; one that does not reads `endpoint` instead.
portinteger—是TCP port the query request is accepted on. The realization fronts the tool on the control plane's own port rather than the tool container's, so a consumer reads this rather than the port an operator set.
endpointstring—是Full base URL an agent posts a query to, with the host and the port already composed. A consumer hands it to its tool client as the address it calls.
protocolstring—否URL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`.

uses 套接字

此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。

target_datastore

选择器
component.aggrega.ai/category=datastore
注入
env, file

此套接字未声明附加槽位,因此经由它的连接不携带任何附加项。

附加槽位

Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。

未声明附加槽位。

自注入允许列表

env, file

关系

与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。

Component 概念参考 →

Aggrega 目录 — 收录组件、功能、配方以及渲染它们的插件的开放索引。

基于共享的 Aggrega 设计系统构建。

隐私