API batch per l'analisi del testo

Usa Amazon Comprehend Medical per analizzare il testo medico archiviato in un bucket Amazon S3. Analizza fino a 10 GB di documenti in un unico batch. È possibile utilizzare la console per creare e gestire processi di analisi in batch oppure utilizzare le API in batch per rilevare entità mediche, incluse le informazioni sanitarie protette (PHI). Le API avviano, interrompono, elencano e descrivono i processi di analisi in batch in corso.

Le informazioni sui prezzi per l'analisi dei lotti e altre operazioni di Amazon Comprehend Medical sono disponibili qui.

Avviso importante

Le operazioni di analisi dei lotti di Amazon Comprehend Medical non sostituiscono consulenze, diagnosi o trattamenti medici professionali. Identificare la soglia di confidenza giusta per il caso d'uso e utilizzare soglie di confidenza elevata in situazioni che richiedono un'elevata precisione. Per alcuni casi d'uso, i risultati devono essere riesaminati e verificati da revisori umani adeguatamente formati. Tutte le operazioni di Amazon Comprehend Medical devono essere utilizzate in scenari di assistenza ai pazienti solo dopo aver verificato l'accuratezza e l'attendibilità del giudizio medico da parte di professionisti medici qualificati.

Esecuzione di analisi in batch utilizzando le API

Puoi eseguire un processo di analisi in batch utilizzando la console Amazon Comprehend Medical o le API di Amazon Comprehend Medical Batch.

Prerequisiti

Quando utilizzi l'API Amazon Comprehend Medical, crea una policy AWS Identity Access and Management (IAM) e collegala a un ruolo IAM. Per ulteriori informazioni sui ruoli IAM e sulle policy di fiducia, consulta IAM Policies and Permissions.

1. Carica i tuoi dati in un bucket S3.

2. Per iniziare un nuovo processo di analisi, utilizzate l'operazione StartEntitiesDetection V2Job o l'operazione StartPhi. DetectionJob All'avvio del processo, comunica ad Amazon Comprehend Medical il nome del bucket S3 di input che contiene i file di input e indica il bucket S3 di output per scrivere i file dopo l'analisi in batch.

3. Monitora lo stato di avanzamento del lavoro utilizzando la console o l'operazione DescribeEntitiesDetection V2Job o l'operazione DescribePhi. DetectionJob Inoltre, ListEntitiesDetection V2Jobs e ListPhi DetectionJobs consentono di visualizzare lo stato di tutte le ontologie che collegano i lavori di analisi in batch.

4. Se è necessario interrompere un processo in corso, utilizzare StopEntitiesDetection V2Job o StopPhi per interrompere l'analisi. DetectionJob

5. Per visualizzare i risultati del processo di analisi, guarda il bucket di output S3 che hai configurato all'avvio del lavoro.

Esecuzione dell'analisi in batch utilizzando la console

1. Carica i tuoi dati in un bucket S3.

2. Per iniziare un nuovo lavoro di analisi, seleziona il tipo di analisi che eseguirai. Fornisci quindi il nome del bucket S3 che contiene i file di input e il nome del bucket S3 a cui desideri inviare i file di output.

3. Monitora lo stato del tuo lavoro mentre è in corso. Dalla console è possibile visualizzare tutte le operazioni di analisi in batch e il relativo stato, incluso l'inizio e la fine dell'analisi.

4. Per vedere i risultati del processo di analisi, guarda il bucket di output S3 che hai configurato all'avvio del lavoro.

Politiche IAM per le operazioni in batch

Il ruolo IAM che richiama le API batch di Amazon Comprehend Medical deve avere una policy che garantisca l'accesso ai bucket S3 che contengono i file di input e output. Inoltre, deve essere assegnato un rapporto di fiducia che consenta al servizio Amazon Comprehend Medical di assumere il ruolo. Per ulteriori informazioni sui ruoli IAM e sulle politiche di fiducia, consulta IAM Roles.

Il ruolo deve avere la seguente politica.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::input-bucket/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::input-bucket",
                "arn:aws:s3:::output-bucket",
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                " arn:aws:s3:::output-bucket/*"
            ],
            "Effect": "Allow"
        }
    ]
}

Il ruolo deve avere la seguente relazione di fiducia. Si consiglia di utilizzare i tasti aws:SourceAccount e aws:SourceArn condition per evitare il confuso problema di Vice Security. Per saperne di più sul problema del vicesceriffo confuso e su come proteggere il tuo AWS account, consulta Il problema del vice confuso nella documentazione di IAM.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Principal":{
            "Service":[
               "comprehendmedical.amazonaws.com"
            ]
         },
         "Action":"sts:AssumeRole",
         "Condition": {
            "StringEquals": {
               "aws:SourceAccount": "account_id"
            },
            "ArnLike": {
               "aws:SourceArn": "arn:aws:comprehendmedical:region:account_id:*"
            }
         }
      }
   ]
}

File di output per l'analisi in batch

Amazon Comprehend Medical crea un file di output per ogni file di input nel batch. Il file ha l'estensione.out. Amazon Comprehend Medical crea innanzitutto una directory nel bucket di output S3 utilizzando AwsAccountIdJobType- JobId- come nome, quindi scrive tutti i file di output per il batch in questa directory. Amazon Comprehend Medical crea questa nuova directory in modo che l'output di un job non sovrascriva l'output di un altro.

L'output di un'operazione batch produce lo stesso output di un'operazione sincrona. Per esempi dell'output generato da Amazon Comprehend Medical, Rileva entità (versione 2) consulta.

Ogni operazione batch produce tre file manifest che contengono informazioni sul lavoro.

• Manifest— Riassume il lavoro. Fornisce informazioni sui parametri utilizzati per il lavoro, la dimensione totale del lavoro e il numero di file elaborati.

• success— Fornisce informazioni sui file che sono stati elaborati correttamente. Include il nome del file di input e output e la dimensione del file di input.

• unprocessed— Elenca i file non elaborati dal processo batch, inclusi i codici di errore e i messaggi di errore per file.

Amazon Comprehend Medical scrive i file nella directory di output specificata per il processo batch. Il file manifesto di riepilogo verrà scritto nella cartella di output, insieme a una cartella intitolataManifest_AccountId-Operation-JobId. All'interno della cartella manifest c'è una success cartella che contiene il manifesto di successo. È inclusa anche una failed cartella che contiene il manifesto del file non elaborato. Le seguenti sezioni mostrano la struttura dei file manifest.

File manifesto Batch

Di seguito è riportata la struttura JSON del file manifesto batch.

{"Summary" : 
    {"Status" : "COMPLETED | FAILED | PARTIAL_SUCCESS | STOPPED", 
    "JobType" : "EntitiesDetection | PHIDetection", 
    "InputDataConfiguration" : {
        "Bucket" : "input bucket", 
        "Path" : "path to files/account ID-job type-job ID" 
    }, "OutputDataConfiguration" : {
        "Bucket" : "output bucket", 
        "Path" : "path to files" 
    }, 
    "InputFileCount" : number of files in input bucket, 
    "TotalMeteredCharacters" : total characters processed from all files, 
    "UnprocessedFilesCount" : number of files not processed, 
    "SuccessFilesCount" : total number of files processed, 
    "TotalDurationSeconds" : time required for processing, 
    "SuccessfulFilesListLocation" : "path to file", 
    "UnprocessedFilesListLocation" : "path to file",
    "FailedJobErrorMessage": "error message or if not applicable,
              The status of the job is completed"
    } 
}

File manifesto di successo

Di seguito è riportata la struttura JSON del file che contiene informazioni sui file elaborati correttamente.

{
        "Files": [{
               "Input": "input path/input file name",
               "Output": "output path/output file name",
               "InputSize": size in bytes of input file
        }, {
               "Input": "input path/input file name",
               "Output": "output path/output file name",
               "InputSize": size in bytes of input file
        }]
}

File manifesto non elaborato

Di seguito è riportata la struttura JSON del file manifest che contiene informazioni sui file non elaborati.

{
  "Files" : [ {
      "Input": "file_name_that_failed",
      "ErrorCode": "error code for exception",
      "ErrorMessage": "explanation of the error code and suggestions"
  }, 
  { ...}
  ]
}