Skip to main content
Last updated on
Tags:
Options
Open in ChatGPTAsk ChatGPT about this pageOpen in ClaudeAsk Claude about this page

Run the Demo

Clone the OpenBox demo agent, plug in your keys, and see governance capture and evaluate every workflow event, activity, and LLM call.

Prerequisites​

You'll also need make and the Temporal CLI. Install both for your platform:

xcode-select --install   # provides make
brew install temporal

Or to manually install Temporal, download for your architecture:

Extract the archive and add the temporal binary to your PATH.

Clone and Configure​

git clone https://github.com/OpenBox-AI/poc-temporal-agent
cd poc-temporal-agent

Install dependencies:

make setup

To get your OPENBOX_API_KEY, register an agent in the dashboard: Agents → Add Agent, set the workflow engine to Temporal, and generate an API key.

Copy .env.example to .env and set your values:

.env
# LLM — use the format provider/model-name
LLM_MODEL=openai/gpt-4o
LLM_KEY=your-llm-api-key

# Temporal
TEMPORAL_ADDRESS=localhost:7233

# OpenBox
OPENBOX_URL=https://core.openbox.ai
OPENBOX_API_KEY=your-openbox-api-key

Run the Demo​

The demo runs four processes that work together:

TerminalCommandWhat it does
1temporal server start-devStarts a local Temporal server that orchestrates workflows — it schedules activities, manages retries, and maintains workflow state
2make run-workerRuns the Temporal worker that executes your agent's workflow and activity code. The OpenBox SDK is initialized here, intercepting every event for governance
3make run-apiStarts the backend API that the frontend calls to trigger workflows and relay messages to the agent
4make run-frontendServes the chat UI at localhost:5173 where you interact with the agent

Start each in a separate terminal:

# Terminal 1 — Temporal dev server
temporal server start-dev

# Terminal 2 — OpenBox worker
make run-worker

# Terminal 3 — API server
make run-api

# Terminal 4 — Frontend
make run-frontend

You should see OpenBox SDK initialized successfully in the worker output.

Chat with the Agent​

Open http://localhost:5173 — this is the demo frontend. The default scenario is a travel booking assistant.

Send a message (e.g., "I want to book a trip to Australia") and let the agent run through the full workflow. This generates the workflow events, activity executions, and LLM calls that OpenBox captures and governs.

What Just Happened?​

When you ran the demo, the OpenBox SDK:

  • Intercepted workflow and activity events — every workflow start, activity execution, and signal was captured and sent to OpenBox for governance evaluation
  • Captured HTTP calls automatically — OpenTelemetry instrumentation recorded all outbound HTTP requests (LLM calls, external APIs) with full request/response bodies
  • Evaluated governance policies — each event was checked against your agent's configured policies in real-time
  • Recorded a governance decision for every event — approved, blocked, or flagged — giving you a complete audit trail

See It in the Dashboard​

Open the OpenBox Dashboard:

  1. Navigate to Agents → Click your agent
  2. On the Overview tab, find the session that corresponds to your workflow run
  3. Click Details to open the Event Log Timeline
  4. Scroll through the timeline — you'll see every event the trust layer captured:
    • Workflow start/complete events
    • Each activity with its inputs and outputs
    • HTTP requests to your LLM provider
    • The governance decision OpenBox made for each event
  5. Click Watch Replay to open Session Replay — this plays back the entire session step-by-step

Next Steps​