a2aproject / a2aproject/A2A

Add 'limitations' field to AgentCard

Offen Anfängerfreundlich
#1,694 15 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
Vorherrschende Sprache
Shell
Sterne
25.7k
Forks
2.6k
Ø Merge
3 T. 6 Std.
Gemergte PRs (30 T.)
16

Beschreibung

## Summary

Proposal to add an optional `limitations` field to the `AgentCard` message in the A2A specification.

## Motivation

Currently, the `AgentCard` describes what an agent **can** do (via `description`, `skills`, `capabilities`), but there is no structured way to express what an agent **cannot** do or where it may underperform.

Exposing limitations is important for:
- **Agent-to-agent orchestration**: A calling agent can make better routing decisions if it knows the limitations of downstream agents (e.g., language support, file size limits, domain restrictions).
- **User trust & transparency**: Users can set appropriate expectations before interacting with an agent.
- **Safety & compliance**: Explicitly declaring limitations helps prevent misuse in unsupported scenarios.

## Proposed Change

Add a `repeated string limitations` field to the `AgentCard` message in `specification/a2a.proto`:

```protobuf
// Optional. A human-readable description of the agent's limitations,
// helping users and other agents understand what the agent cannot do
// or where it may underperform.
// Example: ["Does not support languages other than English",
// "Cannot process images larger than 10MB"]
repeated string limitations = 15;
```

This field is optional (empty list by default) and fully backward-compatible.

## Examples

```json
{
"name": "Recipe Agent",
"description": "Agent that helps users with recipes and cooking.",
"limitations": [
"Does not support languages other than English",
"Cannot process images larger than 10MB",
"Not suitable for professional nutritional advice"
]
}
```

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

The change is in specification/a2a.proto, specifically the AgentCard message. Look at the existing fields to understand the structure. Add the repeated string limitations field at the suggested position (field number 15). Ensure the change is backward compatible. Check if there are any tests for the protobuf definitions to run.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
api
Issue-Typ
Feature
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Aktiv
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
75/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.