

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.

# Formatos de datos de inferencia de Información IP
<a name="ip-insights-inference-data-formats"></a>

Lo que sigue son los formatos de entrada y salida disponibles para el algoritmo IP Insights. Los algoritmos integrados de Amazon SageMaker AI siguen el formato de inferencia de entrada común descrito en[Formatos de datos comunes para la inferencia](cdf-inference.md). Sin embargo, el algoritmo SageMaker AI IP Insights no admite actualmente el formato Recordio.

## Formatos de solicitud de entrada de Información IP
<a name="ip-insights-input-format-requests"></a>

### INPUT: Formato CSV
<a name="ip-insights-input-csv-format"></a>

El archivo CSV debe tener dos columnas. La primera columna es una cadena opaca que corresponde a un identificador único de la entidad. La segunda columna es la IPv4 dirección del evento de acceso de la entidad en notación de puntos decimales. 

content-type: text/csv

```
entity_id_1, 192.168.1.2
entity_id_2, 10.10.1.2
```

### INPUT: Formato JSON
<a name="ip-insights-input-json"></a>

Los datos JSON se puede proporcionar en diferentes formatos. IP Insights sigue los formatos de IA más comunes SageMaker . Para obtener más información sobre los formatos de inferencia, consulte [Formatos de datos comunes para la inferencia](cdf-inference.md).

content-type: application/json

```
{
  "instances": [
    {"data": {"features": {"values": ["entity_id_1", "192.168.1.2"]}}},
    {"features": ["entity_id_2", "10.10.1.2"]}
  ]
}
```

### INPUT: Formato JSONLINES
<a name="ip-insights-input-jsonlines"></a>

El tipo de contenido JSON Lines es útil para la ejecución de los trabajos de transformación por lotes. Para obtener más información sobre los formatos de inferencia de SageMaker IA, consulte[Formatos de datos comunes para la inferencia](cdf-inference.md). Para obtener más información sobre la ejecución de los trabajos de transformación por lotes, consulte [Transformación por lotes para inferencias con Amazon AI SageMaker](batch-transform.md).

content-type: application/jsonlines

```
{"data": {"features": {"values": ["entity_id_1", "192.168.1.2"]}}},
{"features": ["entity_id_2", "10.10.1.2"]}]
```

## Formatos de respuesta de salida de Información IP
<a name="ip-insights-ouput-format-response"></a>

### SALIDA: Formato de respuesta JSON
<a name="ip-insights-output-json"></a>

La salida predeterminada del algoritmo SageMaker AI IP Insights es la que se encuentra `dot_product` entre la entidad de entrada y la dirección IP. El dot\$1product indica el grado de compatibilidad de la entidad y dirección IP según lo determina el modelo. El `dot_product` es ilimitado. Para realizar predicciones sobre si un evento es anómalo, debe establecer un umbral basado en función de su distribución definida. Para obtener información sobre cómo utilizarlos `dot_product` para la detección de anomalías, consulte [Introducción al algoritmo SageMaker AIIP Insights](https://sagemaker-examples.readthedocs.io/en/latest/introduction_to_amazon_algorithms/ipinsights_login/ipinsights-tutorial.html).

accept: application/json

```
{
  "predictions": [
    {"dot_product": 0.0},
    {"dot_product": 2.0}
  ]
}
```

Los usuarios avanzados pueden acceder a la entidad aprendida del modelo e incrustaciones IP proporcionando el parámetro de tipo de contenido adicional `verbose=True` en el encabezado Aceptar. Puede utilizar `entity_embedding` e `ip_embedding` para la depuración, visualización y comprensión del modelo. Además, puede utilizar estas incrustaciones en otras técnicas de machine learning, como clasificación clustering.

accept: application/json;verbose=True

```
{
  "predictions": [
    {
        "dot_product": 0.0,
        "entity_embedding": [1.0, 0.0, 0.0],
        "ip_embedding": [0.0, 1.0, 0.0]
    },
    {
        "dot_product": 2.0,
        "entity_embedding": [1.0, 0.0, 1.0],
        "ip_embedding": [1.0, 0.0, 1.0]
    }
  ]
}
```

### SALIDA: Formato de respuesta JSONLINES
<a name="ip-insights-jsonlines"></a>

aceptar: application/jsonlines 

```
{"dot_product": 0.0}
{"dot_product": 2.0}
```

accept: application/jsonlines; verbose=True 

```
{"dot_product": 0.0, "entity_embedding": [1.0, 0.0, 0.0], "ip_embedding": [0.0, 1.0, 0.0]}
{"dot_product": 2.0, "entity_embedding": [1.0, 0.0, 1.0], "ip_embedding": [1.0, 0.0, 1.0]}
```