> For the complete documentation index, see [llms.txt](https://guidenai.gitbook.io/broxi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guidenai.gitbook.io/broxi/workflows/playground.md).

# Playground

The **Playground** is a dynamic interface designed for real-time interaction with LLMs, allowing users to chat, access memories, and monitor inputs and outputs. Here, users can directly prototype their models, making adjustments and observing different outcomes.

As long as you have an Input or Output component working, you can open it by clicking the **Playground** button. The Playground's window arrangement changes depending on what components are being used.

![](https://2739525811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGUcjvdv7MzVy7GYqImRT%2Fuploads%2F6Eh2X2L2jujzVQOqxgl7%2FScreenshot%202025-04-26%20at%2020.52.53.png?alt=media\&token=eadf3e63-a8b3-43d7-a141-e4cbadeaecdb)

### Run a flow in the playgound

When you run a flow in the **Playground**, BroxiAI calls the `/build/{flow_id}/flow` endpoint. This call retrieves the flow data, builds a graph, and executes the graph.

### View playground messages by session ID

When you send a message from the **Playground** interface, the interactions are stored in the **Message Logs** by `session_id`. A single flow can have multiple chats, and different flows can share the same chat. Each chat will have a different `session_id`.

To view messages by `session_id` within the Playground, click the menu of any chat session, and then select **Message Logs**.

![](https://2739525811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGUcjvdv7MzVy7GYqImRT%2Fuploads%2FOuJnJuzjaUCsou7tV1ef%2FScreenshot%20from%202025-09-07%2023-52-02.png?alt=media\&token=e6ed2be8-935a-40d8-9905-7a2c15bd1df4)

Individual messages in chat memory can be edited or deleted. Modifying these memories influences the behavior of the chatbot responses.

### Use custom Session IDs for multiple user interactions

`session_id` values are used to track user interactions in a flow. By default, if the `session_id` value is empty, it is set to the same value as the `flow_id`. In this case, every chat call uses the same `session_id`, and you effectively have one chat session.

The `session_id` value can be configured in the **Advanced Settings** of the **Chat Input** and **Chat Output** components.

To have more than one session in a single flow, pass a specific Session ID to a flow with the `session_id` parameter in the URL. All the components in the flow will automatically use this `session_id` value.

To post a message to a flow with a specific Session ID with curl, enter the following command:

```json
   curl -X POST "https://use.broxi.ai/api/v1/run/$FLOW_ID" \
   -H 'Content-Type: application/json' \
   -d '{
       "session_id": "custom_session_123",
       "input_value": "message",
       "input_type": "chat",
       "output_type": "chat"
   }'
```

Check your flow's **Playground**. In addition to the messages stored for the Default Session, a new session is started with your custom Session ID.

[<br>](/broxi/workflows/overview.md)