Cette page a été traduite automatiquement. Lire l’original en anglais.

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, and it is published on 127.0.0.1 only where `infra.published_port` asks. 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

OfficielSigné par une identité de signature que ce catalogue reconnaît comme éditeur officiel.
Empreinte du contenu
sha256:89d61f17b0fdfec710676f580fed812fb93ac09e5fccb5ecfba7181c7a206ce3
Publié
2026-11-15T08:08:55Z
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:9d4570d57bcd21ff7384907ead4ea3c04ad4d102737369ce1f1de916e00a63ff

Référence à cette version

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

Paramètres du développeur

Valeurs que le développeur définit dans l’Aggregate.

Étend BaseComponents#/schemas/BaseAgentParameter

NomTypeValeur par défautObligatoireDescription
graph_entrypointstring—oui—
recursion_limitinteger25oui—

Dimensionnement de l’opérateur

Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.

NomTypeValeur par défautObligatoireDescription
imagestring—nonContainer image running the LangGraph application code. The Docker Compose Recipe runs the catalog's quickstart agent when it is unset.
portinteger (min 1024, max 65535)8000nonPort the application listens on inside its container, 8000 for the catalog's quickstart agent. The Recipes deliver nothing for it, since the application's own code picks its port; it names that port, which infra.published_port forwards to on Docker Compose.
published_portinteger (min 1024, max 65535)—nonPort published on the host's loopback address, 127.0.0.1, on Docker Compose, forwarding to infra.port inside the container; any process on this machine can reach it there. Unset, nothing is published. Kubernetes realizations refuse it; reach the application there with kubectl port-forward.

Contrat de sortie

Valeurs que ce composant publie vers les consommateurs via la topologie uses.

Aucune valeur de sortie déclarée.

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.

checkpointer_db

Sélecteur
component.aggrega.ai/category=datastore
Injection
env, file

Emplacements que chaque connexion passant par ce socket peut remplir

EmplacementSélecteurObligatoireInjectionSensibleDescription
credentialfeature.aggrega.ai/kind=secretnonenvouiOptional 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

Sélecteur
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Injection
env, file

Emplacements que chaque connexion passant par ce socket peut remplir

EmplacementSélecteurObligatoireInjectionSensibleDescription
credentialfeature.aggrega.ai/kind=secretnonenvouiOptional 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.

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

env, file

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

Utilisé par

Référence du concept Component →

Le catalogue Aggrega — un index ouvert de composants, de fonctionnalités, de recettes et des plugins qui en assurent le rendu.

Conçu avec le système de design partagé d’Aggrega.

Confidentialité