Formati riconosciuti

• 20 centesimi
• Cinque dollari
• $10

Attributi

• .literal: frase esatta nell'input che viene interpretata come una citazione di valuta.
• .numeric_value: valore numerico canonico come un numero intero o un doppio, in unità di base.
• .location: elenca i valori dell'elemento indice della prima e ultima lettera nella stringa di testo per la frase interpretata come una citazione di valuta.
• .unit: Unità di base della valuta, specificata come codice ISO a 3 lettere. Ad esempio, USD o EUR.

La seguente tabella illustra le informazioni che ogni attributo acquisisce dall'input utente.

Per l'input veinte euro ( twenty euro in spagnolo) o €1.234,56, @sys-currency restituisce questi valori:

Vengono restituiti risultati equivalenti per altre lingue supportate e valute nazionali.

Suggerimenti sull'utilizzo di @sys-currency

Se utilizzi l'entità @sys-currency come condizione del nodo e l'utente specifica $0 come valore, il valore viene riconosciuto correttamente come valuta, ma la condizione viene valutata sul numero zero, non sulla valuta zero. Di conseguenza, null nella condizione viene valutato con false e il nodo non viene elaborato. Per controllare i valori di valuta in modo da gestire correttamente gli zeri, nella condizione del nodo utilizza invece l'espressione @sys-currency OR @sys-currency == 0.

Per ulteriori informazioni sulle valute riconosciute per lingua, vedi Supporto valuta.

Formati riconosciuti

• Venerdì
• oggi
• May 8

Attributi

• .alternatives: salva i valori di data alternativi quando l'input è aperto a interpretazione. Normalmente la data futura viene restituita come valore @sys-date. Se c'è ambiguità, la data passata viene salvata come un data alternativa. Ad esempio, per l'input in January, viene restituita una data futura. Tuttavia, se è febbraio (gennaio è passato per questo anno), allora viene restituito anche il gennaio passato come data alternativa. Una data alternativa viene fornita anche per i giorni della settimana quando ne viene specificato uno senza un modificatore. Ad esempio, per l'input Are you open Wednesday?, viene memorizzata la data futura ma viene creata anche una data alternativa del mercoledì precedente. Le date alternative vengono create per frasi che contengono modificatori come next, this o last, che possono avere significati diversi in locali differenti. Il servizio watsonx Assistant considera le date last e next come riferimenti al giorno precedente o successivo più immediato, che può essere nella stessa settimana o in una settimana precedente. Per alcuni modificatori, viene creata una data alternativa o meno a seconda del giorno della settimana corrente. Ad esempio, forse l'input contiene this Wednesday. Se è lunedì, la data futura viene memorizzata e non viene creata una data alternativa. Tuttavia, se è mercoledì, allora viene assunto che la data sia il mercoledì della settimana successiva ma la data di oggi viene memorizzata come una data alternativa. Ogni data alternativa viene salvata come un oggetto che contiene un valore e l'affidabilità di ogni data alternativa. Gli oggetti date alternative vengono memorizzati in un array JSON. Per richiamare un valore alternativo, utilizza la sintassi: @sys-date.alternative.
• .calendar_type: specifica il tipo di calendario per il fuso orario in uso. GREGORIAN è l'unico tipo supportato.
• .datetime_link: vedi Citazioni di data e ora.
• .day: metodo helper che restituisce il giorno nella data.
• .day_of_week: restituisce il giorno della settimana nella data come una stringa con caratteri minuscoli.
• .festival: riconosce i nomi delle festività specifiche della locale e può restituire la data di una festività imminente, ad esempio Thanksgiving, Christmas e Halloween. Utilizzare tutte lettere minuscole se è necessario specificare un nome di festività, in una condizione ad esempio (@sys-date.festival == 'thanksgiving'). Per ulteriori informazioni sulle festività riconosciute, consultare Festivals.
• .granularity: riconosce le citazioni di intervalli di tempo. Le opzioni sono day, weekend, week, fortnight, month, quarter e year.
• .interpretation: L'oggetto restituito dall'assistente, che contiene nuovi campi che aumentano la precisione del classificatore di entità del sistema. Puoi omettere interpretation dall'espressione che utilizzi per fare riferimento ai relativi campi. Ad esempio, è possibile accedere al valore del campo festival nell'oggetto interpretazione utilizzando la sintassi abbreviata <? @sys-date.festival ?>.
• .literal: frase esatta nell'input che viene interpretata come la data.
• .location: valori dell'elemento indice della prima e ultima lettera nella stringa di testo per la frase interpretata come una data.
• .month: metodo helper che restituisce il mese nella data.
• .range_link: se presente, indica che l'input dell'utente contiene un intervallo di date. I valori di indice di inizio e fine della stringa che include l'intervallo di date vengono salvati come parte del nome del link. Vengono fornite ulteriori informazioni, incluso il ruolo che ciascuna @sys-date ricopre nella relazione di intervallo. Ad esempio, la data di inizio ha un tipo di ruolo di date_from mentre la data di fine date_to. Per controllare un valore di ruolo, puoi utilizzare la sintassi @sys-date.role?.type == 'date_from'. Se l'input utente implica un intervallo, ma viene specificata solo una data, la proprietà range_link non viene restituita, ma viene restituito un tipo di ruolo. Ad esempio, se l'utente chiede a Have you been open since yesterday. La data yesterday viene riconosciuta come la citazione @sys-date e viene restituito per essa un ruolo di tipo date_from. Viene restituito anche un range_modifier che identifica la parola nell'input che attiva l'identificazione di un intervallo. In questo esempio, il modificatore è since.
• .relative_{timeframe}: riconosce ed acquisisce le citazioni di valori di data relativi nell'input dell'utente. Restituisce un numero che mostra il numero di unità tra ora e la data specificata. Le unità {time frame} possono essere year, month, week, weekend, o day.
• .specific_{timeframe}: riconosce ed acquisisce le citazioni di unità di date specifiche nell'input utente. Le unità {time frame} possono essere year, quarter, month, day, o day_of_week.
• .year: metodo helper che restituisce l'anno nella data.

La seguente tabella illustra le informazioni che ogni attributo acquisisce dall'input utente.

Formati riconosciuti

• 2pm
• at 4
• 15:30

Attributi

• .alternatives: Cattura orari diversi da quello salvato come valore @sys-time che l'utente potrebbe intendere quando l'ora non è chiaramente indicata. I valori alternativi vengono salvati come un oggetto che contiene un valore e l'affidabilità di ogni ora alternativa e viene archiviato in un array JSON. Per richiamare un valore alternativo, utilizza la sintassi: @sys-time.alternative.
• .calendar_type: specifica il tipo di calendario per il fuso orario in uso. GREGORIAN è l'unico tipo supportato.
• .granularity: riconosce le citazioni di intervalli di tempo. Le opzioni sono hour, minute, second e instant.
• .hour: il metodo helper che restituisce l'ora specificata nel tempo come un valore numerico.
• .interpretation: L'oggetto restituito dall'assistente, che contiene nuovi campi che aumentano la precisione del classificatore di entità del sistema. Puoi omettere interpretation dall'espressione che utilizzi per fare riferimento ai relativi campi. Ad esempio, è possibile accedere al valore del campo granularity nell'oggetto interpretazione utilizzando la sintassi abbreviata <? @sys-time.granularity ?>.
• .literal: Frase esatta nell'input che viene interpretata come l'ora.
• .location: elenca i valori dell'elemento indice della prima e ultima lettera nella stringa di testo per la frase interpretata come una citazione di ora.
• .minute: il metodo helper che restituisce il valore di minuto specificato nell'ora.
• .part_of_day: riconosce i termini che rappresentano l'ora del giorno, ad esempio morning, afternoon, evening, night o now. Imposta anche un intervallo di tempo per ogni parte del giorno. La risposta contiene due valori @sys-time, uno per l'inizio e uno per la fine dell'intervallo di tempo. L'array di entità contiene un oggetto range_link con i tipi di ruolo time-from e time-to. Gli intervalli di tempo per parti diverse del giorno possono essere diversi in base alla locale. Per l'inglese americano, il mattino è da 6:00:00 a 12:00:00. Il pomeriggio va dalle 12:00:00 alle 18:00:00. La sera va dalle 18:00:00 alle 22:00:00. La notte va dalle 22:00:00 alle 23:59:59. La notte termina appena prima la mezzanotte perché altrimenti si sovrapporrebbe a un nuovo giorno che viene misurato da @sys-date.
• .range_link: se presente, indica che l'input dell'utente contiene un intervallo di ore. I valori di indice di inizio e fine della stringa che include l'intervallo di ore vengono salvati come parte del nome del link. Vengono fornite ulteriori informazioni, incluso il ruolo che ciascuna @sys-time ricopre nella relazione di intervallo. Ad esempio, l'ora di inizio ha un tipo di ruolo di time_from mentre l'ora di fine time_to. Per controllare un valore di ruolo, puoi utilizzare la sintassi @sys-time.role?.type == 'time_from'. Se l'input utente implica un intervallo, ma viene specificata solo un'ora, la proprietà range_link non viene restituita, ma viene restituito un tipo di ruolo. Viene restituito anche un range_modifier che identifica la parola nell'input che attiva l'identificazione di un intervallo.
• .relative_{timeframe}: riconosce le citazioni correlate all'ora e restituisce un numero che mostra il numero di unità tra ora e la data specificata. Le unità {timeframe} possono essere hour, minute o second.
• .second: il metodo helper che restituisce il valore di secondo specificato nell'ora.
• .specific_{timeframe}: riconosce ed acquisisce le citazioni di unità di ore specifiche nell'input utente. Le unità {timeframe} possono essere hour, minute o second.

La seguente tabella illustra le informazioni che ogni attributo acquisisce dall'input utente.

Formati riconosciuti

• now
• two hours from now
• on Monday at 4pm

Attributi

• .datetime_link: Se presente, indica che l'input dell'utente menziona una data e un'ora insieme, il che implica che la data e l'ora sono collegate tra loro. I valori di indice di inizio e fine della stringa che include la data e l'ora vengono salvati come parte del nome del link.

La seguente tabella illustra le informazioni che ogni attributo acquisisce dall'input utente.

Fusi orari

Le citazioni di una data o un'ora relative all'ora corrente vengono risolte per un fuso orario scelto. Per impostazione predefinita, il fuso orario è Greenwich Mean Time (GMT). Pertanto, i client API REST che si trovano in fusi orari diversi acquisiscono il Coordinated Universal Time corrente quando now viene citato nell'input.

Facoltativamente, il client API REST può aggiungere il fuso orario locale come variabile di contesto $timezone. Questa variabile di contesto deve essere inviata con ogni richiesta del client. Ad esempio, il valore $timezone può essere America/Los_Angeles, EST o UTC. Per un elenco completo di fusi orari supportati, vedi Fusi orari supportati.

Quando viene fornita la variabile $timezone, i valori delle menzioni relative @sys-date e @sys-time vengono calcolati in base al fuso orario del client anziché al Tempo Universale Coordinato.

Per informazioni sull'elaborazione dei valori di data e ora, vedi il riferimento al metodo Data e ora.

Formati riconosciuti

• 21
• twenty one
• 3.13

Attributi

• .literal: frase esatta nell'input che viene interpretata come il numero.
• .location: valori dell'elemento indice della prima e ultima lettera nella stringa di testo interpretata come un numero.
• .numeric_value: valore numerico canonico come un numero intero o un doppio.
• .range_link: se presente, indica che l'input dell'utente contiene un intervallo di numeri. Il valore di posizione del testo che specifica l'intervallo viene accodato al nome del link. Vengono fornite ulteriori informazioni, incluso il ruolo che ciascuna @sys-number ricopre nella relazione di intervallo. Ad esempio, il numero iniziale ha un tipo di ruolo di number_from mentre il numero finale number_to. Per controllare un valore di ruolo, puoi utilizzare la sintassi @sys-number.role?.type == 'number_from'.

La seguente tabella illustra le informazioni che ogni attributo acquisisce dall'input utente.

Suggerimenti sull'utilizzo di @sys-number

• Se utilizzi l'entità @sys-number come condizione del nodo e l'utente specifica zero come valore, il valore 0 viene riconosciuto correttamente come un numero. Tuttavia, lo 0 viene interpretato come un valore null per la condizione, il che implica che il nodo non viene elaborato. Per controllare i numeri in modo da gestire correttamente gli zeri, nella condizione del nodo utilizza anche l'espressione @sys-number == 0. L'espressione completa da utilizzare è @sys-number OR @sys-number == 0.

• Se utilizzi @sys-number per confrontare i valori di numero in una condizione, assicurati di includere separatamente un controllo per la presenza di un numero stesso. Se non viene trovato alcun numero, @sys-number viene valutato come null. Il tuo confronto potrebbe essere valutato come true quando non sono presenti numeri.

  Ad esempio, non utilizzare @sys-number<4 da solo, perché se non viene trovato alcun numero, @sys-number dà come risultato nullo. Poiché null è inferiore a 4, la condizione viene valutata come true anche se non è presente un numero.

  Utilizzare invece (@sys-number OR @sys-number == 0) AND @sys-number < 4. Se non è presente alcun numero, la prima condizione viene valutata come false. Di conseguenza, l'intera condizione viene valutata come false.

Per ulteriori informazioni sull'elaborazione dei valori numerici, vedi il riferimento al metodo Numeri.

Formati riconosciuti

• 15%
• 10 percent

Attributi

• .literal: frase esatta nell'input che viene interpretata come una percentuale.
• .location: valori dell'elemento indice della prima e ultima lettera nella stringa di testo interpretata come una citazione di percentuale.
• .numeric_value: valore numerico canonico come un numero intero o un doppio
• .range_link: se presente, indica che l'input dell'utente contiene un intervallo, ad esempio from 2 to 3 percent. Il valore di posizione del testo che specifica l'intervallo viene accodato al nome del link. Vengono fornite ulteriori informazioni, incluso il ruolo che ciascuna @sys-percentage ricopre nella relazione di intervallo. Ad esempio, il numero iniziale ha un tipo di ruolo di number_from mentre il numero finale number_to. Per controllare un valore di ruolo, puoi utilizzare la sintassi @sys-percentage.role?.type == 'number_from'.

La seguente tabella illustra le informazioni che ogni attributo acquisisce dall'input utente.

Suggerimenti sull'utilizzo di @sys-percentage

• Se si utilizza l'entità @sys-percentage come condizione del nodo e l'utente specifica 0% come valore, il valore viene riconosciuto correttamente come percentuale, ma la condizione viene valutata sul numero zero e non sulla percentuale 0%. Di conseguenza, null nella condizione viene valutato con false e il nodo non viene elaborato. Per controllare le percentuali in modo da gestire correttamente le percentuali di zero, nella condizione del nodo utilizza invece l'espressione @sys-percentage OR @sys-percentage == 0.

• Se immetti un valore come 1-2%, i valori 1% e 2% vengono restituiti come entità di sistema.