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.
Provenance
- Empreinte du contenu
- sha256:43a0fdde1aa1ec6947c3a6c2c1d08b6eb852a3c220697cbb88e291e957123852
- Publié
- 2026-11-10T10:10:08Z
- Identité de signature
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officielapplication/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
Référence à cette version
oci://hub.aggrega.ai/component/core/ai-tool/search:1.0.0Paramètres du développeur
Valeurs que le développeur définit dans l’Aggregate.
Étend BaseComponents#/schemas/BaseToolParameter
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| provider | string | tavily | oui | — |
| max_results | integer | 5 | oui | — |
| side_effects | string (read_only) | read_only | oui | — |
Dimensionnement de l’opérateur
Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| endpoint | string | https://api.tavily.com | non | — |
Contrat de sortie
Valeurs que ce composant publie vers les consommateurs via la topologie uses.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| endpoint | string | — | oui | 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 | — | oui | 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 | — | oui | 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
Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.
Aucun socket uses déclaré.
Emplacements d’attache
Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.
Aucun emplacement d’attache déclaré.
Liste d’autorisation d’auto-injection
Aucun canal d’auto-injection déclaré.
Relations
Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.
Utilise
- $refétend le schéma (values)
BaseComponents#/schemas/BaseToolParameter
Utilisé par
implémente
implémente