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.
Proveniência
- Digest do conteúdo
- sha256:43a0fdde1aa1ec6947c3a6c2c1d08b6eb852a3c220697cbb88e291e957123852
- Publicado
- 2026-11-10T10:10:08Z
- 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:2a0b75f5bd739e49d847017b2c0e426b82366fb940990c4746260ad0608ba8b0
Referência nesta versão
oci://hub.aggrega.ai/component/core/ai-tool/search:1.0.0Parâmetros do programador
Valores que o programador define no Aggregate.
Estende BaseComponents#/schemas/BaseToolParameter
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| provider | string | tavily | sim | — |
| max_results | integer | 5 | sim | — |
| side_effects | string (read_only) | read_only | sim | — |
Dimensionamento do operador
Dimensionamento da infraestrutura que o operador ajusta por ambiente.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| endpoint | string | https://api.tavily.com | não | — |
Contrato de saída
Valores que este componente publica para os consumidores através da topologia uses.
| Nome | Tipo | Predefinição | Obrigatório | Descrição |
|---|---|---|---|---|
| endpoint | string | — | sim | 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 | — | sim | 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 | — | sim | 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
Os sockets de dependência através dos quais este componente se liga. O destino de cada ligação estabelecida através de um socket tem de satisfazer o respetivo seletor de etiquetas, e cada ligação pode transportar um acoplamento nos slots que o socket declara. Cada ligação que o Aggregate ou a Release estabelece através do socket tem de preencher os slots obrigatórios.
Nenhum socket uses declarado.
Slots de acoplamento
Pontos de vinculação com nome nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual a Feature que o pode preencher, e a respetiva lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório tem de estar vinculado em cada instância, por um acoplamento na instância ou num âmbito acima dela, e um slot sensível é declarado para tratar material secreto. Uma Feature também se pode acoplar com um nome que nenhum slot declara.
Nenhum slot de acoplamento declarado.
Lista de autorizações de autoinjeção
Nenhum canal de autoinjeção declarado.
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é apresentada como uma aresta quebrada em vez de uma ligação.
Usa
- $refestende o esquema (values)
BaseComponents#/schemas/BaseToolParameter
Usado por
implementa
implementa