Anteos Health — Medical Appointment Booking

Recherche des médecins Anteos par spécialité et/ou ville. Retourne les médecins avec disponibilités, secteur conventionnement et informations pratiques. Utilisez get_doctor_profile avec le champ id pour obtenir le profil complet d'un médecin (avis patients, diplômes, langues, tarifs).

{
  "type": "object",
  "properties": {
    "specialty": {
      "type": "string",
      "description": "Spécialité médicale (ex: \"médecin généraliste\", \"dermatologue\", \"cardiologue\")"
    },
    "city": {
      "type": "string",
      "description": "Ville où rechercher (ex: \"Paris\", \"Lyon\")"
    },
    "available_from": {
      "type": "string",
      "format": "date",
      "description": "Si fourni, ne retourne que les médecins ayant au moins un créneau libre à partir de cette date (YYYY-MM-DD). Utile pour filtrer d'emblée sur la disponibilité."
    },
    "limit": {
      "type": "integer",
      "description": "Nombre maximum de résultats par page (défaut: 10, max: 50)",
      "default": 10
    },
    "offset": {
      "type": "integer",
      "description": "Décalage pour la pagination (défaut: 0). Utiliser limit+offset pour naviguer au-delà de la première page.",
      "default": 0
    }
  }
}

Prend un rendez-vous pour un patient chez un médecin Anteos. Le rendez-vous est immédiatement confirmé dans l'agenda du médecin.

{
  "type": "object",
  "properties": {
    "doctor_id": {
      "type": "string",
      "description": "Identifiant du médecin (obtenu via search_doctors)"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date du rendez-vous au format YYYY-MM-DD (ex: \"2026-04-20\")"
    },
    "time": {
      "type": "string",
      "description": "Heure du rendez-vous au format HH:MM (ex: \"14:30\")"
    },
    "patient_lastname": {
      "type": "string",
      "description": "Nom de famille du patient (en majuscules de préférence)"
    },
    "patient_firstname": {
      "type": "string",
      "description": "Prénom du patient"
    },
    "patient_email": {
      "type": "string",
      "format": "email",
      "description": "Email du patient — OBLIGATOIRE. Utilisé pour l'envoi de la confirmation et des rappels de rendez-vous."
    },
    "patient_phone": {
      "type": "string",
      "description": "Téléphone du patient (optionnel — format: 0612345678 ou +33612345678)"
    },
    "patient_dob": {
      "type": "string",
      "format": "date",
      "description": "Date de naissance du patient au format YYYY-MM-DD. Obligatoire."
    },
    "patient_sex": {
      "type": "string",
      "enum": [
        "M",
        "F",
        "autre"
      ],
      "description": "Sexe du patient : M (Masculin), F (Féminin) ou autre. Obligatoire."
    },
    "motif": {
      "type": "string",
      "description": "Motif de la consultation en texte libre (optionnel, ex: \"Suivi traitement\", \"Renouvellement ordonnance\")"
    },
    "motif_id": {
      "type": "string",
      "description": "Identifiant du motif de consultation (optionnel, obtenu via get_doctor_profile). Détermine la durée du RDV et est enregistré dans l'agenda du médecin."
    },
    "send_confirmation_email": {
      "type": "boolean",
      "description": "Envoyer un email de confirmation au patient avec des liens de gestion du RDV. Défaut: true. Passer false si votre plateforme envoie sa propre confirmation.",
      "default": true
    }
  },
  "required": [
    "doctor_id",
    "date",
    "time",
    "patient_lastname",
    "patient_firstname",
    "patient_email",
    "patient_sex",
    "patient_dob"
  ]
}

Cherche les prochains créneaux disponibles sur une période, pour un ou plusieurs médecins filtrés par spécialité et/ou ville. À préférer à get_available_slots quand l'utilisateur demande "quand est-ce que X est libre" ou "y a-t-il un RDV disponible cette semaine". Retourne au maximum max_slots créneaux par médecin pour ne pas surcharger le contexte.

{
  "type": "object",
  "properties": {
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Date de début de la recherche au format YYYY-MM-DD"
    },
    "days": {
      "type": "integer",
      "description": "Nombre de jours à couvrir depuis from_date (défaut: 7, max: 30)",
      "default": 7
    },
    "specialty": {
      "type": "string",
      "description": "Spécialité médicale (ex: \"neurologue\", \"cardiologue\"). Ignoré si doctor_id est fourni."
    },
    "city": {
      "type": "string",
      "description": "Ville (ex: \"Paris\"). Ignoré si doctor_id est fourni."
    },
    "doctor_id": {
      "type": "string",
      "description": "Chercher uniquement pour ce médecin (obtenu via search_doctors). Court-circuite specialty et city."
    },
    "max_slots": {
      "type": "integer",
      "description": "Nombre maximum de créneaux retournés par médecin (défaut: 5, max: 20)",
      "default": 5
    },
    "motif_id": {
      "type": "string",
      "description": "Identifiant du motif de consultation (optionnel, obtenu via get_doctor_profile). Adapte la grille de créneaux à la durée du motif."
    }
  },
  "required": [
    "from_date"
  ]
}

Retourne les créneaux disponibles pour un médecin à une date donnée. À appeler avant book_appointment pour proposer des options concrètes au patient plutôt que de réserver à l'aveugle.

{
  "type": "object",
  "properties": {
    "doctor_id": {
      "type": "string",
      "description": "Identifiant du médecin (obtenu via search_doctors)"
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date au format YYYY-MM-DD (ex: \"2026-05-10\")"
    },
    "motif_id": {
      "type": "string",
      "description": "Identifiant du motif de consultation (optionnel, obtenu via get_doctor_profile). Adapte la grille de créneaux à la durée du motif."
    }
  },
  "required": [
    "doctor_id",
    "date"
  ]
}

Récupère les informations et le statut d'un rendez-vous. Requiert le appointment_token reçu lors de la réservation (book_appointment) — ce token prouve que l'appelant représente le patient concerné.

{
  "type": "object",
  "properties": {
    "appointment_id": {
      "type": "string",
      "description": "Identifiant unique du rendez-vous (obtenu via book_appointment)"
    },
    "appointment_token": {
      "type": "string",
      "description": "Token de sécurité reçu dans la réponse de book_appointment. À stocker côté client et à transmettre ici pour prouver l'identité du patient."
    }
  },
  "required": [
    "appointment_id",
    "appointment_token"
  ]
}

Annule un rendez-vous existant. L'annulation est définitive. Requiert le appointment_token reçu lors de la réservation (book_appointment).

{
  "type": "object",
  "properties": {
    "appointment_id": {
      "type": "string",
      "description": "Identifiant unique du rendez-vous à annuler"
    },
    "appointment_token": {
      "type": "string",
      "description": "Token de sécurité reçu dans la réponse de book_appointment. Révoqué définitivement après annulation."
    }
  },
  "required": [
    "appointment_id",
    "appointment_token"
  ]
}

Renvoie par email au patient le lien de gestion de son rendez-vous. À utiliser si le appointment_token n'est plus disponible côté client. Le token n'est jamais renvoyé dans la réponse — uniquement par email au patient.

{
  "type": "object",
  "properties": {
    "appointment_id": {
      "type": "string",
      "description": "Identifiant unique du rendez-vous"
    },
    "patient_email": {
      "type": "string",
      "format": "email",
      "description": "Email du patient enregistré lors de la réservation. Doit correspondre exactement."
    }
  },
  "required": [
    "appointment_id",
    "patient_email"
  ]
}

Reporte un rendez-vous existant vers un nouveau créneau. L'opération est atomique : l'ancien RDV est annulé et le nouveau est créé en une seule transaction, évitant qu'un autre agent prenne le créneau cible entre les deux. Un nouveau appointment_token est émis — l'ancien est révoqué définitivement.

{
  "type": "object",
  "properties": {
    "appointment_id": {
      "type": "string",
      "description": "Identifiant du rendez-vous à reporter"
    },
    "appointment_token": {
      "type": "string",
      "description": "Token de sécurité reçu lors de la réservation initiale"
    },
    "new_date": {
      "type": "string",
      "format": "date",
      "description": "Nouvelle date au format YYYY-MM-DD"
    },
    "new_time": {
      "type": "string",
      "description": "Nouvelle heure au format HH:MM"
    }
  },
  "required": [
    "appointment_id",
    "appointment_token",
    "new_date",
    "new_time"
  ]
}

Liste les rendez-vous créés par cette clé partenaire. Utile pour récupérer l'état après un crash ou un redémarrage de l'agent, ou pour vérifier les RDV en cours sans stocker les tokens côté client.

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "upcoming",
        "past",
        "all"
      ],
      "description": "Filtrer par statut temporel : \"upcoming\" (par défaut), \"past\" ou \"all\"",
      "default": "upcoming"
    },
    "limit": {
      "type": "integer",
      "description": "Nombre de résultats par page (défaut: 20, max: 100)",
      "default": 20
    },
    "offset": {
      "type": "integer",
      "description": "Décalage pour la pagination (défaut: 0)",
      "default": 0
    }
  }
}

Retourne le profil complet d'un médecin : coordonnées, secteur conventionnement, carte vitale, tiers payant, téléconsultation, langues, description, diplômes, expertises, avis patients Anteos (note, résumé IA), et créneaux disponibles sur les 7 prochains jours. À appeler après search_doctors pour aider le patient à choisir son médecin.

{
  "type": "object",
  "properties": {
    "doctor_id": {
      "type": "string",
      "description": "Identifiant du médecin (champ \"id\" retourné par search_doctors)"
    }
  },
  "required": [
    "doctor_id"
  ]
}