Permettez à vos agents IA de découvrir les capacités de Magisterium AI, de communiquer avec elle et de lui déléguer des tâches grâce au protocole ouvert A2A (Agent-to-Agent).

Pourquoi A2A ?

Alors que MCP permet aux outils d'IA d'accéder au savoir du Magistère, A2A permet aux agents d'IA de collaborer avec Magisterium en tant que pair. Un agent orchestrateur peut découvrir les capacités de Magisterium, lui envoyer des tâches et recevoir des résultats structurés — le tout via une interface JSON-RPC standard.

Un plan payant est requis. Le point de terminaison A2A est disponible sur les plans Pro, Organisation et Entreprise. Les comptes gratuits reçoivent une erreur PLAN_REQUIRED (-32005). Consultez la Tarification MCP pour connaître les limites actuelles par plan — A2A partage le même pool de limites d'utilisation.

Découverte de l'agent

Magisterium AI publie une Agent Card publique à l'adresse :

https://www.magisterium.com/.well-known/agent.json

C'est ainsi que les agents externes découvrent les compétences disponibles, les exigences d'authentification et l'URL du point de terminaison A2A. La carte respecte la spécification A2A et ne nécessite aucune authentification pour être récupérée.

curl https://www.magisterium.com/.well-known/agent.json

Point de terminaison A2A

Le point de terminaison JSON-RPC pour toutes les opérations A2A est :

https://www.magisterium.com/api/v1/a2a

Toutes les requêtes utilisent POST avec un en-tête Content-Type: application/json et une enveloppe JSON-RPC 2.0 standard.

Capacités

L'Agent Card annonce les capacités suivantes :

Authentification

A2A utilise la même authentification par jeton utilisateur OAuth 2.0 que le serveur MCP Magisterium. Vous devez disposer d'un compte sur magisterium.com pour appeler le point de terminaison A2A.

Magisterium publie les métadonnées OAuth 2.0 à l'adresse https://www.magisterium.com/.well-known/oauth-authorization-server, incluant le point de terminaison d'autorisation, le point de terminaison de jeton et le point de terminaison d'enregistrement dynamique des clients. Les clients qui implémentent le flux Authorization Code OAuth 2.0 (avec PKCE) peuvent obtenir un jeton d'accès à partir de ces métadonnées ; consultez la documentation d'authentification MCP pour la configuration côté client standard.

Une fois en possession d'un jeton d'accès, incluez-le dans l'en-tête Authorization de chaque requête A2A :

Authorization: Bearer $MAGISTERIUM_TOKEN

Les clés d'API longue durée générées dans la Console d'API servent uniquement aux points de terminaison Chat Completions, Search et News — elles n'authentifient pas A2A. Utilisez plutôt un jeton utilisateur émis via OAuth.

Les jetons manquants ou invalides renvoient une erreur UNAUTHORIZED (-32004).

Exemple rapide

Envoyez une question à la compétence catholic_qa :

curl -X POST https://www.magisterium.com/api/v1/a2a \
    -H "Authorization: Bearer $MAGISTERIUM_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "message/send",
      "params": {
        "message": {
          "role": "user",
          "messageId": "msg-001",
          "kind": "message",
          "parts": [{ "kind": "text", "text": "What does the Church teach about the Real Presence?" }],
          "metadata": { "skillId": "catholic_qa" }
        }
      }
    }'

La réponse est une Task terminée, avec la réponse et les citations à l'intérieur de result.artifacts :

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": "task_abc123",
    "contextId": "ctx_def456",
    "kind": "task",
    "status": { "state": "completed", "timestamp": "2026-04-20T12:00:00.000Z" },
    "artifacts": [
      {
        "artifactId": "art_ghi789",
        "name": "catholic_qa_response",
        "parts": [
          { "kind": "text", "text": "The Catholic Church teaches..." },
          { "kind": "data", "data": { "citations": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Étapes suivantes

• Mise en route — effectuez votre première requête A2A en curl, Python et TypeScript.
• Compétences — la liste complète des compétences exposées via A2A, avec les structures d'entrée et de sortie pour chacune.
• Référence de l'API — méthodes JSON-RPC, codes d'erreur et cycle de vie des tâches.