Skip to main content
Hi-Doctor est conçu pour être piloté par un assistant IA. Le connecteur MCP expose l’ensemble du parcours de soin d’un patient sous forme d’outils, dont un questionnaire qui peut être rempli comme une conversation plutôt que comme un formulaire. Cette page s’adresse à qui développe cet assistant.

Collez ceci dans votre prompt système

Copiez ce texte tel quel dans le prompt système de tout assistant connecté à Hi-Doctor. Il encode les règles ci-dessous, ce qui vous évite d’avoir à les répéter. Il est fourni en anglais ; conservez-le tel quel.

Le protocole du questionnaire conversationnel

1

start

hidoctor_questionnaire_start avec un category_slug (weight-loss, hair-growth, sexual-health, etc.). Renvoie la première question sans réponse, ainsi que answered_count et applicable_total pour que vous puissiez afficher la progression.Si le patient avait déjà un questionnaire en cours, il reprend là où il s’était arrêté.
2

answer, en boucle

hidoctor_questionnaire_answer enregistre une réponse et renvoie la question suivante. C’est le serveur qui décide de la suite : l’arborescence est donc gérée pour vous, et vous n’évaluez jamais une condition vous-même.Les réponses sont fusionnées, pas remplacées. Rien n’est perdu d’un appel à l’autre, et le patient peut s’interrompre puis revenir plus tard.
3

relire et corriger

hidoctor_questionnaire_review renvoie toutes les réponses données jusque-là sous une forme lisible. hidoctor_questionnaire_back revient à la question précédente afin qu’une réponse puisse être modifiée.Modifier une réponse peut fermer une branche. Dans ce cas, la réponse de l’outil liste dropped_question_keys : les réponses devenues sans objet et supprimées. Signalez-le si cela a de l’importance pour le patient.
4

submit

hidoctor_questionnaire_submit renvoie un outcome :

La forme des réponses

La question vous indique comment y répondre. Lisez kind : Les nœuds de relance portent une chaîne answer_instructions qui indique exactement où doit aller la valeur. Suivez-la.

Les règles ci-dessus ne sont pas imposées techniquement

Hi-Doctor ne peut pas savoir si une réponse vient du patient ou a été déduite par l’assistant. Rien dans l’API ne le vérifie.
L’intégrité du dossier clinique dépend du respect de ces règles par votre assistant. Un assistant qui complète une réponse plausible enverra le questionnaire avec succès — et un médecin prescrira à partir de là. Traitez « ne jamais inventer de réponse » comme une contrainte stricte de votre prompt système, et non comme une suggestion.
Ce que le serveur impose, en revanche, c’est l’éligibilité.

L’éligibilité est décidée par le serveur

Les contre-indications, le seuil d’IMC, la limite d’âge et le contrôle du pays pris en charge sont appliqués au moment de l’envoi du questionnaire — ni par l’assistant, ni par le site.
N’essayez pas de présélectionner un patient, et ne relancez pas un questionnaire avec des réponses modifiées après un résultat ineligible. Ce contrôle existe pour protéger les personnes, et le contourner mettrait un patient en danger.

Les pièges qui vous attendent

Les libellés sont du texte destiné aux humains et sont traduits dans la langue du patient. value est l’identifiant stable attendu par le serveur.
Le texte des questions revient dans la langue enregistrée sur le profil du patient. Posez-les dans cette langue.
hidoctor_checkout_create renvoie un lien. Ne demandez jamais de données de carte bancaire : vous n’avez aucun moyen de les recueillir, et le demander habitue les patients à confier leur numéro de carte à des agents conversationnels.
Toutes les autorisations sont accordées lors d’une connexion patient normale, paiement compris. Mais le journal de progression est construit autour du poids, des injections et d’un plan d’injection : il n’est donc disponible que pour le traitement de la perte de poids, et pas pour les formules croissance des cheveux ou santé sexuelle.Appelez hidoctor_progress_status avant de proposer un suivi. Si un outil est totalement absent, c’est que le patient a refusé cette autorisation au moment de la connexion : dites-le plutôt que d’imaginer un contournement.
Enregistrer un poids pour une date remplace l’entrée de cette journée. Les notes et les injections s’ajoutent : les enregistrer deux fois en crée deux.

Sans MCP

Si vous n’utilisez pas de client MCP, les mêmes capacités sont disponibles via l’API REST — y compris l’inscription par programmation, afin qu’une interface conversationnelle puisse aussi créer le compte.