Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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.

Versione

1.0.01.1.0

Provenienza

UfficialeFirmato da un’identità di firma che questo catalogo riconosce come editore ufficiale.
Digest del contenuto
sha256:89d61f17b0fdfec710676f580fed812fb93ac09e5fccb5ecfba7181c7a206ce3
Pubblicato
2026-11-15T08:08:55Z
Identità di firma
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Firma

  • Ufficialeapplication/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

Riferimento a questa versione

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

Parametri dello sviluppatore

Valori che lo sviluppatore imposta nell’Aggregate.

Estende BaseComponents#/schemas/BaseAgentParameter

NomeTipoPredefinitoObbligatorioDescrizione
graph_entrypointstring—sì—
recursion_limitinteger25sì—

Dimensionamento dell’operatore

Dimensionamento dell’infrastruttura che l’operatore regola per ogni ambiente.

NomeTipoPredefinitoObbligatorioDescrizione
imagestring—noContainer 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)8000noPort 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)—noPort 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.

Contratto di output

Valori che questo componente pubblica verso i consumatori attraverso la topologia uses.

Nessun valore di output dichiarato.

Socket uses

I socket di dipendenza attraverso cui questo componente si connette. La destinazione di ogni connessione collegata attraverso un socket deve soddisfare il suo selettore di etichette, e ogni connessione può portare un aggancio negli slot che il socket dichiara. Uno slot obbligatorio deve essere riempito da ogni connessione che l’Aggregate o la Release collega attraverso il socket.

checkpointer_db

Selettore
component.aggrega.ai/category=datastore
Iniezione
env, file

Slot che ogni connessione attraverso questo socket può riempire

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
credentialfeature.aggrega.ai/kind=secretnoenvsìOptional 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

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

Slot che ogni connessione attraverso questo socket può riempire

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
credentialfeature.aggrega.ai/kind=secretnoenvsìOptional 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.

Slot di aggancio

Punti di associazione con nome in cui una Feature si aggancia a questo componente. Il selettore di uno slot limita quale Feature può riempirlo e la sua lista inject indica come può essere consegnato il materiale della Feature. Uno slot obbligatorio deve essere associato su ogni istanza, da un aggancio sull’istanza o a un ambito superiore, e uno slot sensibile è dichiarato per gestire materiale segreto. Una Feature può anche agganciarsi con un nome che nessuno slot dichiara.

Nessuno slot di aggancio dichiarato.

Elenco consentito di auto-iniezione

env, file

Relazioni

Archi tipizzati da e verso altre entità pubblicate. Un riferimento senza una destinazione pubblicata viene mostrato come arco interrotto anziché come link.

Usa

Usato da

Riferimento al concetto Component →

Il catalogo Aggrega — un indice aperto di componenti, funzionalità, ricette e dei plugin che li renderizzano.

Realizzato con il design system condiviso di Aggrega.

Privacy