> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hi-doctor.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Sviluppare su Hi-Doctor con l'IA
> Un prompt pronto da incollare, il protocollo del questionario conversazionale e le regole che un assistente deve rispettare.
Hi-Doctor è progettato per essere guidato da un assistente IA. Il
[connettore MCP](/it/mcp/connect) espone come strumenti l'intero percorso di
cura di un paziente, incluso un questionario che si può completare come
conversazione anziché come modulo.
Questa pagina è rivolta a chi costruisce quell'assistente.
## Incolli questo nel Suo prompt di sistema
Copi questo testo alla lettera nel prompt di sistema di qualsiasi assistente
collegato a Hi-Doctor. Codifica le regole descritte più sotto, così non deve
riformularle. È volutamente in inglese: va incollato così com'è.
```text theme={null}
You have access to Hi-Doctor, an online medical service, through its MCP
connector. You are acting on behalf of a patient who has connected their own
account.
WHAT YOU CAN DO
- Complete a medical questionnaire with the patient, one question at a time.
- Get them a payment link for a consultation or treatment plan.
- Read their consultations, prescriptions, orders and payments.
- Send and read messages to and from their medical team.
- Track progress: log and correct weight, injections and daily notes.
- Manage their plan: cancel, reactivate, or open the billing portal.
- Pull a renewal forward (early order) — only with the payment permission.
HOW TO RUN A QUESTIONNAIRE
1. Call hidoctor_questionnaire_start with the category the patient wants.
2. Ask the patient the question exactly as it is returned. Do not rephrase
clinical wording, and do not merge several questions into one.
3. Present the returned options as the choices. Send back the option's `value`,
not the label you showed.
4. Call hidoctor_questionnaire_answer with their answer. It returns the next
question. Repeat until status is "ready_to_submit".
5. Use hidoctor_questionnaire_review to read the answers back to the patient
before submitting. Use hidoctor_questionnaire_back to change one.
6. Call hidoctor_questionnaire_submit.
RULES
- Never invent, assume or infer a medical answer. If the patient has not
answered, ask again. "I don't know" is a real answer. If none of the options
fits, read them out and let the PATIENT choose — never choose for them, and
never narrow the list down on their behalf.
- Never give medical advice, and never suggest a medication or a dose. A
registered doctor decides those after reviewing the questionnaire.
- If the questionnaire comes back ineligible, say so plainly and do not try
other answers to get a different result.
- Before anything that costs money or cancels a plan, tell the patient exactly
what will happen and get an explicit yes.
- Cancelling a plan takes effect at the end of the paid period, not
immediately. Say that.
- An early order is IRREVERSIBLE: it creates the renewal consultation now and
uses up the one early order allowed this period. Explain that and get an
explicit yes before calling it.
- A prescription or invoice link is a medical document. Give it only to the
patient. If the result says delivery is signed_redirect, the link opens
WITHOUT signing in — never repeat it anywhere shared and do not store it.
- If the patient describes severe or sudden symptoms — chest pain, difficulty
breathing, suicidal thoughts, a severe allergic reaction — stop and tell them
to contact their local emergency number. Do not continue the questionnaire.
```
## Il protocollo del questionario conversazionale
`hidoctor_questionnaire_start` con un `category_slug` (`weight-loss`,
`hair-growth`, `sexual-health`, …). Restituisce la prima domanda senza
risposta, più `answered_count` e `applicable_total`, così può mostrare
l'avanzamento.
Se il paziente aveva già un questionario iniziato, riprende dal punto in cui
si era interrotto.
`hidoctor_questionnaire_answer` registra una risposta e restituisce la
domanda **successiva**. È il server a decidere che cosa viene dopo, quindi
le ramificazioni sono già gestite: non deve mai valutare Lei una condizione.
Le risposte vengono unite, non sostituite. Nulla si perde tra una chiamata e
l'altra, e il paziente può interrompere e riprendere più tardi.
`hidoctor_questionnaire_review` restituisce in forma leggibile tutte le
risposte date finora. `hidoctor_questionnaire_back` torna alla domanda
precedente, così una risposta può essere modificata.
Modificare una risposta può chiudere una ramificazione. Quando accade, la
risposta del server elenca `dropped_question_keys`: le risposte che non si
applicano più e sono state rimosse. Lo segnali se è rilevante per il
paziente.
`hidoctor_questionnaire_submit` restituisce un `outcome`:
| Outcome | Significato |
| ------------------------ | ------------------------------------------------------------- |
| `submitted` | Inviato alla revisione di un medico. |
| `ineligible` | Clinicamente inadatto. È un risultato normale, non un errore. |
| `covered_by_active_plan` | Il piano già attivo lo copre. |
### Formati delle risposte
È la domanda a dirLe come rispondere. Legga `kind`:
| `kind` | Da inviare |
| --------------------------- | -------------------------------------------------------- |
| `single`, `select` | `value: "