Component
core/ai-agent/google-adk
An agent built on Google's Agent Development Kit (ADK), run in-cluster as an application image the Release supplies. ADK is a library an application is built around, so the catalog pins no image; the build halts naming `infra.image` until a Release sets it. It runs as a server on `infra.port`, 8000 by default like ADK's own API server: the REST API of `adk api_server` or of an application built on ADK's `get_fast_api_app()`, with `/list-apps`, session routes under `/apps/`, `/run` and `/run_sse`. The image listens on every interface, not `adk api_server`'s default 127.0.0.1, and receives the port as PORT, which ADK's container guide reads. ADK documents those endpoints as unauthenticated, for a trusted network, and the component publishes them on the cluster network alone, as host, port, endpoint and protocol; attaching core/public-ingress or core/http-route halts the build until `infra.routes_authenticated` affirms the application authenticates them. The `model` socket takes a model, never a gateway, carrying `model.aggrega.ai/api: gemini`, such as `core/ai-model/gemini`, and delivers the connection's credential, by reference, as GOOGLE_API_KEY, which ADK's Gemini client sends to the Gemini API; it reads no address or model name from its environment, so the agent's code names the model. Each tool wired to the optional `tools` socket, such as an HTTP Model Context Protocol server, reaches the application as AGGREGA_TOOL_<ALIAS>_URL, beside any credential its connection carries. An `inject:` block on any connection, or on the component itself, delivers names the application reads, as variables or files, a tools connection's in place of the tool's address and header.
Версия
Происхождение
- Дайджест содержимого
- sha256:470a7b93ce8c33794c567c2e558534494cab8a99dc2ec7552332d4f4b1c4af28
- Опубликовано
- 2026-11-10T10:08:04Z
- Идентичность подписи
- 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:9cd240323783fd241fd67f875fe0b79a6fd1dd465d9a7f7899e715b7f8890ef8
Ссылка на эту версию
oci://hub.aggrega.ai/component/core/ai-agent/google-adk:1.0.0Параметры разработчика
Значения, которые разработчик задаёт в сущности Aggregate.
Расширяет BaseComponents#/schemas/BaseAgentParameter
Размеры, задаваемые оператором
Размеры инфраструктуры, которые оператор настраивает для каждого окружения.
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| image | string | — | нет | Container image running the application built on ADK, serving its API on infra.port on every interface. |
| port | integer (min 1024, max 65535) | 8000 | нет | Port the application's server listens on, delivered to it as PORT, and the port the component publishes. |
| routes_authenticated | boolean | false | нет | Operator affirmation that the application authenticates every request its routes take. While false, its default, a core/public-ingress or core/http-route attachment on this component halts the build, because ADK's endpoints otherwise answer any caller. An attachment is matched by those two Feature names, so one of a Feature that extends either under another name is not refused, though it may publish the routes as well. It changes nothing this component renders. |
Контракт выходных значений
Значения, которые этот компонент публикует для потребителей через топологию uses.
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| host | string | — | да | DNS name a caller reaches the application's server at: the Service's name on Kubernetes, the service's name on the compose network. A caller that composes its own address dials this name; one that does not reads `endpoint` instead. |
| port | integer | — | да | TCP port the application's server is reached on, following infra.port. |
| endpoint | string | — | да | Base URL of the application's server, with the host and the port already composed. ADK's REST routes, such as /list-apps and /run, sit under it. |
| protocol | string | — | нет | URL scheme to reach `host` and `port` over, for a caller composing its own address rather than reading `endpoint`. |
Сокеты uses
Сокеты зависимостей, через которые подключается этот компонент. Цель каждого соединения, проведённого через сокет, должна удовлетворять его селектору меток, и каждое соединение может нести подключение в слотах, которые объявляет сокет. Обязательный слот должен заполнить каждое соединение, которое сущность Aggregate или сущность Release проводит через сокет.
model
- Селектор
- component.aggrega.ai/category=ai-model, model.aggrega.ai/api=gemini
- Внедрение
- env, file
Слоты, которые может заполнить каждое соединение через этот сокет
| Слот | Селектор | Обязательный | Внедрение | Конфиденциальный | Описание |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | нет | env | да | Optional credential the agent presents to the model this connection reaches. When attached, the Recipe delivers it to the application as GOOGLE_API_KEY (a Kubernetes secretKeyRef on helm, the inject pipe on compose); unattached, the application runs without an injected key. |
tools
- Селектор
- component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
- Внедрение
- env, file
Слоты, которые может заполнить каждое соединение через этот сокет
| Слот | Селектор | Обязательный | Внедрение | Конфиденциальный | Описание |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | нет | env | да | 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 | нет | env | да | 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. |
Слоты подключения
Именованные точки привязки, в которых Feature подключается к этому компоненту. Селектор слота ограничивает, какая сущность Feature может его заполнить, а его список внедрения указывает, как могут доставляться материалы сущности Feature. Обязательный слот должен быть привязан в каждом экземпляре — подключением в самом экземпляре или в области выше него, — а конфиденциальный слот объявляется для работы с секретными материалами. Feature также может подключаться под именем, которое не объявляет ни один слот.
Слоты подключения не объявлены.
Список разрешённых самовнедрений
env, file
Связи
Типизированные рёбра к другим опубликованным сущностям и от них. Ссылка без опубликованной цели отображается как разорванное ребро, а не как ссылка.
Использует
- используетиспользует сокет «model»
component.aggrega.ai/category=ai-model, model.aggrega.ai/api=gemini
Слоты подключения: credential
- используетиспользует сокет «tools»
component.aggrega.ai/category=ai-tool, tool.aggrega.ai/transport=http
Слоты подключения: credential, endpoint
- $refрасширяет схему (values)
BaseComponents#/schemas/BaseAgentParameter
Используется в
использует сокет «runner»
использует сокет «api»
использует сокет «runner»
использует сокет «api»
использует сокет «services»
использует сокет «api»
использует сокет «services»
использует сокет «services»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «api»
использует сокет «ssrf_proxy»
использует сокет «api»
использует сокет «api»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «sandbox»
использует сокет «plugin_daemon»
использует сокет «ssrf_proxy»
использует сокет «target_agent»
использует сокет «upstream»
использует сокет «forward_target»
использует сокет «scrape_target»
использует сокет «store»
применяется к
применяется к
применяется к
применяется к
применяется к
применяется к
применяется к
реализует
реализует