Component
core/ai-tool/search
A read-only tool that answers an agent's question from the public web through a managed search API, so a deployment can reach current information without operating a crawler or an index of its own. The developer names the search provider, defaulting to Tavily, and how many results a query returns, defaulting to five. Declared as a resource: the search service is operated outside the deployment, which consumes it rather than running it. Its effect is pinned read-only in its own schema. Realized on Kubernetes and on Docker Compose as a reference realization, selected in the Manifest: neither provisions anything and no container runs for the tool. On Kubernetes the helm provider emits an ExternalName Service mapping an in-cluster name onto the search API's base address; on Compose no service is defined for it, and the address reaches the consuming service through the injection context instead. Both publish the same base address, provider name and result count, so a consumer wires to either unchanged.
Procedencia
- Digest del contenido
- sha256:43a0fdde1aa1ec6947c3a6c2c1d08b6eb852a3c220697cbb88e291e957123852
- Publicado
- 2026-11-10T10:10:08Z
- 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:2a0b75f5bd739e49d847017b2c0e426b82366fb940990c4746260ad0608ba8b0
Referencia en esta versión
oci://hub.aggrega.ai/component/core/ai-tool/search:1.0.0Parámetros del desarrollador
Valores que el desarrollador establece en el Aggregate.
Extiende BaseComponents#/schemas/BaseToolParameter
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| provider | string | tavily | sí | — |
| max_results | integer | 5 | sí | — |
| side_effects | string (read_only) | read_only | sí | — |
Dimensionamiento del operador
Dimensionamiento de la infraestructura que el operador ajusta para cada entorno.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| endpoint | string | https://api.tavily.com | no | — |
Contrato de salida
Valores que este componente publica para los consumidores a través de la topología uses.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| endpoint | string | — | sí | Base URL of the managed search API the tool queries. The Release supplies it, so an operator may point it at a different host without the Aggregate changing. |
| provider | string | — | sí | Name of the search service behind the endpoint, carried through from the value the Aggregate declared. A consumer reads it to know whose results it is reading and whose terms it is bound by. |
| max_results | integer | — | sí | How many results a single query returns, carried through from the value the Aggregate declared. A consumer reads it to size the material it will put in front of a model. |
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.
No se declararon sockets uses.
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
No se declararon canales de autoinyección.
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
- $refextiende el esquema (values)
BaseComponents#/schemas/BaseToolParameter
Usado por
implementa
implementa