Playground Instructions

Estimated reading: 4 minutes

The Playground Instructions component passes response guidelines configured under Agent Behaviour in the Playground to the connected Agent. These instructions control how the Agent formats and delivers its responses without requiring changes to the underlying prompt or flow.

1. Purpose and Benefits

Use Playground Instructions when the core task stays the same, but you want to adjust how the Agent communicates the result such as its tone, response length, level of detail, or output format. Separating response preferences from the task lets you iterate quickly in the Playground without editing the flow.

For example, you can instruct the Agent to:

a. Use simple language for a non-technical audience.
b. Keep responses concise and focused.
c. Maintain a professional, friendly, or conversational tone.
d. Format outputs as bullet points, tables, or step-by-step explanations.

2. How Playground Instructions Fit with Prompts and Skills

Prompts, Skills, and Playground Instructions each serve a distinct role:

Capability Purpose Example
Prompt Defines the core task, objective, or outcome the Agent is expected to achieve. "Analyze the uploaded monthly sales reports and identify key performance trends."
Skills Provide reusable instructions, domain expertise, and supporting resources that help the Agent perform specialized tasks. A sales analysis Skill providing specific analytical frameworks and reference data.
Playground Instructions Define how the Agent should present its response, including behavior, tone, formatting, and response style. "Use simple language, keep the response concise, and present trends as bullet points."

Playground Instructions do not replace Prompts or Skills. Instead, they define how the Agent presents its responses, while Prompts and Skills determine what the Agent does and how it completes the task.

3. Playground Instructions vs. Prompt

The Prompt and Playground Instructions serve different purposes. Keeping them, separate helps ensure the Agent behaves consistently and produces the expected results.

Feature Prompt Playground Instructions
Purpose Defines what the Agent does. Defines how the Agent responds.
Configuration Set in the Agent component. Set under Agent Behaviour in the Playground.
Example "Review customer feedback and summarize the major issues." "Use simple language, a professional tone, and present the summary as bullet points."

Avoiding conflicts: Ensure your Playground Instructions do not contradict the prompt. If a prompt requests a “comprehensive, detailed report” and Playground Instructions say “keep answers under two sentences,” the Agent will attempt to satisfy both, leading to unpredictable outputs.

4. How it works at runtime

When a flow runs, the component executes the following sequence:

1. Retrieve: Fetches the guidelines saved under Agent Behaviour for that specific flow.
2. Pass: Sends those guidelines through its Instructions output port.
3. Receive: The connected Agent receives the guidelines via its instruction input alongside the task prompt and flow context.
4. Generate: The Agent applies the style and formatting guidance while generating its final response.

5. How to configure Playground Instructions

To set up and use Playground Instructions in a flow:

1. Add the component: Drag the Playground Instructions component onto the [visual editor] canvas. (This enables the Agent Behaviour option for the flow in the Playground.) 
2. Connect to the Agent: Wire the Instructions output to the instruction input of the Agent component.
3. Define the task: Ensure the Agent’s prompt clearly states the task to perform.
4. Configure in the Playground:
a. Open the flow in the Playground and select Agent Behaviour.
b. Enter your response guidelines in the Instructions field (e.g., “Use simple language. Keep the response concise.”).
c. Click Save.
5. Test and iterate: Run the flow in the Playground to verify the output. To adjust the style later, update and save the text under Agent Behaviour and re-run the flow.

Component Parameters

Parameter Description
Instructions Contains the instructions configured in Agent Behaviour and sends them to a connected Agent.

Important Considerations

a. Flow-specific: Guidelines apply only to the flow in which they are configured and are not shared across flows.

b. Connection required: Leaving the Instructions output disconnected prevents the Agent from receiving your saved guidelines.

c. Behavioral guidance: Playground Instructions guide the model rather than enforce strict rules. Final output quality still depends on the selected language model, prompt clarity, and other flow configurations.

Related topics: Agent, Playground, Skills, Playground LLM.

Share this Doc

Playground Instructions

Or copy link

CONTENTS
Robility Chatbot
Robility Assistant
Online