Catalogue d'outils¶
Les outils (« tools ») sont les capacités qu'Aeliam expose à l'assistant. Chacun nécessite un droit (scope) accordé lors du consentement OAuth. La référence technique détaillée (schémas d'entrée/sortie) est en anglais : Tools reference.
Source de vérité
Chaque outil MCP encapsule un endpoint de l'API REST publique. Les droits et schémas sont donc strictement les mêmes que côté API.
Lecture (consultation — aucun effet de bord)¶
| Outil | Droit requis | Ce qu'il fait |
|---|---|---|
whoami |
— | Cabinet, droits, environnement de la session |
list_compagnies_supportees |
— | Compagnies d'assurance actives |
list_produits_disponibles |
— | Catalogue produits (MRP, RC, etc.) |
get_produit_schema |
— | Champs requis pour un produit/assureur (à appeler avant un devis/tarif) |
list_opportunities |
crm:read |
Liste filtrable des opportunités |
get_opportunity |
crm:read |
Détail d'une opportunité |
list_contacts |
devis:read |
Liste des contacts (prospects/clients) |
list_devis |
devis:read |
Liste des devis |
get_devis |
devis:read |
Détail d'un devis (+ lien PDF présigné) |
axa_pingid_list_devices |
automation:read |
Appareils PingID enrôlés (compte AXA) |
Écriture CRM¶
| Outil | Droit requis | Ce qu'il fait |
|---|---|---|
create_lead |
crm:write |
Crée une opportunité (rattache/crée le contact). Idempotent. |
update_opportunity_stage |
crm:write |
Change l'étape d'une opportunité |
add_note |
crm:write |
Ajoute une note (appel, RDV, email) |
schedule_followup |
crm:write |
Planifie une relance |
create_devis_draft |
devis:draft |
Prépare un devis brouillon — ne lance rien chez l'assureur |
Automatisation (tarification RPA)¶
| Outil | Droit requis | Coût indicatif | Confirmation |
|---|---|---|---|
enqueue_tarification |
automation:enqueue |
~5 crédits (mode observation, non facturé) | OUI |
get_job_status |
automation:read |
0 | non |
wait_for_job |
automation:read |
0 | non |
enqueue_tarification — action sensible
Cet outil déclenche une tarification réelle chez l'assureur (un robot remplit le formulaire
sur le portail). Il est marqué comme destructif : l'assistant doit demander votre
confirmation explicite avant de l'appeler. Pour tester sans effet ni coût, utilisez
dry_run: true. Le résultat (tarif, numéro de suspens, PDF) se récupère ensuite via
get_job_status ou wait_for_job.
Comprendre les droits (scopes)¶
| Droit | Donne accès à |
|---|---|
crm:read |
Lecture des opportunités |
crm:write |
Création/mise à jour opportunités + contacts |
devis:read |
Lecture devis et contacts |
devis:draft |
Création de devis brouillons (sans tarification) |
automation:read |
État des jobs + appareils PingID |
automation:enqueue |
Déclenchement de tarifications RPA |
webhooks:manage |
Gestion des webhooks (API REST) |
Vous choisissez les droits accordés à chaque connexion sur l'écran de consentement. Une connexion en lecture seule ne pourra jamais écrire ni tarifer.