Skip to main content

​
Running the iCommerce Agent in Sandbox

This guide explains how to run the iCommerce agent inside StateSet Sandbox for secure, isolated execution.

​
Why Sandbox

  • Isolated runtime for agent execution
  • Controlled access to tools and data
  • Deterministic workflows with auditability

​
High-Level Flow

  1. Provision a sandbox environment.
  2. Start the iCommerce agent process.
  3. Use MCP tools or the CLI for queries and actions.
  4. Stream outputs and capture logs.

​
Sandbox Setup

Create a sandbox and run a simple command: 
curl -X POST https://api.sandbox.stateset.app/api/v1/sandbox/create \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout_seconds": 300}'

​
Run the Agent

Inside the sandbox, run the stateset CLI in read-only mode first, then apply actions explicitly: 
stateset "show me pending orders"
stateset --apply "ship order #12345 with tracking FEDEX123"

​
Logging and Auditing

  • Stream command output for review
  • Record actions, inputs, and outcomes
  • Keep explicit write intent for audit trails