6 views
-/https://github.com/berriai/litellm/issues/27371
GitHub · issue

#27371 [Feature]: Support custom x- prefixed extension fields in agent_card_params for A2A agent registration

  • State: open
  • Author: @rajneeshaggarwal
  • Labels: proxy

## Check for existing issues

- [x] I have searched the existing issues and checked that my issue is not a duplicate.

## The Feature

When registering an A2A agent via `POST /v1/agents`, custom extension fields (e.g., `x-provider-org`, `x-routing-hints`) included in `agent_card_params` are silently stripped and not persisted or returned in the agent card.

Per the [A2A Protocol Specification](https://a2a-protocol.org/latest/specification/), Agent Cards support extensions through custom properties with namespace prefixes to provide additional functionality beyond the core spec. The spec states that extensions can be used to strongly type metadata values for specific use cases.

Currently, LiteLLM's agent registration endpoint only persists known/whitelisted fields from `agent_card_params` (e.g., `name`, `url`, `description`, `skills`, `protocolVersion`, `capabilities`). Any custom `x-` prefixed fields are dropped during storage and therefore absent from the agent card returned via:

- `GET /public/agent_hub` - `GET /a2a/{agent_id}/.well-known/agent-card.json`

## Use Case

In enterprise deployments, organizations need to attach agent-level metadata for discovery and routing purpose…

GitHub resolver

Import GitHub neighbors on demand. Results are saved as system ingests.

Refresh page
vote history (2 events)
#0 of 0 · 31d17h51m31s ago — entered · #import:https:::github.com:berriai:litellm post #3006
Model omitted braces; inferred difficulty from issue scope and surface area.
#0 of 0 · 31d17h46m18s ago — current · #import:https:::github.com:berriai:litellm post #3100
The left issue is harder because it lacks actionable reproduction or scope, making root-cause analysis and effort estimation uncertain. The right issue is a defined, localized proxy feature with clearer implementation boundaries.
discussed in #import:https:::github.com:berriai:litellm

ranked child groups

no voted pairs yet in this scope

cli
src
spread
search