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), avec recherche texte libre (q) sur nom, prénom, entreprise, email |
get_contact |
crm:read ou devis:read |
Détail d'un contact par identifiant |
list_devis |
devis:read |
Liste des devis |
get_devis |
devis:read |
Détail d'un devis (le PDF n'est pas dans cette réponse : voir get_devis_pdf_url) |
get_devis_pdf_url |
devis:read |
URL signée de téléchargement du PDF d'un devis (validité courte, ~5 min) |
axa_pingid_list_devices |
automation:read |
Appareils PingID enrôlés (compte AXA) |
list_webhooks |
webhooks:manage |
Liste des souscriptions webhook du cabinet (lecture seule ; création/modification dans l'UI Aeliam ou par l'API REST) |
Statuts d'un devis (list_devis / get_devis)
Le champ statut (aussi utilisable comme filtre sur list_devis) prend l'une des valeurs :
draft_api (brouillon créé par create_devis_draft, aucune tarification lancée), en_cours
(robot en cours), completed (tarif et PDF obtenus), partial (tarif obtenu, sans PDF),
failed, cancelled.
É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 |
Crédits Robot, barème de l'app (10/devis, 4/action) — credits_exhausted (402) si solde insuffisant, remboursé sur échec technique |
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.