Skip to main content

Sandgarden architecture

Sandgarden architecture

Customer app​

This is any application that the customer is running in their environment and wants to extend with AI functionality. It communicates to the Director over an HTTPS endpoint.

Director​

Directors organize, execute, and route workflows in real-time. They are also responsible for the coordination of complex batch processes and data syncs to ensure workflows are always production-ready. The director’s ultimate job is to provide an HTTPS endpoint for integration into the customer’s application.

The director is a stateless Go binary that can be deployed however you choose. Directors can be deployed in pools behind a load balancer for redundancy and scalability. They are deployed entirely in a customer’s environment. Directors communicate with the control plane (see below) to share configuration, workflow, and run information.

CLI​

The Sandgarden CLI (sand) is a command-line tool you can use to manage workflows and testing.

API​

The Sandgarden API is a full-featured REST API that allows you to embed Sandgarden workflows into your existing application. It offers the same actions as the CLI and web UI.

Web UI and control plane​

The Web UI (app.sandgarden.com) is where configuration is housed. This includes user management, access controls, resource management, workflow management, logging, debugging, and the entire lifecycle of running and reviewing test suites (either via the UI or in code). The Web UI distributes workflow configuration to the director pool.

The Web UI and control plane are hosted by Sandgarden.

Execution layer​

The execution layer talks to all defined resources and is where workflows run. It is modular, designed to be run in any way and integrate with the customer’s existing compute infrastructure. It talks to all target systems (e.g. datasources and AI).

External connectors​

Under this heading are connections to external resources such as datasources, LLMs and other AI tools, and RAG (retrieval-augmented generation) tools. Sandgarden handles configuring and exposing access to these resources via steps and workflows.

See also​

For more information about these and other Sandgarden concepts, check out our Concepts page.