API, MCP et A2A
Trois portes vers le même service, avec les mêmes règles : le connecteur MCP pour les assistants IA, l'Agent Kelki pour la conversation, l'API pour les applications qui veulent suivre leurs demandes.
Correspondance
| Connecteur MCP | Agent Kelki | API v1 |
|---|---|---|
trouver_service | le besoin, en conversation | POST /trade-matches |
lister_prestations | les boutons de l'agent | GET /trades/{trade_id} (+ GET /consent-texts/{version}) |
verifier_lieu | la question du lieu | GET /places |
demander_rappel | l'accord à l'étape du récapitulatif | POST /requests puis POST /requests/{request_id}/confirmation |
| Même page de confirmation de kelki.ai, ouverte depuis l'e-mail « Confirmer ma demande ». | ||
| — | — | suivi propre à l'API : GET /requests, /events, webhooks, /account |
Que choisir
- Le connecteur MCP : vous faites un assistant IA (ou vous l'utilisez) et voulez qu'il trouve un professionnel pour l'utilisateur. Sans compte ni clé, limité par adresse IP, sans suivi.
- L'Agent Kelki par l'API (
/agent/conversations) : vous voulez une conversation toute faite dans votre application, avec suivi et webhooks (guide). - L'API avec vos écrans : vous voulez maîtriser le parcours, sans modèle d'IA, avec suivi par référence et webhooks (guide).
Pour qu'un autre agent parle à l'Agent Kelki (A2A), le principe est le même que par l'API : mêmes étapes, même accord, même confirmation par e-mail.
Règles communes
- Mêmes listes fermées et mêmes contrôles que le formulaire ; « Autre besoin » avec un besoin libre de 3 à 160 caractères.
- Mêmes exclusions : métiers de santé, métiers en relecture.
- Même confirmation par e-mail sous 48 heures, puis effacement ; 3 demandes par 24 heures pour un même contact, tous canaux confondus ; doublons ignorés.
- Même texte d'accord versionné, enregistré mot pour mot ; un seul professionnel ; provenance jamais montrée au professionnel.