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`.
Proveniência
- Digest do conteúdo
- sha256:86f5461d5676c88f8b53d171725b5dbc3ed18afeaacaeca88963cd4a723d15e7
- Publicado
- 2026-11-10T10:07:45Z
- Identidade de assinatura
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Assinatura
- 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
Referência nesta versão
oci://hub.aggrega.ai/component/core/ai-agent/claude-agent-sdk:1.0.0Parâmetros do programador
Valores que o programador define no Aggregate.
Estende BaseComponents#/schemas/BaseAgentParameter
Dimensionamento do operador
Dimensionamento da infraestrutura que o operador ajusta por ambiente.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| image | string | — | não | Container image running the application built on the Claude Agent SDK, with the command line the SDK bundles. |
Contrato de saída
Valores que este componente publica para os consumidores através da topologia uses.
Nenhum valor de saída declarado.
Sockets uses
Os sockets de dependência através dos quais este componente se liga. O destino de cada ligação estabelecida através de um socket tem de satisfazer o respetivo seletor de etiquetas, e cada ligação pode transportar um acoplamento nos slots que o socket declara. Cada ligação que o Aggregate ou a Release estabelece através do socket tem de preencher os slots obrigatórios.
model
- Seletor
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api=anthropic
- Injeção
- env, file
Slots que cada ligação através deste socket pode preencher
| Slot | Seletor | Obrigatório | Injeção | Sensível | Descrição |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | não | env | sim | 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
- Seletor
- component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
- Injeção
- env, file
Slots que cada ligação através deste socket pode preencher
| Slot | Seletor | Obrigatório | Injeção | Sensível | Descrição |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | não | env | sim | 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 | não | env | sim | 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 acoplamento
Pontos de vinculação com nome nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual a Feature que o pode preencher, e a respetiva lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório tem de estar vinculado em cada instância, por um acoplamento na instância ou num âmbito acima dela, e um slot sensível é declarado para tratar material secreto. Uma Feature também se pode acoplar com um nome que nenhum slot declara.
Nenhum slot de acoplamento declarado.
Lista de autorizações de autoinjeção
env, file
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é apresentada como uma aresta quebrada em vez de uma ligação.
Usa
- usausa o socket «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api=anthropic
Slots de acoplamento: credential
- usausa o socket «tools»
component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
Slots de acoplamento: credential, endpoint
- $refestende o esquema (values)
BaseComponents#/schemas/BaseAgentParameter
Usado por
usa o socket «runner»
usa o socket «api»
usa o socket «runner»
usa o socket «api»
usa o socket «services»
usa o socket «api»
usa o socket «services»
usa o socket «services»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «api»
usa o socket «ssrf_proxy»
usa o socket «api»
usa o socket «api»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «target_agent»
usa o socket «scrape_target»
aplica-se a
aplica-se a
aplica-se a
implementa
implementa