rivet-dev/sandbox-agent

Was macht sandbox-agent?

Stellen Sie Sandbox Agent bereit, konfigurieren Sie ihn und integrieren Sie ihn – eine universelle API für die Orchestrierung von KI-Codierungsagenten (Claude Code, Codex, OpenCode, Amp) in Sandbox-Umgebungen. Verwenden Sie dies, wenn Sie den Sandbox-Agent-Server lokal oder in Cloud-Sandboxen (E2B, Daytona, Docker) einrichten, Agenten-Sitzungen über SDK oder API erstellen und verwalten, Agenten-Events streamen und Human-in-the-Loop-Interaktionen handhaben, Chat-Oberflächen für Codierungsagenten erstellen oder das universelle Schema für Agentenantworten verstehen möchten.

Funktionen

• Universelle API: Einheitliche Schnittstelle für verschiedene Codierungsagenten
• Sandbox-Integration: Unterstützt E2B, Daytona und Docker
• Session-Management: Erstellen, verwalten und überwachen Sie Agenten-Sitzungen
• Event-Streaming: Echtzeit-Ereignisse von Agentenaktionen
• Human-in-the-Loop: Interaktive Genehmigungen und Eingriffe
• Chat-Oberflächen: Einfacher Aufbau von benutzerdefinierten UIs

Schnellstart

# Sandbox-Agent lokal installieren
npm install @rivet-ai/sandbox-agent

# Server starten
npx sandbox-agent start --port 8080

API-Endpunkte

Methode	Pfad	Beschreibung
POST	/sessions	Neue Agenten-Sitzung erstellen
GET	/sessions/:id	Sitzungsdetails abrufen
DELETE	/sessions/:id	Sitzung beenden
POST	/sessions/:id/execute	Befehl ausführen
GET	/sessions/:id/events	Events streamen

Beispiel mit SDK

import { SandboxAgent } from '@rivet-ai/sandbox-agent';

const agent = new SandboxAgent({
  provider: 'e2b',
  apiKey: process.env.E2B_API_KEY
});

const session = await agent.createSession({
  agent: 'claude-code',
  sandbox: 'ubuntu-22.04'
});

const result = await session.execute('ls -la');
console.log(result.output);

Unterstützte Agenten

• Claude Code – Anthropics Codierungsassistent
• Codex – OpenAI's Codex
• OpenCode – Open-Source-Codierungsagent
• Amp – Amps KI-Entwicklungstool

Konfiguration

Umgebungsvariablen:

• SANDBOX_AGENT_PORT – Server-Port (Standard: 8080)
• E2B_API_KEY – API-Schlüssel für E2B-Sandbox
• DAYTONA_API_KEY – API-Schlüssel für Daytona-Sandbox
• DOCKER_HOST – Docker-Host-URL

Lizenz

MIT