mirror of
https://github.com/harivansh-afk/sandbox-agent.git
synced 2026-04-15 16:04:06 +00:00
e3c030f66d
* chore: remove inspect.sandboxagent.dev in favor of /ui/ * chore: add 404 page * fix: correct inspector package name in Dockerfiles and add .dockerignore - Change @anthropic-ai/sdk-inspector to @sandbox-agent/inspector in all Dockerfiles - Add .dockerignore to exclude target/, node_modules/, etc from Docker context The wrong package name caused pnpm install --filter to match nothing, so the inspector frontend was never built, resulting in binaries without the /ui/ endpoint. * chore: cargo fmt * chore(release): update version to 0.1.4-rc.7
45 lines
1.5 KiB
Text
45 lines
1.5 KiB
Text
---
|
|
title: "Inspector"
|
|
description: "Debug and inspect agent sessions with the Inspector UI."
|
|
icon: "magnifying-glass"
|
|
---
|
|
|
|
The Inspector is a web-based GUI for debugging and inspecting Sandbox Agent sessions. Use it to view events, send messages, and troubleshoot agent behavior in real-time.
|
|
|
|
<Frame>
|
|
<img src="/images/inspector.png" alt="Sandbox Agent Inspector" />
|
|
</Frame>
|
|
|
|
## Open the Inspector
|
|
|
|
The Inspector UI is served at `/ui/` on your sandbox-agent server. For example, if your server is running at `http://localhost:2468`, open `http://localhost:2468/ui/` in your browser.
|
|
|
|
You can also generate a pre-filled Inspector URL with authentication from the TypeScript SDK:
|
|
|
|
```typescript
|
|
import { buildInspectorUrl } from "sandbox-agent";
|
|
|
|
const url = buildInspectorUrl({
|
|
baseUrl: "http://127.0.0.1:2468",
|
|
token: process.env.SANDBOX_TOKEN,
|
|
});
|
|
console.log(url);
|
|
// http://127.0.0.1:2468/ui/?token=...
|
|
```
|
|
|
|
## Features
|
|
|
|
- **Session list**: View all active sessions and their status
|
|
- **Event stream**: See events in real-time as they arrive (SSE or polling)
|
|
- **Event details**: Expand any event to see its full JSON payload
|
|
- **Send messages**: Post messages to a session directly from the UI
|
|
- **Agent selection**: Switch between agents and modes
|
|
- **Request log**: View raw HTTP requests and responses for debugging
|
|
|
|
## When to Use
|
|
|
|
The Inspector is useful for:
|
|
|
|
- **Development**: Test your integration without writing client code
|
|
- **Debugging**: Inspect event payloads and timing issues
|
|
- **Learning**: Understand how agents respond to different prompts
|