The Execute Generative AI Skill smart service lets you integrate your AI skill into your process. This smart service takes input and appends it to the prompt you created in the relevant AI skill. Then, the smart service sends the compiled prompt to a generative artificial intelligence model, which returns an output.
The smart service takes a document, email, or text as input. Review the list of generative AI skills you can use with this smart service.
The user who executes the process model doesn't need to have access to the AI skill being called by the Execute Generative AI Skill smart service. However, without those permissions, some smart service configuration options are masked.
The Setup tab allows you to select an AI skill.
Inputs change based on the AI skill you use with this smart service.
Name | Data Type | Description | Required | Multiple |
---|---|---|---|---|
Input Document | Document | Runtime document that will be appended to the prompt configured in the selected AI skill. | Y | N |
Name | Data Type | Description | Required | Multiple |
---|---|---|---|---|
Input Email | Document | Runtime email that will be appended to the prompt configured in the selected AI skill. | Y | N |
Name | Data Type | Description | Required | Multiple |
---|---|---|---|---|
Input Text | Text | Runtime text that will be appended to the prompt configured in the selected AI skill. | Y | N |
The smart service returns the model's response as text. If the model encounters an error, details are returned in the Error Message
output.
Output | Data Type | Multiple | Description |
---|---|---|---|
Success | Boolean | N | Returns true if the execution was successful or false if it was unsuccessful. |
Response | Text | N | The model's response. |
Error Message | Text | N | When applicable, the error message returned by the model. |
Activity chaining is supported.
The AI model has a maximum limit of 100,000 tokens to analyze per call. If the combined prompt and input text exceed this limit, you may encounter an error.
The output of the smart service will never exceed 4096 tokens.
If any of these guardrails are limiting, please reach out to your Appian contact.
Input requirements correspond to the type of AI skill you're using with the smart service. Refer to the table below to see the requirements for each AI skill using that input type.
Requirement | Document input | Email input | Text input |
---|---|---|---|
File type | PDF, digital or scanned | EML | N/A |
File size limit | 25MB | 25MB | N/A |
Page limit per file | 100 pages | N/A | N/A |
At run-time, the smart service calls a machine learning model that is associated with the AI skill configured in the Setup tab.
Consult the following table to learn how to fix common errors when using this smart service:
Error message | Reason | Remedy |
---|---|---|
Invalid input. The combination of the prompt and input text may exceed the maximum size accepted by the AI model. Reduce the prompt or input text size and try again. |
The prompt and input are too large for the AI model to analyze. | Reduce the size of either the prompt or the input and try again. |
There is a problem with the task "Execute Prompt" in the process "process_model_name". The underlying AI Skill object has been deleted or is otherwise invalid. Please confirm the node's configuration and try again. |
The Execute Generative AI Skill smart service is referring to an AI skill design object that no longer exists. | Reconfigure the smart service to use an existing AI skill. |
The parameter Input Text has an invalid value or is missing. |
The smart service input is empty. | Reconfigure the smart service to pass a value into the input variable. |
The underlying AI Skill object has an invalid prompt or the prompt is empty. |
The AI skill does not have the prompt defined. | Edit the AI skill and add a prompt. |
An unexpected error occurred while executing the Smart Service. |
Unknown issue communicating with the AI model. | Try again later. |
The AI model took too long to respond and timed out. |
The AI model takes too long to respond to the request. | Try again later. |
The number of requests exceeds the service quota. Try again later. |
The number of requests to the AI model exceeds the service quota. | Reduce the number of calls to the AI model and try again. |
The number of requests and tokens exceeds the limit allowed per minute. Reduce usage or try again later. |
The number of requests and tokens per minute exceeds the limit. | Reduce the size of each prompt and number of calls to the AI model and try again. |
Execute Generative AI Skill Smart Service