As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Resposta de endpoint para dados tabulares
Depois que o trabalho de processamento do SageMaker Clarify recebe a resposta de uma invocação de endpoint de inferência, ele desserializa a carga útil da resposta e extrai previsões dela. Use o parâmetro `accept_type` de configuração de análise para especificar o formato de dados da carga útil da resposta. Se não `accept_type` for fornecido, o trabalho de processamento do SageMaker Clarify usará o valor do parâmetro content\$1type como formato de saída do modelo. Para saber mais sobre o `accept_type`, consulte [Arquivos de configuração de análise](clarify-processing-job-configure-analysis.md).
As predições podem consistir em rótulos previstos para análise de desvio ou valores de probabilidade (pontuações) para análise de importância do atributo. Na configuração da análise `predictor`, os três parâmetros a seguir extraem as predições.
+ O parâmetro `probability` é usado para localizar os valores de probabilidade (pontuações) na resposta do endpoint.
+ O parâmetro `label` é usado para localizar os rótulos previstos na resposta do endpoint.
+ (Opcional) O parâmetro `label_headers` fornece os rótulos previstos para um modelo multiclasse.
As diretrizes a seguir se referem às respostas de endpoints nos formatos CSV, JSON Lines e JSON.
## O Endpoint Response está em formato CSV
Se a carga de resposta estiver no formato CSV (tipo MIME:`text/csv`), a tarefa de processamento do SageMaker Clarify desserializará cada linha. Em seguida, ele extrai as predições dos dados desserializados usando os índices de coluna fornecidos na configuração da análise. As linhas na carga útil da resposta devem corresponder aos registros na carga útil da solicitação.
As tabelas a seguir fornecem exemplos de dados de resposta em diferentes formatos e para diferentes tipos de problemas. Seus dados podem variar desses exemplos, desde que as predições possam ser extraídas de acordo com a configuração da análise.
As seções a seguir mostram exemplos de respostas de endpoint em formatos CSV.
### A resposta do endpoint está no formato CSV e contém apenas probabilidade
A tabela a seguir é um exemplo de resposta de endpoint para problemas de regressão e classificação binária.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '0.6' |
| Dois registros (resultados em uma linha, divididos por vírgula). | '0.6,0.3' |
| Dois registros (resultados em duas linhas) | '0.6\$1n0.3' |
Para o exemplo anterior, o endpoint gera um único valor de probabilidade (pontuação) do rótulo previsto. Para extrair probabilidades usando o índice e usá-las para análise da importância do atributo, defina o parâmetro `probability` de configuração da análise como índice da coluna `0`. Essas probabilidades também podem ser usadas para análise de desvio se forem convertidas em valor binário usando o parâmetro `probability_threshold`. Para saber mais sobre o `probability_threshold`, consulte [Arquivos de configuração de análise](clarify-processing-job-configure-analysis.md).
A tabela a seguir é um exemplo de resposta de endpoint para um problema multiclasse.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único de um modelo multiclasse (três classes). | '0.1,0.6,0.3' |
| Dois registros de um modelo multiclasse (três classes). | '0.1,0.6,0.3\$1n0.2,0.5,0.3' |
Para o exemplo anterior, o endpoint gera uma lista de probabilidades (pontuações). Se nenhum índice for fornecido, todos os valores serão extraídos e usados para análise de importância do atributo. Se o parâmetro de configuração de análise `label_headers` for fornecido. Em seguida, o trabalho de processamento do SageMaker Clarify pode selecionar o cabeçalho do rótulo com a probabilidade máxima como o rótulo previsto, que pode ser usado para análise de viés. Para saber mais sobre o `label_headers`, consulte [Arquivos de configuração de análise](clarify-processing-job-configure-analysis.md).
### A resposta do endpoint está no formato CSV e contém apenas o rótulo previsto
A tabela a seguir é um exemplo de resposta de endpoint para problemas de regressão e classificação binária.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '1' |
| Dois registros (resultados em uma linha, divididos por vírgula). | '1,0' |
| Dois registros (resultados em duas linhas) | '1\$1n0' |
Para o exemplo anterior, o endpoint gera o rótulo previsto em vez da probabilidade. Defina o parâmetro `label` da configuração `predictor` para o índice da coluna `0` para que os rótulos previstos possam ser extraídos usando o índice e usados para análise de polarização.
### A resposta do endpoint está no formato CSV e contém rótulo e probabilidade previstos
A tabela a seguir é um exemplo de resposta de endpoint para problemas de regressão e classificação binária.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '1,0.6' |
| Dois registros | '1,0.6\$1n0,0.3' |
Para o exemplo anterior, o endpoint gera o rótulo previsto seguido por sua probabilidade. Defina o `label` parâmetro da `predictor` configuração como índice `0` da coluna e `probability` defina como índice da coluna `1` para extrair os dois valores do parâmetro.
### A resposta do endpoint está no formato CSV e contém rótulos e probabilidades previstas (multiclasse)
Um modelo multiclasse treinado pelo Amazon SageMaker Autopilot pode ser configurado para gerar a representação em sequência da lista de rótulos e probabilidades previstos. A tabela de exemplo a seguir mostra um exemplo de resposta de endpoint de um modelo configurado para gerar `predicted_label`, `probability`, `labels` e `probabilities`.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '"dog",0.6,"[\$1'cat\$1', \$1'dog\$1', \$1'fish\$1']","[0.1, 0.6, 0.3]"' |
| Dois registros | '"dog",0.6,"[\$1'cat\$1', \$1'dog\$1', \$1'fish\$1']","[0.1, 0.6, 0.3]"\$1n""cat",0.7,[\$1'cat\$1', \$1'dog\$1', \$1'fish\$1']","[0.7, 0.2, 0.1]"' |
No exemplo anterior, o trabalho de processamento do SageMaker Clarify pode ser configurado das seguintes maneiras para extrair as previsões.
Para análise de desvio, o exemplo anterior pode ser configurado como um dos seguintes:
+ Defina o parâmetro `label` da configuração `predictor` como `0` para extrair o rótulo previsto.
+ Defina o parâmetro para `2` extrair os rótulos previstos e `probability` defina como `3` para extrair as probabilidades correspondentes. O trabalho de processamento do SageMaker Clarify pode determinar automaticamente o rótulo previsto identificando o rótulo com o maior valor de probabilidade. Referindo-se ao exemplo anterior de um único registro, o modelo prevê três rótulos: `cat`, `dog` e `fish`, com probabilidades correspondentes de `0.1`, `0.6` e `0.3`. Com base nessas probabilidades, o rótulo previsto é `dog`, pois tem o maior valor de probabilidade de `0.6`.
+ Defina `probability` como `3` para extrair as probabilidades. Se `label_headers` for fornecido, o trabalho de processamento do SageMaker Clarify poderá determinar automaticamente o rótulo previsto identificando o cabeçalho do rótulo com o maior valor de probabilidade.
Para análise da importância do atributo, o exemplo anterior pode ser configurado da seguinte forma:
+ Defina `probability` para `3` extrair as probabilidades de todos os rótulos previstos. Em seguida, as atribuições de atributos serão computadas para todos os rótulos. Se o cliente não especificar `label_headers`, as etiquetas previstas serão usadas como cabeçalhos de etiquetas no relatório de análise.
## A resposta do endpoint está no formato JSON Lines
Se a carga de resposta estiver no formato JSON Lines (tipo MIME:`application/jsonlines`), a tarefa de processamento do SageMaker Clarify desserializará cada linha como JSON. Em seguida, ele extrai as previsões dos dados desserializados usando JMESPath expressões fornecidas na configuração da análise. As linhas na carga útil daresposta devem corresponder aos registros na carga útil da solicitação. As tabelas a seguir mostram exemplos de dados de resposta em diferentes formatos. Seus dados podem variar desses exemplos, desde que as predições possam ser extraídas de acordo com a configuração da análise.
As seções a seguir mostram exemplos de respostas de endpoint em formato JSON Lines.
### A resposta do endpoint está no formato JSON Lines e contém apenas probabilidade
A tabela a seguir é um exemplo de resposta de endpoint que gera apenas o valor de probabilidade (pontuação).
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '\$1"score":0.6\$1' |
| Dois registros | '\$1"score":0.6\$1\$1n\$1"score":0.3\$1' |
Para o exemplo anterior, defina o parâmetro de configuração de análise `probability` como JMESPath expressão “pontuação” para extrair seu valor.
### A resposta do endpoint está no formato JSON Lines e contém apenas o rótulo previsto
A tabela a seguir é um exemplo de resposta de endpoint que gera apenas o rótulo previsto.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '\$1"prediction":1\$1' |
| Dois registros | '\$1"prediction":1\$1\$1n\$1"prediction":0\$1' |
Para o exemplo anterior, defina o `label` parâmetro da configuração do preditor como JMESPath expressão`prediction`. Em seguida, o trabalho de processamento do SageMaker Clarify pode extrair os rótulos previstos para análise de viés. Para obter mais informações, consulte [Arquivos de configuração de análise](clarify-processing-job-configure-analysis.md).
### A resposta do endpoint está no formato JSON Lines e contém rótulo e probabilidade previstos
A tabela a seguir é um exemplo de resposta de endpoint que gera o rótulo previsto e sua pontuação.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '\$1"prediction":1,"score":0.6\$1' |
| Dois registros | '\$1"prediction":1,"score":0.6\$1\$1n\$1"prediction":0,"score":0.3\$1' |
No exemplo anterior, defina o `label` parâmetro da `predictor` configuração como JMESPath expressão “previsão” para extrair os rótulos previstos. `probability`Defina a JMESPath expressão “pontuação” para extrair a probabilidade. Para obter mais informações, consulte [Arquivos de configuração de análise](clarify-processing-job-configure-analysis.md).
### A resposta do endpoint está no formato JSON Lines e contém rótulos e probabilidades previstas (multiclasse)
A tabela a seguir é um exemplo de resposta de endpoint de um modelo multiclasse que gera o seguinte:
+ Uma lista de rótulos previstos.
+ Probabilidades e o rótulo previsto selecionado e sua probabilidade.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '\$1"predicted\$1label":"dog","probability":0.6,"predicted\$1labels":["cat","dog","fish"],"probabilities":[0.1,0.6,0.3]\$1' |
| Dois registros | '\$1"predicted\$1label":"dog","probability":0.6,"predicted\$1labels":["cat","dog","fish"],"probabilities":[0.1,0.6,0.3]\$1\$1n\$1"predicted\$1label":"cat","probability":0.7,"predicted\$1labels":["cat","dog","fish"],"probabilities":[0.7,0.2,0.1]\$1' |
No exemplo anterior, a tarefa de processamento do SageMaker Clarify pode ser configurada de várias maneiras para extrair as previsões.
Para análise de desvio, o exemplo anterior pode ser configurado como **um** dos seguintes:
+ Defina o `label` parâmetro da `predictor` configuração para a JMESPath expressão “predicted\$1label” para extrair o rótulo previsto.
+ Defina o parâmetro como a JMESPath expressão “predicted\$1labels” para extrair os rótulos previstos. `probability`Defina a JMESPath expressão “probabilidades” para extrair suas probabilidades. A tarefa SageMaker Clarify determina automaticamente o rótulo previsto identificando o rótulo com o maior valor de probabilidade.
+ `probability`Defina a JMESPath expressão “probabilidades” para extrair suas probabilidades. Se `label_headers` for fornecido, o trabalho de processamento do SageMaker Clarify poderá determinar automaticamente o rótulo previsto identificando o rótulo com o maior valor de probabilidade.
Para analisar a importância do atributo, faça o seguinte:
+ `probability`Defina a JMESPath expressão “probabilidades” para extrair suas probabilidades de todos os rótulos previstos. Em seguida, as atribuições de atributos serão computadas para todos os rótulos.
## A resposta do endpoint está no formato JSON
Se a carga de resposta estiver no formato JSON (tipo MIME:`application/json`), a tarefa de processamento do SageMaker Clarify desserializará toda a carga como JSON. Em seguida, ele extrai as previsões dos dados desserializados usando JMESPath expressões fornecidas na configuração da análise. Os registros na carga útil da resposta devem corresponder aos registros na carga útil da solicitação.
As seções a seguir mostram exemplos de respostas de endpoint em formatos JSON. As tabelas a seguir fornecem exemplos de dados de resposta em diferentes formatos e para diferentes tipos de problemas. Seus dados podem variar desses exemplos, desde que as predições possam ser extraídas de acordo com a configuração da análise.
### A resposta do endpoint está no formato JSON e contém apenas probabilidade
A tabela a seguir é um exemplo de resposta de um endpoint que gera apenas o valor de probabilidade (pontuação).
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '[0.6]' |
| Dois registros | '[0.6,0.3]' |
No exemplo anterior, não há quebra de linha na carga útil da resposta. Em vez disso, um único objeto JSON contém uma lista de pontuações, uma para cada registro na solicitação. Defina o parâmetro de configuração da análise `probability` para a JMESPath expressão “[\$1]” para extrair o valor.
### A resposta do endpoint está no formato JSON Lines e contém apenas o rótulo previsto
A tabela a seguir é um exemplo de resposta de um endpoint que gera apenas o rótulo previsto.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '\$1"predicted\$1labels":[1]\$1' |
| Dois registros | '\$1"predicted\$1labels":[1,0]\$1' |
Defina o `label` parâmetro da `predictor` configuração para a JMESPath expressão “predicted\$1labels” e, em seguida, o trabalho de processamento do SageMaker Clarify poderá extrair os rótulos previstos para análise de viés.
### A resposta do endpoint está no formato JSON e contém rótulo e probabilidade previstos
A tabela a seguir é um exemplo de resposta de endpoint que gera o rótulo previsto e sua pontuação.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '\$1"predictions":[\$1"label":1,"score":0.6\$1' |
| Dois registros | ‘\$1"predictions":[\$1"label":1,"score":0.6\$1,\$1"label":0,"score":0.3\$1]\$1' |
No exemplo anterior, defina o `label` parâmetro da `predictor` configuração para a JMESPath expressão “predictions [\$1] .label” para extrair os rótulos previstos. `probability`Defina a JMESPath expressão “predictions [\$1] .score” para extrair a probabilidade.
### A resposta do endpoint está no formato JSON e contém rótulos e probabilidades previstas (multiclasse)
A tabela a seguir é um exemplo de resposta de um endpoint de um modelo multiclasse que gera o seguinte:
+ Uma lista de rótulos previstos.
+ Probabilidades e o rótulo previsto selecionado e sua probabilidade.
| Carga útil da solicitação de endpoint | Carga útil da resposta do endpoint (representação de string) |
| --- | --- |
| Registro único | '[\$1"predicted\$1label":"dog","probability":0.6,"predicted\$1labels":["cat","dog","fish"],"probabilities":[0.1,0.6,0.3]\$1]' |
| Dois registros | '[\$1"predicted\$1label":"dog","probability":0.6,"predicted\$1labels":["cat","dog","fish"],"probabilities":[0.1,0.6,0.3]\$1,\$1"predicted\$1label":"cat","probability":0.7,"predicted\$1labels":["cat","dog","fish"],"probabilities":[0.7,0.2,0.1]\$1]' |
O trabalho de processamento do SageMaker Clarify pode ser configurado de várias maneiras para extrair as previsões.
Para análise de desvio, o exemplo anterior pode ser configurado como **um** dos seguintes:
+ Defina o `label` parâmetro da `predictor` configuração para a JMESPath expressão “[\$1] .predicted\$1label” para extrair o rótulo previsto.
+ Defina o parâmetro como a JMESPath expressão “[\$1] .predicted\$1labels” para extrair os rótulos previstos. `probability`Defina a JMESPath expressão “[\$1] .probabilidades” para extrair suas probabilidades. O trabalho de processamento do SageMaker Clarify pode determinar automaticamente a etiqueta prevista identificando a etiqueta com o maior valor de proximidade.
+ `probability`Defina a JMESPath expressão “[\$1] .probabilidades” para extrair suas probabilidades. Se `label_headers` for fornecido, o trabalho de processamento do SageMaker Clarify poderá determinar automaticamente o rótulo previsto identificando o rótulo com o maior valor de probabilidade.
Para análise da importância do recurso, `probability` defina a JMESPath expressão “[\$1] .probabilidades” para extrair suas probabilidades de todos os rótulos previstos. Em seguida, as atribuições de atributos serão computadas para todos os rótulos.