Skip to main content
Hi-Doctor está diseñado para que lo maneje un asistente de IA. El conector MCP expone todo el recorrido asistencial de un paciente en forma de herramientas, incluido un cuestionario que puede completarse como una conversación en lugar de como un formulario. Esta página es para quien esté desarrollando ese asistente.

Pegue esto en su prompt de sistema

Copie esto tal cual en el prompt de sistema de cualquier asistente conectado a Hi-Doctor. Recoge las reglas que se explican más abajo, así que no tiene que repetirlas.

El protocolo conversacional del cuestionario

1

start

hidoctor_questionnaire_start con un category_slug (weight-loss, hair-growth, sexual-health, …). Devuelve la primera pregunta sin responder junto con answered_count y applicable_total, para que pueda mostrar el avance.Si el paciente ya tenía un cuestionario a medias, se reanuda donde lo dejó.
2

answer, de forma repetida

hidoctor_questionnaire_answer registra una respuesta y devuelve la siguiente pregunta. El servidor decide qué viene después, así que la ramificación está resuelta: usted nunca evalúa una condición por su cuenta.Las respuestas se fusionan, no se sustituyen. No se pierde nada entre llamadas, y el paciente puede dejarlo y volver más tarde.
3

revisar y corregir

hidoctor_questionnaire_review devuelve en formato legible todas las respuestas dadas hasta el momento. hidoctor_questionnaire_back retrocede a la pregunta anterior para poder cambiar una respuesta.Cambiar una respuesta puede cerrar una rama. Cuando ocurre, la respuesta incluye dropped_question_keys: las respuestas que dejan de ser aplicables y se han eliminado. Menciónelo si al paciente le importa.
4

submit

hidoctor_questionnaire_submit devuelve un outcome:

Formatos de respuesta

La propia pregunta indica cómo responderla. Lea kind: Los nodos de seguimiento llevan una cadena answer_instructions que indica exactamente dónde va el valor. Sígala.

Estas reglas no se imponen técnicamente

Hi-Doctor no puede saber si una respuesta la dio el paciente o la dedujo el asistente. Nada en la API lo comprueba.
La integridad de la historia clínica depende de que su asistente cumpla las reglas anteriores. Un asistente que rellene una respuesta plausible enviará el cuestionario con éxito, y un médico prescribirá a partir de él. Trate “nunca inventes una respuesta” como una restricción estricta de su prompt de sistema, no como una sugerencia.
Lo que el servidor impone es la idoneidad.

La idoneidad la decide el servidor

Las contraindicaciones, el umbral de IMC, el límite de edad y la comprobación del país admitido se aplican al enviarse el cuestionario, no las hace el asistente ni la web.
No intente hacer un cribado previo del paciente y no vuelva a lanzar un cuestionario con respuestas alteradas después de un resultado ineligible. La comprobación existe para proteger a las personas, y sortearla pondría en riesgo a un paciente.

Cosas con las que va a tropezar

Las etiquetas son texto para personas y se traducen al idioma del paciente. value es el identificador estable que espera el servidor.
El texto de las preguntas llega en el idioma que figure en el perfil del paciente. Pregunte en ese idioma.
hidoctor_checkout_create devuelve un enlace. Nunca pida datos de la tarjeta: no tiene forma de recogerlos, y pedirlos acostumbra a los pacientes a dar su número de tarjeta a un chatbot.
En una conexión normal de paciente se conceden todos los permisos, el de pago incluido. Pero el diario de evolución está construido en torno al peso, las inyecciones y una pauta de inyección, así que solo está disponible en el tratamiento de control de peso, no en los planes de crecimiento capilar ni de salud sexual.Llame a hidoctor_progress_status antes de ofrecerse a registrar nada. Si una herramienta falta por completo, el paciente rechazó ese permiso al conectar: dígaselo en lugar de improvisar un rodeo.
Registrar el peso de una fecha sustituye el registro de ese día. Las notas y las inyecciones se añaden, así que registrarlas dos veces crea dos entradas.

Sin MCP

Si no usa un cliente MCP, las mismas capacidades están disponibles a través de la API REST, incluido el registro programático para que una interfaz de chat pueda crear también la cuenta.