Component
core/datastore/cognee
A semantic-memory store for agent deployments. It ingests text and documents and turns them into a typed graph of entities and the relations between them, kept alongside embeddings of the same material, so a consumer asks what relates to what rather than only what looks similar. Construction is the point: a model reads each ingested item, names the entities and relations it finds, and the result is written into the graph, optionally grounded against an ontology the deployment supplies so extracted names resolve onto terms the deployment already uses. The graph, the embeddings and the bookkeeping tables are held by this component itself, on its own persistent volume, which is why it is a stateful server rather than a façade over someone else's store. The model it reads with is wired in over the uses topology and its address is a deterministic pointer string the running server resolves per request; the compiler never contacts a model. Realized on Kubernetes via its Helm Recipe, which runs the official upstream image directly and carries the whole memory configuration — the graph engine, the embedding store, the extraction and embedding models, and the ontology grounding — into the rendered artifact. Exports its host, its port, its base URL and its protocol to consumers via the uses topology.
Pochodzenie
- Skrót zawartości
- sha256:4bdd8f4f621c576eefbce67fb2a33f88a5cf55cb32f9d46beeeae96c5ba66294
- Opublikowano
- 2026-11-10T10:10:28Z
- Tożsamość podpisująca
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Podpis
- Oficjalnyapplication/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:978ba6e470686d5cdd8098768482297abf1b488a9a0b5142d5872c40f11b286f
Referencja w tej wersji
oci://hub.aggrega.ai/component/core/datastore/cognee:1.0.0Parametry dewelopera
Wartości ustawiane przez dewelopera w encji Aggregate.
| Nazwa | Typ | Wartość domyślna | Wymagane | Opis |
|---|---|---|---|---|
| extraction_provider | string | openai | nie | The provider family the server reads ingested material with. Consulted when the extraction_model socket is unwired; a wired socket supplies the address and model name instead. |
| embedding_provider | string | openai | nie | The provider family the server encodes ingested material with. Consulted when the embedding_model socket is unwired; a wired socket supplies the address and model name instead. |
| embedding_dimensions | integer (min 1) | — | nie | Width of the vectors the embedding model returns. Set it to match the model in use; omit it and the server takes the width its own default model returns. |
| ontology_file_path | string | — | nie | Path inside the container to an ontology document the deployment supplies, against which extracted names are resolved onto terms the deployment already uses. A deterministic pointer string the running server opens; the compiler never reads the file. Omit it and extraction proceeds ungrounded, naming entities as it finds them. |
| extraction_rate_limit_per_minute | integer (min 1) | — | nie | Largest number of model requests the server issues per minute while building the graph, which is what keeps a large ingestion inside a provider's own quota. Omit it and the server issues requests as fast as ingestion produces them. |
| access_control_enabled | boolean | false | nie | Keep each dataset's memory readable only by the users granted it, rather than serving one shared memory to every caller. Off by default, matching the server's own default. |
Wymiarowanie przez operatora
Wymiarowanie infrastruktury, które operator dostraja dla każdego środowiska.
| Nazwa | Typ | Wartość domyślna | Wymagane | Opis |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 8000 | nie | HTTP listen port the API serves on. Most operators should omit this and let the Recipe assign the default (8000). |
| engine_version | string | 1.5.3 | nie | Server container image tag. |
| compute | object | — | nie | — |
| storage | object | — | nie | — |
| overrides | object (open) | — | nie | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Kontrakt wyjściowy
Wartości, które ten komponent publikuje konsumentom za pośrednictwem topologii uses.
| Nazwa | Typ | Wartość domyślna | Wymagane | Opis |
|---|---|---|---|---|
| host | string | — | tak | In-cluster DNS name of the Service fronting the memory API. A consumer that composes its own address dials this name; one that does not reads `endpoint` instead. |
| port | integer | — | tak | TCP port that Service accepts API requests on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default. |
| endpoint | string | — | nie | Full base URL of the memory API, with the host and the port already composed. A consumer hands it to its client as the address it ingests material through and asks its questions of. |
| protocol | string | — | nie | How the published address is spoken to — `http`, so a consumer reaches the API with an HTTP client. |
Gniazda uses
Gniazda zależności, przez które łączy się ten komponent. Cel każdego połączenia poprowadzonego przez gniazdo musi spełniać jego selektor etykiet, a każde połączenie może przenosić dołączenie w slotach deklarowanych przez gniazdo. Wymagany slot musi wypełnić każde połączenie, które encja Aggregate lub encja Release prowadzi przez gniazdo.
extraction_model
- Selektor
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
- Wstrzykiwanie
- —
Sloty, które może wypełnić każde połączenie przez to gniazdo
| Slot | Selektor | Wymagane | Wstrzykiwanie | Wrażliwe | Opis |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | nie | env | tak | Optional credential the server presents to the model this connection reaches, the one it reads ingested material with. When attached, the Recipe delivers it as LLM_API_KEY (a Kubernetes secretKeyRef on helm), so its value never appears in the rendered manifest, and the component's model_api_key is not read for this side; unattached, no key is delivered for it. |
embedding_model
- Selektor
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
- Wstrzykiwanie
- —
Sloty, które może wypełnić każde połączenie przez to gniazdo
| Slot | Selektor | Wymagane | Wstrzykiwanie | Wrażliwe | Opis |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | nie | env | tak | Optional credential the server presents to the model this connection reaches, the one it encodes ingested material with. When attached, the Recipe delivers it as EMBEDDING_API_KEY (a Kubernetes secretKeyRef on helm), so its value never appears in the rendered manifest, and the component's model_api_key is not read for this side; unattached, no key is delivered for it, and the server may then present the extraction side's key, where one is delivered, to this model instead. |
Sloty dołączania
Nazwane punkty wiązania, w których encja Feature dołącza się do tego komponentu. Selektor slotu ogranicza, która encja Feature może go wypełnić, a jego lista inject określa, jak można dostarczyć materiał encji Feature. Wymagany slot musi być powiązany w każdej instancji, przez dołączenie w instancji lub w zakresie nad nią, a slot wrażliwy jest zadeklarowany do obsługi materiału tajnego. Encja Feature może również dołączyć się pod nazwą, której nie deklaruje żaden slot.
| Slot | Selektor | Wymagane | Wstrzykiwanie | Wrażliwe | Opis |
|---|---|---|---|---|---|
| model_api_key | feature.aggrega.ai/kind=secret | nie | env | tak | Optional credential the server presents to a model provider it reaches without a connection. It serves only a model socket left unwired, where the server reaches the provider its values name at that provider's own address: for extraction it is delivered as LLM_API_KEY, for embedding as EMBEDDING_API_KEY, so with both unwired each side presents this key. A wired socket carries its key on its own connection, under credential, and never reads this slot. Delivered as an environment variable, so the plaintext never appears in the rendered manifest; unattached, no key is delivered for an unwired side. |
Lista dozwolonych samowstrzyknięć
env
Relacje
Typowane krawędzie do innych opublikowanych encji i od nich. Odwołanie bez opublikowanego celu jest renderowane jako przerwana krawędź, a nie jako łącze.
Używa
- używaużywa gniazda «extraction_model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Sloty dołączania: 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 → - używaużywa gniazda «embedding_model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Sloty dołączania: 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 →
Używane przez
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «queue»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «queue»
używa gniazda «backend»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «queue»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «queue»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «queue»
używa gniazda «knowledge_base»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «vector_store»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «vector_store»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «vector_store»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «vector_store»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «state_store»
używa gniazda «vector_store»
używa gniazda «vector_store»
używa gniazda «task_memory»
używa gniazda «document_store»
używa gniazda «vector_store»
używa gniazda «vector_store»
używa gniazda «checkpointer_db»
używa gniazda «checkpointer_db»
używa gniazda «backend»
używa gniazda «backend»
używa gniazda «backend»
używa gniazda «vector_store»
używa gniazda «vector_store»
używa gniazda «storage»
używa gniazda «knowledge_base»
używa gniazda «data_store»
używa gniazda «metadata_store»
używa gniazda «target_datastore»
używa gniazda «target_datastore»
używa gniazda «target_datastore»
używa gniazda «backend»
używa gniazda «databases»
używa gniazda «etcd»
używa gniazda «backend»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «state_store»
używa gniazda «forward_target»
używa gniazda «backend»
używa gniazda «cache»
używa gniazda «chunk_cache»
używa gniazda «scrape_target»
używa gniazda «backend»
używa gniazda «backend»
używa gniazda «database»
dotyczy
dotyczy
dotyczy
implementuje