Análisis asíncrono para el modelado de temas - Amazon Comprehend
Antes de comenzarMediante AWS Command Line InterfaceUso del SDK para Python o AWS SDK for .NET

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Análisis asíncrono para el modelado de temas

Para determinar los temas de un conjunto de documentos, utilice el StartTopicsDetectionJobpara iniciar un trabajo asíncrono. Puede supervisar los temas de los documentos escritos en inglés o español.

Antes de comenzar

Antes de comenzar, asegúrese de que dispone de:

  • Buckets de entrada y de salida: identifique los buckets de Amazon S3 que quiere usar para la entrada y la salida. Los buckets deben estar situados en la misma región que la API a la cual está llamando.

  • Rol de servicio de IAM: debe tener un rol de servicio de IAM con permiso para acceder a sus buckets de entrada y salida. Para obtener más información, consulte Se requieren permisos basados en roles para las operaciones asíncronas.

Mediante AWS Command Line Interface

El siguiente ejemplo muestra el uso de la operación StartTopicsDetectionJob en la AWS CLI.

El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

aws comprehend start-topics-detection-job \
                --number-of-topics topics to return \
                --job-name "job name" \
                --region region \
                --cli-input-json file://path to JSON input file

Para el parámetro de cli-input-json, debe proporcionar la ruta de un archivo JSON que contiene los datos de solicitud, como se muestra en el siguiente ejemplo.

{
    "InputDataConfig": {
        "S3Uri": "s3://input bucket/input path",
        "InputFormat": "ONE_DOC_PER_FILE"
    },
    "OutputDataConfig": {
        "S3Uri": "s3://output bucket/output path"
    },
    "DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role"
}

Si la solicitud para iniciar el trabajo de detección de eventos se ha realizado correctamente, recibirá la siguiente respuesta:

{
    "JobStatus": "SUBMITTED",
    "JobId": "job ID"
}

Utilice la ListTopicsDetectionJobsoperación para ver una lista de los trabajos de detección de temas que ha enviado. La lista incluye información sobre las ubicaciones de entrada y salida que utilizó y el estado de cada uno de los trabajos de detección. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

aws comprehend list-topics-detection-jobs \-- region

Obtendrá una respuesta JSON similar a la siguiente en respuesta a:

{
    "TopicsDetectionJobPropertiesList": [
        {
            "InputDataConfig": {
                "S3Uri": "s3://input bucket/input path",
                "InputFormat": "ONE_DOC_PER_LINE"
            },
            "NumberOfTopics": topics to return,
            "JobId": "job ID",
            "JobStatus": "COMPLETED",
            "JobName": "job name",
            "SubmitTime": timestamp,
            "OutputDataConfig": {
                "S3Uri": "s3://output bucket/output path"
            },
            "EndTime": timestamp
        },
        {
            "InputDataConfig": {
                "S3Uri": "s3://input bucket/input path",
                "InputFormat": "ONE_DOC_PER_LINE"
            },
            "NumberOfTopics": topics to return,
            "JobId": "job ID",
            "JobStatus": "RUNNING",
            "JobName": "job name",
            "SubmitTime": timestamp,
            "OutputDataConfig": {
                "S3Uri": "s3://output bucket/output path"
            }
        }
    ]
}

Puede utilizar la DescribeTopicsDetectionJoboperación para obtener el estado de un trabajo existente. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

aws comprehend describe-topics-detection-job --job-id job ID

Obtendrá el siguiente JSON similar en respuesta a:

{
    "TopicsDetectionJobProperties": {
        "InputDataConfig": {
            "S3Uri": "s3://input bucket/input path",
            "InputFormat": "ONE_DOC_PER_LINE"
        },
        "NumberOfTopics": topics to return,
        "JobId": "job ID",
        "JobStatus": "COMPLETED",
        "JobName": "job name",
        "SubmitTime": timestamp,
        "OutputDataConfig": {
            "S3Uri": "s3://output bucket/ouput path"
        },
        "EndTime": timestamp
    }
}

Uso del SDK para Python o AWS SDK for .NET

Para ver ejemplos del SDK sobre cómo iniciar un trabajo de modelado de temas, consulte StartTopicsDetectionJobÚselo con una AWS SDK o CLI.