Component
core/ai-agent/pydantic-ai
A Pydantic AI agent, run in-cluster as an application image the Release supplies. Pydantic AI makes an agent's answer a typed, validated object rather than free text: the result type is declared, each reply is checked against it, and a reply that fails the check is asked for again — so what this component exposes is that type, the retry budget, and the system prompt the agent works under. Deploying it gives that agent as a worker wired to a model on the `model` socket, reached through the environment an OpenAI-compatible client reads, so one image runs against any model in the catalog. The catalog supplies no image for it — Pydantic AI 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. An `inject:` block on the model connection delivers the names the application reads, as variables or as files, in place of the model-name variable the Recipes choose by default; the endpoint variable the client SDK reads and the attached key stay. 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.
Procedencia
- Digest del contenido
- sha256:f6fcca831b4f403ac5267b1e8e62a99ec9794e3fbfe8726c117436898da6a323
- Publicado
- 2026-11-10T10:08:45Z
- Identidad de firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- 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:540dc5c8b70f5ced5e2dc6edf7bf81fc18bca3e7064816738cdb1d5baed55ca2
Referencia en esta versión
oci://hub.aggrega.ai/component/core/ai-agent/pydantic-ai:1.0.0Parámetros del desarrollador
Valores que el desarrollador establece en el Aggregate.
Extiende BaseComponents#/schemas/BaseAgentParameter
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| result_type | string | — | sí | — |
| retries | integer | 1 | sí | — |
| system_prompt | string | — | no | — |
Dimensionamiento del operador
Dimensionamiento de la infraestructura que el operador ajusta para cada entorno.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| image | string | — | no | Container image running the Pydantic AI application code. |
Contrato de salida
Valores que este componente publica para los consumidores a través de la topología uses.
No se declararon valores de salida.
Sockets uses
Los sockets de dependencia a través de los cuales se conecta este componente. El destino de cada conexión cableada a través de un socket debe satisfacer su selector de etiquetas, y cada conexión puede llevar un acoplamiento en los slots que declara el socket. Cada conexión que el Aggregate o la Release cablea a través del socket debe llenar los slots obligatorios.
model
- Selector
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
- Inyección
- env, file
Slots que cada conexión a través de este socket puede llenar
| Slot | Selector | Obligatorio | Inyección | Sensible | Descripción |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | sí | 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 acoplamiento
Puntos de enlace con nombre en los que una Feature se acopla a este componente. El selector de un slot restringe qué Feature puede llenarlo y su lista inject indica cómo puede entregarse el material de la Feature. Un slot obligatorio debe estar enlazado en cada instancia, mediante un acoplamiento en la instancia o en un ámbito superior, y un slot sensible se declara para manejar material secreto. Una Feature también puede acoplarse con un nombre que ningún slot declara.
No se declararon slots de acoplamiento.
Lista de permitidos de autoinyección
env, file
Relaciones
Aristas tipadas hacia y desde otras entidades publicadas. Una referencia sin un destino publicado se muestra como una arista rota en lugar de como un enlace.
Usa
- usausa el socket «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Slots de acoplamiento: 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 → - $refextiende el esquema (values)
BaseComponents#/schemas/BaseAgentParameter
Usado por
usa el socket «runner»
usa el socket «api»
usa el socket «runner»
usa el socket «api»
usa el socket «services»
usa el socket «api»
usa el socket «services»
usa el socket «services»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «api»
usa el socket «ssrf_proxy»
usa el socket «api»
usa el socket «api»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «target_agent»
usa el socket «scrape_target»
se aplica a
se aplica a
se aplica a
implementa
implementa