Prompt Decorator¶

The Prompt Decorator is a custom Synapse mediator for the WSO2 API Manager Universal Gateway, designed to enhance and standardize prompt inputs sent to AI services. It applies structured prompt decoration techniques to incoming text or chat-based payloads, enabling centralized control over prompt formatting, tone, behavior hints, and other guiding cues.

Prompt decoration is a specialized prompt engineering technique that uses explicit modifiers such as symbols, keywords, or formatting cues to direct the AI’s reasoning, structure, or output format. These decorators act as meta-instructions, clarifying how the AI should approach a task. Among emerging techniques, prompt decoration stands out as a practical method for guiding AI behavior with precision and consistency.

Features¶

Apply structured decorations to both text and chat-based prompts
Support prepend and append modes for flexible decorator placement
Centrally manage decorators at the AI API level
Enforce prompt consistency across all AI API consumers
Improve safety, predictability, and output control in LLM interactions

How to Use¶

Follow these steps to integrate the Prompt Decorator policy into your AI API:

Open the API Publisher Portal (https://<host>:<port>/publisher)
Select your AI API
Go to Develop > API Configurations > Policies
Expand Common Policies in the Policy List
Drag and drop the Prompt Decorator policy into your desired mediation flow
Fill in the required policy configuration
Save and Deploy the AI API

Example Policy Configuration¶

Mode: Text Prompt Decoration¶

This example demonstrates how the Prompt Decorator policy can be used to inject summarization instructions into a raw prompt that contains a large block of text. The decorator is applied at the text level, specifically targeting the last message in the conversation using a JSONPath expression. By prepending a consistent summarization directive, the assistant is guided to produce summaries that align with organizational tone and expectations, such as being concise, neutral, and professionally structured.

Create an AI API with Mistral AI.
Add the Prompt Decorator policy to the API with the following configuration:

Field Example

Decorator Name Summarizer Directive

JSON Path $.messages[-1].content

Append Decorated Content false

Prompt Decorator Configuration:
```
{
  "decoration": "Summarize the following content in a concise, neutral, and professional tone. Structure the summary using bullet points if appropriate.\n\n"
}
```
Save and re-deploy the API.

Invoke the API's chat/completion endpoint with a large text to summerize in the payload:

{
  "model": "mistral-small-latest",
  "messages": [
      {
          "role": "user",
          "content": "<Large text to summarize>"
      }
  ]
}

The policy will inject the configured prompt decorator and the following will be sent to the AI service:

{
  "model": "mistral-small-latest",
      "messages": [
          {
              "role": "user",
              "content": "Summarize the following content in a concise, neutral, and professional tone. Structure the summary using bullet points if appropriate.\n\n<Large text to summarize>"
          }
      ]
}

Mode: Chat Prompt Decoration¶

This example demonstrates how the Prompt Decorator policy can be used to inject a receptionist persona into an AI-powered hotel booking agent. By applying a structured decorator at the chat level, the assistant is guided to interact in a professional, friendly, and conversational manner, similar to a real hotel receptionist. This ensures an improved user experience while the assistant gathers booking details and completes the reservation using a tool call.

Create an AI API with Mistral AI.

Add the Prompt Decorator policy to the API with the following configuration:

Field	Example
`Decorator Name`	`Receptionist Persona`
`JSON Path`	`$.messages`
`Append Decorated Content`	`false`

Prompt Decorator Configuration:

{
    "decoration": [
        {
            "role": "system",
            "content": "You are a helpful hotel booking receptionist for the imaginary hotel 'Azure Horizon Resort'. Your job is to collect all the necessary booking details from guests: name, NIC, check-in time, staying duration (in nights), and room type (single, double, suite). Ask one detail at a time in a friendly and professional tone. Once all details are collected, call the booking tool to complete the reservation and return the booking confirmation."
        }
    ]
}

Save and re-deploy the API.

Invoke the API's chat/completion endpoint with the following payload:

{
    "model": "mistral-small-latest",
    "messages": [
        {
            "role": "user",
            "content": "Hi, I’d like to book a room."
        }
    ],
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "book_hotel_room",
                "description": "Finalizes a hotel room reservation based on guest-provided details.",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "name": {
                            "type": "string",
                            "description": "Full name of the guest"
                        },
                        "nic": {
                            "type": "string",
                            "description": "National Identity Card number"
                        },
                        "check_in": {
                            "type": "string",
                            "format": "date-time",
                            "description": "Check-in date and time (e.g., 2025-08-01T14:00:00)"
                        },
                        "nights": {
                            "type": "integer",
                            "description": "Number of nights the guest wants to stay"
                        },
                        "room_type": {
                            "type": "string",
                            "enum": ["single", "double", "suite"],
                            "description": "Type of room requested"
                        }
                    },
                    "required": ["name", "nic", "check_in", "nights", "room_type"]
                }
            }
        }
    ],
    "tool_choice": "auto"
}

The policy will inject the configured prompt decorator and the following will be send to the AI service:

{
    "model": "mistral-small-latest",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful hotel booking receptionist for the imaginary hotel 'Azure Horizon Resort'. Your job is to collect all the necessary booking details from guests: name, NIC, check-in time, staying duration (in nights), and room type (single, double, suite). Ask one detail at a time in a friendly and professional tone. Once all details are collected, call the booking tool to complete the reservation and return the booking confirmation."
        },
        {
            "role": "user",
            "content": "Hi, I’d like to book a room."
        }
    ],
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "book_hotel_room",
                "description": "Finalizes a hotel room reservation based on guest-provided details.",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "name": {
                            "type": "string",
                            "description": "Full name of the guest"
                        },
                        "nic": {
                            "type": "string",
                            "description": "National Identity Card number"
                        },
                        "check_in": {
                            "type": "string",
                            "format": "date-time",
                            "description": "Check-in date and time (e.g., 2025-08-01T14:00:00)"
                        },
                        "nights": {
                            "type": "integer",
                            "description": "Number of nights the guest wants to stay"
                        },
                        "room_type": {
                            "type": "string",
                            "enum": ["single", "double", "suite"],
                            "description": "Type of room requested"
                        }
                    },
                    "required": ["name", "nic", "check_in", "nights", "room_type"]
                }
            }
        }
    ],
    "tool_choice": "auto"
}

Field	Example
`Decorator Name`	`Summarizer Directive`
`JSON Path`	`$.messages[-1].content`
`Append Decorated Content`	`false`