AI Sandbox SDK for Java

UX-First Value Cards

Quick Integration	Real-Time Experience	Reliability by Default
Clean Java API surface with low onboarding overhead	sendChatStream(...) for streaming chunks	Timeout + retry controls tuned for production

Visual Integration Flow

flowchart LR
  A[Create Agent] --> B[Create Chat Channel]
  B --> C[Send Message]
  C --> D[SSE Stream Chunks]
  D --> E[Attach Knowledge Base]
  E --> F[Customer-Ready Experience]

Loading

60-Second Quick Start

import com.egroupai.sandbox.sdk.AiSandboxClient;
import java.util.List;
import java.util.Map;

AiSandboxClient client = new AiSandboxClient(
  System.getenv().getOrDefault("AI_SANDBOX_BASE_URL", "https://www.egroupai.com"),
  System.getenv().getOrDefault("AI_SANDBOX_API_KEY", "")
);

Map<String, Object> agent = client.createAgent(Map.of(
  "agentDisplayName", "Support Agent",
  "agentDescription", "Handles customer inquiries"
));
int agentId = Integer.parseInt(String.valueOf(((Map<String, Object>) agent.get("payload")).get("agentId")));

Map<String, Object> channel = client.createChatChannel(agentId, Map.of(
  "title", "Web Chat",
  "visitorId", "visitor-001"
));
String channelId = String.valueOf(((Map<String, Object>) channel.get("payload")).get("channelId"));

List<String> chunks = client.sendChatStream(agentId, Map.of(
  "channelId", channelId,
  "message", "What is the return policy?",
  "stream", true
));
chunks.forEach(System.out::println);

Maven

<dependency>
  <groupId>com.egroupai</groupId>
  <artifactId>ai-sandbox-sdk-java</artifactId>
  <version>1.0.0</version>
</dependency>

Integration Sanity Checklist

• Keep AI_SANDBOX_API_KEY in secure runtime configuration.
• Confirm AI_SANDBOX_BASE_URL points to the intended environment.
• Verify [DONE] handling in stream consumers before release.

Snapshot

Metric	Value
API Coverage	11 operations (Agent / Chat / Knowledge Base)
Stream Mode	text/event-stream with [DONE] handling
Retry Safety	429/5xx auto-retry for GET/HEAD + capped exponential backoff
Error Surface	ApiException with status/body/traceId
Validation	Production-host integration verified
Release Readiness	Run draft-release-train and guards checks before merge

Links

• Official System Integration Docs
• Public Capability Showcase
• 30-Day Optimization Plan
• Integration Guide
• Quickstart Example
• Repository

License

This SDK is released under the Apache-2.0 license.