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
- 署名 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:6caa9488c89e18da3ed706679927efe50d215f5c66051cbb0c419516d26e3347
このバージョンの参照
oci://hub.aggrega.ai/component/core/ai-tool/datastore-query:1.0.0開発者パラメーター
開発者が Aggregate で設定する値です。
BaseComponents#/schemas/BaseToolParameter を拡張
| 名前 | 型 | デフォルト | 必須 | 説明 |
|---|---|---|---|---|
| dialect | string | sql | はい | — |
| side_effects | string (read_only) | read_only | はい | — |
運用担当者によるサイジング
運用担当者が環境ごとに調整するインフラストラクチャのサイジングです。
| 名前 | 型 | デフォルト | 必須 | 説明 |
|---|---|---|---|---|
| image | string | — | いいえ | Container image serving the query over HTTP. |
| port | integer (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. |
| compute | object | — | いいえ | — |
| min_replicas | integer (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_replicas | integer (min 1) | 5 | いいえ | Replica ceiling the realization's autoscaler may reach. |
| control_plane_present | boolean | false | いいえ | 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. |
| overrides | object (open) | — | いいえ | Realization-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
出力コントラクト
このコンポーネントが uses トポロジを通じて利用側に公開する値です。
| 名前 | 型 | デフォルト | 必須 | 説明 |
|---|---|---|---|---|
| host | string | — | はい | 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. |
| port | integer | — | はい | 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. |
| endpoint | string | — | はい | 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. |
| protocol | string | — | いいえ | 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
関係
他の公開エンティティとの間の型付きエッジです。公開されたターゲットがない参照は、リンクではなく切れたエッジとして表示されます。
使用先
- 使用ソケット «target_datastore» を使用
component.aggrega.ai/category=datastore
アタッチメントスロットを宣言していません。
core/datastore/chroma v1.0.0 →core/datastore/cognee v1.0.0 →core/datastore/documentdb v1.0.0 →core/datastore/elasticsearch v1.0.0 →core/datastore/etcd v1.0.0 →core/datastore/ferretdb v1.0.0 →core/datastore/mariadb v1.0.0 →core/datastore/mariadb-operator v1.0.0 →core/datastore/memcached v1.0.0 →core/datastore/milvus v1.0.0 →core/datastore/mysql v1.0.0 →core/datastore/mysql-innodb-cluster v1.0.0 →core/datastore/mysql-operator v1.0.0 →core/datastore/opensearch v1.0.0 →core/datastore/pgvector v1.0.0 →core/datastore/postgres v1.0.0 →core/datastore/qdrant v1.0.0 →core/datastore/redis v1.0.0 →core/datastore/timescaledb v1.0.0 →core/datastore/valkey v1.0.0 →core/datastore/weaviate v1.0.0 → - $refスキーマを拡張(values)
BaseComponents#/schemas/BaseToolParameter
使用元
適用対象
実装