Esta página foi traduzida automaticamente. Leia o original em inglês.

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.

Procedência

OficialAssinado por uma identidade de assinatura que este catálogo reconhece como publicador oficial.
Digest do conteúdo
sha256:f6fcca831b4f403ac5267b1e8e62a99ec9794e3fbfe8726c117436898da6a323
Publicado
2026-11-10T10:08:45Z
Identidade de assinatura
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Assinatura

  • 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

Referência nesta versão

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

Parâmetros do desenvolvedor

Valores que o desenvolvedor define no Aggregate.

Estende BaseComponents#/schemas/BaseAgentParameter

NomeTipoPadrãoObrigatórioDescrição
result_typestring—sim—
retriesinteger1sim—
system_promptstring—não—

Dimensionamento do operador

Dimensionamento de infraestrutura que o operador ajusta por ambiente.

NomeTipoPadrãoObrigatórioDescrição
imagestring—nãoContainer image running the Pydantic AI application code.

Contrato de saída

Valores que este componente publica para os consumidores pela topologia uses.

Nenhum valor de saída declarado.

Sockets uses

Os sockets de dependência pelos quais este componente se conecta. O destino de cada conexão ligada por um socket deve satisfazer o seletor de rótulos dele, e cada conexão pode carregar um acoplamento nos slots que o socket declara. Cada conexão que o Aggregate ou a Release liga pelo socket deve preencher os slots obrigatórios.

model

Seletor
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Injeção
env, file

Slots que cada conexão por este socket pode preencher

SlotSeletorObrigatórioInjeçãoSensívelDescrição
credentialfeature.aggrega.ai/kind=secretnãoenvsimOptional 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 acoplamento

Pontos de vinculação nomeados nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual Feature pode preenchê-lo, e sua lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório deve estar vinculado em cada instância, por um acoplamento na instância ou em um escopo acima dela, e um slot sensível é declarado para lidar com material secreto. Uma Feature também pode se acoplar com um nome que nenhum slot declara.

Nenhum slot de acoplamento declarado.

Lista de permissões de autoinjeção

env, file

Relações

Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é exibida como uma aresta quebrada em vez de um link.

Usa

Usado por

Referência do conceito Component →

O catálogo Aggrega — um índice aberto de componentes, funcionalidades, receitas e dos plugins que os renderizam.

Criado com o sistema de design compartilhado do Aggrega.

Privacidade