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

Component

core/ai-tool/agent-invocation

A tool letting one agent delegate a step to another over an agent-to-agent protocol, A2A by default: the caller waits synchronously for a result, asynchronously for a handle it polls, or not at all, fire-and-forget. Its required agent socket resolves the target by topology, not prompt. Marked mutating: a delegated agent may act in the world. Realized on Kubernetes as a Knative Service scaled to zero between calls yet admitting each, it publishes a host, port, endpoint and protocol for a consumer to wire to. The catalog pins no image, so nothing renders until the Release sets `infra.image`. The agent'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. The component's own `inject:` block adds `env` and `file` entries beside them, and one reading a tool value alone replaces that value's default name. The connection may hold a credential, presented under the agent's published credential_header, its Secret holding the whole value: an API key in a header or cookie, or an HTTP scheme such as Bearer or Basic; a client_secret, for the OAuth 2.0 client-credentials grant, directly or through OpenID Connect; and, for mutual TLS, a client_certificate, mounted as files. A server_ca, also mounted, names the agent's server certificate authority. The build halts on a connection to an agent labelled managed with none of credential, client_secret, client_certificate or unauthenticated: true, and on a credential or client_secret to one labelled external publishing protocol http; to an agent inside the Release, http carries the credential or token unencrypted on the cluster network.

来源

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

此版本的引用

oci://hub.aggrega.ai/component/core/ai-tool/agent-invocation:1.0.0

开发者参数

开发者在 Aggregate 中设置的值。

扩展 BaseComponents#/schemas/BaseToolParameter

名称类型默认值必需描述
protocolstringa2a是—
execution_modestring (synchronous | asynchronous | fire_and_forget)synchronous是—

运维规格

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

名称类型默认值必需描述
imagestring—否Container image serving the delegation 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 delegate a step to the wired agent. A consumer that composes its own address dials this name; one that does not reads `endpoint` instead.
portinteger—是TCP port the delegation 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 delegation 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_agent

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

经由此套接字的每个连接可填充的槽位

槽位选择器必需注入敏感描述
credentialfeature.aggrega.ai/kind=secret否env是Optional credential the tool presents to the agent this connection reaches, under the request header that agent publishes as credential_header. When attached, the Recipe delivers it to the tool's container as AGENT_TOOL_TARGET_CREDENTIAL, a Kubernetes secretKeyRef to the Secret the credential publishes, and, on a connection writing no inject block, the header as AGENT_TOOL_TARGET_CREDENTIAL_HEADER where the agent publishes one; a credential publishing no Secret name and data key halts the build, and so does one on a connection to an agent labelled component.aggrega.ai/hosting external that publishes protocol http, to which it would travel unencrypted. An agent inside the Release that publishes protocol http receives it unencrypted on the cluster network. The Secret's value is the whole header value, delivered unchanged for the container to present as it is, with no prefix added: the key, for an API key the agent's card places in a header; the cookie's name, "=" and the key, under a credential_header of Cookie, for one it places in a cookie; and the scheme's name, a space and the credential, as "Bearer " and a token, for an HTTP scheme whose value is fixed, such as Bearer or Basic. An API key the card places in the query string, an HTTP scheme whose value answers a challenge from the agent, such as Digest, and two header credentials required together are not covered; OAuth 2.0 and OpenID Connect take client_secret, and mutual TLS client_certificate. Fill it with core/referenced-secret mapped to helm/k8s-existing-secret, naming a Secret the namespace already holds: a realization that names its Secret after the tool, such as k8s-external-secret or k8s-secret-from-parameter, halts the build here, because the Recipe renders its Service from an artifacts template and gives the tool no rendered name. Unattached, the tool runs without an injected credential.
client_secretfeature.aggrega.ai/kind=secret否env是Optional client secret the tool's container sends, with client_id, to the agent's authorization server to obtain an access token by the OAuth 2.0 client-credentials grant, at the token_url the agent publishes or the token endpoint its oidc_discovery_url names. Delivered as AGENT_TOOL_TARGET_CLIENT_SECRET, a Kubernetes secretKeyRef to the Secret it publishes, beside AGENT_TOOL_TARGET_CLIENT_ID and AGENT_TOOL_TARGET_AUDIENCE and, on a connection writing no inject block, AGENT_TOOL_TARGET_TOKEN_URL, AGENT_TOOL_TARGET_OIDC_DISCOVERY_URL and AGENT_TOOL_TARGET_SCOPES, each where it has a value. Obtaining, caching and refreshing the token, and presenting it on each request, are the container's. The other OAuth 2.0 flows a card may declare, authorization code, device code, implicit and password, are not covered. The build halts on a client_secret with no client_id, on one wired to an agent publishing neither token_url nor oidc_discovery_url, on either address when it is not an https URL naming a host or carries a user name or password, and on one wired to an agent labelled component.aggrega.ai/hosting external that publishes protocol http, to which the token obtained with it would travel unencrypted. An agent inside the Release that publishes protocol http receives the token unencrypted on the cluster network. Fill it as credential is filled; it may sit beside credential on one connection.
client_certificatefeature.aggrega.ai/kind=secret否file是Optional client certificate the tool's container presents in the TLS handshake to an agent whose card requires mutual TLS. Its Secret holds tls.crt, the certificate, and tls.key, its private key, as a kubernetes.io/tls Secret does. The Recipe mounts the whole Secret read-only into the tool's container and delivers AGENT_TOOL_TARGET_CLIENT_CERT_FILE and AGENT_TOOL_TARGET_CLIENT_KEY_FILE naming the two files; presenting the certificate, and reading the files again when a renewal updates them, are the container's. The build halts on a client_certificate publishing no Secret name, on one wired to an agent publishing protocol http, and on one wired to an agent publishing no protocol and an endpoint that is not an https URL. Fill it with core/referenced-secret mapped to helm/k8s-existing-secret, naming a Secret the namespace already holds; the data key it publishes is not read, since the whole Secret is mounted. It may sit beside credential or client_secret on one connection.
server_cafeature.aggrega.ai/kind=secret否file是Optional authority the tool's container checks the agent's server certificate against, where the image does not already trust the authority that signs it. Its Secret holds ca.crt: the agent's server authority, not the issuer of a client certificate, so a ca.crt written beside a client certificate is not this one. The Recipe mounts the whole Secret read-only into the tool's container and delivers AGENT_TOOL_TARGET_SERVER_CA_FILE naming the file; checking the agent's certificate against it is the container's. It serves a connection holding any credential, or none. The build halts on a server_ca publishing no Secret name, on one wired to an agent publishing protocol http, and on one wired to an agent publishing no protocol and an endpoint that is not an https URL. Fill it as client_certificate is filled.

附加槽位

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

未声明附加槽位。

自注入允许列表

env, file

关系

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

使用

被使用

Component 概念参考 →

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

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

隐私