Skip to main content
Hi-Doctor ist darauf ausgelegt, von einem KI-Assistenten gesteuert zu werden. Der MCP-Connector stellt den gesamten Behandlungsweg einer Patientin oder eines Patienten als Tools bereit, einschließlich eines Fragebogens, der sich als Gespräch statt als Formular ausfüllen lässt. Diese Seite richtet sich an alle, die einen solchen Assistenten bauen.

Diesen Text in Ihren System-Prompt einfügen

Kopieren Sie ihn unverändert in den System-Prompt jedes Assistenten, der mit Hi-Doctor verbunden ist. Er kodiert die unten beschriebenen Regeln, sodass Sie sie nicht wiederholen müssen. Der Prompt bleibt auf Englisch, damit er wortgleich übernommen werden kann.

Das Protokoll für den dialogischen Fragebogen

1

Starten

hidoctor_questionnaire_start mit einem category_slug (weight-loss, hair-growth, sexual-health, …). Gibt die erste unbeantwortete Frage zurück, dazu answered_count und applicable_total, sodass Sie den Fortschritt anzeigen können.Hatte die Patientin oder der Patient bereits einen angefangenen Fragebogen, wird dort fortgesetzt, wo sie oder er aufgehört hat.
2

Wiederholt beantworten

hidoctor_questionnaire_answer erfasst eine Antwort und gibt die nächste Frage zurück. Was als Nächstes kommt, entscheidet der Server; die Verzweigung wird Ihnen also abgenommen — Sie werten nie selbst eine Bedingung aus.Antworten werden zusammengeführt, nicht ersetzt. Zwischen zwei Aufrufen geht nichts verloren, und man kann aufhören und später weitermachen.
3

Prüfen und korrigieren

hidoctor_questionnaire_review gibt alle bisherigen Antworten in lesbarer Form zurück. hidoctor_questionnaire_back geht zur vorherigen Frage, damit eine Antwort geändert werden kann.Eine geänderte Antwort kann einen Fragezweig schließen. Passiert das, listet die Antwort dropped_question_keys auf — Antworten, die nicht mehr gelten und entfernt wurden. Erwähnen Sie es, wenn es für die Patientin oder den Patienten von Bedeutung ist.
4

Absenden

hidoctor_questionnaire_submit gibt ein outcome zurück:

Antwortformate

Die Frage sagt Ihnen, wie sie zu beantworten ist. Lesen Sie kind: Folgefragen enthalten eine Zeichenkette answer_instructions, die genau angibt, wohin der Wert gehört. Halten Sie sich daran.

Die obigen Regeln sind technisch nicht erzwungen

Hi-Doctor kann nicht erkennen, ob eine Antwort von der Patientin oder dem Patienten kam oder vom Assistenten abgeleitet wurde. Nichts in der API prüft das.
Ob die Krankenakte integer bleibt, hängt davon ab, dass Ihr Assistent sich an die obigen Regeln hält. Ein Assistent, der eine plausible Antwort einsetzt, sendet erfolgreich ab — und eine Ärztin oder ein Arzt verschreibt daraufhin. Behandeln Sie „niemals eine Antwort erfinden“ als harte Vorgabe in Ihrem System-Prompt, nicht als Empfehlung.
Was der Server sehr wohl durchsetzt, ist die Eignung.

Über die Eignung entscheidet der Server

Gegenanzeigen, der BMI-Schwellenwert, die Altersgrenze und die Prüfung des unterstützten Landes werden beim Absenden des Fragebogens durchgesetzt — nicht vom Assistenten und nicht von der Website.
Versuchen Sie keine Vorabprüfung, und lassen Sie einen Fragebogen nach einem Ergebnis ineligible nicht mit geänderten Antworten erneut durchlaufen. Die Prüfung ist da, um Menschen zu schützen, und sie zu umgehen würde eine Patientin oder einen Patienten gefährden.

Dinge, die Ihnen auf die Füße fallen

Beschriftungen sind menschlicher Text und werden in die Sprache der Patientin oder des Patienten übersetzt. value ist die stabile Kennung, die der Server erwartet.
Der Fragetext kommt in der Sprache zurück, die im Profil hinterlegt ist. Fragen Sie in dieser Sprache.
hidoctor_checkout_create gibt einen Link zurück. Fragen Sie nie nach Kartendaten — Sie können sie ohnehin nicht entgegennehmen, und die Frage gewöhnt Menschen daran, Kartennummern an Chatbots zu geben.
Bei einer normalen Patientenverbindung werden alle Berechtigungen erteilt, Zahlung eingeschlossen. Das Fortschrittstagebuch ist aber um Gewicht, Injektionen und einen Injektionsplan herum gebaut und daher nur bei der Behandlung zur Gewichtsabnahme verfügbar — nicht bei Haarwachstum oder sexueller Gesundheit.Rufen Sie hidoctor_progress_status auf, bevor Sie eine Erfassung anbieten. Fehlt ein Tool vollständig, wurde diese Berechtigung beim Verbinden abgelehnt — sagen Sie das, statt einen Umweg zu erraten.
Ein Gewichtseintrag für ein Datum ersetzt den Eintrag dieses Tages. Notizen und Injektionen kommen hinzu, zweimal erfasst heißt also zwei Einträge.

Ohne MCP

Wenn Sie keinen MCP-Client verwenden, stehen dieselben Funktionen über die REST-API zur Verfügung — einschließlich der programmatischen Registrierung, sodass eine Chat-Oberfläche auch das Konto anlegen kann.