# 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é…

Guide - Depuis la version 1.2.0 - Flexway v1.6.3 - https://flexway.io/docs/developer-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](https://flexway.io/docs/product-agents/) ; côté exploitation : [Agents A2A](https://flexway.io/docs/operations-a2a/).

## Trouver l'agent

```bash
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

```bash
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 |
