Skip to main content

​
iCommerce Agent Sandbox Troubleshooting

Use this checklist when sandboxed agent runs fail or return unexpected results.

​
Authentication Errors

  • Confirm ApiKey is valid and not expired
  • Verify the Authorization header format: ApiKey YOUR_API_KEY

​
Missing CLI

  • Ensure the sandbox image includes the stateset CLI
  • Rebuild or update the runtime image if the CLI is missing

​
Permission or Guardrail Failures

  • Verify the command includes --apply for write actions
  • Review guardrail policies for restricted operations

​
Timeouts

  • Increase timeout_seconds when creating the sandbox
  • Reduce workflow size or split into smaller tasks

​
Output/Logging Issues

  • Stream command output to capture errors
  • Store execution logs for auditability