Component
core/ai-agent/crewai
A CrewAI agent, run in-cluster as an application image the Release supplies. CrewAI casts each agent as a member of a crew with a stated part to play, so what this component exposes is that part — the role the agent occupies, the goal it is working toward and the backstory it reasons from — together with whether it may hand work to another member and how much of its reasoning it narrates. Deploying it gives that agent as a worker wired to a model: the component on the `model` socket publishes its endpoint and model name, and the Recipe delivers them as the environment an OpenAI-compatible client reads, so one image runs against any model in the catalog without an endpoint in its code. The catalog supplies no image for it — CrewAI is published as a library an application is built around, so there is no upstream image to pin — and until a Release sets `infra.image` the build halts naming the container image and renders nothing. On Docker Compose the application is published on the host's 127.0.0.1 only where `infra.published_port` asks, forwarding to `infra.port`, the port it listens on. An `inject:` block on the model connection delivers the names the application reads, as variables or as files, beside the variables the framework and its client read. 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
Provenance
- Content digest
- sha256:f3c361e7754e3c5b3d6302b65b76b097198d1b2b967f5dff719110943f7e9f24
- Published
- 2026-11-15T08:08:49Z
- 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:b53bb22ddf8f01d6d802040a06cc96d44f3ccf0f5266c9d5eded4706b1cf0004
Reference at this version
oci://hub.aggrega.ai/component/core/ai-agent/crewai:1.1.0Developer parameters
Values the developer sets in the Aggregate.
Extends BaseComponents#/schemas/BaseAgentParameter
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| role | string | — | yes | — |
| goal | string | — | yes | — |
| backstory | string | — | yes | — |
| allow_delegation | boolean | false | yes | — |
| log_level | string (DEBUG | INFO | WARNING | ERROR | CRITICAL) | DEBUG | yes | Log verbosity the agent emits. At DEBUG the agent narrates each step of its reasoning as it works; INFO and above report progress and problems only. |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| image | string | — | no | Container image running the CrewAI application code. |
| port | integer (min 1024, max 65535) | 8000 | no | Port the application listens on inside its container. 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) | — | no | 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. |
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. |
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 → - $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