Agents A2A

Un agent A2A v1.0 publié derrière Flexway s'appelle à l'adresse de la passerelle, en JSON-RPC ou en HTTP+JSON.

Côté produit : Agents : MCP et A2A ; côté exploitation : Agents A2A.

Trouver l'agent

curl https://api.example.com/agents/support/.well-known/agent-card.json

La carte est publique, servie avec un ETag ; ses supportedInterfaces donnent les adresses de la passerelle. Elle n'est pas encore signée.

Appeler

curl -s https://api.example.com/agents/support -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"role":"ROLE_USER","messageId":"m-1","parts":[{"text":"Où en est ma commande 42 ?"}]}}}'

Règle	Détail
Identité	Celles que la carte déclare (en général un jeton OIDC) ; l'agent appelé reçoit un jeton échangé pour lui, jamais le vôtre
Quota	Écrire (SendMessage...) compte ; lire une tâche (GetTask) est gratuit
Flux	SendStreamingMessage et SubscribeToTask sont plafonnés par appelant et durent au plus la durée fixée par l'exploitant : suivez une tâche plus longue avec GetTask
Tâches	Liées à votre identité par l'agent : un autre appelant reçoit « tâche introuvable »
Notifications push	Seulement vers les hôtes https que l'exploitant autorise