Component
core/ai-agent/phidata
A Phidata agent, run in-cluster as an application image the Release supplies. Phidata separates two kinds of remembering that other frameworks fold together: session storage, which holds the running conversation so a later turn can see an earlier one, and a knowledge base, which holds reference material the agent retrieves from. This component declares both as distinct topology edges — the only agent here that does — and its two values govern whether prior turns are replayed into the prompt and whether replies are formatted as markdown. The Release supplies the image containing the Phidata application. The catalog pins no image, so nothing renders until the Release sets `infra.image`. 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 store connection writing none refuses a store served over TLS alone or over HTTPS, since the application would be handed only its host and port. Neither store connection carries a credential, so a store that requires signing in cannot be reached through one. 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.
Provenance
- Content digest
- sha256:b44e2a81a1c73c4734cba68b4972369745e4e3b106c7badbc1bdf899e5048fd8
- Published
- 2026-11-10T10:08:41Z
- 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:4c3fd5849cc68f6db3e2bf31c0e47f0ff61759e5c88c227195edc1d41896b89c
Reference at this version
oci://hub.aggrega.ai/component/core/ai-agent/phidata:1.0.0Developer parameters
Values the developer sets in the Aggregate.
Extends BaseComponents#/schemas/BaseAgentParameter
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| add_history_to_messages | boolean | true | yes | — |
| markdown | boolean | true | yes | — |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| image | string | — | no | Container image running the Phidata application code. |
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.
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
| Slot | Selector | Required | Inject | Sensitive | Description |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | yes | 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. |
storage
- Selector
- component.aggrega.ai/category=datastore
- Inject
- env, file
This socket declares no attachment slots, so a connection through it carries no attachment.
knowledge_base
- Selector
- datastore.aggrega.ai/engine in (vector, semantic-memory, search)
- Inject
- env, file
This socket declares no attachment slots, so a connection through it carries no attachment.
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
- usesuses socket «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Attachment slots: 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 → - usesuses socket «storage»
component.aggrega.ai/category=datastore
Declares no attachment slots.
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 → - usesuses socket «knowledge_base»
datastore.aggrega.ai/engine in (vector, semantic-memory, search)
Declares no attachment slots.
- $refextends schema (values)
BaseComponents#/schemas/BaseAgentParameter
Used by
uses socket «runner»
uses socket «api»
uses socket «runner»
uses socket «api»
uses socket «services»
uses socket «api»
uses socket «services»
uses socket «services»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «api»
uses socket «ssrf_proxy»
uses socket «api»
uses socket «api»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «sandbox»
uses socket «plugin_daemon»
uses socket «ssrf_proxy»
uses socket «target_agent»
uses socket «scrape_target»
applies to
applies to
applies to
implements
implements