Every GeneXus AI task has a parameter based on Messages structured data type, which includes information about the status of the operation. This parameter is always the second last on the list, allowing you to write an AI task as follows.
&result = GeneXusAI.<Category>.<AI_Task>(&parm1, ..., &parmN, &messages)
where |
|
&parm1,...,&parmN |
: Set of parameters whose types depends on the AI task. |
&messages |
: Messages, GeneXus.Common |
&result |
: Returned value whose type depends on the AI task. |
The table below lists the possible error codes raised by GeneXusAI, and is stored in the 'Id' field of the Messages.Message data type.
Code |
Description |
|
There is no result
Raised as an informational status when the provider does not give any output result. |
|
There is no processing
Raised as an informational status when the provider does not process any output. |
|
Language is not set
Raised as an informational status when a language is not set, but by setting it you could achieve higher accuracy. |
|
Credentials are missing
Raised when you do not provide your access credentials properly. |
|
Text is empty
Raised when the given input required text is empty. |
|
Language is empty
Raised when the given input required language is empty. |
|
Source language is empty
Raised when the given input required source language, in translation task context, is empty. |
|
Target language is empty
Raised when the given input required target language, in translation task context, is empty. |
|
Language has an incorrect format
Raised when the given input language is a two-letter code (e.g. 'en') but a language/locale is expected (e.g. 'en-US'). |
|
File path is empty
Raised when the given input required file path is empty. |
|
File path does not exist
Raised when the given input file path does not exist. |
|
File format is not supported
Raised when the given file format is not supported. |
|
File fetch from URL failed
Raised when the given file URL cannot be fetched. |
|
File upload failed
Raised when the given file could not be uploaded to the application server. |
|
Model name '%1' is unknown
Raised when the given model name (%1) is unknown by the provider. |
|
File source is ambiguous, path and URL are both given
Raised when you give both URL and path for a file resource. |
|
File source is unspecified, path or URL must be given
Raised when you do not give any URL or path for a file resource. |
|
Collection '%1' is empty
Raised when the given collection input does not have elements. |
|
Recognition mode '%1' is unknown
Raised when the given recognition mode is unknown by the provider. |
|
SSML has a wrong format
Raised when the given SSML, in text-to-speech context, is unknown by the provider. |
|
Voice is unavailable
Raised when the given voice, in text-to-speech context, is not available by the provider. |
|
File content or location is empty
Raised when the given file content or location (path/URL) is empty. |
|
File is unavailable
Raised when your input file is not available or reachable. |
|
URL has a wrong format.
Raised when you provide a URL with an unexpected format. |
|
Credentials are ambiguous, username/password and key are both given.
Raised when you provide both Username/Password and Key for authenticating, you must set only one mechanism. |
|
Text is too large
Raised when the given text is too large. |
|
Proxy is enabled but host/port is missing
Raised when you enable a proxy but connection information is missing. |
|
Model is unavailable
Raised when your model is unavailable. |
|
Model sample is empty
Raised when your model's dataset generator (procedure or data provider object) raise an empty collection. |
|
Parameter '%1' is malformed
Raised when a required parameter is malformed. |
|
Parameter '%1' is missing
Raised when a required parameter is missing. |
|
External provider raises an error '%1'
Raised when the provider has not finished successfully. |
|
Authentication failed due to an invalid token
Raised when the authentication has failed due to an invalid access token. |
|
Authentication failed during communication. Reason %1
Raised when the authentication has failed due to an unknown issue. |
|
Operation failed
Raised when the current operation has failed. |
|
Deprecated
Raised when a provider has deprecated the service used by some task. |
|
Provider name is empty
Raised when you set a provider at runtime, but the Provider.Name field has not been set. |
|
Task '%1' is unavailable for '%2' provider
Raised when you try to execute an AI task which is not available for the given provider. |
|
Unhandled exception
Raised when the module catch an unhandled exception. |
|
An error has occurred
Raised when the AI task return an error, giving a code/detail of its cause. |
This document applies as of GeneXus 16.