Execute Generative AI Skill Smart Service

Overview

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.

Permissions

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.

Properties

• Category: AI_Skills
• Icon:
• Assignment options: Unattended

Configuration options

Setup tab

The Setup tab allows you to select an AI skill.

• Select AI Skill: Search or browse for an AI skill to use with this smart service.

Data tab

Node inputs

Inputs change based on the AI skill you use with this smart service.

Document inputs

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

Email inputs

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

Text inputs

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

Node outputs

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.

Usage considerations

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

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

Runtime behavior

At run-time, the smart service calls a machine learning model that is associated with the AI skill configured in the Setup tab.

Possible error messages

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.

Feedback