AI Prompts

This page is accessed via Configuration and Administration > Power Data > AI > AI Prompts.

Use this page to add agentic prompts for custom AI agent queries. An agentic prompt is the first question in an agentic chat.

Prompt writing can be very sophisticated. Look at the sample prompts in the PUBLIC domain for examples on how to phrase prompts.

Macros of the form {<macro-name>} may be entered into prompts. These are evaluated before prompts are set to the AI. These macros currently include:

• content: See the Prompt Content section.
• audience: The audience fragment for insertion into the prompt.
• guardrail: The guardrail fragment for insertion into the prompt, for Generative AI only.
• output: The output fragment for insertion into the prompt.
• language: The ISO language specification for the current user. This is based on User Preferences.
• country: The country preference for the current user.
• timeZone: The time zone preference for the current user.
• currency: The currency preference for the current user.
• weight: The weight preference for the current user.
• volume: The volume preference for the current user.
• translation: A special marker to add language requests for non-English users. When a user's language is not English, the prompt will include the following text: Translate the results into ISO language {language}.

Prompt Content

Prompt content changes based on use cases.

Use Case	content
SQL Analysis	Simple string holding SQL.
Explain Plan	Simple string holding the entire database explain plan.
Shipment Summary	Simple string holding the shipment GID.

 

Prompt content changes based on AI Agents.

AI Agent	content
BULK PLAN DIAGNOSTIC SUMMARY AI Agent	String holding the bulk plan's diagnostic log file ID: content.diagnosticLogFileID
BULK PLAN DIAGNOSTIC FULL SUMMARY AI Agent	String holding the bulk plan's diagnostic log file ID: content.diagnosticLogFileID
BULK PLAN DIAGNOSTIC ORDER ERRORS AI Agent	String holding the bulk plan's diagnostic log file ID: content.diagnosticLogFileID If you use this content string and an AI Agent Query Type ID of BULK PLAN DIAGNOSTICS in a prompt, when you use the prompt in AI Chat you see a standard UI picklist field of Bulk Plan Diagnostics Log File ID. You can use this field to search for and select a log file.
BULK PLAN DIAGNOSTIC OPEN ENDED AI Agent	Open-ended AI agent. No content is provided. The first question asked by the user becomes content.
RATE INQUIRY AI Agent	Open-ended AI agent. No content is provided. The first question asked by the user becomes content.
DOCK SCHEDULING AI Agent	Open-ended AI agent. No content is provided. The first question asked by the user becomes content.
SHIPMENT CHANGE AI Agent	Open-ended AI agent. No content is provided. The first question asked by the user becomes content.
PRODUCT CLASSIFICATION ASSISTANT AI Agent	Open-ended AI agent. No content is provided. The first question asked by the user becomes content. You can create your own prompt and include: ${content.itemID} ${content.productClassificationTypeID} If you use these content strings and an AI Agent Query Type ID of PRODUCT CLASSIFICATION ASSISTANT in a prompt, when you use the prompt in AI Chat you see a standard UI picklist fields of Item ID and Classification Type. You can use these fields to search for and each of the IDs.
GTM RESTRICTED PARTY PREPROCESSING ASSISTANT AI Agent	Open-ended AI agent. No content is provided. The first question asked by the user becomes content.

Note: Open-ended agents have no content provided. The first chat question asked by the user becomes content.

 

Adding an AI Prompt

1. Enter an AI Prompt ID.
2. Select an AI Agent Query Type ID. Note that the AI agent query type on the AI prompt must match the agent query type on any AI agent query to which you attach this prompt.
3. Select a domain from the Domain Name drop-down list.
4. Enter a Prompt.
5. Select Finished.

Note: After selecting Finished to save your new prompt, you must sign out and sign back into OTM.

Example Prompt

You can create your own prompt and include specific content for the BULK PLAN DIAGNOSTIC AI Agents and the PRODUCT CLASSIFICATION ASSISTANT AI Agent.

Adding a Prompt for GTM Product Classification with a Pick List

1. Enter an AI Prompt ID. For example, PRODUCT_CLASS_CHECK.
2. Select an AI Agent Query Type ID of PRODUCT CLASSIFICATION ASSISTANT.
3. Select a domain from the Domain Name drop-down list.
4. Enter a Prompt similar to one shown below:
   
   The item ID is ${content.itemID} and the product classification type is ${content.productClassificationTypeID}
5. Select Finished.

If you use these content strings and an AI Agent Query Type ID of PRODUCT CLASSIFICATION ASSISTANT in a prompt, when you use the prompt in AI Chat you see a standard UI picklist fields of Item ID and Classification Type. You can use these fields to search for and each of the IDs.

Note: You can use the content string, ${content.<anyInputField>, to create a plain-text input field.