LangSmithOnboarding

Hybrid Onboarding Overview

Get LangSmith SaaS set up, with the option to run agent servers in your own environment.

Relevant Tools
Admin Readiness Review→RBAC & SCIM Guide→ABAC Policy Builder→Cluster Sizing Calculator→
Onboarding Partner Your assigned Customer Engineer owns your onboarding experience. If you choose to deploy standalone Agent Servers, your Solution Architect will help with that setup.

What is LangSmith Hybrid?

LangSmith Hybrid gives you the full LangSmith SaaS platform — tracing, evaluation, prompts, and more — with the option to run your agent runtime in your own environment instead of LangChain's:

  • LangSmith Platform — Fully managed by LangChain, same as Cloud. Handles observability, evaluation, prompts, and org configuration.
  • Agent Servers (optional) — If you need agent execution to stay inside your own infrastructure, deploy standalone Agent Servers via Docker, Docker Compose, or Kubernetes. They send traces back to LangSmith for observability.

This gives you LangChain's fully-managed platform with the flexibility to keep agent workloads in your own environment when required — useful for data residency requirements or workloads that cannot leave your environment.

Onboarding Overview

Step 1: Set Up Your LangSmith SaaS Account

Hybrid starts exactly like LangSmith Cloud:

  1. Sign up for your region — GCP US (default), GCP EU, GCP APAC, or AWS US — using your company email. See the regions FAQ for details on each.
  2. Create your organization — do not use the personal org created on first login. See set up hierarchy.
  3. Share your Organization ID with your Customer Engineer.

Step 2 (Optional): Deploy Standalone Agent Servers

If you need agent execution to run inside your own environment, deploy standalone Agent Servers there instead of using LangSmith's managed runtime:

What you need:

  • Docker, Docker Compose, or a Kubernetes cluster — whichever you already run
  • A LangSmith API key from the workspace you want to trace to
  • Network egress to your chosen LangSmith endpoint (e.g. api.smith.langchain.com, or your self-hosted instance)

How it connects:

  • Agent Servers send traces to LangSmith via the LANGSMITH_ENDPOINT environment variable, authenticated with your LangSmith API key.
  • Everything else — the LangSmith UI, tracing storage, evaluation, and prompts — stays fully managed in SaaS.

Full setup instructions live in the official Hybrid deployment docs. Your Solution Architect will guide you through standalone server setup if you choose this path.

Next: Configure Your Organization

With your account created and org ID shared, use the Admin Readiness Review to work through all org configuration — SSO, SCIM, workspace design, roles, ABAC policy, API keys, data retention, Fleet setup, and more. Your Customer Engineer will guide you through each topic.