a2aproject / a2aproject/A2A

[Bug]: Contradictory A2A-Version transmission requirements

オープン 初心者向け
#2,184 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
Shell
スター
25.7k
フォーク
2.6k
平均マージ
3日 6時間
マージ済み PR(30日)
16

説明

### What happened?

The specification says:

[3.6.1 (Client Responsibilities)](https://a2a-protocol.org/latest/specification/#361-client-responsibilities)
> Clients MUST send the A2A-Version header with each request [...]

But just a bit later, it says:
> Clients MAY provide the A2A-Version as a request parameter instead of a header.

The specification for JSON-RPC Protocol Binding adds:

[9.2 (Service Parameter Transmission)](https://a2a-protocol.org/latest/specification/#92-service-parameter-transmission)

> A2A service parameters defined in [Section 3.2.6](https://a2a-protocol.org/latest/specification/#326-service-parameters) MUST be transmitted using standard HTTP request headers, as JSON-RPC 2.0 operates over HTTP(S).

Same for HTTP+JSON/REST Protocol Binding:
[11.2 (Service Parameter Transmission)](https://a2a-protocol.org/latest/specification/#112-service-parameter-transmission)
> A2A service parameters defined in [Section 3.2.6](https://a2a-protocol.org/latest/specification/#326-service-parameters) MUST be transmitted using standard HTTP request headers.

Per [RFC2119](https://datatracker.ietf.org/doc/html/rfc2119), MUST means that sending the header "is an absolute requirement of the specification".

It should be clarified which requirement takes precedence in which case.

### Code of Conduct

- [x] I agree to follow this project's Code of Conduct

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

Read the specification sections linked in the issue: 3.6.1, 9.2, and 11.2. Understand the difference between 'MUST' and 'MAY' per RFC2119. The task is to propose a clarification in the specification text, likely in the A2A documentation repository. Check if there are existing pull requests or issues about this contradiction. The outcome is a suggested edit to resolve the ambiguity.

索引モデルが issue の本文から書いたものです。

評価

領域
documentation
issue の種類
ドキュメント
難易度
2/5
見積もり時間
1〜3時間
活発さ
活発
明瞭さ
明確に書かれている
初心者へのやさしさ
75/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。