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`.
Procedê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 desenvolvedor
Valores que o desenvolvedor define no Aggregate.
Estende BaseComponents#/schemas/BaseAgentParameter
Dimensionamento do operador
Dimensionamento de infraestrutura que o operador ajusta por ambiente.
| Nome | Tipo | Padrã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 pela topologia uses.
Nenhum valor de saída declarado.
Sockets uses
Os sockets de dependência pelos quais este componente se conecta. O destino de cada conexão ligada por um socket deve satisfazer o seletor de rótulos dele, e cada conexão pode carregar um acoplamento nos slots que o socket declara. Cada conexão que o Aggregate ou a Release liga pelo socket deve 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 conexão por este 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 conexão por este 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 nomeados nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual Feature pode preenchê-lo, e sua lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório deve estar vinculado em cada instância, por um acoplamento na instância ou em um escopo acima dela, e um slot sensível é declarado para lidar com material secreto. Uma Feature também pode se acoplar com um nome que nenhum slot declara.
Nenhum slot de acoplamento declarado.
Lista de permissões de autoinjeção
env, file
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é exibida como uma aresta quebrada em vez de um link.
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