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.

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.

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:

   curl -X POST "http://127.0.0.1:7860/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.