Component
core/ai-agent/claude-agent-sdk
An agent built on the Claude Agent SDK, run in-cluster as an application image the Release supplies. The SDK runs each session in the `claude` command line it bundles, as a process inside that image, so there is no upstream image to pin: the catalog supplies none, and until a Release sets `infra.image` the build halts naming the container image and renders nothing. Deploying it gives that application as a worker wired to a model serving Anthropic's Messages API: the `model` socket takes a model or a gateway whose `model.aggrega.ai/api` is `anthropic`, as `core/ai-model/anthropic` is, and refuses any other. The Recipe delivers the model's endpoint, its model name and the connection's credential as the variables the command line reads. Each tool wired into the optional `tools` socket, such as a Model Context Protocol server reached over HTTP, reaches the application under variables named for the connection's alias: the tool's address as AGGREGA_TOOL_<ALIAS>_URL, and the connection's credential, by reference, as AGGREGA_TOOL_<ALIAS>_CREDENTIAL beside the header to present it under. The SDK reads no tool's address from a variable of its own, so the application names each one in the servers it hands the SDK. An `inject:` block on a connection, or on the component itself, delivers the names the application reads, as variables or files: in place of a tool's address and header, and beside the model's variables. The SDK's Python package is published under the MIT licence. The command line it bundles, in which every session runs, is distributed by Anthropic under its own commercial terms, so the component's `component.aggrega.ai/upstream-licensing` label is `proprietary`.
Procedencia
- Digest del contenido
- sha256:86f5461d5676c88f8b53d171725b5dbc3ed18afeaacaeca88963cd4a723d15e7
- Publicado
- 2026-11-10T10:07:45Z
- Identidad de firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Oficialapplication/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:5699ba4b6dd8d399168df3dd127613de9e762788dc0e82711752dfb1c463d9a0
Referencia en esta versión
oci://hub.aggrega.ai/component/core/ai-agent/claude-agent-sdk:1.0.0Parámetros del desarrollador
Valores que el desarrollador establece en el Aggregate.
Extiende BaseComponents#/schemas/BaseAgentParameter
Dimensionamiento del operador
Dimensionamiento de la infraestructura que el operador ajusta para cada entorno.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| image | string | — | no | Container image running the application built on the Claude Agent SDK, with the command line the SDK bundles. |
Contrato de salida
Valores que este componente publica para los consumidores a través de la topología uses.
No se declararon valores de salida.
Sockets uses
Los sockets de dependencia a través de los cuales se conecta este componente. El destino de cada conexión cableada a través de un socket debe satisfacer su selector de etiquetas, y cada conexión puede llevar un acoplamiento en los slots que declara el socket. Cada conexión que el Aggregate o la Release cablea a través del socket debe llenar los slots obligatorios.
model
- Selector
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api=anthropic
- Inyección
- env, file
Slots que cada conexión a través de este socket puede llenar
| Slot | Selector | Obligatorio | Inyección | Sensible | Descripción |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | sí | Optional credential the agent presents to the model this connection reaches. When attached, the Recipe delivers it to the application as ANTHROPIC_API_KEY (a Kubernetes secretKeyRef on helm, the inject pipe on compose); unattached, the application runs without an injected key. |
tools
- Selector
- component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
- Inyección
- env, file
Slots que cada conexión a través de este socket puede llenar
| Slot | Selector | Obligatorio | Inyección | Sensible | Descripción |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | sí | Optional credential the agent presents to the tool this connection reaches, under the request header the tool publishes as credential_header: as Bearer <credential> under Authorization, and as the whole value of any other header. When attached, the Recipe delivers it as AGGREGA_TOOL_<ALIAS>_CREDENTIAL (a Kubernetes secretKeyRef on helm, the inject pipe on compose), on a connection writing an inject block too, and, on one writing none, the header as AGGREGA_TOOL_<ALIAS>_CREDENTIAL_HEADER where the tool publishes one. |
| endpoint | feature.aggrega.ai/kind=secret | no | env | sí | Optional whole address of the tool this connection reaches, the part carrying its key included, for a server that reads its key from its own address. When attached, the Recipe delivers it as AGGREGA_TOOL_<ALIAS>_URL in place of the endpoint the tool publishes: a Kubernetes secretKeyRef on helm, so the key reaches no rendered file, and the inject pipe on compose, written as delivered. |
Slots de acoplamiento
Puntos de enlace con nombre en los que una Feature se acopla a este componente. El selector de un slot restringe qué Feature puede llenarlo y su lista inject indica cómo puede entregarse el material de la Feature. Un slot obligatorio debe estar enlazado en cada instancia, mediante un acoplamiento en la instancia o en un ámbito superior, y un slot sensible se declara para manejar material secreto. Una Feature también puede acoplarse con un nombre que ningún slot declara.
No se declararon slots de acoplamiento.
Lista de permitidos de autoinyección
env, file
Relaciones
Aristas tipadas hacia y desde otras entidades publicadas. Una referencia sin un destino publicado se muestra como una arista rota en lugar de como un enlace.
Usa
- usausa el socket «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api=anthropic
Slots de acoplamiento: credential
- usausa el socket «tools»
component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
Slots de acoplamiento: credential, endpoint
- $refextiende el esquema (values)
BaseComponents#/schemas/BaseAgentParameter
Usado por
usa el socket «runner»
usa el socket «api»
usa el socket «runner»
usa el socket «api»
usa el socket «services»
usa el socket «api»
usa el socket «services»
usa el socket «services»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «api»
usa el socket «ssrf_proxy»
usa el socket «api»
usa el socket «api»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «target_agent»
usa el socket «scrape_target»
se aplica a
se aplica a
se aplica a
implementa
implementa