Diese Seite wurde maschinell übersetzt. Englisches Original lesen.

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.

Herkunft

OffiziellSigniert von einer Signaturidentität, die dieser Katalog als offiziellen Herausgeber anerkennt.
Inhalts-Digest
sha256:f6fcca831b4f403ac5267b1e8e62a99ec9794e3fbfe8726c117436898da6a323
Veröffentlicht
2026-11-10T10:08:45Z
Signaturidentität
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signatur

  • Offiziellapplication/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

Referenz zu dieser Version

oci://hub.aggrega.ai/component/core/ai-agent/pydantic-ai:1.0.0

Entwicklerparameter

Werte, die der Entwickler im Aggregate festlegt.

Erweitert BaseComponents#/schemas/BaseAgentParameter

NameTypStandardwertErforderlichBeschreibung
result_typestring—ja—
retriesinteger1ja—
system_promptstring—nein—

Dimensionierung durch den Operator

Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.

NameTypStandardwertErforderlichBeschreibung
imagestring—neinContainer image running the Pydantic AI application code.

Ausgabevertrag

Werte, die diese Komponente über die uses-Topologie an Konsumenten veröffentlicht.

Keine Ausgabewerte deklariert.

uses-Sockets

Die Abhängigkeits-Sockets, über die sich diese Komponente verbindet. Das Ziel jeder über einen Socket verdrahteten Verbindung muss dessen Label-Selektor erfüllen, und jede Verbindung kann in den Slots, die der Socket deklariert, eine Anbindung tragen. Einen erforderlichen Slot muss jede Verbindung füllen, die das Aggregate oder das Release über den Socket verdrahtet.

model

Selektor
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Injektion
env, file

Slots, die jede Verbindung über diesen Socket füllen kann

SlotSelektorErforderlichInjektionSensibelBeschreibung
credentialfeature.aggrega.ai/kind=secretneinenvjaOptional 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.

Anbindungs-Slots

Benannte Bindungspunkte, an denen ein Feature an diese Komponente angebunden wird. Der Selektor eines Slots schränkt ein, welches Feature ihn füllen darf, und seine inject-Liste benennt, wie das Feature sein Material liefern darf. Ein erforderlicher Slot muss auf jeder Instanz gebunden sein, durch eine Anbindung an der Instanz oder in einem darüberliegenden Geltungsbereich, und ein sensibler Slot ist für den Umgang mit geheimem Material deklariert. Ein Feature kann auch unter einem Namen angebunden werden, den kein Slot deklariert.

Keine Anbindungs-Slots deklariert.

Zulassungsliste für Selbstinjektion

env, file

Beziehungen

Typisierte Kanten zu und von anderen veröffentlichten Entitäten. Eine Referenz ohne veröffentlichtes Ziel wird als unterbrochene Kante statt als Link dargestellt.

Verwendet

Verwendet von

Konzeptreferenz zu Component →

Der Aggrega-Katalog — ein offener Index von Komponenten, Funktionen, Rezepten und den Plugins, die sie rendern.

Erstellt mit dem gemeinsamen Aggrega-Designsystem.

Datenschutz