Component
core/ai-tool/http-request
A tool that lets an agent make an HTTP request, for reaching a service that has no more specific tool of its own. The developer fixes the method the tool may use, defaulting to POST, and may reference a schema the request body is expected to satisfy. Fixing the method at authoring time keeps one tool from being repurposed as another: a tool declared for GET cannot be directed to write. Marked mutating, since a request may change state in the service it reaches. 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 calls. It publishes a host, port, endpoint and protocol, and a consumer wires to those without naming how the tool runs. An edge from the tool, on a socket the author names, delivers what its `inject:` block dictates, as variables or as files, on every realization that runs the tool. The catalog pins no image, so nothing renders until the Release sets `infra.image`. 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:a22a8270d5d680fffab4be39aec29e9fa6e12c6b1653a9ef290dce486bdc180e
- 发布时间
- 2026-11-10T10:09: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:a3c0eac97870ab704f88d785fcbcc5b99746c5d7aa6758d74bcb52d0f1573b48
此版本的引用
oci://hub.aggrega.ai/component/core/ai-tool/http-request:1.0.0开发者参数
开发者在 Aggregate 中设置的值。
扩展 BaseComponents#/schemas/BaseToolParameter
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| method | string (POST | GET | PUT) | POST | 是 | — |
| payload_schema_ref | string | — | 否 | — |
运维规格
运维人员按环境调整的基础设施规格。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| image | string | — | 否 | Container image serving the tool 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 make an outward HTTP request. A consumer that composes its own address dials this name; one that does not reads `endpoint` instead. |
| port | integer | — | 是 | TCP port the 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 calls the tool at, with the host and the port already composed. It addresses the tool, not the service the tool goes on to reach. |
| protocol | string | — | 否 | URL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`. |
uses 套接字
此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。
未声明 uses 套接字。
附加槽位
Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。
未声明附加槽位。
自注入允许列表
env, file
关系
与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。
使用
- $ref扩展模式(values)
BaseComponents#/schemas/BaseToolParameter
被使用
适用于
实现