Component

core/ai-agent/llamaindex

A LlamaIndex agent, run in-cluster as an application image the Release supplies. LlamaIndex offers several distinct ways for an agent to reach an answer rather than one — reasoning and acting a step at a time, delegating tool selection to the model's own tool-calling, or planning the whole sequence before any of it runs — and that choice is the value this component insists on, alongside the system prompt the agent works under and a ceiling on how many tool calls a single run may make. Deploying it gives that agent as a worker wired to a model on the `model` socket, so one image runs against any model in the catalog. The catalog supplies no image for it — LlamaIndex is published as a library an application is built around, so there is no upstream image to pin — and until a Release sets `infra.image` the build halts naming the container image and renders nothing. An `inject:` block on the model connection delivers the names the application reads, as variables or as files, in place of the model-name variable the Recipes choose by default; the endpoint variable the client SDK reads and the attached key stay. Its Recipes deliver each own value under a default variable name; the component's own `inject:` block takes `env` and `file` entries, and one reading a value alone replaces that value's default name.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:8ecb518fa9de94671a0dc115d59b47db1ebf8835e53c68feb4fd0d652144c8de
Published
2026-11-10T10:08:24Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/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:26402593d105f586ba18855c8a532104886790e416f02ce496276808d58c6c0e

Reference at this version

oci://hub.aggrega.ai/component/core/ai-agent/llamaindex:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseAgentParameter

NameTypeDefaultRequiredDescription
agent_modestring (react | openai_tools | rewoo)reactyes—
system_promptstring—no—
max_function_callsinteger10yes—
log_levelstring (DEBUG | INFO | WARNING | ERROR | CRITICAL)INFOyesLog verbosity the agent emits. At DEBUG the agent narrates each step of its reasoning as it works; INFO and above report progress and problems only.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
imagestring—noContainer image running the LlamaIndex application code.

Output contract

Values this component publishes to consumers over the uses topology.

No output values declared.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

model

Selector
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Inject
env, file

Slots each connection through this socket may fill

SlotSelectorRequiredInjectSensitiveDescription
credentialfeature.aggrega.ai/kind=secretnoenvyesOptional credential the agent presents to the model this connection reaches. When attached, the Recipe delivers it to the application as OPENAI_API_KEY (a Kubernetes secretKeyRef on helm, the inject pipe on compose); unattached, the application runs without an injected key.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

No attachment slots declared.

Self-inject allowlist

env, file

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

Used by

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy