Skip to content

AgentBackend

This page lists every field of the AgentBackend resource, as the Go types in api/v1alpha1 define it.

The Default column shows what happens when a field is omitted. None means no default is supplied.

apiVersion: agentkourier.dev/v1alpha1 · kind: AgentBackend

AgentBackend describes an A2A server that hosts agents. Owned by the platform team.

AgentBackend

Field Type Required Default Description
metadata ObjectMeta Yes None Standard Kubernetes object metadata. Agent Kourier reads name and namespace.
spec AgentBackendSpec Yes None

AgentBackendSpec

AgentBackendSpec is the desired state of an AgentBackend.

Field Type Required Default Description
dialect string Yes None One of a2a, kagent-v1.
url string Yes None URL is the http or https base URL for kagent-v1, or the exact JSON-RPC endpoint for a2a. The a2a card must be served at URL + "/.well-known/agent-card.json", as AX does. At least 1 character.
headers []Header No Empty list Headers are sent on every request. Omitted headers add no static headers.
allowedNamespaces []string No Empty list AllowedNamespaces lists the other namespaces whose Bindings may reference this backend. Each is a DNS-1123 label. An empty list permits references only from the backend's own namespace.

Header is a static HTTP header. Set exactly one of value and valueSecretRef; valueSecretRef's key defaults to "token", as for the other single-value Secret references. A header that carries or selects identity is refused, because the Binding identity owns it: Authorization, Proxy-Authorization, Cookie, X-User-Id, X-Agent-Name, X-Share-Token and X-Kagent-Insecure-Runtime-Identity.

Field Type Required Default Description
name string Yes None At least 1 character.
value string No None
valueSecretRef SecretKeyRef No None

SecretKeyRef

SecretKeyRef names one value in a Secret in the referring object's namespace.

Field Type Required Default Description
name string Yes None Name is a DNS-1123 subdomain: at most 253 lowercase letters, digits, '-' or '.', starting and ending with a letter or digit.
key string No token Key selects the entry of the Secret. It defaults to "token". It consists of alphanumeric characters, '-', '_' or '.'.

Generated by hack/docs/refgen from api/v1alpha1. Do not edit this page; change the source and run make docs-ref.