Component
core/ai-tool/computer-use
A tool that presents an agent with a virtual desktop it can see and control, taking screenshots and issuing pointer and keyboard input, so a deployment can automate applications that expose neither an API nor a web page. The desktop's screen geometry is set by the developer, defaulting to 1024 by 768, because the agent reasons over the pixels it is given. Declared as a server: the desktop session is a long-running workload the agent connects to. Marked mutating, since that input drives real applications. Realized on Kubernetes as a single-replica Deployment fronted by a ClusterIP Service, so one desktop stays resident across an agent's turns and every screenshot comes from the session the previous input acted on. An edge from the tool, on a socket the author names, delivers what its `inject:` block dictates, as variables or as files, on every realization that runs the tool. The catalog pins no image, so nothing renders until the Release sets `infra.image`. The component's own `inject:` block takes `env` and `file` entries too, and one reading a value of the tool alone replaces that value's default variable name.
Происхождение
- Дайджест содержимого
- sha256:82a9932e7d9a2f8df015ccf1814bfe926f694228b0130e9671b35c479612fa5a
- Опубликовано
- 2026-11-10T10:09:51Z
- Идентичность подписи
- 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:8a22dc63826efb86a642d370ac08613c89b9139de18a4a7c039f609c3bb99964
Ссылка на эту версию
oci://hub.aggrega.ai/component/core/ai-tool/computer-use:1.0.0Параметры разработчика
Значения, которые разработчик задаёт в сущности Aggregate.
Расширяет BaseComponents#/schemas/BaseToolParameter
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| display_width | integer | 1024 | да | — |
| display_height | integer | 768 | да | — |
Размеры, задаваемые оператором
Размеры инфраструктуры, которые оператор настраивает для каждого окружения.
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| image | string | — | нет | Container image serving the desktop session and its control API over HTTP. |
| port | integer (min 1024, max 65535) | 8080 | нет | Port the tool listens on, and the port it publishes to consumers. |
| compute | object | — | нет | — |
Контракт выходных значений
Значения, которые этот компонент публикует для потребителей через топологию uses.
| Имя | Тип | По умолчанию | Обязательный | Описание |
|---|---|---|---|---|
| host | string | — | да | In-cluster DNS name an agent calls to see and control the desktop. A consumer that composes its own address dials this name; one that does not reads `endpoint` instead. |
| port | integer | — | да | TCP port the control API is accepted on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default. |
| endpoint | string | — | да | Full base URL an agent sends screenshot and input requests to, with the host and the port already composed. A consumer hands it to its tool client as the address it calls. |
| protocol | string | — | нет | URL scheme to reach `host` and `port` over, for a consumer composing its own address rather than reading `endpoint`. |
Сокеты uses
Сокеты зависимостей, через которые подключается этот компонент. Цель каждого соединения, проведённого через сокет, должна удовлетворять его селектору меток, и каждое соединение может нести подключение в слотах, которые объявляет сокет. Обязательный слот должен заполнить каждое соединение, которое сущность Aggregate или сущность Release проводит через сокет.
Сокеты uses не объявлены.
Слоты подключения
Именованные точки привязки, в которых Feature подключается к этому компоненту. Селектор слота ограничивает, какая сущность Feature может его заполнить, а его список внедрения указывает, как могут доставляться материалы сущности Feature. Обязательный слот должен быть привязан в каждом экземпляре — подключением в самом экземпляре или в области выше него, — а конфиденциальный слот объявляется для работы с секретными материалами. Feature также может подключаться под именем, которое не объявляет ни один слот.
Слоты подключения не объявлены.
Список разрешённых самовнедрений
env, file
Связи
Типизированные рёбра к другим опубликованным сущностям и от них. Ссылка без опубликованной цели отображается как разорванное ребро, а не как ссылка.
Использует
- $refрасширяет схему (values)
BaseComponents#/schemas/BaseToolParameter
Используется в
использует сокет «upstream»
использует сокет «forward_target»
использует сокет «scrape_target»
использует сокет «store»
применяется к
применяется к
применяется к
применяется к
применяется к
применяется к
применяется к
реализует