Formats reconnus

• 20 cents
• Five dollars
• 10 $

Attributs

• .literal : expression exacte dans une entrée qui est interprétée comme mention de devise.
• .numeric_value : valeur numérique canonique sous la forme d'un entier ou d'un double dans des unités de base.
• .location : répertorie les valeurs d'élément d'index des première et dernière lettres de la chaîne de texte pour la phrase qui est interprétée comme mention de devise.
• .unit: Unité de base de la monnaie qui est spécifiée sous la forme d'un code monétaire ISO à 3 lettres. Par exemple, USD ou EUR.

Le tableau ci-après présente les informations capturées par chaque attribut à partir de l'entrée utilisateur.

Pour l'entrée veinte euro ( twenty euro en espagnol) ou €1.234,56, @sys-currency renvoie ces valeurs :

Des résultats équivalents sont renvoyés pour d'autres langues et devises nationales prises en charge.

Conseils relatifs à l'utilisation de @sys-currency

Si vous utilisez l'entité @sys-currency comme condition de noeud et que l'utilisateur spécifie $0 comme valeur, la valeur est correctement reconnue en tant que devise, mais la condition renvoie le nombre zéro et non la devise zéro. Par conséquent, la valeur null dans la condition est évaluée à false et le noeud n'est pas traité. Pour vérifier les valeurs de devise d'une manière qui gère correctement les zéros, utilisez à la place l'expression @sys-currency OR @sys-currency == 0 dans la condition de noeud.

Pour plus d'informations sur les devises reconnues par langue, voir Support de devise.

Formats reconnus

• Vendredi
• aujourd'hui
• May 8

Attributs

• .alternatives : permet de sauvegarder les valeurs de date de remplacement lorsque l'entrée est ouverte pour interprétation. En général, la date ultérieure est renvoyée en tant que valeur @sys-date. En cas d'ambiguïté, la date passée est sauvegardée en tant que date de remplacement. Par exemple, pour l'entrée in January, une date ultérieure est renvoyée. Toutefois, s'il s'agit de Février (le mois de janvier est passé pour cette année), le mois de janvier dernier est également renvoyé comme date de remplacement. Une date de remplacement est également fournie pour les jours de la semaine lorsque le jour de la semaine est spécifié sans modificateur. Par exemple, pour l'entrée Are you open Wednesday?, la date ultérieure est stockée, mais une date de remplacement avec la date du mercredi précédent est également renvoyée. Des dates de remplacement sont créées pour des phrases contenant des modificateurs, tels que next, this ou last, qui peuvent avoir différentes significations dans différents environnements locaux. Le service watsonx Assistant interprète les éléments de date last et next comme un renvoi au jour suivant ou précédent le plus proche du jour référencé, ce qui peut correspondre à la même semaine ou à la semaine précédente. Pour certains modificateurs, une date de remplacement est créée ou non selon le jour de la semaine. Par exemple, l'entrée peut contenir this Wednesday. S'il s'agit d'un lundi, la date ultérieure est stockée et aucune date de remplacement n'est créée. Toutefois, s'il s'agit d'un mercredi, la date est considérée comme étant le mercredi de la semaine à venir, mais la date du jour est stockée comme une date de remplacement. Chaque date de remplacement est sauvegardée en tant qu'objet qui contient une valeur et une confiance pour chaque date de remplacement. Les objets de date de remplacement sont stockés dans un tableau JSON. Pour obtenir une valeur alternative, utilisez la syntaxe suivante : @sys-date.alternative.
• .calendar_type: Spécifie le type de calendrier pour le fuseau horaire utilisé. GREGORIAN est le seul type pris en charge.
• .datetime_link : voir Mentions de date et d'heure.
• .day : méthode d'auxiliaire qui renvoie le jour dans la date.
• .day_of_week : renvoie le jour de la semaine dans la date sous la forme d'une chaîne en minuscule.
• .festival : reconnaît les noms de fête spécifiques à l'environnement local et peut renvoyer la date du jour férié à venir, tel que Thanksgiving, Christmas et Halloween. Utilisez toutes les lettres minuscules si vous devez indiquer un nom de congé, dans une condition, par exemple (@sys-date.festival == 'thanksgiving'). Pour plus d'informations sur les congés reconnus, voir Festivals.
• .granularity : reconnaît les mentions de délais. Les options sont day, weekend, week, fortnight, month, quarter et year.
• .interpretation: L'objet renvoyé par votre assistant, qui contient de nouveaux champs qui augmentent la précision du classificateur d'entités du système. Vous pouvez omettre interpretation dans l'expression que vous utilisez pour faire référence à ses zones. Par exemple, vous pouvez accéder à la valeur du champ festival dans l'objet d'interprétation en utilisant la syntaxe abrégée <? @sys-date.festival ?>.
• .literal : expression exacte dans une entrée qui est interprétée comme date.
• .location : répertorie les valeurs d'élément d'index des première et dernière lettres de la chaîne de texte pour la phrase qui est interprétée comme date.
• .month : méthode d'auxiliaire qui renvoie le mois dans la date.
• .range_link : si présent, indique que l'entrée de l'utilisateur contient une plage de dates. Les valeurs d'index de début et de fin de la chaîne incluant la plage de dates sont sauvegardées dans le nom du lien. Des informations supplémentaires sont fournies, notamment le rôle joué par chaque entité @sys-date dans la relation de plage. Par exemple, la date de début a un type de rôle date_from et la date de fin a un type de rôle date_to. Pour vérifier une valeur de rôle, vous pouvez utiliser la syntaxe @sys-date.role?.type == 'date_from'. Si l'entrée utilisateur implique une plage, mais qu'une seule date est spécifiée, la propriété range_link n'est pas renvoyée, mais un type de rôle est renvoyé. Par exemple, si l'utilisateur demande Have you been open since yesterday. La date d'hier est reconnue comme mention @sys-date et un rôle de type date_from est renvoyé pour cette date. Un élément range_modifier qui identifie le mot dans l'entrée qui déclenche l'identification d'une plage est également renvoyé. Dans cet exemple, le modificateur est since.
• .relative_{timeframe} : reconnaît et capture des mentions de valeurs de date relatives dans l'entrée de l'utilisateur. Renvoie un nombre correspondant au nombre d'unités entre maintenant et la date spécifiée. Les unités de {time frame} peuvent être year, month, week, weekend, ou day.
• .specific_{timeframe} : reconnaît et capture des mentions d'unités de date spécifiques dans l'entrée de l'utilisateur. Les unités de {time frame} peuvent être year, quarter, month, day, ou day_of_week.
• .year : méthode d'auxiliaire qui renvoie l'année dans la date.

Le tableau ci-après présente les informations capturées par chaque attribut à partir de l'entrée utilisateur.

Formats reconnus

• 2pm
• at 4
• 15:30

Attributs

• .alternatives: Capture des heures autres que celle enregistrée comme valeur @sys-time que l'utilisateur pourrait vouloir dire lorsque l'heure n'est pas clairement indiquée. Les valeurs de remplacement sont sauvegardées en tant qu'objet qui contient une valeur et une confiance pour chaque heure de remplacement et qui est stocké dans un tableau JSON. Pour obtenir une valeur de remplacement, utilisez la syntaxe suivante : @sys-time.alternative.
• .calendar_type: Spécifie le type de calendrier pour le fuseau horaire utilisé. GREGORIAN est le seul type pris en charge.
• .granularity : reconnaît les mentions de délais. Les options sont hour, minute, second et instant.
• .hour : méthode d'auxiliaire qui renvoie l'heure spécifiée dans l'horodatage sous la forme d'une valeur numérique.
• .interpretation: L'objet renvoyé par votre assistant, qui contient de nouveaux champs qui augmentent la précision du classificateur d'entités du système. Vous pouvez omettre interpretation dans l'expression que vous utilisez pour faire référence à ses zones. Par exemple, vous pouvez accéder à la valeur du champ granularity dans l'objet d'interprétation en utilisant la syntaxe abrégée <? @sys-time.granularity ?>.
• .literal: Phrase exacte dans l'entrée qui est interprétée comme étant l'heure.
• .location : répertorie les valeurs d'élément d'index des première et dernière lettres de la chaîne de texte pour la phrase qui est interprétée comme mention d'heure.
• .minute : méthode d'auxiliaire qui renvoie la valeur de minute spécifiée dans l'horodatage dans l'heure.
• .part_of_day : reconnaît les termes qui représentent le moment de la journée, par exemple, morning, afternoon, evening, night ou now. Définit également une plage horaire pour chaque partie de la journée. La réponse contient deux valeurs @sys-time : une pour le début et une pour la fin de la plage horaire. Le tableau des entités contient l'objet range_link avec les types de rôle time-from et time-to. Les plages temporelles pour différentes parties de la journée peuvent varier d'un environnement local à l'autre. Pour l'anglais américain, le matin correspond à 6:00:00 to 12:00:00. L'après-midi dure de 12:00:00 à 18:00:00. Le soir dure de 18:00:00 à 22:00:00. La nuit dure de 22:00:00 à 23:59:59. La nuit prend fin juste avant minuit pour ne pas empiéter sur le jour suivant, qui est mesuré par @sys-date.
• .range_link : si cette entité apparaît, cela indique que l'entrée utilisateur contient une plage temporelle. Les valeurs d'index de début et de fin de la chaîne incluant l'intervalle de temps sont sauvegardées dans le nom du lien. Des informations supplémentaires sont fournies, notamment le rôle joué par chaque entité @sys-time dans la relation de plage. Par exemple, l'heure de début a un type de rôle time_from et l'heure de fin a un type de rôle time_to. Pour vérifier une valeur de rôle, vous pouvez utiliser la syntaxe @sys-time.role?.type == 'time_from'. Si l'entrée utilisateur implique une plage, mais qu'une seule heure est spécifiée, la propriété range_link n'est pas renvoyée, mais un type de rôle est renvoyé. Un élément range_modifier qui identifie le mot dans l'entrée qui déclenche l'identification d'une plage est également renvoyé.
• .relative_{timeframe} : reconnaît les mentions relatives d'heure et renvoie un nombre correspondant au nombre d'unités entre maintenant et l'heure spécifiée. Les unités {timeframe} peuvent être hour, minute ou second.
• .second : méthode d'auxiliaire qui renvoie la seconde valeur spécifiée dans l'heure.
• .specific_{timeframe} : reconnaît et capture des mentions d'unités de temps spécifiques dans l'entrée de l'utilisateur. Les unités {timeframe} peuvent être hour, minute ou second.

Le tableau ci-après présente les informations capturées par chaque attribut à partir de l'entrée utilisateur.

Formats reconnus

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

Attributs

• .datetime_link: Si elle est présente, elle indique que l'entrée de l'utilisateur mentionne une date et une heure ensemble, ce qui implique que la date et l'heure sont liées l'une à l'autre. Les valeurs d'index de début et de fin de la chaîne incluant la date et l'heure sont enregistrées dans le nom du lien.

Le tableau ci-après présente les informations capturées par chaque attribut à partir de l'entrée utilisateur.

Fuseaux horaires

Les mentions de date ou d'heure relatives à l'heure actuelle sont résolues par rapport à un fuseau horaire choisi. Par défaut, le fuseau horaire est l'heure GMT. Ainsi, les clients d'API REST situés dans des fuseaux horaires différents obtiennent l'heure UTC actuelle lorsque now est mentionné dans l'entrée.

Le client d'API REST peut éventuellement ajouter le fuseau horaire local sous la forme de la variable contextuelle $timezone. Cette variable contextuelle doit être envoyée avec chaque demande du client. Par exemple, la valeur de $timezone peut être America/Los_Angeles, EST ou UTC. Pour obtenir la liste complète des fuseaux horaires pris en charge, reportez-vous à la rubrique Fuseaux horaires pris en charge.

Lorsque la variable $timezone est fournie, les valeurs des mentions relatives @sys-date et @sys-time sont calculées en fonction du fuseau horaire du client et non du temps universel coordonné.

Pour plus d'informations sur le traitement des valeurs de date et d'heure, reportez-vous à la référence sur la méthode Date et heure.

Formats reconnus

• 21
• twenty one
• 3.13

Attributs

• .literal : expression exacte dans une entrée qui est interprétée comme nombre.
• .location : répertorie les valeurs d'élément d'index des première et dernière lettres de la chaîne de texte qui est interprétée comme nombre.
• .numeric_value : valeur numérique canonique sous la forme d'un entier ou d'un double.
• .range_link : si cette entité apparaît, cela indique que l'entrée utilisateur contient une plage numérique. La valeur d'emplacement du texte qui spécifie la plage est ajoutée au nom de lien. Des informations supplémentaires sont fournies, notamment le rôle joué par chaque entité @sys-number dans la relation de plage. Par exemple, le numéro de début a un type de rôle number_from et le numéro de fin a un type de rôle number_to. Pour vérifier une valeur de rôle, vous pouvez utiliser la syntaxe @sys-number.role?.type == 'number_from'.

Le tableau ci-après présente les informations capturées par chaque attribut à partir de l'entrée utilisateur.

Conseils relatifs à l'utilisation de @sys-number

• Si vous utilisez l'entité @sys-number en tant que condition de noeud et que l'utilisateur spécifie zéro comme valeur, la valeur 0 est reconnue comme un nombre. Toutefois, la valeur 0 est interprétée en tant que valeur null pour la condition, ce qui entraîne le non-traitement du noeud. Pour vérifier les nombres d'une manière qui gère correctement les zéros, utilisez également l'expression @sys-number == 0 dans la condition de noeud. L'expression complète à utiliser est @sys-number OR @sys-number == 0.

• Si vous utilisez @sys-number pour comparer des valeurs numériques dans une condition, prenez soin d'inclure séparément une recherche de la présence d'un nombre proprement dit. Si aucun nombre n'est trouvé, @sys-number renvoie la valeur null. Votre comparaison peut renvoyer la valeur true même en l'absence de nombres.

  Par exemple, n'utilisez pas @sys-number<4 uniquement car si aucun nombre n'est trouvé, @sys-number a pour résultat la valeur null. La valeur null étant inférieure à 4, la condition renvoie la valeur true même si aucun nombre n'est présent.

  Utilisez (@sys-number OR @sys-number == 0) AND @sys-number < 4 à la place. Si aucun nombre n'est présent, la première condition renvoie la valeur false. Par conséquent, la condition entière renvoie la valeur false.

Pour plus d'informations sur le traitement des valeurs numériques, reportez-vous aux informations de référence sur la méthode des nombres.

Formats reconnus

• 15 %
• 10 percent

Attributs

• .literal : expression exacte dans une entrée qui est interprétée comme pourcentage.
• .location : répertorie les valeurs d'élément d'index des première et dernière lettres de la chaîne de texte qui est interprétée comme mention de pourcentage.
• .numeric_value : valeur numérique canonique sous la forme d'un entier ou d'un double.
• .range_link : si cette entité apparaît, cela indique que l'entrée utilisateur contient une plage, par exemple, from 2 to 3 percent. La valeur d'emplacement du texte qui spécifie la plage est ajoutée au nom de lien. Des informations supplémentaires sont fournies, notamment le rôle joué par chaque entité @sys-percentage dans la relation de plage. Par exemple, le numéro de début a un type de rôle number_from et le numéro de fin a un type de rôle number_to. Pour vérifier une valeur de rôle, vous pouvez utiliser la syntaxe @sys-percentage.role?.type == 'number_from'.

Le tableau ci-après présente les informations capturées par chaque attribut à partir de l'entrée utilisateur.

Conseils relatifs à l'utilisation de @sys-percentage

• Si vous utilisez l'entité @sys-pourcentage en tant que condition de noeud et que l'utilisateur spécifie 0% comme valeur, la valeur est reconnue comme un pourcentage correctement, mais la condition est évaluée au nombre zéro non pas le pourcentage 0%. Par conséquent, la valeur null dans la condition est évaluée à false et le noeud n'est pas traité. Pour vérifier les pourcentages d'une manière qui gère correctement les pourcentages zéro, utilisez à la place l'expression @sys-percentage OR @sys-percentage == 0 dans la condition de noeud.

• Si vous entrez une valeur telle que 1-2%, les valeurs 1% et 2% sont renvoyées sous la forme d'entités système.