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.
Versão
Procedência
- Digest do conteúdo
- sha256:89d61f17b0fdfec710676f580fed812fb93ac09e5fccb5ecfba7181c7a206ce3
- Publicado
- 2026-11-15T08:08:55Z
- 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:9d4570d57bcd21ff7384907ead4ea3c04ad4d102737369ce1f1de916e00a63ff
Referência nesta versão
oci://hub.aggrega.ai/component/core/ai-agent/langgraph:1.1.0Parâmetros do desenvolvedor
Valores que o desenvolvedor define no Aggregate.
Estende BaseComponents#/schemas/BaseAgentParameter
| Nome | Tipo | Padrão | Obrigatório | Descrição |
|---|---|---|---|---|
| graph_entrypoint | string | — | sim | — |
| recursion_limit | integer | 25 | sim | — |
Dimensionamento do operador
Dimensionamento de infraestrutura que o operador ajusta por ambiente.
| Nome | Tipo | Padrão | Obrigatório | Descrição |
|---|---|---|---|---|
| image | string | — | não | Container image running the LangGraph application code. The Docker Compose Recipe runs the catalog's quickstart agent when it is unset. |
| port | integer (min 1024, max 65535) | 8000 | não | Port 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_port | integer (min 1024, max 65535) | — | não | Port 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. |
Contrato de saída
Valores que este componente publica para os consumidores pela topologia uses.
Nenhum valor de saída declarado.
Sockets uses
Os sockets de dependência pelos quais este componente se conecta. O destino de cada conexão ligada por um socket deve satisfazer o seletor de rótulos dele, e cada conexão pode carregar um acoplamento nos slots que o socket declara. Cada conexão que o Aggregate ou a Release liga pelo socket deve preencher os slots obrigatórios.
checkpointer_db
- Seletor
- component.aggrega.ai/category=datastore
- Injeção
- env, file
Slots que cada conexão por este socket pode preencher
| Slot | Seletor | Obrigatório | Injeção | Sensível | Descrição |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | não | env | sim | 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
- Seletor
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
- Injeção
- env, file
Slots que cada conexão por este socket pode preencher
| Slot | Seletor | Obrigatório | Injeção | Sensível | Descrição |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | não | env | sim | 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. |
Slots de acoplamento
Pontos de vinculação nomeados nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual Feature pode preenchê-lo, e sua lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório deve estar vinculado em cada instância, por um acoplamento na instância ou em um escopo acima dela, e um slot sensível é declarado para lidar com material secreto. Uma Feature também pode se acoplar com um nome que nenhum slot declara.
Nenhum slot de acoplamento declarado.
Lista de permissões de autoinjeção
env, file
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é exibida como uma aresta quebrada em vez de um link.
Usa
- usausa o socket «checkpointer_db»
component.aggrega.ai/category=datastore
Slots de acoplamento: credential
core/datastore/chroma v1.0.0 →core/datastore/cognee v1.0.0 →core/datastore/documentdb v1.0.0 →core/datastore/elasticsearch v1.0.0 →core/datastore/etcd v1.0.0 →core/datastore/ferretdb v1.0.0 →core/datastore/mariadb v1.0.0 →core/datastore/mariadb-operator v1.0.0 →core/datastore/memcached v1.0.0 →core/datastore/milvus v1.0.0 →core/datastore/mysql v1.0.0 →core/datastore/mysql-innodb-cluster v1.0.0 →core/datastore/mysql-operator v1.0.0 →core/datastore/opensearch v1.0.0 →core/datastore/pgvector v1.0.0 →core/datastore/postgres v1.0.0 →core/datastore/qdrant v1.0.0 →core/datastore/redis v1.0.0 →core/datastore/timescaledb v1.0.0 →core/datastore/valkey v1.0.0 →core/datastore/weaviate v1.0.0 → - usausa o socket «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Slots de acoplamento: credential
core/ai-model/ai21 v1.0.0 →core/ai-model/anthropic v1.0.0 →core/ai-model/azure-managed v1.0.0 →core/ai-model/azure-openai v1.0.0 →core/ai-model/azure-openai-embedding v1.0.0 →core/ai-model/bedrock v1.0.0 →core/ai-model/bedrock-embedding v1.0.0 →core/ai-model/cohere v1.0.0 →core/ai-model/databricks v1.0.0 →core/ai-model/docker-model-runner v1.0.0 →core/ai-model/gemini v1.0.0 →core/ai-model/huggingface v1.0.0 →core/ai-model/litellm v1.0.0 →core/ai-model/mistral v1.0.0 →core/ai-model/nvidia-api v1.0.0 →core/ai-model/nvidia-nim v1.0.0 →core/ai-model/ollama v1.0.0 →core/ai-model/openai v1.0.0 →core/ai-model/openai-compatible v1.0.0 →core/ai-model/openai-embedding v1.0.0 →core/ai-model/replicate v1.0.0 →core/ai-model/sagemaker v1.0.0 →core/ai-model/tei v1.0.0 →core/ai-model/tgi v1.0.0 →core/ai-model/vertex-ai v1.0.0 →core/ai-model/vertex-ai-embedding v1.0.0 →core/ai-model/vllm v1.0.0 →core/gateway/agentgateway v1.0.0 →core/gateway/apisix v1.0.0 →core/gateway/envoy-gateway v1.0.0 →core/gateway/higress v1.0.0 →core/gateway/kong v1.0.0 →core/gateway/kong-enterprise v1.0.0 →core/gateway/litellm v1.0.0 →core/gateway/traefik-hub v1.0.0 → - $refestende o esquema (values)
BaseComponents#/schemas/BaseAgentParameter
Usado por
usa o socket «runner»
usa o socket «api»
usa o socket «runner»
usa o socket «api»
usa o socket «services»
usa o socket «api»
usa o socket «services»
usa o socket «services»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «api»
usa o socket «ssrf_proxy»
usa o socket «api»
usa o socket «api»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «sandbox»
usa o socket «plugin_daemon»
usa o socket «ssrf_proxy»
usa o socket «target_agent»
usa o socket «scrape_target»
aplica-se a
aplica-se a
aplica-se a
implementa
implementa