Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. Scopri di più»
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateExplainability
Nota
La spiegabilità è disponibile solo per le previsioni e i predittori generati da un () AutoPredictor CreateAutoPredictor
Crea una spiegabilità di Amazon Forecast.
Importante
Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. Scopri di più»
La spiegabilità ti aiuta a comprendere meglio in che modo gli attributi dei tuoi set di dati influiscono sulle previsioni. Amazon Forecast utilizza una metrica chiamata Impact score per quantificare l'impatto relativo di ogni attributo e determinare se aumenta o diminuisce i valori di previsione.
Per abilitare Forecast Explainability, il tuo predittore deve includere almeno uno dei seguenti elementi: serie temporali correlate, metadati degli articoli o set di dati aggiuntivi come Holidays e Weather Index.
Nota
I modelli ARIMA (AutoRegressive Integrated Moving Average), ETS (Exponential Smoothing State Space Model) e NPTS (Non-Parametric Time Series) non incorporano dati di serie temporali esterne. Pertanto, questi modelli non creano un rapporto di spiegabilità, anche se si includono set di dati aggiuntivi.
CreateExplainability accetta un Predictor ARN o ForecastARN. Per ricevere punteggi di impatto aggregati per tutte le serie temporali e i punti temporali nei tuoi set di dati, fornisci un Predictor. ARN Per ricevere punteggi di impatto per serie temporali e punti temporali specifici, fornisci un ForecastARN.
CreateExplainability con un Predictor ARN
Nota
Puoi avere solo una risorsa di spiegabilità per predittore. Se hai già abilitato ExplainPredictor l'accessoCreateAutoPredictor, quel predittore dispone già di una risorsa Explainability.
I seguenti parametri sono necessari quando si fornisce un Predictor: ARN
-
ExplainabilityName- Un nome univoco per l'esplicabilità. -
ResourceArn- L'Arn del predittore. -
TimePointGranularity- Deve essere impostato su «»ALL. -
TimeSeriesGranularity- Deve essere impostato su «ALL».
Non specificate un valore per i seguenti parametri:
-
DataSource- Valido solo quando TimeSeriesGranularity è «SPECIFIC». -
Schema- Valido solo quando TimeSeriesGranularity è «SPECIFIC». -
StartDateTime- Valido solo quando TimePointGranularity è «SPECIFIC». -
EndDateTime- Valido solo quando TimePointGranularity è «SPECIFIC».
CreateExplainability con un Forecast ARN
Nota
È possibile specificare un massimo di 50 serie temporali e 500 punti temporali.
I seguenti parametri sono necessari quando si fornisce un PredictorARN:
-
ExplainabilityName- Un nome univoco per l'esplicabilità. -
ResourceArn- L'Arn della previsione. -
TimePointGranularity- O «ALL» o «SPECIFIC». -
TimeSeriesGranularity- «ALL» o «SPECIFIC».
Se è TimeSeriesGranularity impostato su «SPECIFIC», è necessario fornire anche quanto segue:
-
DataSource- La posizione S3 del CSV file che specifica le serie temporali. -
Schema- Lo schema definisce gli attributi e i tipi di attributi elencati nell'origine dati.
Se si imposta TimePointGranularity su «SPECIFIC», è necessario fornire anche quanto segue:
-
StartDateTime- Il primo timestamp nell'intervallo di punti temporali. -
EndDateTime- L'ultimo timestamp nell'intervallo di punti temporali.
Sintassi della richiesta
{
"DataSource": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"EnableVisualization": boolean,
"EndDateTime": "string",
"ExplainabilityConfig": {
"TimePointGranularity": "string",
"TimeSeriesGranularity": "string"
},
"ExplainabilityName": "string",
"ResourceArn": "string",
"Schema": {
"Attributes": [
{
"AttributeName": "string",
"AttributeType": "string"
}
]
},
"StartDateTime": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parametri della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- DataSource
-
L'origine dei tuoi dati, un ruolo AWS Identity and Access Management (IAM) che consente ad Amazon Forecast di accedere ai dati e, facoltativamente, una chiave AWS Key Management Service (KMS).
Tipo: oggetto DataSource
Campo obbligatorio: no
- EnableVisualization
-
Crea una visualizzazione di spiegabilità visualizzabile all'interno della console. AWS
Tipo: Booleano
Campo obbligatorio: no
- EndDateTime
-
Se
TimePointGranularityè impostato suSPECIFIC, definisci l'ultimo punto temporale per l'esplicabilità.Utilizza il seguente formato di timestamp: yyyy-MM-dd:mm:ss (esempio: THH 2015-01-01T 20:00:00)
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 19.
Modello:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$Campo obbligatorio: no
- ExplainabilityConfig
-
Le impostazioni di configurazione che definiscono la granularità delle serie temporali e dei punti temporali per la spiegabilità.
Tipo: oggetto ExplainabilityConfig
Campo obbligatorio: sì
- ExplainabilityName
-
Un nome univoco per Explainability.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z][a-zA-Z0-9_]*Campo obbligatorio: sì
- ResourceArn
-
L'Amazon Resource Name (ARN) del Predictor o Forecast utilizzato per creare l'Explainability.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+Campo obbligatorio: sì
- Schema
-
Definisce i campi di un set di dati.
Tipo: oggetto Schema
Campo obbligatorio: no
- StartDateTime
-
Se
TimePointGranularityè impostato suSPECIFIC, definisci il primo punto per l'esplicabilità.Utilizza il seguente formato di timestamp: yyyy-MM-dd:mm:ss (esempio: THH 2015-01-01T 20:00:00)
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 19.
Modello:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$Campo obbligatorio: no
- Tags
-
Metadati opzionali per aiutarti a classificare e organizzare le tue risorse. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili. I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
Ai tag si applicano le limitazioni seguenti:
-
Per ogni risorsa, ogni chiave di tag deve essere unica e ogni chiave di tag deve avere un valore.
-
Numero massimo di tag per risorsa: 50.
-
Lunghezza massima della chiave: 128 caratteri Unicode in UTF -8.
-
Lunghezza massima del valore: 256 caratteri Unicode in UTF -8.
-
Caratteri accettati: tutte le lettere e i numeri, gli spazi rappresentabili in UTF -8 e + - =. _:/@. Se lo schema di etichettatura viene utilizzato in altri servizi e risorse, si applicano anche le restrizioni relative ai caratteri di tali servizi.
-
I prefissi chiave non possono includere alcuna combinazione maiuscola o minuscola di o.
aws:AWS:I valori possono avere questo prefisso. Se il valore di un tag haawscome prefisso ma la chiave no, Forecast lo considera un tag utente e verrà conteggiato nel limite di 50 tag. I tag con solo il prefisso chiave diawsnon vengono conteggiati ai fini del limite di tag per risorsa. Non è possibile modificare o eliminare le chiavi dei tag con questo prefisso.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
-
Sintassi della risposta
{
"ExplainabilityArn": "string"
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- ExplainabilityArn
-
Il nome della risorsa Amazon (ARN) dell'Explainability.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+
Errori
- InvalidInputException
-
Non possiamo elaborare la richiesta perché include un valore non valido o un valore che supera l'intervallo valido.
HTTPCodice di stato: 400
- LimitExceededException
-
Il limite del numero di risorse per account è stato superato.
HTTPCodice di stato: 400
- ResourceAlreadyExistsException
-
Esiste già una risorsa con questo nome. Riprova con un nome diverso.
HTTPCodice di stato: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
Non riusciamo a trovare una risorsa con quel nome di risorsa Amazon (ARN). Controlla ARN e riprova.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
