Component

core/ai-agent/langgraph

A LangGraph agent, run in-cluster as an application image the Release supplies. LangGraph models an agent as a graph whose nodes resume from persisted state rather than as a single call, which is why a datastore is a required topology edge here rather than an option: the store wired into `checkpointer_db` contributes its host and port, and its user and database where it publishes them; a credential attached on that connection contributes its password; and the store is where a run's state survives between steps. What this component exposes is the graph entrypoint inside the application image and the recursion ceiling that stops a graph which is not converging. LangGraph is published as a library an application is built around, so there is no upstream image to pin: the Release supplies its application in `infra.image`. On Kubernetes, until it does, the build halts naming the container image; on Docker Compose the image defaults to the catalog's own quickstart agent, whose own code reads the model's default variables and the store's host and port, and no other. The variables each connection is delivered under are defaults: an `inject:` block on the connection replaces them with the names the application reads, as variables or as files, and a checkpointer connection writing none refuses a store served over TLS alone or over HTTPS, since the application would be handed its host and port and not its protocol. 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.

Version

1.0.01.1.0

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:87150fbcc8434e1b33e7841a429ac28b9f11f992cb756455f05d4385ba196f04
Published
2026-11-10T10:08:14Z
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:074a42ec1a450240331c725a324f99c2ed5517a48a42e006c0579722e307e100

Reference at this version

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

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseAgentParameter

NameTypeDefaultRequiredDescription
graph_entrypointstring—yes—
recursion_limitinteger25yes—

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
imagestring—noContainer image running the LangGraph application code. The Docker Compose Recipe runs the catalog's quickstart agent when it is unset.

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.

checkpointer_db

Selector
component.aggrega.ai/category=datastore
Inject
env, file

Slots each connection through this socket may fill

SlotSelectorRequiredInjectSensitiveDescription
credentialfeature.aggrega.ai/kind=secretnoenvyesOptional password the agent presents to the store this connection reaches, the same password that store holds in its own credential slot. When attached, the Recipe delivers it to the application as LANGGRAPH_CHECKPOINTER_PASSWORD (a Kubernetes secretKeyRef on helm, the inject pipe on compose); unattached, no password variable is rendered.

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