The Execute Prompt smart service lets you integrate your AI skill into your process. This smart service takes text input and appends it to your prompt. Then, the smart service sends the compiled prompt to a generative artificial intelligence model, which returns text output.
The smart service takes text as input.
The user who executes the process model doesn't need to have access to the AI skill being called by the Execute Prompt smart service. However, without those permissions, some smart service configuration options are masked.
The Setup tab allows you to select an AI skill.
| 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.
If any of these guardrails are limiting, please reach out to your Appian contact.
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 text are too large for the AI model to analyze. | Reduce the size of either the prompt or the input text 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 Prompt 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 text is empty. | Reconfigure the smart service to pass a value into Input Text. |
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. |
