Come usare Analisi del testo per l'integrità
Importante
Analisi del testo per l'integrità è una funzionalità fornita da "AS IS" e "WITH ALL FAULTS". Analisi del testo per la salute non è destinata o resa disponibile per l'uso come dispositivo medico, supporto clinico, strumento diagnostico o altra tecnologia che deve essere usata nella diagnosi, cura, mitigazione, trattamento, prevenzione o prevenzione di malattie o altre condizioni e non viene concessa alcuna licenza o diritto da Microsoft per utilizzare questa funzionalità a tali scopi. Questa funzionalità non è progettata o destinata a essere implementata o distribuita come sostituto di consulenza medica professionale o parere sanitario, diagnosi, trattamento o giudizio clinico di un professionista sanitario e non deve essere usata come tale. Il cliente è responsabile esclusivamente di qualsiasi utilizzo di Analisi del testo per la salute. Il cliente deve concedere in licenza separatamente tutti i vocabolari di origine che intende utilizzare in base ai termini stabiliti per tale appendice dell'accordo di licenza UMLS Metathesaurus o qualsiasi collegamento futuro equivalente. Il cliente è responsabile di garantire la conformità a tali termini di licenza, incluse eventuali restrizioni geografiche o altre restrizioni applicabili.
Analisi del testo per la salute consente ora l'estrazione di determinanti sociali della salute (SDOH) e le menzioni dell'etnia nel testo. Questa funzionalità potrebbe non coprire tutti i potenziali SDOH e non deriva inferenze basate su SDOH o etnia (ad esempio, le informazioni sull'uso di sostanze vengono rilevate, ma l'abuso di sostanze non viene dedotto). Tutte le decisioni che sfruttano gli output del Analisi del testo per l'integrità che influisce sulle persone o sull'allocazione delle risorse (incluse, ma non solo, quelle correlate alla fatturazione, alle risorse umane o alla gestione delle cure) devono essere prese con supervisione umana e non si basano esclusivamente sui risultati del modello. Lo scopo della funzionalità DISOH ed estrazione etnica è aiutare i provider a migliorare i risultati sanitari e non deve essere usato per stigmatizzare o disegnare inferenze negative sugli utenti o sui consumatori di dati SDOH, o popolazioni di pazienti oltre lo scopo dichiarato di aiutare i provider a migliorare i risultati sanitari.
Analisi del testo per la salute può essere utilizzato per estrarre e etichettare informazioni mediche rilevanti da testi non strutturati come note dei medici, riepiloghi di scarico, documenti clinici e cartelle cliniche elettroniche. Il servizio esegue il riconoscimento delle entità denominate, l'estrazione delle relazioni, il collegamento di entità e il rilevamento delle asserzioni per individuare informazioni dettagliate dal testo di input. Per informazioni sui punteggi di attendibilità restituiti, vedere la nota sulla trasparenza.
Suggerimento
Se si vuole testare la funzionalità senza scrivere codice, usare Language Studio.
Esistono due modi per chiamare il servizio:
- Contenitore Docker (sincrono)
- Uso dell'API basata sul Web e delle librerie client (asincrone)
Opzioni di sviluppo
Per usare Analisi del testo per l'integrità, inviare testo non strutturato non elaborato per l'analisi e gestire l'output dell'API nell'applicazione. L'analisi viene eseguita così come è, senza alcuna personalizzazione aggiuntiva per il modello usato nei dati. Esistono due modi per usare Analisi del testo per l'integrità:
| Opzione di sviluppo | Descrizione |
|---|---|
| Language Studio | Language Studio è una piattaforma basata sul Web che consente di provare il collegamento di entità con esempi di testo senza un account Azure e i propri dati quando si effettua l'iscrizione. Per altre informazioni, vedere il sito Web di Language Studio o la guida introduttiva di Language Studio. |
| API REST o libreria client (Azure SDK) | Integrare Analisi del testo per l'integrità nelle applicazioni usando l'API REST o la libreria client disponibile in diversi linguaggi. Per altre informazioni, vedere il Analisi del testo per l'avvio rapido sull'integrità. |
| Contenitore Docker | Usare il contenitore Docker disponibile per distribuire questa funzionalità in locale. Questi contenitori Docker consentono di avvicinare il servizio ai dati per motivi di conformità, sicurezza o altri motivi operativi. |
Lingue di input
Il Analisi del testo per l'integrità supporta l'inglese oltre a più lingue attualmente in anteprima. È possibile usare l'API ospitata o distribuire l'API in un contenitore, come descritto in dettaglio in Analisi del testo per il supporto delle lingue di integrità.
Invio di dati
Per inviare una richiesta API, è necessario l'endpoint della risorsa lingua e la chiave.
Nota
È possibile trovare la chiave e l'endpoint per la risorsa Lingua nel portale di Azure. Si troveranno nella pagina Chiave ed endpoint della risorsa, in Gestione risorse.
Al momento della ricezione della richiesta viene eseguita l'analisi. Se si invia una richiesta usando l'API REST o la libreria client, i risultati verranno restituiti in modo asincrono. Se si usa il contenitore Docker, verranno restituiti in modo sincrono.
Quando si usa questa funzionalità in modo asincrono, i risultati dell'API sono disponibili per 24 ore dal momento in cui la richiesta è stata inserita e viene indicata nella risposta. Dopo questo periodo di tempo, i risultati vengono eliminati e non sono più disponibili per il recupero.
Invio di una richiesta FHIR (Fast Healthcare Interoperability Resources)
Fast Healthcare Interoperability Resources (FHIR) è lo standard di comunicazione del settore sanitario sviluppato dall'organizzazione Health Level Seven International (HL7). Lo standard definisce i formati di dati (risorse) e la struttura API per lo scambio di dati sanitari elettronici. Per ricevere il risultato usando la struttura FHIR , è necessario inviare la versione FHIR nel corpo della richiesta API.
| Nome del parametro | Tipo | Valore |
|---|---|---|
| fhirVersion | string | 4.0.1 |
Ottenere risultati dalla funzionalità
A seconda della richiesta API e dei dati inviati al Analisi del testo per l'integrità, si otterranno:
- Riconoscimento di entità denominate
- Estrazione delle relazioni
- Collegamento delle entità
- Rilevamento asserzione
Il riconoscimento di entità denominate viene usato per eseguire un'estrazione semantica di parole e frasi menzionate da testo non strutturato associato a uno dei tipi di entità supportati, ad esempio diagnosi, nome del farmaco, sintomo/segno o età.
Limiti relativi a servizi e dati
Per informazioni sulle dimensioni e sul numero di richieste che è possibile inviare al minuto e al secondo, vedere l'articolo limiti del servizio.